;
                                   RLIB.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               4k (27)   1306  1.2        Al Hawley 12/88          Z3COM7

  1- Syntax/Options  2- Usage                                                 


   RLIB  manages library files  containing  REL modules compatible  with those
produced by the Microsoft  Macro-80 assembler and by others like ZAS and ZMAC.
Such files are MREL format files.   RLIB allows one to:

   1. Display Names and Entry points for MREL modules in a library
   2. Delete modules from a library by name
   3. Add modules to a (possibly empty) library.

   All filenames  may  be  provided on  the  command line using  standard ZCPR
filespecs for which all but the filename is optional.
:1

   Syntax:  RLIB LIB[=MOD[,MOD...]]  [[/]<option>]

<option> is one of:
        M - Display names of modules in LIB
        P - Display names and public symbols in LIB
        D - Delete modules MOD 
        R - Replace MOD(s) in LIB
        A - Append MOD(s) to LIB, create new LIB if required

If no option is present, then

        Default is P if LIB is the only argument (no "="), and
        Default is A if the form "LIB=MOD[,MOD...]" is present.
:2


Usage:  Extracting Modules

   When  all modules but  one have been deleted from a library,  the resulting
file is identical to  the original single  REL module.   This is how  one  can
extract  modules (one at  a time) from  the library.   Naturally,  the  single
module library would usually be renamed to its module name.


        Building a Library

   The command "RLIB <libname>=<list of REL files>" causes search for the file
<libname>.  If found,  the REL modules in the list are appended to the library
in the order they occur in the list.   If the library file is not found,  then 
it is created and the same appending process occurs.



Usage:  Deleting Modules from a Library

   A command like "RLIB <lib>=<module list> /d" causes the modules named to be
deleted from the library.  The "/d" is an option, and the "/" is not required
as long as there is a delimiting space between the list and the option char.


        Replacing Modules

   The same  command  format  is  used  as in Deleting,  but  with  an  option 
character "R".  RLIB first deletes the modules named in the list, then appends
those files with the same name.  This is not a 'true' replacement, because the
order of occurrence in the library is not retained.



Usage:  Rearranging the Order of Modules

   Repetetive deletion  and append operations  are sufficient to rearrange the
modules in  a library.   During the  append operation,  a new module could  be
included at any point; this constitutes an insertion.
