pas(1) — Commands
NAME
pas − Compile a Pascal program.
SYNOPSIS
pas source_file [−b [pathname] −bx pathname.suffix | −nb]
[−bounds_violation | −no_bounds_violation]
[−cd | −ncd]
[−comchk | −ncomchk]
[−compress | −ncompress]
[−cond | −ncond]
[−config name1 name2]
[−db | −dbs | −dba | −ndb]
[−exp | -nexp]
[−idir pathname]
[−imap | −nimap]
[−indexl | −nindexl]
[−info [n]]
[−inlib pathname]
[−iso | −niso]
[−l [pathname] | −nl]
[−map | −nmap]
[−msgs | −nmsgs]
[−natural | −nnatural]
[−opt [n]]
[−pic]
[−slib pathname]
[−std | −nstd]
[−vendor | −nvendor]
[−version]
[−warn | −nwarn]
ARGUMENTS
source_file (required)
Specify the pathname of the source file to be compiled. The source_file must be the first argument. If you do not specify the .pas extension, then the compiler searches for the source_file pathname in the following order. First, it searches for source_file.pas. If not found, the compiler searches for source_file. If not found, the compiler reports an error.
FLAGS
−b [file] (default) Generate binary file named file.bin. If argument is omitted, default name is sourcefile.bin.
−bx pathname.suffix
Generate a binary file at pathname.suffix.
−nb Suppress binary file.
−bounds_violation (default)
Allow referencing beyond the end of an array. Optimization of code is less efficient.
−no_bounds_violation
Do not allow referencing beyond the end of an array. Allows superior optimization of code.
−cd Compress debugger information in the object file.
−ncd (default) Do not compress debugger information in the object file.
−comchk Check that all comments are closed. Issue a warning for any unclosed comments.
−ncomchk (default)
Suppress comment checking.
−compress (default)
Store data in the object file in compressed format. With this option, the object file contains instructions to the loader that tell how to write the data into memory.
−ncompress Store data in the object file in uncompressed format. With this format, the object file contains an exact image of the data that is loaded into memory.
−cond Compile lines prefixed with "%DEBUG".
−ncond (default) Ignore lines prefixed with "%DEBUG".
−config name1 name2 ...
Conditional processing: compile statements associated with name1, name2, and so on via conditional compiler directives.
−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 with an argument greater than 0.
−ndb Suppress runtime debug tables.
−exp Generate expanded code listing (implies −l).
−nexp (default) Suppress expanded code listing.
−idir pathname Add pathname to the search hierarchy of directories for include file names. The hierarchy applies only to file name strings that 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.
−indexl Produce a 32-bit index for all array references.
−nindexl (default)
Refer to source code for array reference index information.
−info [n] Default is n=2. Display information messages to nth level.
−inlib dir/libx.so Load dir/libx.so (a pic binary file) at runtime and resolve global references. The filename in the directory dir must have the prefix lib and the suffix .so . x can consist of up to nine characters. Whenever you use the −inlib option, you need to specify −Lx and −lx on the pas_ld command line.
−iso Compile using ISO/ANSI standard Pascal rules for certain Acorn Pascal features that deviate from the standard.
−niso (default) Compile using Acorn Pascal features.
−l [file] Generate compilation listing. Default name is sourcefile.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 (default)
Use natural alignment for record fields and array elements that do not have alignment attributes.
−nnatural 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. 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 Acorn Pascal Language Reference manual for details.
−pic (default) Compile using Position Independent Code.
−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.
−vendor (default) Create expanded compiler listings in PA-RISC assembler format.
−nvendor Create expanded compiler listings in a generic format.
−version Display version number of compiler.
−warn (default) Display warning messages.
−nwarn Suppress warning messages.
DESCRIPTION
pas translates a Pascal source file into a binary object module, which can be used as input to the link editor (ld). Use the utility pas_ld to invoke the link editor. 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).
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.
COMPATIBILITY WITH OSF/1
The pas command is provided on HP OSF/1. It may not be provided on other implementations of OSF/1.