listing C List Option

Syntax: Default:
list(listing[, yes])
list(listing, no)
list(listing, no)

This option determines whether the C compiler generates a listing file. By default no compile listing is produced.

If you specify list(listing), a listing is produced for every source to which the option applies. By default, these files have the same name as the source file and the extension .lst.

On OS/2 and Windows NT platforms you can supply a file name by building with option list(fileName, fileName).

This option is implicitly set to no when any of the following options are in effect:

pp(preprocessOnly)
pp(preserveComments, no)
pp(stdout, no)
pp(suppressLine)

You can use a listing file as a tool for debugging. It contains error messages, and a prolog that gives the following information:

You can control the appearance and contents of the listing file by specifying the options shown below. These options are enabled when you build with list(listing):

list(allStructVar)
list(attr)
list(expAllInc)
list(expMacros)
list(expUserInc)
list(fullXRef)
list(incSource)
list(minXRef)
list(options)
list(pageLen)
list(refStructVar)
list(reportLevel)
list(subTitle, string)
file(tabSize)
list(title, string)

On OS/2 and Windows NT platforms, building with list(full) also enables all the listing options that apply on OS/2 and Windows NT platforms, and implicitly sets them to produce a full listing.

Listing options are processed in the order they are specified. Therefore, you can combine them to include only what you want to appear in a listing file.

Example of a C Compile List File



C Compilation
Configuration Files


Set Build Options
Build


C Listing Options