home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 5 / 05.iso / a / a009 / 3.ddi / BIN1.LIF / RTLINK.HLP < prev    next >
Encoding:
Text File  |  1991-04-14  |  8.2 KB  |  295 lines
  1. #              HELP TEXT FOR BOTH FREEFORMAT AND POSITIONAL SYNTAX
  2. #
  3. #                        .RTLink, Clipper 5.0 Version
  4. #
  5. # (C) Copyright Pocket Soft Inc. 1987, 1988, 1989, 1990.  All Rights Reserved.
  6. #
  7. # Lines from this file are printed 23 lines per screen
  8. # Lines which begin with a "#" are not printed
  9. #
  10. #
  11. # EACH SCREENFUL OF MESSAGES CONTAINS 23 LINES OF TEXT #######################
  12. FREEFORMAT syntax:
  13.  
  14. RTLINK [FILE <objFile list> [OUTPUT <outputFile>]
  15.        [LIBRARY [<libFile list>] [<linkOption list>]] | [@<scriptFile>]
  16.  
  17. POSITIONAL syntax:
  18.  
  19. RTLINK [<objFile list>, [<outputFile>], [<mapFile>],
  20.        [<libFile list>] [<linkOption list>]] | [@<scriptFile>][;]
  21.  
  22. If used without arguments, .RTLink enters prompt mode.
  23.  
  24. <objFile list> is a list of object (.OBJ) files to link.  
  25.  
  26. <outputFile> is the name of the file (.EXE or .PLL/.PLT) to be generated.
  27.  
  28. <mapFile> is the name of a map (.MAP) file to generate.
  29.  
  30. <libFile list> is the list of library (.LIB) files to search.
  31.  
  32. <linkOption list> is a list one or more linker options described below.
  33.  
  34. <scriptFile> is the name of a linker script (.lnk) file.
  35. # 23 LINES OF TEXT ###########################################################
  36.  
  37. For many options, two syntaxes are given and the correct one depends on the
  38. input mode used.  Specifying options in POSITIONAL mode requires the option
  39. to begin with a forward slash (if no forward slash is included in the syntax,
  40. the option is allowed only in FREEFORMAT).  FREEFORMAT mode allows you to use
  41. either syntax, and where there is only one syntax representation it allows
  42. you to omit both the slash and the colon.
  43.  
  44.  
  45.  
  46. Configuration Options
  47.  
  48.  
  49. /FREEFORMAT | /POSITIONAL
  50.  
  51. Configures the linker interface to FREEFORMAT or POSITIONAL input mode when
  52. .RTLink switches to a new input stream.  /FREEFORMAT is default input mode. 
  53. /FREEFORMAT and /POSITIONAL are special configuration options that may only
  54. be specified as part of the RTLINKCMD environment variable, within
  55. RTLINK.CFG, or on the RTLINK command-line if you are linking with a script
  56. file.  The forward slash is required regardless of the current input mode.
  57.  
  58.  
  59. # 23 LINES OF TEXT ###########################################################
  60.  
  61. Dynamic Overlay Options
  62.  
  63.  
  64. /DYNAMIC[:<ovlFile>]
  65. DYNAMIC [INTO <ovlFile>]
  66.  
  67. DYNAMIC forces the linker to place any subsequent Clipper-compiled modules
  68. into a dynamic overlay instead of placing the module in the root section. 
  69. The <ovlFile> causes .RTLink to generate an external overlay (.OVL) file.  If
  70. not specified, the overlay code is written to the .EXE file.  DYNAMIC is the
  71. opposite of RESIDENT and is the default mode.
  72.  
  73.  
  74.  
  75. /RESIDENT
  76.  
  77. Causes subsequent Clipper-compiled modules to be loaded into the root section
  78. of the current program, overriding the automatic creation of dynamic overlays
  79. for all Clipper-compiled code. RESIDENT is the opposite of DYNAMIC.  
  80.  
  81.  
  82.  
  83. # 23 LINES OF TEXT ###########################################################
  84.  
  85. Help and Debugging Options
  86.  
  87. /DEBUG
  88.  
  89. Causes the .RTLink overlay manager to display a message that identifies each
  90. overlay as it is loaded into memory during program execution.
  91.  
  92.  
  93. /HELP
  94.  
  95. Lists the linker options to the console.
  96.  
  97.  
  98. /MAP[:<mapOption list>]
  99. MAP [= <mapFile>] [<mapOption list>]
  100.  
  101. Generates a map file containing one or more reports about the link session. 
  102. The available MAP options are S to report segments with assigned addresses, N
  103. to report public symbols with addresses sorted by symbol, and A to report
  104. public symbols with addresses sorted by address.
  105.  
  106. (continued on next page)
  107. # 23 LINES OF TEXT ###########################################################
  108.  
  109. Help and Debugging Options (continued)
  110.  
  111.  
  112. /SILENT
  113.  
  114. Suppresses the display of the linker prompts and responses when .RTLink is
  115. invoked with a script file.
  116.  
  117.  
  118.  
  119. /VERBOSE[:<level>]
  120.  
  121. Causes .RTLink to display status messages during linking indicating the
  122. modules being linked and in what order.  <level> specifies the amount of
  123. information to display (0, 1, or 2).
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131. # 23 LINES OF TEXT ###########################################################
  132.  
  133. Incremental Linking Options
  134.  
  135.  
  136. /INCREMENTAL[:<wastedSpace>] | /NOINCREMENTAL
  137.  
  138. INCREMENTAL enables incremental linking of Clipper-compiled modules.  When a
  139. program is linked, only modules that have changed are re-linked. 
  140. <wastedSpace> is a numeric parameter that controls the percentage of wasted
  141. space allowed in the .EXE file that .RTLink will tolerate before re-linking
  142. the entire application.  Use of the INCREMENTAL option causes .RTLink to
  143. generate and maintain an information (.inf) file.  NOINCREMENTAL is the
  144. default.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155. # 23 LINES OF TEXT ###########################################################
  156.  
  157. Miscellaneous Options
  158.  
  159. /BATCH | /NOBATCH
  160.  
  161. BATCH prevents the linker from prompting you when it is unable to locate a
  162. file.  NOBATCH is the default.
  163.  
  164.  
  165. /DEFAULTLIBRARYSEARCH | /NODEFAULTLIBRARYSEARCH
  166.  
  167. NODEFAULTLIBRARYSEARCH causes .RTLink to ignore any library names embedded by
  168. the compiler.  Clipper automatically embeds CLIPPER.LIB, EXTEND.LIB, and
  169. DBFNTX.LIB in all of the .OBJ files that it generates unless you change the
  170. default using the /R compiler option.  DEFAULTLIBRARYSEARCH is the default.
  171.  
  172.  
  173. /EXTDICTIONARY | /NOEXTDICTIONARY
  174.  
  175. /NOEXTDICTIONARY causes the linker not to search the extended dictionary. 
  176. /EXTDICTIONARY is the default.  
  177.  
  178. (continued on next page)
  179. # 23 LINES OF TEXT ###########################################################
  180.  
  181. Miscellaneous Options (continued)
  182.  
  183.  
  184. /IGNORECASE | /NOIGNORECASE
  185.  
  186. NOIGNORECASE causes case to be significant in symbol and segment names. 
  187. IGNORECASE is the default.  
  188.  
  189.  
  190. /STACK:<sizeBytes>
  191.  
  192. Specifies a program stack overriding the stack size specified in the object
  193. module.  <sizeBytes> is a numeric values up to 65,535.
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203. # 23 LINES OF TEXT ###########################################################
  204.  
  205. Pre-link Options
  206.  
  207.  
  208. /EXCLUDE:<symbol>
  209. EXCLUDE <symbol list>
  210.  
  211. In pre-link mode (PRELINK linker option specified), causes any module
  212. defining the specified symbol(s) to be excluded from the link.
  213.  
  214.  
  215.  
  216. /PLL:<prelinkLib>
  217.  
  218. Used in link mode to specify a pre-linked library file that the resulting
  219. executable file depends on.  This option may also be used in pre-link mode in
  220. order to create a pre-linked library that depends on another pre-linked
  221. library; however, this nesting of pre-linked libraries is allowed only one
  222. level deep.
  223.  
  224.  
  225.  
  226. (continued on next page)
  227. # 23 LINES OF TEXT ###########################################################
  228.  
  229. Pre-link Options (continued)
  230.  
  231.  
  232. /PRELINK
  233.  
  234. Changes .RTLink to pre-link mode.  In this mode .RTLink generates two output
  235. files, a pre-linked library (.PLL) and a pre-linked transfer (.PLT) file,
  236. instead of an executable (.EXE) file.
  237.  
  238.  
  239.  
  240. /REFER:<symbol>
  241. REFER <symbol list>
  242.  
  243. In pre-link mode, forces .RTLink to search all specified libraries in order
  244. to load the necessary code associated with the specified symbols.
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251. # 23 LINES OF TEXT ###########################################################
  252.  
  253. Static Overlay Options
  254.  
  255.  
  256. BEGINAREA
  257. .
  258. . <linker freeformat options>
  259. .
  260. ENDAREA
  261.  
  262. Designates a static overlay area with all sections specified between these
  263. two commands becoming static overlay sections within the overlay area. 
  264. Static overlay areas may be nested by specifying a BEGINAREA...ENDAREA
  265. construct inside of another.
  266.  
  267.  
  268.  
  269. MODULE <moduleName list>
  270.  
  271. Moves the segments from the specified modules into the current static overlay
  272. section.
  273.  
  274. (continued on next page)
  275. # LAST PAGE HAS 19 LINES OF TEXT #############################################
  276.  
  277. Static Overlay Options (continued)
  278.  
  279.  
  280. PRELOAD
  281.  
  282. Causes the current static overly section to be loaded into memory before the
  283. program begins execution.  Normally, only the resident sections of the
  284. program are loaded into memory before execution begins.
  285.  
  286.  
  287.  
  288. SECTION [= <sectionName>] [INTO <ovlFile>]
  289.  
  290. Creates a static overlay section, and causes segments within any non-Clipper
  291. object modules specified in subsequent FILE or LIBRARY options to become a
  292. part of that section.  The <ovlFile> causes .RTLink to generate an external
  293. overlay (.OVL) file.  If not specified, the overlay code is written to the 
  294. .EXE file
  295.