home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / zsys / znode-12 / s / z3help06.lbr / RLIB.HZP / RLIB.HLP
Encoding:
Text File  |  1993-06-12  |  2.9 KB  |  76 lines
  1. ;
  2.                                    RLIB.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                4k (27)   1306  1.2        Al Hawley 12/88          Z3COM7
  6.  
  7.   1- Syntax/Options  2- Usage                                                 
  8.  
  9.  
  10.    RLIB  manages library files  containing  REL modules compatible  with those
  11. produced by the Microsoft  Macro-80 assembler and by others like ZAS and ZMAC.
  12. Such files are MREL format files.   RLIB allows one to:
  13.  
  14.    1. Display Names and Entry points for MREL modules in a library
  15.    2. Delete modules from a library by name
  16.    3. Add modules to a (possibly empty) library.
  17.  
  18.    All filenames  may  be  provided on  the  command line using  standard ZCPR
  19. filespecs for which all but the filename is optional.
  20. :1
  21.  
  22.    Syntax:  RLIB LIB[=MOD[,MOD...]]  [[/]<option>]
  23.  
  24. <option> is one of:
  25.         M - Display names of modules in LIB
  26.         P - Display names and public symbols in LIB
  27.         D - Delete modules MOD 
  28.         R - Replace MOD(s) in LIB
  29.         A - Append MOD(s) to LIB, create new LIB if required
  30.  
  31. If no option is present, then
  32.  
  33.         Default is P if LIB is the only argument (no "="), and
  34.         Default is A if the form "LIB=MOD[,MOD...]" is present.
  35. :2
  36.  
  37.  
  38. Usage:  Extracting Modules
  39.  
  40.    When  all modules but  one have been deleted from a library,  the resulting
  41. file is identical to  the original single  REL module.   This is how  one  can
  42. extract  modules (one at  a time) from  the library.   Naturally,  the  single
  43. module library would usually be renamed to its module name.
  44.  
  45.  
  46.         Building a Library
  47.  
  48.    The command "RLIB <libname>=<list of REL files>" causes search for the file
  49. <libname>.  If found,  the REL modules in the list are appended to the library
  50. in the order they occur in the list.   If the library file is not found,  then 
  51. it is created and the same appending process occurs.
  52.  
  53.  
  54.  
  55. Usage:  Deleting Modules from a Library
  56.  
  57.    A command like "RLIB <lib>=<module list> /d" causes the modules named to be
  58. deleted from the library.  The "/d" is an option, and the "/" is not required
  59. as long as there is a delimiting space between the list and the option char.
  60.  
  61.  
  62.         Replacing Modules
  63.  
  64.    The same  command  format  is  used  as in Deleting,  but  with  an  option 
  65. character "R".  RLIB first deletes the modules named in the list, then appends
  66. those files with the same name.  This is not a 'true' replacement, because the
  67. order of occurrence in the library is not retained.
  68.  
  69.  
  70.  
  71. Usage:  Rearranging the Order of Modules
  72.  
  73.    Repetetive deletion  and append operations  are sufficient to rearrange the
  74. modules in  a library.   During the  append operation,  a new module could  be
  75. included at any point; this constitutes an insertion.
  76.