as: listing
1
1 2.8 Configuring listing output: '--listing'
1 ===========================================
1
1 The listing feature of the assembler can be enabled via the command line
1 switch '-a' (⇒a). This feature combines the input source file(s)
1 with a hex dump of the corresponding locations in the output object
1 file, and displays them as a listing file. The format of this listing
1 can be controlled by directives inside the assembler source (i.e.,
DONTPRINTYET 1 '.list' (⇒List), '.title' (⇒Title), '.sbttl' (*note1DONTPRINTYET 1 '.list' (⇒List), '.title' (⇒Title), '.sbttl' (⇒
Sbttl), '.psize' (⇒Psize), and '.eject' (⇒Eject) and
1 also by the following switches:
1
1 '--listing-lhs-width='number''
1 Sets the maximum width, in words, of the first line of the hex byte
1 dump. This dump appears on the left hand side of the listing
1 output.
1
1 '--listing-lhs-width2='number''
1 Sets the maximum width, in words, of any further lines of the hex
1 byte dump for a given input source line. If this value is not
1 specified, it defaults to being the same as the value specified for
1 '--listing-lhs-width'. If neither switch is used the default is to
1 one.
1
1 '--listing-rhs-width='number''
1 Sets the maximum width, in characters, of the source line that is
1 displayed alongside the hex dump. The default value for this
1 parameter is 100. The source line is displayed on the right hand
1 side of the listing output.
1
1 '--listing-cont-lines='number''
1 Sets the maximum number of continuation lines of hex dump that will
1 be displayed for a given single line of source input. The default
1 value is 4.
1