Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                             ◄Up► ◄Contents► ◄Index► ◄Back►
─────Creating Listing Files (/F)────────────────────────────────────────────
 
     The /F options can create a source listing, a map listing, or one
     of several kinds of object listings.
 
     The FL command optimizes by default, so object listings reflect
     the optimized code. Since optimization may involve rearranging
     the code, the correspondence between your source file and the
     machine instructions may not be clear. To suppress optimization,
     use the /Od option.
 
     The following is a list of options that produce listings and
     control their appearances:
 
     Option            Effect
 
     /Fs[listfile]     Produces source listing
 
     /Fl[listfile]     Produces object listing
 
     /Fa[listfile]     Produces assembly listing
 
     /Fc[listfile]     Produces combined source and object listing
 
     /Fm[mapfile]      Produces map file that lists segments in order
 
     The options require the <listfile> or <mapfile> argument to follow
     the option immediately, with no intervening spaces. They are
     optional file specifications for the listings.
 
     If you omit the argument altogether, FL uses the base name of the
     source file, plus the default extensions, to create a default file
     name.
 
     Option          Listing Type               Extension
 
     /Fs             Source                     .LST
 
     /Fl             Object                     .COD
 
     /Fa             Assembly                   .ASM
 
     /Fc             Combined source-object     .COD
 
     /Fm             Map                        .MAP
 
     The default extension is used when a file name lacking an
     extension is given.
 
     If a source file includes one or more $NOLIST metacommands,
     the portion of that source file between each $NOLIST
     metacommand and the following $LIST metacommand (if any) is
     omitted from the listing.
 
     See Also: ◄$[NO]LIST►
               ◄Special File Names►
 
     The map file is produced during the linking stage. If linking is
     suppressed with the /c option, the /Fm option has no effect.
                                    -♦-