home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / squsq / fcrnch11.lbr / FCRUNCH.DZC / FCRUNCH.DOC
Text File  |  1986-12-24  |  4KB  |  91 lines
  1. FCRUNCH is a functional replacement for CRUNCH23 by Steven Goldberg,
  2. and executes on Z80,8080,8085 and V20 processors.  It performs LZW
  3. encoding of files, with full DU addressing.
  4.  
  5. When executed without parameters, the following display appears:
  6.  
  7.  
  8.   A>fcrunch
  9.   FCRUNCH v1.0 by C.B. Falconer
  10.  
  11.        keep old   quiet   input file      output file
  12.               \     \              \              \
  13.   FCRUNCH {-{c}{k}{p}{q}} {d{u}:}afnin.aft {d{u}:}{afnout.aft} {[id]}
  14.             /     /         /                /                   /
  15.      confirm   purge    source     destination             idstring 
  16.  
  17.           [idstring] is anything enclosed in []
  18.           default destination is source name with modified "typ"
  19.  
  20.   ex: FCRUNCH -p b5:fcopy.* c6:',t,'(crunches to C6: and erases)'
  21.  
  22.   A>
  23.  
  24.  
  25. The 'du' addresses may have the forms 'du:', 'u:', 'd:', or be
  26. omitted to use the default drive/user.  d is a drive letter, and u
  27. is an integer from 0 to 15 (or 31 for some systems) specifying the
  28. user area.  They control the directories and drives which hold the
  29. files.
  30.  
  31. 'afnin.aft' is a REQUIRED entry (ommision produces the help message),
  32. and is a normal filename specification with wild cards.  All matching
  33. files will be processed.
  34.  
  35. 'afnout.aft' is an optional destination filename.  Any wild cards
  36. must match those in the input filename.  If included, the normal
  37. generation of an output filename (with a middle Z in the file type)
  38. is over-ridden. 
  39.  
  40. '[id]' is any sequence of characters starting with '[', and terminating
  41. on ']' (up to 40 at present).  They are recorded in the output file
  42. and are normally displayed when the output is uncrunched.  The use is
  43. up to you.
  44.  
  45. The option characters (the string preceded by "-" at the start of the
  46. command line) have the following functions:
  47.  
  48. c       Confirm before crunching.  Allows selections from a wildcard
  49.         input specification to be discarded 'on the fly'
  50.  
  51. k       Keep old files.  No output will be generated if a previous
  52.         output file with the same name exists
  53.  
  54. p       Purge (without asking).  Any previous output file with the
  55.         same name will be deleted.  (Normal operation is to ask
  56.         whether to delete)
  57.  
  58. q       Quiet operations.  Suppresses the running display and output
  59.         relative size final display.
  60.  
  61. The running display is:
  62.  
  63.    in   out ratio    ca    cr
  64.    ==   === =====    ==    ==
  65.  
  66. where 'in' and 'out' are the count of input/output 128 byte records,
  67. 'ratio' is the size of output compared to input (a percentage), 'ca' is
  68. the number of codes assigned (at 4096 the internal table is full), and
  69. 'cr' is the number of codes re-assigned.
  70.  
  71. At completion the size of input and output files in Kbytes is shown.
  72.  
  73. FCRUNCH uses large i/o buffers (up to the available memory), and thus
  74. will not access the disk too often.  The input buffer is always twice
  75. the size of the output buffer.  If a wild card specification covers
  76. many files the buffers sizes are reduced to hold the (internally
  77. generated) file lists.
  78.  
  79. Most of the file handling procedures are from BUFFLIB.REL (.SLR)  (in
  80. BUFFERS.LBR), and can be re-used for other programs.  The cruncher
  81. proper is from CRN.REL (.SLR), and is also re-usable.
  82.  
  83. '.SLR' files are in SLR systems relocatable format, and '.REL' files
  84. are in Microsoft format.  SLR files are much faster to link, specify
  85. 16 character names, contain module date/time stamps, and can handle
  86. fairly complicated relocatable expressions.  They require SLRNK or
  87. SLRNK+ for processing.  '.REL' files can be processed with L80. 
  88.  
  89.       C.B. Falconer, 680 Hartford Tpk., Hamden, Conn. 06517
  90.       (203) 281-1438.
  91. └╢