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