This guide describes the Sun Workshop Compiler Pascal 4.2. This guide is to help you write and compile Pascal programs on a SPARCstation^TM system.

The Pascal 4.2 compiler runs on Solaris 2.x systems. A previous major Pascal release ran also on Solaris 1.x. Features previously available on only Solaris 1.x systems generally have been dropped or superceded by others that now work on Solaris 2.x systems, as described in current documentation.

The README file that accompanies the product compiler may provide other release-specific information.

---

Note - References to Pascal in this manual refer to the Sun Workshop Compiler Pascal 4.2 unless otherwise indicated.

---

For other release-specific information, see the README file.

• Chapter 1, "Introduction," gives basic information about the Pascal compiler and related program development tools.

• Chapter 2, "Pascal Programs," describes how to write, compile, and run a Pascal 4.2 program.

• Chapter 3, "The Pascal Compiler," describes the pc command and its options.

• Chapter 4, "Program Construction and Management," is an introduction to how complex programs are built in Pascal 4.2.

• Chapter 5, "Separate Compilation," describes how programs can be divided into several units, and how they are compiled and linked.

• Chapter 6, "The C-Pascal Interface," describes how to write programs that are partly in C and partly in Pascal.

• Chapter 7, "The C++-Pascal Interface," describes how to write programs that are partly in C++ and partly in Pascal.

• Chapter 8, "The FORTRAN-Pascal Interface," describes how to write programs that are partly in FORTRAN and partly in Pascal.

• Chapter 9, "Error Diagnostics," describes the errors you may encounter while writing programs with Pascal.

• Chapter 10, "Math Libraries," describes how to use the libm and libsunmath functions in Pascal programs.

• Chapter 11, "The Multithread Library," describes how to use the multithread library in Pascal programs.

• Appendix A, "Pascal Preprocessor," describes the Pascal preprocessors, with emphasis on the nonstandard preprocessor, cppas.

• Appendix B, "Error Messages," lists all error messages Pascal produces.

The following table describes the type styles and symbols used in this guide:

Table  P-2 Typographic Conventions 

Typeface or Symbol	Meaning	Example
AaBbCc123	The names of commands, files, and directories; on-screen computer output	Edit your .login file. Use ls -a to list all files. hostname% You have mail.
AaBbCc123	What you type, contrasted with on-screen computer output	hostname% su Password:
AaBbCc123	Command-line placeholder: replace with a real name or value	To delete a file, type rm filename.
AaBbCc123	Book titles, new words or terms, or words to be emphasized	Read the User's Guide. These are called class options. You must be root to do this.

• Pascal Language Reference, which describes extensions to standard Pascal

• Pascal Quick Reference Card, which summarizes the compiler options

Manual Page

Once you install the documentation, you can read about pc by entering the man command followed by the command name, as in:

hostname% man pc

This directory contains the following files:

• A Pascal 4.2 README, called pascal, which describes the new features, software incompatibilities, and software bugs of Pascal 4.2.

• A floating-point white paper, What Every Scientist Should Know About Floating-Point Arithmetic, by David Goldberg, in PostScript^TM format. The file is called floating-point.ps, and can be printed on any PostScript-compatible printer that has Palatino font. It can be viewed online by using the imagetool command:

  	hostname% imagetool floating-point.ps
  

This paper is available also in the AnswerBook system.

Incremental Link Editor (ild)
Numerical Computation Guide
Performance Profiling Tools