CA-Clipper Linker--(RTLINK.EXE)

 Overview

     Combines object files (.OBJ) with library files (.LIB) to form an
     executable file (.EXE) or prelink library (.PLL).

 Syntax

     The default, FREEFORMAT syntax to invoke .RTLink is as follows:

     RTLINK [FILE <objFile list>
           [OUTPUT <outputFile>]
           [LIBRARY [<libFile list>]
           [<linkOption list>]] | [@<scriptFile>]

     The POSITIONAL syntax is:

     RTLINK [<objFile list>,
           [<outputFile>],
           [<mapFile>],
           [<libFile list>]
           [<linkOption list>]] | [@<scriptFile>][;]

     If used without arguments, .RTLink enters prompt mode in which you are
     prompted for linker input.

 Command Line Arguments

     <objFile list> is a list of object files to link.

     <outputFile> is the name of the output file to be generated.  If not
     specified, the name of the first file on the .RTLink command line is
     used.

     <mapFile> is the name of a map file to generate.

     <libFile list> is the list of library files to search in order to
     resolve any undefined symbols.

     <linkOption list> refers to the use of one or more of the linker
     options described below.

     <scriptFile> is the name of an ASCII text file used as the linker
     script file.  The default extension for this file is (.LNK).

 Script File

     Using the FREEFORMAT syntax, options specified in the script file do not
     have to be in a specific order.  However, when using POSITIONAL syntax,
     the format of the script file must be as follows:

     <objFile list>[<linkOption list>]
        [<outputFile>]
        [<mapFile>]
        [<libFile list>]  [;]

 Linker Options

     For many options, two syntaxes are given and the correct one depends on
     the input mode used.  Specifying options in POSITIONAL mode requires the
     option to begin with a forward slash (if no forward slash is included in
     the syntax, the option is allowed only in FREEFORMAT). FREEFORMAT mode
     allows you to use either syntax, and where there is only one syntax
     representation it allows you to omit both the slash and the colon.

     /BATCH | /NOBATCH

     BATCH prevents the linker from prompting you when it is unable to locate
     a file.  NOBATCH is the default.

     BEGINAREA
     .
     . <statements>
     .
     ENDAREA

     Designates a static overlay area with all sections specified between
     these two commands becoming static overlay sections within the overlay
     area.  Static overlay areas may be nested by specifying a
     BEGINAREA...ENDAREA construct inside of another.

     /DEBUG

     Causes the .RTLink overlay manager to display a message that identifies
     each overlay as it is loaded into memory during program execution.

     /DEFAULTLIBRARYSEARCH | /NODEFAULTLIBRARYSEARCH

     NODEFAULTLIBRARYSEARCH causes .RTLink to ignore any library names
     embedded by the compiler.  DEFAULTLIBRARYSEARCH is the default.

     /DYNAMIC[:<ovlFile>]
     DYNAMIC [INTO <ovlFile>]

     DYNAMIC forces the linker to place any subsequent CA-Clipper-compiled
     modules into a dynamic overlay instead of placing the module in the root
     section.  DYNAMIC is the opposite of RESIDENT and is the default mode.

     /EXCLUDE:<symbol>
     EXCLUDE <symbol list>

     In prelink mode, causes any module defining the specified symbol(s) to
     be excluded from the link.

     /EXTDICTIONARY | /NOEXTDICTIONARY

     /NOEXTDICTIONARY causes the linker not to search the extended
     dictionary.  /EXTDICTIONARY is the default.

     /FREEFORMAT

     Configures the linker interface to FREEFORMAT input mode when .RTLink
     switches to a new input stream. /FREEFORMAT is the opposite of
     /POSITIONAL and the default input mode.

     /HELP

     Lists the linker options to the console.

     /IGNORECASE | /NOIGNORECASE

     NOIGNORECASE causes case to be significant in symbol and segment names.
     IGNORECASE is the default.

     /INCREMENTAL[:<wastedSpace>] | /NOINCREMENTAL

     INCREMENTAL enables incremental linking of CA-Clipper-compiled modules.
     When a program is linked, only modules that have changed are relinked.
     NOINCREMENTAL is the default.

     /MAP[:<mapOption list>]
     MAP [= <mapFile>] [<mapOption list>]

     Generates a map file containing one or more reports about the link
     session.

     MODULE <moduleName list>

     Moves the segments from the specified modules into the current static
     overlay section.

     /PLL:<prelinkLib>

     Used in link mode to specify a prelinked library file the output
     executable file depends on.

     /POSITIONAL

     Configures the linker interface to the POSITIONAL input mode when
     .RTLink switches to a new input stream. /POSITIONAL is the opposite of
     /FREEFORMAT which is the default input mode.

     /PRELINK

     Changes .RTLink to prelink mode.  In this mode the <outputFile>
     generated by .RTLink is a prelink library (.PLL) file instead of an
     executable file (.EXE).

     PRELOAD

     Causes the current static overly section to be loaded into memory before
     the program begins execution.  Normally, only the resident sections of
     the program are loaded into memory before execution begins.

     /REFER:<symbol>
     REFER <symbol list>

     In prelink mode, forces .RTLink to search all specified libraries in
     order to load the necessary code associated with the specified symbols.

     /RESIDENT

     Causes subsequent CA-Clipper-compiled modules to be loaded into the root
     section of the current program, overriding the automatic creation of
     dynamic overlays for all CA-Clipper-compiled code. RESIDENT is the
     opposite of DYNAMIC.

     SECTION [= <sectionName>] [INTO <ovlFile>]

     Creates a static overlay section, and causes segments within any non-
     CA-Clipper object modules specified in subsequent FILE or LIBRARY
     options to become a part of that section.

     /SILENT

     Suppresses the display of the linker prompts and responses when .RTLink
     is invoked with a script file.

     /STACK:<sizeBytes>

     Specifies a program stack overriding the stack size specified in the
     object module.  <sizeBytes> is a numeric values up to 65,535.

     /VERBOSE[:<level>]

     Causes .RTLink to display status messages during linking indicating the
     modules being linked and in what order. <level> specifies the amount of
     information to display (0, 1, or 2).