home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug078.arc / USAGE23.DOC < prev    next >
Text File  |  1979-12-31  |  4KB  |  77 lines
  1.      Prgm:   CRUNCH v2.3
  2.                               filename       date, etc.     Verbose
  3.                              /              /              /
  4.      Usage:  CRUNCH  {du:}<afn>  {du:}  { [id] }  { /Q | /V | /C}
  5.                        \           \                  \         \
  6.                         source      destination        Quiet     Confirm
  7.  
  8.      Items  in curly brackets are optional (namely  everything  except
  9.      for  the  filename). The two optional 'du:' specs may be  of  the
  10.      form DU:, UD:, D: or U: where D is any legal drive letter, and  U
  11.      is  a user code from '0' thru '15' inclusive. The colon  must  be
  12.      typed.   The first 'du:' specifies where the filename '<afn>'  is
  13.      located,  and  it should immediately precede the  <afn>  with  no
  14.      intervening blanks if it is used.  If no drive is specified,  the
  15.      default (currently logged) drive is assumed. The same is true for
  16.      the  user  code.  The filename <afn> may  contain  the  ambiguous
  17.      (wildcard) characters '?' or '*' if desired.
  18.  
  19.      The  second 'du:', which has the same form as the  one  described
  20.      above,  is an optional drive specifier where the output  will  be
  21.      directed.   No  filename may follow the the second  'du:'  -  the
  22.      filename will be generated automatically (see below).  As  above,
  23.      if either part of the 'du:' spec is not included (or if the  spec
  24.      is left out altogether) appropriate defaults will be used.
  25.  
  26.      The resulting file will have the same name as the crunched  file,
  27.      except that the middle letter of the extension will be  converted
  28.      to  "Z".  If the original file's extension was blank, or  already
  29.      had a "Z" in the middle, then a filetype of "ZZZ" will be used.
  30.  
  31.      [id] is an optional "date stamp" (or other information), used  to
  32.      identify the file.  If used, [id] consists of any text  contained
  33.      between a pair of square brackets (ie the brackets must  actually
  34.      be typed).  The text contained in [id] will be  recreated at  the
  35.      console  for the operator's reference when  the  file   is  later
  36.      uncrunched.
  37.  
  38.      Three  command line options, "/Q", "/V" or "/C",  are  available.
  39.      If  used, the option should be last on the command line, and  the
  40.      "/"  must be preceded by a space.  Although the  technical  usage
  41.      above  implies only one letter may be used, rev 2.3  will  accept
  42.      any two options.  Other combinations,  which  would  include both
  43.      Q and V, are contradictory.
  44.  
  45.      "/Q"  and  "/V" will "quiet down" a version of CRUNCH  which  has
  46.      been  configured to be "verbose", or cause a "verbose" run  of  a
  47.      program  normally configured to be "quiet".  This relates to  the
  48.      amount of information sent to  the console while the function  is
  49.      in progress.
  50.  
  51.      "/C", the confirm option, is used for selective crunching.  Norm-
  52.      ally  used  in conjunction with wildcard filespecs,  this  option
  53.      causes the program to ask "Y/N" for each matching file. Only  the
  54.      files to which "Y" is responded will be crunched.  Selecting this
  55.      option  causes  the program to automatically ask  for  additional
  56.      confirmation  if a pre-existing file is about to be  overwritten,
  57.      regardless of the program's configuration.
  58.      Prgm:   UNCR  v2.3
  59.  
  60.                             filename       Quiet     Confirm
  61.                            /              /         /
  62.      Usage:  UNCR  {du:}<afn>  {du:}  { /Q | /V | /C}
  63.                      \           \             \
  64.                       source      destination   Verbose
  65.  
  66.      All  usage,  options, and patches are identical  to  CRUNCH,  de-
  67.      scribed  above, except that no  [id] can be specified. Also  note
  68.      that  the that the resulting filename will be recreated from  the
  69.      name of the file that was originally crunched.
  70.  
  71.      It  is not necessary that the file to be uncrunched have  "Z"  as
  72.      the  middle letter of the extension; an attempt will be  made  to
  73.      uncrunch  any filename explicitly specified.  Note  however  that
  74.      "UNCR *.*" will be internally converted to "UNCR *.?Z?" to facil-
  75.      itate quickly uncrunching all crunched files in a mixed group.
  76.  
  77.