home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / MBUG / MBUG145.ARC / CRLZH11.LBR / USAGE11.DYC / USAGE11.DYC
Text File  |  1979-12-31  |  7KB  |  130 lines
  1. -----------------------CRLZH/UNCRLZH v1.1 Usage----------------------------
  2.  
  3. Since CRLZH and UNCRLZH are spawned from Steve Greenberg's CRUNCH and 
  4. UNCRunch V2.4, usage is exactly the same with the notable exception of the 
  5. file extensions used (LZH uses a 'Y' instead of a 'Z'.  See also NOTES11.) 
  6. So...to avoid duplication, merely substitute CRLZH for CRUNCH, UNCRLZH for 
  7. UNCR and 1.1 for 2.4 in the following duplication of the CRUNCH/UNCR usage 
  8. notes: 
  9.  
  10. -------------------CRUNCH/UNCRunch v2.4 Usage follows:---------------------
  11.  
  12. This file contains the basic usage syntax for CRUNCH and UNCRunch programs,
  13. along with a brief description of what the various modes are. Many  additi-
  14. onal operational details are contained in the file NOTES24.DOC,  especially
  15. details relating to features new to v2.4 vs. v2.3.
  16. ---------------------------------------------------------------------------
  17.  
  18. CRUNCH  v2.4  Usage:
  19.  
  20.                  Filename       Date, etc.    Option letters
  21.                 /              /             /
  22. CRUNCH  {du:}<afn>  {du:}  { [id] }  { /<options> }
  23.           \           \               |
  24.            Source      Destination   (space)
  25.  
  26. where <options> = {Q}{C}{O}{A}
  27.  
  28. Items  in  curly brackets are optional (namely everything  except  for  the
  29. filename). The two optional 'du:' specs may be of the form DU:, UD:, D:  or
  30. U:  where D is any legal drive letter, and U is a user code from  '0'  thru
  31. '15'  inclusive. The colon must be typed. The first 'du:'  specifies  where
  32. the  filename  '<afn>' is located, and it should  immediately  precede  the
  33. <afn>  with no intervening blanks if it is used. If no drive is  specified,
  34. the  default (currently logged) drive is assumed. The same is true for  the
  35. user code. The filename <afn> may contain the ambiguous (wildcard)  charac-
  36. ters '?' or '*' if desired.
  37.  
  38. The second 'du:', which has the same form as the one described above, is an
  39. optional drive specifier where the output will be directed. No filename may
  40. follow the the second 'du:' - the filename will be generated  automatically
  41. (see below). As above, if either part of the 'du:' spec is not included (or
  42. if the spec is left out altogether) appropriate defaults will be used.
  43.  
  44. The  resulting  file will have the same name as the crunched  file,  except
  45. that  the middle letter of the extension will be converted to "Z".  If  the
  46. original  file's extension was blank, or already had a "Z" in  the  middle,
  47. then a filetype of "ZZZ" will be used.
  48.  
  49. [id]  is an optional "date stamp" (or other information), used to  identify
  50. the  file. If used, [id] consists of any text contained between a  pair  of
  51. square  brackets (ie the brackets must actually be typed). The  text  con-
  52. tained  in [id] will be recreated at the console for the operator's  refer-
  53. ence when the file is later uncrunched.
  54.  
  55. Four  command line options, "Q", "C", "O" and "A", are available. They  may
  56. be  used  in any combination and in any order, but must be  preceded  by  a
  57. single slash and there should be no intervening blanks between option  let-
  58. ters.  The "/" itself must be preceded by a blank. For example:
  59.  
  60.      crunch *.doc b0:  /CQ
  61.  
  62. is a valid command line.
  63. The letters have the following significance:
  64.  
  65.      Q  Quiet mode toggle
  66.      C  Confirm (tag) mode toggle
  67.      O  Overwrite without prompt mode toggle
  68.      A  Archive bit mode toggle
  69.  
  70. The "standard distribution" copy of CRUNCH is shipped with all four of  the
  71. above modes "off", and the command line option will activate the associated
  72. mode.  It should be noted that patch bytes in the COM file allow a copy  of
  73. CRUNCH  to  be  configured  to default to  a  user's  own  preference  (see
  74. PATCHES.DOC). If a mode is configured to default to the "on" state, then an
  75. occurrence  of the associated letter in the command line will flip the  op-
  76. tion back off.
  77.  
  78. For example, some users may prefer that CRUNCH generally perform overwrites
  79. without  always prompting. In a certain situation where the user wanted  to
  80. be  extra  careful, however, he could temporarily reinstate the  prompt  by
  81. specifying the /O option.
  82.  
  83.  
  84. Following is a brief statement of what each mode does when active:
  85.  
  86. QUIET  MODE: Simply suppresses the continuous console output normally  sup-
  87. plied  by  the program while it is processing a file. May be  desirable  if
  88. your console is slow, or auto-adds LF after CR, or is a printing device, or
  89. if you just plain don't like watching this kind of activity.
  90.  
  91. OVERWRITE  WITHOUT PROMPT MODE: Suppresses the question  "Destination  File
  92. exists;  Overwrite?"  from being issued everytime the program is  about  to
  93. overwrite  an old file with the same name as the new one. "Safer" to  leave
  94. this mode in the default "off" state, but really a matter of personal pref-
  95. erence.  Off state can hinder "unattended" mass operations, however,  since
  96. processing may occasionally be suspended pending an operator response.
  97.  
  98. TAG MODE: An enhanced method for selectively processing certain files  from
  99. a wildcard group. Though vastly more limited, it is obviously modeled after
  100. the SWEEP/NSWP type "tagging" concept, so many users will feel  comfortable
  101. with  it  immediately. All specified files are displayed one at a  time  in
  102. alphabetical  order. Only "tag", "untag", "next file" and "back  one  file"
  103. functions are supported. After all proper files have been tagged, the  mass
  104. operation commences without further user intervention. See NOTES24.DOC  for
  105. some some additional notes on this mode.
  106.  
  107. ARCHIVE BIT MODE: Allows CRUNCH to be used as an archival type simple back-
  108. up  program. Like other "incremental" backup programs, in this mode  CRUNCH
  109. will  only  process files which have been changed since  the  last  backup,
  110. based on the CP/M "archive" directory attribute. After each file is proces-
  111. sed,  the  bit  will  be set indicating the file  is  now  backed  up.  See
  112. NOTES24.DZC for some additional notes about this mode as well. NOTE:  While
  113. all other modes and command line options are common to UNCRunch and CRUNCH,
  114. this one is implemented in CRUNCH only.
  115. UNCR  v2.4
  116. Usage:
  117.  
  118.                 Filename   (space)
  119.                /            |
  120.  UNCR  {du:}<afn>  {du:}   { /<options> }
  121.          \           \             \
  122.           Source      Destination   Option letters
  123.  
  124. where <options> = {Q}{C}{O}
  125.  
  126. All  usage, options, and patches are identical to CRUNCH, described  above,
  127. except  that no [id] can be specified and the /A mode is  not  implemented.
  128. Also  note that the the resulting filename will be recreated from the  name
  129. of the file that was originally crunched.
  130.