home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / packer / qaz / qaz.txt < prev   
Text File  |  1993-11-23  |  11KB  |  235 lines
  1. 'Qaz' v2.10  Copyright (c)1993, Robert Walking-Owl (All Rights Reserved)
  2.  
  3. What does 'Qaz' do?
  4. -------------------
  5. 'Qaz' will display the directory of most archive formats, or if not, it will
  6. at least identify the archive format.  In certain cases it will display the 
  7. resolution/colors of graphics files or output a text or ANSI file, if
  8. appropriate.
  9.  
  10. ...Why?
  11. -------
  12. If you have a collection of (backups) in a variety of archive formats,
  13. including SFX (or SEA, self-extracting archives), using 'Qaz' saves you
  14. a bit of trouble having to use the appropriate command(s) for each archive
  15. type, assuming you have the archiver handy.  (Some archivers may not even
  16. allow you to view self-extracting archives).
  17.  
  18. If you use or run a BBS (Computer Bulletin Board System), 'Qaz' is a con-
  19. venient 'universal archiver' allowing users to view (almost) any archive. 
  20. This means that users need not be victims of 'Snake-Oil' as much as they 
  21. often are: 'Qaz' can identify the file or archive type, so they know what 
  22. de-archivers or utilities they may need BEFORE downloading the file (if 
  23. they even want to).
  24.  
  25. What does 'Qaz' mean?
  26. ---------------------
  27. You HAD to ask!  Q-A-Z are the left-most letters on the keyboard
  28. (at least the standard American QWERTY type...)
  29.  
  30. How to use 'Qaz'...
  31. -------------------
  32. Usage: QAZ filename[.ext] [filespecs] [options]
  33.  
  34. The options are as follows (most similar to those used in the 'dir' command):
  35.    /b = Bare Listing - Same as the /b option in 'dir'
  36.    /w = Wide Listing - Same as the /w option in 'dir' 
  37.    /l = LowerCase    - Same as the /l option in 'dir'
  38.    /p = Page Break   - Same as the /p option in 'dir' (Note that the /p
  39.                        option works for examining one archive only, and 
  40.                        not for multiple archives.)
  41.    /v = Verbose      - Sort-of verbose.  Shows directories, if they exist. 
  42.    /o = Order (dnse) - Sort order (similar to the /o option in 'dir')
  43.                          /od  = sort by date (ascending)
  44.                          /on  = sort by name
  45.                          /oe  = sort by extension
  46.                          /os  = sort by size
  47.                          /o-d = sort by date (descending)
  48.                                 etc..
  49.    /t = View Text    - If an ASCII Text (7-bit) is detected, display the 
  50.                        'head' (first 15 lines or so) of it. (Note that
  51.                        control codes or 8-bit characters will not be
  52.                        displayed, unless ANSI sequences are detected!)
  53.  
  54. Example uses of 'Qaz':
  55. ----------------------
  56. QAZ FILENAME *.TXT *.DOC README.*
  57. QAZ WHICHONE.*
  58. QAZ PGP23SRC.ZIP *.C *.H /L /V /P
  59. QAZ *.GIF
  60. QAZ THIS*.LZH /W
  61. QAZ .SQZ 
  62. QAZ QAZ200 /OS
  63. QAZ LARGE.ARC |MORE
  64. QAZ *.*
  65.  
  66. Notes for SysOps using 'Qaz' with a BBS:
  67. ----------------------------------------
  68. If %F happens to be the "filename" macro, use (as on a Renegade BBS):
  69.  
  70. QAZ %F /T /E
  71.  
  72. (Of course, use whatver the proper macro or calling conventions are
  73. appropriate for your BBS. %F is Renegade's macro; check your BBS docs
  74. if you already don't know what to do--The %F macro is not universal!)
  75.  
  76. It's recommend that SysOps use both the /t option to give users the ability 
  77. to view UUENCODED or BinHex files.  (The /e option available in version 2.00
  78. wwas removed, since it never seemed to work properly on the BBSs that tried
  79. it.)
  80.  
  81. Using the /l option may make the text a bit more readable (though that's up
  82. to individual tastes).  
  83.  
  84. Do NOT use the /p option, unless your BBS software does not provide this
  85. function.  The /w or /b options are not recommended either, since they will
  86. only display filenames, and not file dates or sizes.  The /v option is
  87. probably not necessary.
  88.  
  89. Note that on some systems, EACH archive 'type' (usually the extension)
  90. must be configured INDIVIDUALLY to use 'Qaz' to view/list.
  91.  
  92. What files can 'Qaz' recognize?
  93. -------------------------------
  94. 'Qaz' v2.10 can list the contents of the following archive types:
  95.  
  96. Archiver:  Extension: Version(s)            No.SFX?   Comments:
  97. -----------------------------------------------------------------------
  98. AR                    0.02                      -     (LHA-Clone)
  99. ARC        .ARC/.ARK  3.x-7.x                   1
  100. ARJ        .ARJ       1.xx-2.41a               10
  101. CPSHRINK   .CPZ       1992                      -
  102. HA         .HA        0.98                      -     (Not the same as HAP!)
  103. HAP/PAH    .HAP       3.00 only?                -
  104. HPACK      .HPK       0.78                      -  
  105. HYPER      .HYP       2.6                       1
  106. LAR/LUE    .LBR       12 Jan 1984               -     (Archaic CP/M)
  107. LHA/LHARC  .LZH/.LHA  various 1.xx-2.52         9
  108. PACK       .ZPK       1.0?  2.20                2     "ZiLite" (aka "ZPack")
  109. PAK        .PAK                                 0
  110. PKARC      .ARC       3.2?  3.5                 1
  111. PKPAK      .ARC       3.61                      1
  112. PKZIP      .ZIP       1.10, 2.04                4
  113. PUT        .PUT       2.00                      1     (LHA-Clone)
  114. SQZ        .SQZ       1.08.2E, 1.08.3E          4     "Squeeze-It!"
  115. ZOO        .ZOO       2.10                      0
  116.            
  117. Note that if 'Qaz' does not display a date for some archives, it is because
  118. the date is 'undefined' (as is the case with AR v0.02).
  119.  
  120. 'Qaz' can recognize the following file formats (but not list the 'contents'
  121. as these files are either encrypted or single-compressed files):
  122.  
  123. Utility:   Extension: Version(s)            No.SFX?   Comments:
  124. -----------------------------------------------------------------------
  125. COMPRESS   .Z                                   -     Unix Compress
  126. DIET                  1d                        0     Diet (non-EXE)
  127. FREEZE     .XF/.F     2.3.0?                    -     Unix Freeze
  128. GZIP       .Z/.ZIP                              -     GNU Zip
  129. PGP        .PGP       1.x?  2.x                 -     Pretty Good Privacy
  130. SQ         .?Q?                                 -     CP/M Squeeze
  131.  
  132. 'Qaz' can recognize the following graphics file formats, and give a brief
  133. description of the image size and colors:
  134.  
  135. Utility:   Extension: Version(s)            No.SFX?   Comments:
  136. -----------------------------------------------------------------------
  137.  -         .GIF       87a/89a                   4     Graphics
  138.  -         .BMP       ?                         -     Graphics
  139.  -         .PCX       2-5                       -     Graphics
  140.  
  141. 'Qaz' can also recognize a possible 7-bit ASCII text file, and given the
  142. permission (through the /t option) will display the 'head' (first several
  143. lines) of the file.  
  144.  
  145. Control codes or ANSI escape sequences will not be displayed, however. 
  146.  
  147. This feature was added after testing 'Qaz' on a BBS that included a CD-ROM
  148. of Macintosh files.  Apparently the .SIT files were encoded with BinHex 4.0
  149. (a utility similar to UUENCODE or XX3401 for the Mac).
  150.  
  151. What archives 'Qaz' cannot recognize:
  152. -------------------------------------
  153. The following archivers/utilities are not (yet) supported by 'Qaz', aside 
  154. from what is noted in the above listing, or any archivers/utilities I have
  155. not yet come accross (due to certain technical limitations)...
  156.  
  157. * Self-displaying GIFs made by Graphics Work Shop or TitleMaker
  158. * Self-Extracting archives made using Compack (directories are compressed)
  159.  
  160. NOTE: Amiga .LHA files are sometimes not processed properly by 'Qaz'
  161.       (However LHA or LHARC also find problems with them as well)
  162.  
  163.       For .ZIP files, 'Qaz' scans the 'local' directory rather than the
  164.       central directory--which means that damaged archives can still be
  165.       viewed, even if partially.  'Qaz' should return an error if the
  166.       local directory structure is damaged (which is usually the case
  167.       in damaged .ZIP files.
  168.  
  169. Note that if 'Qaz' returns garbage it is because (1) the file is damaged
  170. (2) the archive format is not compatible--either for a different machine,
  171. as in the case of Amiga LHA files, or there is a new version/format or
  172. (3) 'Qaz' thinks the file is something that it isn't: this is bound to
  173. happen sooner or later.
  174.  
  175.  
  176. What's New?
  177. -----------
  178. v2.10 - Option to sort the directory in descending order.
  179.  
  180.         The /e (Enable ANSI) option was removed.
  181.         
  182.         A nasty bug where some SFXZIP archives were identified as SFXARCs
  183.         was fixed.
  184.         
  185.         A minor bug fix, where 'Qaz' would recognize certain AR (LZH)
  186.         archives as ARC.
  187.  
  188. v2.00 - The options, of course.  They didn't exist in the prior Beta 
  189.         versions.
  190.  
  191.         A few bug fixes: 'Qaz' v2.00 won't gag on commented SQZ files, Amiga 
  192.         LHA files, certain types of ARJ, HA files.  A few other things. It 
  193.         also won't gag on an archive that has a whole lot of files in it.
  194.  
  195.        'Qaz' can handle a few more types of SFX files, graphics files and 
  196.        ASCII or ANSI files.
  197.  
  198. v1.10B - Initial Beta versions of 'Qaz'...
  199. v1.00B
  200.  
  201. In the future...
  202. ----------------
  203. Aside from newer versions of existing archives (including SFX), 'Qaz' may
  204. also add support for .TAR, .LIF, .IDX, .DWC, .LZS, .LHA (enhanced for the
  205. Amiga?), .SIT, .PIT (for the Mac, Atari) and others, as they come along.
  206.  
  207. Other file types (incl. graphics) may also be added.
  208.  
  209. Needless to say, a forthcomming source-code of general purpose routines to
  210. process archives is in the works.
  211.  
  212. Disclaimer, License, et cetera...
  213. ---------------------------------
  214. No warrantees or guarantees, expressed or implied, go with the use of
  215. this software ('Qaz').  The author will not be held responsible in any
  216. way, shape or form for damages (or improvements) to data, on-line time,
  217. friends, finances, pets, ideas, ideologies, etc. due to the use or mis-
  218. use of the software.
  219.  
  220. The above includes no guarantee to accurately identify any or all types
  221. or archives, or newer versions of various archives, or other types of
  222. files, et cetera.  (Nor will the author be responsible for errors or
  223. glitches due to attempted processing such archives, for that metter.)
  224.  
  225. You have the 'license' to freely use and distribute 'Qaz' so long as the
  226. executable (qaz.exe) and this text file (qaz.txt) are unmodified in any 
  227. way, [with the exception of the use of 'Qaz' by or for any commercial or
  228. governmental institution--if that is the case, please contact me...]
  229.  
  230. If you have any comments, questions, criticisms, or (preferably) 
  231. suggestions the author can be reached electronically care of: 
  232.          
  233.          < robert.rothenburg@asb.com >
  234.  
  235.