7.1452;pas (pascal), revision 7.1452, 1986/12/02
PAS (PASCAL) -- Compile a Pascal program.
usage: PAS source_file [-ALIGN|-NALIGN] [-B [file] | -NB] [-NCOMCHK|-COMCHK]
[-NCOND|-COND] [-CONFIG name1 name2]
[-CPU id] [-DB|-DBS|-DBA|-NDB]
[-NEXP|-EXP] [-IDIR pathname]
[-ISO|-NISO] [-NL|-L [file]]
[-NMAP|-MAP] [-MSGS|-NMSGS] [-OPT [n]]
[-SLIB pathname] [-NSUBCHK|-SUBCHK]
[-WARN|-NWARN] [-XRS|-NXRS]
FORMAT
PAS source_file [options]
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 as of
SR9.5, 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
Default options are indicated by "(D)."
-ALIGN (D) Align data on natural boundaries. Keep the stack and the
"top" of loops longword aligned. This helps DNx60
processors to execute more efficiently.
-NALIGN Suppress alignment.
-B [file] (D) Generate binary file. Default name is source_file.BIN.
-NB Suppress binary file.
-COMCHK Check for balanced comments and warn if not.
-NCOMCHK (D) Suppress comment checking.
-COND Compile lines prefixed with "{%DEBUG}".
-NCOND (D) 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 (D) 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.
-DB (D) Generate runtime debug tables without symbol table.
-DBS Generate full runtime debug tables with symbol table. If
this option is specified, -OPT 3 is also set. (You may
override this by specifying -OPT 0.)
-DBA Identical to -DBS except that no optimization is performed
(i.e., -OPT 0 is set). This prevails even if you also
specify -OPT.
-NDB Suppress runtime debug tables.
-EXP Generate expanded code listing (implies -L).
-NEXP (D) Suppress expanded code listing.
-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 (D) Compile using DOMAIN Pascal features.
-L [file] Generate compilation listing. Default name is
source_file.LST.
-NL (D) Suppress compilation listing.
-MAP Generate symbol table map (implies -L).
-NMAP (D) Suppress symbol table map.
-MSGS (D) Generate final error and warning count message.
-NMSGS Suppress final error and warning count message.
-OPT [n] (D) 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 'n' 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: At 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 (D) 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.
-SUBCHK Subscript checking.
-NSUBCHK (D) Suppress subscript checking.
-WARN (D) Display warning messages.
-NWARN Suppress warning messages.
-XRS (D) Save registers across a call to an external procedure or
function.
-NXRS Do not assume thatcalls 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.