[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
MODULE
------------------------------------------------------------------------------
Purpose : Specify placement of individual library modules
Syntax : MODULE <module> [,<module> ...] [FROM <libname>]
Example : # Move the module COLOR to the current location
MODULE COLOR
The module command allows individual modules to be forced into the root
or the overlay area regardless of whether the originating libraries or
object modules are specified within an overlay area or not.
The position of the module command within the link script determines the
placement of the named module within the executable - if the MODULE
command is in the root the named modules will be forced into the root;
if it is in the overlay area, the named modules will be overlaid.
Multiple modules can be specified on the same command line separated by
','.
The library and module names should be specified without path names; if
included, they will be ignored. The VERBOSE command can be used to
determine the correct module name to use, since it displays each module
name as it is processed from the library or object module. This is the
same name as used by the Microsoft librarian (LIB.EXE). MODULE commands
are case insensitive, (upper or lower case will be treated the same)
unless the MIXCASE command has been specified in the script file before
the MODULE command.
The MODULE command has a second mode of operation, whereby a source
library is specified using the FROM <libname> option. This allows
modules from specific libraries to be used in preference to others, and
at the same time performs the normal MODULE function of changing the
placement of routines in the root or overlay area. This is useful to
resolve a conflict between two libraries which contain modules with the
same name.
It is advisable to use the FROM option only when necessary, since it
modifies the normal linking sequence.
MODULE DBEDIT, MEMOEDIT FROM EXTEND
This command forces the modules DBEDIT and MEMOEDIT from EXTEND to be
used in preference to modules of the same name which may have been found
previously in other libraries or files, AND moves those modules to the
current location in the script file.
MODULE MEMOEDIT FROM NUL
This command forces the module MEMOEDIT not to be linked at all, since
Blinker will be looking for a library called NUL, which cannot exist.
If, however, something in MEMOEDIT is explicitly referenced by another
module, this will cause an unresolved external. To override this, use
the DEFINE command rather than the MODULE command, and DEFINE the public
symbols within the module which are unresolved.
See Also:
DEFINE
MESSAGE DUPLICATES
LIBRARY
VERBOSE
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson