home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / f / rlib12.lbr / RLIB.DOC < prev    next >
Encoding:
Text File  |  1991-10-19  |  3.0 KB  |  73 lines
  1.                     RLIB REL LIBRARY MANAGER
  2.  
  3. RLIB and its companion files are Copyrighted in 1988 by A.E. Hawley
  4. You may use and modify it for your own personal needs but may not
  5. distribute it in modified form and may not distribute it for the
  6. purpose of profit or other monetary gain. If you modify RLIB and
  7. wish to share such modifications, please send them to the author
  8. for coordination and version control.
  9.  
  10. RLIB manages library files containing REL modules compatible with
  11. those produced by the Microsoft Maccro-80 assembler, and by others
  12. like ZAS and ZMAC. Such files are mrel format files.
  13.  
  14. The command structure for RLIB is explained in the help screen which
  15. is invoked by typing the program name either alone or with one or
  16. two slashes (/) or question marks (?). All filenames may be provided
  17. on the command line using standard ZCPR filespecs for which all but
  18. the filename is optional.
  19.  
  20. The functions provided by RLIB are basically three. These three basic
  21. functions are sufficient to build and maintain mrel libraries, as will
  22. be discussed below. The three basic functions are:
  23.  
  24.     1. Display Names and Entry points for mrel modules
  25.        in a library.
  26.  
  27.     2. Delete modules from a library by name.
  28.  
  29.     3. Add modules to a (possibly empty) library.
  30.  
  31. Extracting modules
  32.  
  33. When all modules but one have been deleted from a library, the resulting
  34. file is identical to the original single REL module. This is how one can
  35. extract modules (one at a time) from the library. Naturally, the single
  36. module library would usually be renamed to its module name.
  37.  
  38. Building a Library
  39.  
  40. The command "RLIB <libname>=<list of rel files>" causes search for the
  41. file <libname>. If found, the rel modules in the list are appended to
  42. the library in the order they occur in the list. If the library file
  43. is not found, then it is created and the same appending process occurs.
  44.  
  45. Deleting modules from a Library
  46.  
  47. A command like "RLIB <lib>=<module list> /d" causes the modules named
  48. to be deleted from the library. The "/d" is an option, and the '/' is
  49. not required as long as there is a delimiting space between the list
  50. and the option character.
  51.  
  52. Replacing Modules
  53.  
  54. The same command format is used, but with an option character 'R'.
  55. RLIB first deletes the modules named in the list, then appends those
  56. files with the same name. This is not a 'true' replacement, because
  57. the order of occurrence in the library is not retained.
  58.  
  59. Rearranging the order of modules in the library
  60.  
  61. Repetitive deletion and append operations are sufficient to rearrange
  62. the modules in a library. During the append operation, a new module
  63. could be included at any point; this constitutes an insertion.
  64.  
  65. So you can build, add to, delete, insert, replace, and rearrange the
  66. modules in a library. It is not the purpose of this documentation to
  67. explain WHY one would want to use mrel libraries. Having read this
  68. far, you probably already have some good and sufficient reasons.
  69.  
  70.         Al Hawley
  71.         Ladera Znode, Los Angeles, Ca
  72.         (213) 670-9465
  73.