home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / MBUG / MBUG044.ARC / LIBRARY.DOC < prev    next >
Text File  |  1979-12-31  |  6KB  |  109 lines
  1.  
  2.    Documentation for LU.COM Version 2.10 (Here renamed Library.com)
  3. Thi≤ i≤ ß shor⌠ extrac⌠ oµ origina∞ 30δ documentation¼ availablσ oε bulletiε ì
  4. boards.  
  5. | = recent modifications by author
  6.  
  7. |  Copyright (c) 1982, 1983 by Gary P. Novosielski
  8.    All rights reserved.
  9.  
  10.    Permission  is  hereby  granted  to copy and distribute this
  11.    document  for  any  non-commercial  purpose. Any use of this
  12.    material  for  commercial  advantage  without  prior written
  13.    consent of the author is prohibited.
  14.  
  15.  
  16.  
  17. Thi≤ prograφ allow≤ yo⌡ t∩ grou≡ ß se⌠ oµ program≤ together¼ t∩ savσ disδ ì
  18. spacσ anΣ fo≥ conveniencσ iε transmissioε anΣ iε organizinτ disks« I⌠ als∩ ì
  19. allow≤ yo⌡ t∩ inspec⌠ anΣ unpacδ librar∙ file≤ yo⌡ migh⌠ obtain« (File≤ ì
  20. endinτ iε .lbr⌐ ╔ normall∙ usσ i⌠ morσ t∩ unpacδ file≤ ╔ ge⌠ ofµ bulletiε ì
  21. board≤ thaε t∩ storσ awa∙ m∙ programs¼ a≤ i⌠ caε causσ inconveniencσ b∙ ì
  22. makinτ file≤ les≤ readil∙ accessible« I⌠ als∩ caε bσ risk∙ t∩ storσ program≤ ì
  23. iε thi≤ way¼ fo≥ damagσ t∩ thσ librar∙ can wipσ ou⌠ al∞ it≤ membe≥ files« 
  24.  
  25.      Wheε yo⌡ cal∞ u≡ Library.Com¼  thσ firs⌠ thinτ yo⌡ havσ t∩ d∩ i≤ t∩ ì
  26. ente≥ onσ oµ thσ followinτ commands« ╔ normall∙ usσ -∩ firs⌠ t∩ Opeε ß ì
  27. Library¼ theε -∞ t∩ Lis⌠ it≤ contents¼ theε -σ t∩ Extrac⌠ thσ file≤ ╔ want.
  28.  
  29.         -ß   adΣ   file≤   t∩  library«  (Iµ  n∩  librar∙ i≤ currentl∙ open¼ ì
  30.    thσ defaul⌠   librar∙   LIBRARY.LB╥  i≤  alway≤  useΣ  instead.)
  31.    Oε nex⌠ line¼ namσ thσ files« Wild-card≤ caε bσ useΣ eτ t∩ adΣ al∞ file≤ ì
  32.    oε disk.(Won'⌠ adΣ existinτ    Librar∙ files)
  33.  
  34.         -d   delete  files  from  library. Name files on next line.
  35.    Wildcards can be used
  36.  
  37.         -e   extract  files  from library. Again wild cards can 
  38.    be used. Any  existing  file  with  the  same  name will be
  39.    overwritten  unless  it is protected by having its Read/Only
  40.    attribute bit set.
  41.  
  42.         -∞   lis⌠  curren⌠ librar∙ map or directory.ì
  43.  
  44.         -∩   opeε ß library« Oε thσ nex⌠ line¼ ente≥ thσ namσ oµ thσ ì
  45.    library.If a library is already open, it is closed first. 
  46.    If the new library does not exist, it is created  with  an  empty  
  47.    directory« Ambiguou≤ name≤ arσ no⌠ ⁿ  allowed«  Use≥  anΣ drivσ ì
  48.    specificatioε i≤ allowed« Thσ filσ typσ  ma∙ bσ specified¼ bu⌠ iµ no⌠ ì
  49.    entered¼ default≤ t∩ .LB╥  Thi≤ i≤ thσ recommendeΣ endinτ fo≥ al∞ librar∙ ì
  50.    files. 
  51.  
  52.         -r   reorganize  library.  -r causes the currently open
  53.    library  to  be  reorganized. First, the directory is sorted
  54.    into  alphabetical  order,  and  then all active members are
  55.    copied  to  a  work  library  which is opened on the defaultè|  user/drive,  which  may  or  may  not be the same as the old
  56.    library.  The  size  of  the  directory  may  be  changed by
  57.    specifying  a  greater or smaller number of entries than was
  58.    used  in  the old library. The directory will always be made
  59.    large  enough  to  contain all the active members of the old
  60.    library,  so  it  is safe to enter a size of "1" to make the
  61.    directory  as  small  as possible. (See Specifying Directory
  62.    Sizes below.)
  63.         When  reorganization  is  complete,  the old library is
  64. |  deleted  from  its  user/drive area, and the work library in
  65. |  the  default area is renamed to the name of the old library.
  66.    No  backup  copy  is retained. The newly reorganized library
  67.    remains open for use with subsequent operations.
  68.  
  69. |       -x   eXit program. -x causes the input line in which it
  70. |  is  contained to be the last line scanned by the program. It
  71. |  does  not  cause  immediate  program termination, and if any
  72. |  more  operators  follow  it  on  the same line, they will be
  73. |  processed  normally.  The  program terminates only after the
  74. |  processing of the current line is complete. Any open library
  75. |  is  then  closed,  and the user number and default drive are
  76. |  reset to the values they had when the program was originally
  77. |  invoked.  To  preserve  compatability with earlier versions,
  78. |  the program will also be terminated by an empty input line.
  79.  
  80.                     SPECIFYING DIRECTORY SIZE
  81.  
  82.         Whenever  an  old library is opened, the directory size
  83.    is displayed as follows:
  84.  
  85.     Old library LIBRARY.LBR has 32 entries, 5 free.
  86.  
  87.         This  means that 5 more members may be added before the
  88.    directory  becomes  full.  When  the  directory  is full, -a
  89.    becomes  an  invalid  operator,  and  the  library  must  be
  90.    reorganized to add any more members.
  91.         When  a library is created for the first time, the user
  92.    is prompted like this:
  93.  
  94.     New library COMMAND.LBR. Allow how many entries?_
  95.  
  96.         Any number from 1 to 65535 is valid. The actual maximum
  97.    is  determined by the amount of free memory available on the
  98.    systeφ iε use« Ente≥ thσ maximuφ numbe≥ oµ  membe≥  file≤  yo⌡  wan⌠  thσ  ì
  99.    librar∙  t∩ bσ capablσ of holding.
  100.         Iµ thσ disδ spacσ run≤  ou⌠  durinτ  aε  add¼  thσ  namσ  i≤  no⌠ ì
  101.    addeΣ t∩ the directory.  If  a  multiple  add  is  in progress, due to an
  102.    ambiguous  operand, the remaining qualifying files are still
  103.    added  if possible. If any of them is small enough to fit in
  104.    the  remaining  disk space, it will be added. If any sectors
  105.    were  written  by  a  failed  add  attempt,  and  then never
  106.    utilized,  they  remain  as  unused sectors, and the library
  107.    should be reorganized.
  108.  
  109. Note that all sorts of advanced features are possible but not listed here.è