home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / compress / arq002.zip / ARQ.TXT < prev    next >
Text File  |  1993-07-25  |  5KB  |  137 lines
  1.                                  ARQ
  2.  
  3.                          v0.02 - 14 July 1993
  4.  
  5.             4DOS command-line shell for multiple archivers
  6.  
  7.              By Roger Burton-West <ubte30e@ccs.bbk.ac.uk>
  8.  
  9.  
  10.         Copying
  11.  
  12.  
  13.         ARQ is distributed under the  terms  of the GNU General Public
  14. Licence, a copy of which is included.   In brief, this states that ARQ
  15. is freely distributable, subject  only  to  the  condition that if you
  16. make a modified version and choose to  distribute it, you must make it
  17. freely distributable as well.  See the file COPYING for details.
  18.  
  19.         ARQ is copyright 1993 by Roger Burton-West.
  20.  
  21.  
  22.         Why ARQ?
  23.  
  24.  
  25.         ARQ is designed for  those  people  who,  like me, use several
  26. different archivers on a regular  basis.   ARQ  allows  you to use the
  27. same syntax to issue commands to  any archiver you have available.  It
  28. also  provides   a   convenient   short-cut   for   archivers  without
  29. configuration files.
  30.         I've  used  programs  like  GUS   and  PKBTM,  but  they  were
  31. orientated towards file extraction; I wanted to retain the majority of
  32. the archiver command  set,  especially  the  hard-to-remember commands
  33. such as comment addition.
  34.  
  35.  
  36.         Use
  37.  
  38.  
  39.         The ARQ syntax is simple:
  40.  
  41. ARQ command archive (files)
  42.  
  43. The archive parameter  should  include  the  extension; otherwise this
  44. will be assumed to be  ARJ.   If  the  files  parameter is omitted, it
  45. defaults to *.*.
  46.  
  47. Command should be one of:
  48.  
  49. a       Add files to archive
  50. m       Move files to archive
  51. x       Extract files from archive
  52. d       Delete files from archive
  53. l       Short list of archive contents
  54. v       Long list of archive contents
  55. t       Test archive integrity
  56. c       Add comment file to archive
  57. s       Create self-extractor (large model)
  58. s1      Create self-extractor (small model)
  59.  
  60.         ARQ issues the appropriate command  to  the archiver, based on
  61. the file extension.   Note  that  self-extracting  archives  cannot be
  62. handled under ARQ, as there is no way of telling which archiver should
  63. be used.
  64.  
  65. a       Add files to archive
  66. m       Move files to archive
  67.  
  68.         Adds the named files to the archive; m will delete files after
  69. they have been added.  If  the archiver supports subdirectories, these
  70. will also be searched.
  71.  
  72. x       Extract files from archive
  73.  
  74.         Extracts the named files from the archive.
  75.  
  76. d       Delete files from archive
  77.  
  78.         Deletes the named files from  the  archive.  Not available for
  79. all archivers.
  80.  
  81. l       Short list of archive contents
  82.  
  83.         Lists the contents of the archive in a brief mode.
  84.  
  85. v       Long list of archive contents
  86.  
  87.         Lists the contents of  the  archive  in  a longer mode.  (Some
  88. archivers only  have  one  list  mode,  in  which  case  this  command
  89. duplicates the effects of "l".)
  90.  
  91. t       Test archive integrity
  92.  
  93.         Tests the files in the  archive for corruption.  Not available
  94. for all archivers.
  95.  
  96. c       Add comment file to archive
  97.  
  98.         Adds the named file as an ANSI comment.  Not available for all
  99. archivers; archivers which require the comment  to be typed in are not
  100. supported.
  101.  
  102. s       Create self-extractor (large model)
  103.  
  104.         Converts the archive into  a  self-extracting  .EXE file.  Not
  105. available for all archivers.   Hyper  is  a  special case; the program
  106. hyper.exe must be available in the current working directory.
  107.  
  108. s1      Create self-extractor (small model)
  109.  
  110.         Converts the archive into  a  self-extracting .EXE file, using
  111. the small  model  code.   Not  available  for  all  archivers.   (Some
  112. archivers only have  one  self-extractor  model,  in  which  case this
  113. command duplicates the effects of "s".)
  114.  
  115.  
  116.         Limitations
  117.  
  118.  
  119.         ARQ currently supports  the  following  archivers: Arj, PKZip,
  120. Arc, LHA, PAK, Zoo, Hyper, DWC, Larc,  HPack, HA, AR, MD, Sqz and Hap;
  121. it also supports Vernon Buerg's utilities for LBR library files.
  122.  
  123.         ARQ expects 4DOS' command-separation character to be ^.
  124.  
  125.         ARQ cannot handle self-extracting archives, because it detects
  126. the archive type by the file extension.
  127.  
  128.         ARQ does not support file compressors such as GZip or COMP430.
  129.  
  130.         Future versions may include  a simulated file-deletion command
  131. and expanded control over the archiver.
  132.  
  133.         If you have an archiver which  is not supported by ARQ, please
  134. let me know where to find it -  I'm always interested in adding to the
  135. collection.
  136.  
  137.