home *** CD-ROM | disk | FTP | other *** search
/ Shareware Supreme Volume 6 #1 / swsii.zip / swsii / 172 / CRUNCH24.ZIP / CRUNCH24.ARK / NOTES24.DOC < prev    next >
Text File  |  1990-05-26  |  9KB  |  145 lines
  1. CRUNCH  v2.4 processes and generates files identical to v2.3. A  series  of
  2. enhancements  have been made, and are summarized below (additional  details
  3. can be found at the end of this document).
  4.  
  5. o  "TAG"  MODE: This new option lets you select any number of files from  a
  6.    group for processing. After all the selections have been made, the files
  7.    will be processed. Selections are presented and processed in  alphabeti-
  8.    cal order. Applies to both CRUNCH and UNCR. (Even when this mode is  not
  9.    active, all wildcard operations are sorted to proceed alphabetically).
  10.  
  11. o  STRAIGHT  COPYING: If CRUNCH ever creates a file larger than  the  orig-
  12.    inal,  the file will automatically be erased and replaced with a  direct
  13.    copy  of the original. If the original is already crunched or  squeezed,
  14.    or if the filetype matches a type on a [user configurable] filetype list
  15.    (eg  .LBR  or  .ARC), no attempt will even be made  to  compress  it;  a
  16.    straight  copy operation will be substituted. Thus ALL  specified  files
  17.    will transferred (in the most efficient manner), facilitating the use of
  18.    CRUNCH for the creation of LBR's or as a backup utility. Similarly, UNCR
  19.    will either uncrunch or direct copy all specified files for full restor-
  20.    ation.
  21.  
  22. o  "SPANNING"  DISKETTES: If CRUNCH ever fills an output diskette during  a
  23.    wildcard operation, the last [partial] file will be deleted and the user
  24.    will  be  prompted to change diskettes. Operation  will  then  continue,
  25.    starting  with that last file. This will work from the output of  either
  26.    CRUNCH or UNCRunch.
  27.  
  28. o  OPTION  "TOGGLES":  UNCRunch and CRUNCH take as many as three  and  four
  29.    (respectively)  command  line options in any  combination.  Each  option
  30.    corresponds  to  a mode which can be set to default to  a  user  defined
  31.    state; then the command line toggle will flip the state back on or  off.
  32.    The  option  toggles  include "quiet" / "verbose",  "tag  mode"  on/off,
  33.    "prompt before overwrite" on/off, and "archive bit" mode on/off.
  34.  
  35. o  OTHER  NEW MODES:   The "archive bit" mode toggle, when turned on,  will
  36.    only  crunch  files  that have changed since they were  last  backed  up
  37.    (based  on the CP/M directory archive bit). When running in  this  mode,
  38.    each input file will be flagged as archived as soon as the crunch  oper-
  39.    ation  for that file has completed. The "prompt before  overwrite"  mode
  40.    toggle allows command line control of whether the program stops to  warn
  41.    you each time it is about to overwrite a file with the same name.
  42.  
  43. o  UNSQUEEZING: UNCRunch now also unsqueezes as an added convenience! Usage
  44.    is  identical; UNCRunch will automatically recognize the  file's  format
  45.    and use the appropriate algorithm.
  46.  
  47. o  FASTER  OPERATION; MORE BUFFERING: Modest speed improvements  have  been
  48.    made  through a variety of techniques, including more data buffering  to
  49.    reduce disk activity. The extended buffers are dynamically allocated  to
  50.    take maximum advantage of currently available memory on your system.
  51.  
  52. o  INFORMATIVE:  Messages inform you when the programs are  crunching,  un-
  53.    crunching,  unsqueezing,  or copying and why (eg "Already  crunched"  or
  54.    "Zero length"). Includes the old in, out, & compression ratio reports as
  55.    well as a final figure on the total number of files processed.
  56.  
  57.                      DETAILED NOTES ABOUT NEW FEATURES
  58.  
  59. Some  of the new features mentioned above require, by logical necessity  or
  60. convenience,  that the programs respond differently to different  types  of
  61. command  line specifications; ie respond differently depending  on  whether
  62. the source and destination user areas and/or drives are different or wheth-
  63. er the program is invoked with a wildcard file specification. Following  is
  64. an itemization of these details:
  65.  
  66. 1. DIRECT COPY OVERRIDE [CRUNCH only]: If the source and destination drives
  67. AND  user areas are the same, then direct copying is inhibited  (ie  CRUNCH
  68. will  not  bother attempting to copy a file onto itself); in this  case  it
  69. will resort to the older method of asking the user whether he wants to keep
  70. the larger "crunched" file.
  71.  
  72. 2.  "SPANNING"  DISKETTE OVERRIDE [CRUNCH or UNCRunch]: If the  source  and
  73. destination  DRIVES are the same, then the prompt to change diskettes  when
  74. the  diskette fills up is inhibited, since by changing the output  diskette
  75. you  will  also be removing the input diskette from which  the  program  is
  76. reading.
  77.  
  78. 3.  EXCLUSION LIST OVERRIDE [CRUNCH only]: While it is generally useful  to
  79. have  CRUNCH  skip attempts to compress certain filetypes when  doing  bulk
  80. transfers,  there may be instances where, for example, you WANT to  create,
  81. say a ".LZR" (crunched library) file. Therefore  for CRUNCH will ignore the
  82. filetype  exclusion  list if a filename is fully specified.  The  exclusion
  83. list WILL be used whenever one or more wildcard characters ("?" or "*") are
  84. used in the command line.
  85.  
  86. 4.  DETAIL INVOLVING FORCED "?Z?" EXTENSION [UNCR only]: UNCRunch  used  to
  87. convert  the wildcard spec "*.*" to "*.?Z?" as a convenience feature.  This
  88. conflicts  with the symmetrical operation of the new programs, ie that  you
  89. can  transfer  all files from a disk or user area with,  for  example,  the
  90. command "CRUNCH  A:*.*  B:" & then restore them all with "UNCR  B:*.*  A:".
  91. Thus  the forced "Z" feature has been removed, and if such is  your  intent
  92. you will have to type "UNCR  B:*.?Z?  A:".  But in an effort retain maximum
  93. convenience  and compatibility with v2.3 where possible, the plain  command
  94. line "UNCR *.*", ie when uncrunching to the same drive and user area,  WILL
  95. automatically  be  converted to "UNCR *.?Z?" since direct  copying  is  not
  96. desired  or  possible in this case anyway. Also note an effect of  this  is
  97. that  a separate "UNCR *.?Q?" command would be required if  squeezed  files
  98. were  mixed  in the group, but if going to a different  drive/user  area  a
  99. single "*.*" specification would do everything.
  100.  
  101.                                MORE DETAILS
  102.  
  103. 1. MIXING /A and /C OPTIONS [CRUNCH only]: The /A, archive bit mode option,
  104. works  internally by "tagging" all files which do not have the archive  at-
  105. tribute  bit set, and thus crunching only those files. This is useful,  be-
  106. cause  if both options are specified, you will be presented with a list  of
  107. ALL  filenames, just as if you had specified the /C option alone,  but  you
  108. will  notice that all non-archived files have been pre-tagged for you.  You
  109. are then free to either tag additional files or untag "pre-tagged" files as
  110. you  wish.  You may wish, for example, to untag various .BAK  files  which,
  111. though not archived, you consider superfluous to backup.
  112.  
  113. 2. UNDOCUMENTED /T OPTION [CRUNCH and UNCRunch]: Though markedly  improved,
  114. the  new  tag  mode achieves the same desired effect as  the  old  v2.3  /C
  115. (Confirm) option, namely selective processing of files from a group. It  is
  116. therefore  still the "/C" option. But I personally always think of  it  and
  117. refer to it as "tag" mode, so I have allowed the programs to accept /T as a
  118. synonym for /C.  (Not really "undocumented", of course...)
  119.  
  120. 3. 255  MAXIMUM FILES [CRUNCH and UNCRunch]: Current  program  constraints
  121. limit  wildcard  operations to a maximum of 255 files. If a  wildcard  spec
  122. matches  more  than that many files, an appropriate error message  will  be
  123. given. In this case you will have to split your job into several operations
  124. by using using more selective wildcard specs.
  125.  
  126. 4.  CRUNCHED FILE OUTPUT [CRUNCH only]: v2.4 produces identical output  re-
  127. gardless  of  mode of operation (a few very observant people  noticed  that
  128. v2.3  could  output  valid, but different, files when  running  in  "quiet"
  129. mode).  The output of v2.4 should be identical to v2.3 running  in  verbose
  130. mode, except for the embedded revision level byte.
  131.  
  132. 5. "FILES PROCESSED" COUNT [CRUNCH and UNCRunch]: The v2.4 programs  output
  133. "<nn>  File(s)  Processed" each time they are run. The count  is  basically
  134. equal  to  the final number of output files  created.  A  crunch/erase/copy
  135. sequence  counts as one; A "no" answer to a "Overwrite existing  file?"  or
  136. "Save file anyway?" question counts as zero.
  137.  
  138. 6. ^C ABORTS, ^S PAUSES, ^W RESUMES [CRUNCH and UNCRunch]: Hitting ^C  will
  139. entirely  abort either program immediately. It may be issued any  time  the
  140. programs are waiting for input, or during actual operation. Use of ^C  dur-
  141. ing  operation will generally result in zero length output file.   Although
  142. probably  of  limited usefulness, it is noteworthy that ^S will  pause  the
  143. programs  (in verbose mode) since it will be intercepted by the system  and
  144. prevent the running console output from continuing. ^W will then resume.
  145.