Turning the listing on or off

Use LSTOUT- to disable all list output except error messages. This directive overrides all other listing control directives.

The default is LSTOUT+, which lists the output (if a list file was specified).

To disable the listing of a debugged section of program:

            lstout-
            ; This section has already been debugged.
            lstout+
            ; This section is currently being debugged.
            end

Listing conditional code and strings

Use LSTCND+ to force the assembler to list source code only for the parts of the assembly that are not disabled by previous conditional IF statements.

The default setting is LSTCND-, which lists all source lines.

Use LSTCOD- to restrict the listing of output code to just the first line of code for a source line.

The default setting is LSTCOD+, which lists more than one line of code for a source line, if needed—that is, long ASCII strings produce several lines of output. Code generation is not affected.

This example shows how LSTCND+ hides a call to a subroutine that is disabled by an IF directive:

            name    lstcndTest
            extern  print
            section FLASH:CODE(2)

debug       set     0
            if      debug
            bl      print
            endif

            lstcnd+
begin2      if      debug
            bl      print
            endif

            end

This generates the following listing:

    9                          name    lstcndTest
   10                          extern  print
   11                          section FLASH:CODE(2)
   12
   13     debug                set     0
   14     begin                if      debug
   15                          bl      print
   16                          endif
   17
   18                          lstcnd+
   19     begin2               if      debug
   21                          endif
   22
   23                          end

Controlling the listing of macros

Use LSTEXP- to disable the listing of macro-generated lines. The default is LSTEXP+, which lists all macro-generated lines.

Use LSTMAC+ to list macro definitions. The default is LSTMAC-, which disables the listing of macro definitions.

This example shows the effect of LSTMAC and LSTEXP:

            name    lstmacTest
            extern  memLoc
            section FLASH:CODE(2)

dec2        macro   arg
            subs    r1,r1,#arg
            subs    r1,r1,#arg
            endm

            lstmac+
inc2        macro   arg
            adds    r1,r1,#arg
            adds    r1,r1,#arg
            endm

begin       dec2    memLoc
            lstexp-
            inc2    memLoc
            bx      lr

; Restore default values for
; listing control directives.

            lstmac-
            lstexp+

            end

This produces the following output:

   13                          name    lstmacTest
   14                          extern  memLoc
   15                          section FLASH:CODE(2)
   16
   21
   22                          lstmac+
   23              inc2        macro   arg
   24                          adds    r1,r1,#arg
   25                          adds    r1,r1,#arg
   26                          endm
   27
   28              begin       dec2    memLoc
   28.1  00000000 ........     subs    r1,r1,#memLoc
   28.2  00000004 ........     subs    r1,r1,#memLoc
   28.3                        endm
   29                          lstexp-
   30                          inc2    memLoc
   31    00000010 1EFF2FE1     bx      lr
   32
   33              ; Restore default values for
   34              ; listing control directives.
   35
   36                          lstmac-
   37                          lstexp+
   38
   39                          end

Controlling the listing of generated lines

Use LSTREP- to turn off the listing of lines generated by the directives REPT, REPTC, and REPTI.

The default is LSTREP+, which lists the generated lines.

Generating a cross-reference table

Use LSTXRF+ to generate a cross-reference table at the end of the assembler list for the current module. The table shows values and line numbers, and the type of the symbol.

The default is LSTXRF-, which does not give a cross-reference table.

Specifying the list file format

Use COL to set the number of columns per page of the assembler list. The default number of columns is 80.

Use PAGSIZ to set the number of printed lines per page of the assembler list. The default number of lines per page is 44.

Use LSTPAG+ to format the assembler output list into pages.

The default is LSTPAG-, which gives a continuous listing.

Use PAGE to generate a new page in the assembler list file if paging is active.