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 list more than one line of code for a source line, if needed—that is, long ASCII strings produce several lines of output.

The default setting is LSTCOD-, which restricts the listing of output code to just the first line of code for a source line.

Using the LSTCND and LSTCOD directives does not affect code generation.

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

            name    lstcndTest
            extern  print
            section .text:CODE(2)

debug       set     0
begin       if      debug
            jarl    print,lp
            endif

            lstcnd+
begin2      if      debug
            jarl    print
            endif

            end

This generates the following listing:

     13                                name   
lstcndTest
     14    000000                      extern  print
     15    000000                      section .text:CODE(2)
     16                                
     17    000000              debug   set     0
     18    000000              begin   if      debug
     19                                jarl    print,lp
     20    000000                      endif
     21                                
     22                                lstcnd+
     23    000000              begin2  if      debug
     25    000000                      endif
     26                                
     27    000000                      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 .text:CODE(2)

dec2:   macro   arg
        mov     arg,r6
        ld.w    0[r6],r7
        add     2,r7
        st.w    r7,0[r6]
        endm
        
        lstmac+
inc2:   macro   arg
        mov     arg,r6
        ld.w    0[r6],r7
        add     -2,r7
        st.w    r7,0[r6]
        endm
        
begin:  dec2    memLoc
        lstexp-
        inc2    memLoc
        jmp     [lp]

; Restore default values for
; listing control directives.

        lstmac-
        lstexp+

        end

This produces the following output:

      1                                NAME    dec2
      2                                
      3                        dec2    MACRO   arg
      4                                subw    $2,arg
      5                                ENDM
      6                                        
      7    000000                      LSTMAC+
      8                        
      9                                
     10    000000              begin:  dec2    R6
     10.1  000000 263A                 subw    $2,R6
     11                        
     12    000000                      LSTEXP-
     13    000002                      inc2    R7
     14                        
     15                        
     16    000000                      ; restore defaults
     17    000000                      LSTMAC-
     18    000000                      LSTEXP+
     19                                
     20    000004                      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.