===========================================
NAME
pas - Compile a Pascal program.
SYNOPSIS
pas source_file [ -options ]
DESCRIPTION
pas translates a Pascal source file into a binary object module, which
can be executed or used as input to the binder. Source files may be a
maximum of 32767 lines long. If errors occur during compilation, the
compiler writes diagnostic messages on standard output and flags the
incorrect statements in the listing file if one exists (see -l).
For complete details, see the Domain Pascal Language Reference.
ARGUMENTS
source_file (required)
Specify the pathname of the source file to be compiled. The source_file
must be the first argument. Prior to sr9.5, the pathname had to end with
.pas, but for sr9.5 and later versions, there are no special requirements
for the pathname. If you do not specify the .pas extension, then the
compiler searches for pathname in the following order. First, it
searches for pathname.pas. If not found, the compiler searches for
pathname. If not found, the compiler reports an error.
OPTIONS
-ac (default) Compile using absolute code.
-pic Compile using Position Independent Code.
-align (default)
Align data on natural boundaries. Obsolete switch. See
-natural.
-nalign Suppress alignment. Obsolete switch. See -nnatural.
-alnchk (default)
Display alignment messages.
-nalnchk Suppress alignment messages.
-b [file] (default)
Generate binary file. Default name is source_file.BIN.
-nb Suppress binary file.
-comchk Check for balanced comments and warn if not.
-ncomchk (default)
Suppress comment checking.
-cond Compile lines prefixed with "{%DEBUG}".
-ncond (default)
Ignore lines prefixed with "{%DEBUG}".
-config name1 name2...
Conditional processing: compile statements associated with
name1, name2, etc. via conditional compiler directives.
-cpu id Generate code for a particular class of processors.
Values for id are
any (default) Generate code which uses only the
basic instructions supported by the
M68000.
160, 460, 660 Generate code which uses the
additional instructions supported by
DNx60 (except the DN560) and DSP160
processors.
90, 330, 560, 570, 580, 3000
Generate code which uses the
additional instructions supported by
the DSP90, DN330, DN560, DN570, DN580,
and DN3000 processors.
peb Generate code for a Performance
Enhancement Board.
fpx Generate code for workstations with a
floating-point accelerator (FPX) --
includes the DN570-T and DN580-T.
-db (default) Generate runtime debug tables without symbol table.
-dbs Generate full runtime debug tables with symbol table.
NOTE: This option has no effect on optimization.
-dba Identical to -dbs except that no optimization is
performed, even if you also specify -opt.
-ndb Suppress runtime debug tables.
-exp Generate expanded code listing (implies -L.
-nexp (default)
Suppress expanded code listing.
-frnd Store and round floating point numbers before comparisons.
-nfrnd (default)
Do not round floating point numbers.
-idir pathname Add a pathname to the search hierarchy of directories for
include file names. The hierarchy applies only to file
name strings which do NOT begin with '.', '~', or '/'. Up
to 63 -idir options may be given. The compiler first
tries to open the include file name as given. Failing
that, it prefixes the given include file name with the
-idir pathnames in the same order as supplied on the
command line.
-imap Implies -map and also generates symbol table map for
%included files.
-nimap (default)
Suppress symbol table map for %included files.
-info [n] Default is n=2. Display information messages to nth
level.
-inlib [pathname]
Load pathname (a pic binary file) at runtime and resolve
global references.
-iso Compile using ISO/ANSI standard Pascal rules for certain
Domain Pascal features that deviate from the standard.
-niso (default)
Compile using Domain Pascal features.
-l [file] Generate compilation listing. Default name is
source_file.lst.
-nl (default) Suppress compilation listing.
-map Generate symbol table map (implies -l).
-nmap (default)
Suppress symbol table map.
-msgs (default)
Generate final error and warning count message.
-nmsgs Suppress final error and warning count message.
-natural Use natural alignment for record fields and array elements
that do not have alignment attributes.
-nnatural (default)
Suppress natural alignment for record fields and array
elements that do not have alignment attributes.
-opt [n] (default)
Perform global optimization. n is a single digit integer
in the range 0 to 4, indicating the level of optimization
performed. -opt 0 is identical to the obsolete switch
-nopt. If ' is omitted, 3 is the default level.
Increasing the optimization level results in faster
execution of your program, at the expense of longer
compilation time. See the Domain Pascal Language Reference
manual for details.
Note: Since sr9.5, -opt 3 and -opt 4 are equivalent.
-nopt Suppress global optimization. Obsolete switch. Use -opt 0.
-peb Generate inline code for Performance Enhancement Board.
Obsolete switch. Use -cpu peb.
-npeb (default)
No inline code for Performance Enhancement Board.
Obsolete switch. Use -cpu any.
-slib pathname Treat the input as an include file and produce a
precompiled library of include files at pathname.plb.
-std Issue warning messages when nonstandard language elements
are encountered.
-nstd (default)
Suppress warning messages for nonstandard elements.
-subchk Subscript checking.
-nsubchk (default)
Suppress subscript checking.
-version Display version number of compiler.
-warn (default)
Display warning messages.
-nwarn Suppress warning messages.
-xrs (default) Save registers across a call to an external procedure or
function.
-nxrs Do not assume that calls to external routines have saved
the registers.
EXAMPLES
$ pas graph.line -l
The Pascal compiler reads the file graph.line.pas, and produces an object
module file named graph.line.bin and a listing file named
graph.line.lst.