HP Pascal/iX Reference Manual (31502-90022)

12- 45
LIST
LIST is an HP Standard Option.
When the LIST compiler option is ON, the compiler produces a listing of
the source code.
The command line option -L also specifies this option.
Syntax
$LIST {ON }$
{OFF}
Default ON.
Location Anywhere.
The first column of the listing shows the source statement number. This
number appears in the code offset table, is used by the symbolic
debugger, and is returned by the predefined function statement_number .
The second column of the listing shows a line number. The line number is
provided by the editor if the source file is numbered; by the compiler if
the source file is unnumbered. If the compiler numbers the lines, the
lines are numbered consecutively, starting with 1. Included files are
numbered separately (see the second example below, and the paragraph
above it).
The third column of the listing shows the source statement nesting level
(if the line is part of a structured statement). If the line was not
compiled (because it is a comment or is affected by the SKIP_TEXT
option), then ** replaces the number.
The end of the listing shows the processor time, elapsed time, the number
of lines compiled, the number of lines compiled per minute, and the
number of notes, warnings, and errors issued during the compilation.
Sample listings in this manual omit this information (except where the
example requires it). Times and rates vary, depending on the operating
system, the memory configuration, system load, and the number of source
lines.
If the compiler issues a message for a source line, it appears beneath
that line in the listing in this form:
**** {NOTE}
{WARNING}
{ERROR} # ord_num [ message ] ( message_num )
If the compiler can pinpoint the item in the source line that caused the
note, warning, or error, the listing indicates that item with a caret
(^).
The ord_num is the ordinal number of the note, warning, or error (it is
the ord_num th note, warning, or error in the compilation). The
message_num is the number that identifies the message, and message is the
text that explains it.
Error and warning messages on multipage listings are chained; that is,
the first such message on a page gives the page number of the previous
such message. If the listing has no error or warning messages, its last
page states this.
If LIST is OFF, and the compiler issues a message, it prints both the
name of the include file that contains the line, and a copy of the line
before issuing the message.
The LIST option must be ON for other options that affect the listing to