home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / l.lbr / LBREXT.HZP / LBREXT.HLP
Encoding:
Text File  |  1991-11-18  |  7.4 KB  |  143 lines
  1. ;
  2.                                  LBREXT.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                9k (66)   C8CD  3.4        Howard Goldstein 9/91    Z3COM11
  6.  
  7.   1- Syntax/Options  2- Notes                                                 
  8.  
  9.  
  10.    LBREXT is something like LGET,  except that LBREXT will extract 'crunched',
  11. 'squeezed' and 'LZH'-encoded files.   It has a brief help display, invoked  by
  12. typing '//' after the name.  
  13.  
  14.    LBREXT maintains dates according to the most precise information available,
  15. either from ZSDOS, DateStamper's  "!!!TIME&.DAT" files,  the  LBR's  DRI-style
  16. member  dates  (ala' SETD.COM) or  from  CR23D-style  imbedded  datespecs,  as 
  17. appropriate.  If  DateStamper  is  not  running,  it  operates  like  previous 
  18. versions of LBREXT.  Version 2.0 by Bob Peddicord.
  19. :1
  20.  
  21.    Syntax   LBREXT dir:lbrname dir:afn1,dir:afn2,... o
  22.  
  23.   Options   U - uncompress squeezed/crunched/LZH-encoded files 
  24.  
  25.             O - overwrite existing files without being asked
  26.  
  27.             I - Inspect (confirm files before extracting)
  28.  
  29.  
  30.    Wildcard  filename(s)  may be specified.   Files will be extracted  to  the 
  31. current directory if no output DU or DIR is specified.  Don't forget to  put a
  32. comma between filenames if specifying  more than  one filename.  ^C aborts  to
  33. the  command  line (if  in  the  middle  of  a  file, the  output file will be 
  34. deleted). 
  35. :2
  36.  LBREXT Notes - 1/6 
  37.  
  38.    a.  Vs 3.4 updates (09/27/91, Howard Goldstein):
  39.        - Added Inspect option to allow "tagging" of files to be extracted.
  40.  
  41.    b.  Vs 3.3 updates (08/02/91, Howard Goldstein):
  42.        - Linked with the new version of the  UNLZH  module  for  compatibility
  43.          with files compressed with CRLZH 2.0.  
  44.        - Fixed bug that caused "expansion errors" on certain squeezed files.  
  45.        - Made a few small changes which allow the  program to  work  correctly
  46.          and reliably under vanilla CP/M.
  47.  
  48.    c.  Vs 3.2 updates (3/23/91, Howard Goldstein):
  49.        -- Added code to extract creation  and  modify  times  from the library
  50.           directory.  
  51.        -- Removed code that  forced  all extractions to  default  directory if
  52.           wheel byte not set.  
  53.        -- Cleaned up I/O routines for a slight speed improvement.
  54.  LBREXT Notes - 2/6 
  55.  
  56.    d.  Vs 3.1 updates (10/14/90, Howard Goldstein):
  57.        -- If a destination directory is specified without a file name,  *.* is
  58.           assumed.  As a side effect, .ext is equivalent to *.ext.
  59.        -- If a CRC error occurs during file  extraction,  a warning message is
  60.           displayed but LBREXT no longer aborts.   This is  to accommote older
  61.           libraries that did not contain CRC's.
  62.        -- LBREXT no longer needs to be manually patched in order to change the
  63.           default configuration.  A CFG file for use with ZCNFG is provided.
  64.  
  65.    e.  Vs 3.0 updates (3/29/90, Howard Goldstein):
  66.        -- Fixed bug in the  SCAN  routine that caused the program to misbehave
  67.           occasionally in various unpredictable ways depending on the previous
  68.           contents of memory.  
  69.  
  70.    f.  Vs 2.9 updates (1/11/90, Howard Goldtsein):
  71.        -- Added CRC check during member file extraction.
  72.  
  73.    g.  Vs 2.8 updates (12/27/89, Howard Goldstein):
  74.        -- Correctly handles squeezed files  with short extensions and uses the
  75.           right default directory under BGii and Z3Plus.
  76.  LBREXT Notes - 3/6 
  77.  
  78.        -- ASCII strings before the option flags changed to upper case.
  79.        -- Typos fixed in comments.
  80.  
  81.    h.  Vs 2.7 updates (10/24/89, Howard Goldtsein):
  82.        -- Now expands LZH encoded files as well as squeezed and crunched.
  83.        -- Uses DSLIB routines (for ZSDOS, as well as DateStamper, support).
  84.        -- When extracting members with  date  stamps,  the  output file's last
  85.           access stamp is set to the current date and time.
  86.        -- 'Mod' date, rather than 'create' date, is displayed 
  87.        -- Type spec on LBR file no longer ignored.  LBR assumed if none given.
  88.        -- Check for user abort now done once every 128 chars instead of before 
  89.           each char is extracted from LBR.  BIOS calls used for this purpose.
  90.        -- Buffer allocation more dynamic  (type of  decompression required and
  91.           number of members extracted determine size of input/output buffers).
  92.        -- (OVWRT>) moved from 102h to 111h.   Another patch  point  UCPRS>) at
  93.           118h determines whether or not files are compressed by default.
  94.        -- First  two bytes of the member file (rather than middle letter)  are 
  95.           checked to determine if file is compressed.
  96.        -- Top of memory is determined from extended env if available.
  97.  LBREXT Notes - 4/6 
  98.  
  99.        -- Bugs  fixed:  endless  loop  when  a  member  could  not  be  found;  
  100.           inability to  uncrunch certain  files in  large  LBR'S;  failure  to 
  101.           recognize 'directory full' condition when opening output files.
  102.        -- Version 4 LIBs and ZSLIB now required for assembly and linking.
  103.  
  104.    i.  Vs 2.6 updates (3/24/88, Bruce Morgen):
  105.        -- DateStamper compatibilty,  including CR23D-style imbedded datespecs.
  106.           Note that this  version  employs  a  modified  version of the SYSLIB
  107.           module LUOPEN,  with the public  2-byte buffer called LUDATE holding
  108.           the DRI-format date  of the last LBR member opened.   DSLIB and Sigi
  109.           Kluger's DATE.REL (Z80ified version of the one from SIG/M v.226) are
  110.           also required.
  111.        -- A patch point is  provided  at  102H,  change this byte to FFH (from
  112.           zero) if you want  LBREXT to  overwrite  any  existing  files as its
  113.           default mode.
  114.        -- The help screen now reflects the state of this new switch as well as 
  115.           the actual name of this program.
  116.        -- Note:  zero and FFH are the ONLY legal values for the patch point.  
  117.  LBREXT Notes - 5/6 
  118.  
  119.        -- All previous  LBREXT upgrades as of version 2.5 are  supported, with
  120.           the exception of the change in  the  file-list delimiter,  which has
  121.           reverted to the ZCPR3 convention  (the comma) used in LGET and LPUT,
  122.           as well as in LBREXT before Version 2.4.
  123.  
  124.    j. Vs 2.2 updates (9/10/87, Bruce Morgen):
  125.        -- Made buffer sizing automatic at runtime
  126.        -- Fixed bug so that files will be extracted to current directory if no
  127.           output DU or DIR is specified
  128.        -- Used DSEG and new Z80-only  Z3LIB and  SYSLIB beta versions to mini-
  129.           mize COMfile size, 
  130.        -- Slimmed down buffer setup code somewhat 
  131.        -- Did some nit-picking  ("ADD A,A" instead of "SLA A",  "OR A" instead
  132.           of "CP 0", etc.)  in critical spots that might contribute to overall
  133.           performance,  although  the  optimized  (at  least  for  uncrunching
  134.           operations) buffer allocation is probably the biggest factor.
  135.        -- LBREXT is now  competitive in  speed  (within 5-10%)  with  LGET for 
  136.           normal and unsqueeze operations as well.  
  137.        -- Included a Z80fied version of Joe Wright's improved ARGV from LX 1.1
  138.           to prevent system crashes with LGET if "=" is used in command line.
  139.  LBREXT Notes - 6/6 
  140.  
  141.    h.  Vs 2.1 updates (Bob Peddicord):
  142.        -- Restored proper ZCPR3 tool format, increased buffer size.
  143.