===========================================
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 to error 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
-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 that uses
only the basic
instructions supported by
the M68000.
PAS Aegis PAS
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.
fpa1 Produce optimized code
for the Floating-Point
Accelerator (FPA) board
that is available with
DN4000 workstations. Use
of this switch can
produce substantially
faster code. Do not use
this switch, however, if
the target machine does
not have an FPA board.
-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.
PAS Aegis PAS
-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.
-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.
-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.
PAS Aegis PAS
-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.