home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / UTIL_ARC / QAZ_230.ZIP / QAZ.DOC < prev    next >
Text File  |  1994-01-30  |  80KB  |  1,924 lines
  1.  
  2.  
  3.  
  4.                   QAZ v2.30
  5.  
  6.                       by
  7.              Robert Rothenburg Walking-Owl
  8.                 Copyright (c)1993,1994
  9.                  All Rights Reserved
  10.  
  11.  
  12.                   No-Frills
  13.  
  14.                User's Guide and Manual
  15.  
  16.  
  17.  
  18.              "No archiver too obscure...(almost)"
  19.  
  20.  
  21.  
  22.       Note: Please read the documentation.  I've put as much effort into
  23.         writing this manual as I have in the actual program.
  24.  
  25.  
  26. [0.0] Table of Contents
  27.       ====================================================================
  28.  
  29.     [1.0] The Distribution Package (Files)
  30.       
  31.     [2.0] License and Registration
  32.     [2.1] Distribution of QAZ
  33.     [2.2] Disclaimer
  34.         [2.3] With regards to other software
  35.  
  36.     [3.0] Introduction to QAZ
  37.     [3.1] Why use QAZ?
  38.     [3.2] What QAZ is, and what QAZ is not
  39.     [3.3] What does "QAZ" mean?
  40.     [3.4] What's new about this version? (Brief)
  41.  
  42.     [4.0] System Requirements
  43.         [4.1] Installation
  44.  
  45.     [5.0] Simple Usage
  46.     [5.1] Using Options and Switches
  47.     
  48.     [5.B] Brief Listing
  49.     [5.W] Wide Listing
  50.     [5.V] View Settings
  51.     [5.O] Listing Order (Sorting)
  52.     [5.F] Formatting the listing
  53.     [5.D] Filter by Date
  54.     [5.S] Filter by Size
  55.     [5.Z] Time Zone adjustments
  56.     [5.T] Viewing the archive's tree structure
  57.     [5.R] Return Codes
  58.     [5.L] Lowercase filenames
  59.     [5.U] Recursive searching
  60.     [5.2] More about using QAZ's search function
  61.  
  62.     [5.3] Options removed or changed from previous versions of QAZ
  63.     [5.4] Setting Default Options with QAZCMD
  64.     [5.5] Using extended wildcards and search-specs
  65.     [5.6] Using QAZ from a BBS
  66.     [5.7] Messages
  67.         [5.8] Questions/Problems
  68.  
  69.     [6.0] Technical Information
  70.     [6.1] What files can QAZ recognize?
  71.     [6.2] What's new about this version of QAZ? (Detailed)
  72.     [6.3] Problematic files and known "bugs"
  73.     [6.4] Formats _not_ (yet) supported by QAZ
  74.     [6.5] Exit codes returned using the /r option
  75.     [6.6] Future additions to QAZ
  76.  
  77.     [7.0] Contacting the author
  78.     [7.1] Thanks and acknowledgements
  79.     [7.2] About the various archiver formats...
  80.  
  81.       To jump to a topic, use your reader's search function to go to
  82.       the item number (i.e. [3.0] for the Introduction).
  83.  
  84.  
  85. [1.0] The Distribution Package (Files)
  86.       ====================================================================
  87.  
  88.       The following files should be included in the distribution archive
  89.       for this version of QAZ.  If any of these files are missing, please
  90.       contact your vendor and/or the SysOp/SysAdmin of the on-line system
  91.       from where you received QAZ.
  92.  
  93.       FILE_ID.DIZ               BBS Identification File
  94.  
  95.           README.1ST                Read this First!
  96.  
  97.           QAZ.EXE                   The QAZ DOS-Executable File
  98.           QAZ.HLP                   The QAZ "Quick-Reference" Help File
  99.           QAZ.DOC                   The QAZ Documentation (This File).
  100.  
  101.           QAZ-DEMO.EXE              Demo Batch-files for use with QAZ.
  102.  
  103.       You may also contact the author at the address(es) given later in
  104.       this document if you have any questions.
  105.  
  106.  
  107. [2.0] Legal Information (License, Distribution, Disclaimer, etc.)
  108.       ====================================================================
  109.  
  110.       You are granted the right to freely use, and/or distribute QAZ
  111.       for personal or institutional purposes.  You may also use or
  112.       install QAZ as part of an online file-viewing facility, so long
  113.       as the copyright notice is not removed or changed.
  114.  
  115.       QAZ is free.  You can use QAZ from until until the hypothetical
  116.       heat death of the universe at no charge.
  117.  
  118.       However, I've put many hours into developing this program, so if
  119.       you'd like to support starving programmers, a registration fee of
  120.       $15US will benefit your karma and perhaps get you the latest
  121.       version.
  122.  
  123.       At the very least, a postcard saying that you use QAZ would be
  124.       nice.
  125.  
  126. [2.1] Distribution of QAZ
  127.       ====================================================================
  128.  
  129.       You may freely distribute copies of QAZ to friends or upload to
  130.       public distribution sites (such as BBSs or ftp-sites) so long as
  131.       the associated files (executables and documentation) are not mod-
  132.       ified in any way, and so long as there are no charges for copies 
  133.       of QAZ (not more than $5.00US per disk plus S&H), aside from usual 
  134.       on-line membership fees, etc.
  135.  
  136.       QAZ may be distributed as part of another software package so
  137.       long as the original distribution files are included entirely as
  138.       an enclosed archive, unchanged, _and_ that the software package
  139.       has the same licensing and distribution policy as QAZ (that is,
  140.       it's 'free'), where no charge for use of the software is stated
  141.       or implied.  (If you distribute QAZ as part of another package,
  142.       you are also responsible for any licensing requirements of the
  143.       archive you distribute it in).
  144.  
  145.       Of course I would appreciate hearing about any utilities that
  146.       make use of QAZ.
  147.  
  148.       Essentially, QAZ is 'freeware'.
  149.  
  150.       Note: If you'd like to distribute QAZ as part of a shareware or
  151.         commercial package, or if you are interested in obtaining 
  152.         source-code(s), please contact me at the address listed
  153.             elsewhere in this document.
  154.             
  155. [2.2] Disclaimer
  156.       ====================================================================
  157.  
  158.       Being free, the author makes no guarantees or warrantees whatso-
  159.       ever on the use, abuse or misuse of QAZ.  Likewise, the author
  160.       shall not (and will not) be held responsible for misidentification
  161.       of archives, strange files, flying saucers, damage of data, disk
  162.       space, system crashes, reputations, ideologies, money, pets, time, 
  163.       et cetera, due to the use or misuse of QAZ and associated files or
  164.       utilities.
  165.     
  166.       QAZ is continuously debugged and tested, however that does not mean
  167.       it is bug free.  In many cases QAZ is the product of many hours of
  168.       hacking, so it's possible undocumented or unanticipated file-types
  169.       may not be handled properly.
  170.  
  171.       Simply put, use QAZ at your own risk.
  172.  
  173.       The information in this document is subject to change without notice.
  174.     
  175. [2.3] With regards to other software
  176.       ====================================================================
  177.  
  178.       You, the user, shall take full responsibility to ensure that you
  179.       have the legal rights to use the associated archive utilities
  180.       (ie. that you are a legitimate, registered owner of any shareware
  181.       or commercial software).
  182.  
  183.       The author of QAZ shall not be responsible for the use of other
  184.       software in violation of any licensing agreements.
  185.  
  186. [3.0] An Introduction to QAZ
  187.       ====================================================================
  188.  
  189.       QAZ is an almost-universal archive viewer.  It was written to pro-
  190.       vide a simple, uniform way of viewing the directories of various
  191.       archive formats without having to have a copy of the appropriate
  192.       software handy.
  193.  
  194.       Originally, QAZ was intended to be a 'test' utility for a diskette
  195.       catalog/librarian system (which is in the works for the future).
  196.       In the meantime QAZ has become a useful file-lister from within
  197.       DOS as well as a BBS-friendly utility so users may (pre)view the
  198.       contents of archives (as well as identify the format) before
  199.       downloading.
  200.  
  201. [3.1] Why Use QAZ?    
  202.       ====================================================================
  203.  
  204.       With QAZ, you need not fumble remembering various archiver-specific
  205.       viewing commands, or even have a copy of the archiver on hand.  You
  206.       can view many self-extracting ("SFX") archives, as well as some pro-
  207.       prietary formats.
  208.  
  209.       The listing can be used for managing floppy disk catalogs or as a BBS
  210.       file-"exam" function, so users have an extra ounce of choice _before_
  211.       transferringing files which may turn out to be dubplicates, unusual
  212.       archive formats (sometimes mislabelled) or downright unsuable files.
  213.  
  214.       The output of QAZ is customizable to a variety of tastes.  By default
  215.       QAZ adjusts itself to the system's native country-code and time-zone
  216.       configuration.
  217.  
  218.       QAZ also exists to encourage a 'free market' of archivers.  There is
  219.       no reason for the BBS-world to be dominated by a few archive formats,
  220.       often leaving other, perhaps 'better', archivers out of the picture.
  221.  
  222.       Hence the purpose of QAZ is to view not just the most common formats, 
  223.       but the obscure, lesser-known archivers that hold a place in some poor 
  224.       fool's (or guru's) heart.
  225.             
  226.       And who knows?  The archiver standards change faster than upgrades to 
  227.       DOS 6, and today's popular formats become tomorrow's dinosaurs.
  228.  
  229.       Of course, if you made the effort to get a copy of this program then 
  230.       you probably know that already.
  231.  
  232. [3.2] What QAZ is, and what QAZ is not...
  233.       ====================================================================
  234.  
  235.       QAZ mainly identifies a variety of archive, compressed, disk image, 
  236.       and graphics file formats.  If possible, QAZ will list a directory 
  237.       or give information about the file (depending on user-set options).
  238.  
  239.       QAZ does _not_ extract or test the contents of archive or graphics
  240.       files: adding these features would increase the size of QAZ tenfold
  241.       and make the software require a high-end computer and operating
  242.       system, not to mention require licensing fees etc.
  243.  
  244.       I have received a few requests to add these abilities to QAZ. Likely
  245.       a future, spin-off utility to do these things may show up as an al-
  246.       together seperate program.
  247.  
  248.       However, QAZ can be used to identify an archive and return an exit-
  249.       code which other programs can use (such as archive shells, batch
  250.       utilities, off-line readers or BBS software); or you can use QAZ to
  251.       search a disk for archives which contain specified files.
  252.  
  253. [3.3] What does "QAZ" mean?
  254.       ====================================================================
  255.  
  256.       "QAZ" has no special meaning.  For lack of a better (and original)
  257.       name, Q-A-Z are the left-most three keys on a standard American
  258.       QWERTY-style keyboard.
  259.  
  260.       No, there isn't a special Dvorak version of QAZ.
  261.  
  262. [3.4] What's new about this version?
  263.       ====================================================================
  264.  
  265.       A lot and very little is new about this version, depending on the
  266.       version of QAZ you previously owned.
  267.  
  268.       Since the last official release (QAZ v2.21a) a few new features were
  269.       added, including the ability to read some Macintosh archiver formats,
  270.       optional ANSI color listings, many speed optimizations and some
  271.       revisions have been made to the documentation.
  272.  
  273.       Since the earlier and more widely released QAZ v2.10c, the size of
  274.       the program has doubled: comparatively this could be version 3.00!
  275.       Many more archiver formats and options were added or changed.  The
  276.       ability to define default options was also added to so users can
  277.       customize QAZ to their liking.
  278.  
  279.       For more specific information, check out the Usage and Technical
  280.       sections of this manual.
  281.  
  282.       SysOps: If you used QAZ v2.10c on a BBS, you should read the manual
  283.               to be aware of some changes in the options.
  284.  
  285. [4.0] System Requirements   
  286.       ====================================================================
  287.  
  288.       An IBM-PC or an up-to-par clone.  DOS v3.3 or newer (most of the new 
  289.       archivers will work better), and at least 128k of RAM (an arbitrary
  290.       amount), although the more memory the better.
  291.  
  292.       QAZ uses only as much RAM as it needs, or as much as there is:
  293.       if QAZ works on a particularly large archive where there is not
  294.       enough memory, it'll let you know, and still give a partial list-
  295.       ing, if possible.
  296.  
  297.       The amount of memory QAZ needs depends on what types of files QAZ
  298.       is working on and what you ask QAZ to do.  Some archives types
  299.       require more memory for processing than others.  Very large arch-
  300.       ives in some cases require more memory to process.  Recursive
  301.       scans and tree-viewing also require more memory.
  302.  
  303. [4.1] Installation
  304.       ====================================================================
  305.  
  306.       To install QAZ on your system, copy the QAZ.EXE and QAZ.HLP files
  307.       into your DOS path (usually the C:\DOS or C:\BIN directories).
  308.  
  309.       Copy the QAZ.HLP file to the same directory as QAZ.EXE if you'd like
  310.       the on-line help function to work properly (by using QAZ /? or from
  311.       DOS v5, HELP QAZ).
  312.  
  313.       To set up default options check the appropriate section of this
  314.       document.
  315.  
  316. [5.0] Simple Usage
  317.       ====================================================================
  318.  
  319.       QAZ is actualy very simple to use.  Without using any of switches or 
  320.       options, you can view an archive from the command line simply by 
  321.       typing:
  322.  
  323.     QAZ filename
  324.  
  325.       Where 'filename' is the name of the archive file you want QAZ to 
  326.       identify/view.  (See the technical notes for specific info on which 
  327.       file types QAZ can recognize.)  If you do not specify an extention, 
  328.       QAZ will examine all files with that name (ie. assume the extention 
  329.       as '*').  In fact you can give QAZ a wildcard filespec--for example:
  330.  
  331.     QAZ TEST*.*
  332.  
  333.       You can also give QAZ a list of filespecs you want shown in the 
  334.       archive:
  335.  
  336.      QAZ EXAMPLE.FOO *.DOC *.TXT READ.ME
  337.  
  338.       This will display all files (if they existed) that matched the file-
  339.       specs '*.DOC', '*.TXT' or 'READ.ME' in the archive EXAMPLE.FOO.
  340.  
  341. [5.1] Using Options and Switches
  342.       ====================================================================
  343.  
  344.       To see the usage screen, just call QAZ with no filenames or options,
  345.       (or if you use an invalid option).  You should see a display similar 
  346.       to this:
  347.  
  348.     Usage: QAZ archive [datafiles] [options] [[|pipe] > stdout]
  349.  
  350.         Options:
  351.         --------
  352.          /b     Bare Listing            /w      Wide Listing
  353.          /l     Lowercase               /o[-]*  Sort Order
  354.          /v[*]  View                    /t[f]   Tree Structure
  355.          /z[*]  Time-Zone Adjust        /f[*]   Formatting
  356.          /r     Return Exit Code        /d[*,*] List Between Date(s)
  357.          /u[*]  Scan Recursively        /s[*.*] List Between Size(s)
  358.  
  359.         * For more information, please read the documentation,
  360.                   or to read the on-line quick reference, type: QAZ /?
  361.  
  362.     QAZ v2.30 Copyright (c)1993,94 Robert Rothenburg Walking-Owl
  363.  
  364.       Note: if QAZ prefixes the options with a hyphen ('-') instead of a
  365.             slash ('/') on your system, then use a hyphen as the 'switch-
  366.             character' for your instead.
  367.  
  368.       QAZ includes a variety of options to adjust and customize the archive 
  369.       listing to your tastes and-or needs.  To use the options, simple add 
  370.       them at the end of the command line.  For example,
  371.  
  372.     QAZ OPTEXMP.ARC /W /L
  373.  
  374.       Lists the files in the archive in the 'wide' format and in lowercase.
  375.  
  376.       You can get a brief quick-reference guide to most QAZ options using
  377.       QAZ /? (Or from DOS v5, HELP QAZ) which displays the QAZ.HLP file.
  378.  
  379.       The options are _not_ case specific: it makes no different whether
  380.       an option is entered in upper- or lowercase.
  381.  
  382. [5.B] Brief Listings (The /B switch)      
  383.       ====================================================================
  384.  
  385.       Usage: QAZ archive /B
  386.  
  387.       The brief listing switch for QAZ works the same way as the same
  388.       option from the DOS 'dir' command. (Similarly, the /B switch
  389.       overrides the /W switch).
  390.  
  391.       Only the filenames are listed, with header information, (which is
  392.       useful for generating picklist files). If the /B switch is used
  393.       along with the /VP or /VU switches, pathnames (if stored in the
  394.       archive) will be shown.
  395.  
  396.       To create a picklist (by disabling header information) use along
  397.       with the /VQ option.
  398.  
  399.       To disable brief listings, use /B-
  400.  
  401.       Brief listings are compatible with the /L, /D, /S, /O, /VP, /VU
  402.       or /VQ options.  They are overridden by the /T and /VI options.
  403.  
  404.  
  405. [5.W] Wide Listings (The /W switch)       
  406.       ====================================================================
  407.  
  408.       Usage: QAZ archive /W
  409.  
  410.       The wide listing switch for QAZ also works similarly to the same
  411.       option from the DOS 'dir' command.  (However, pathnames or sub-
  412.       directories are not listed.)
  413.  
  414.       Filenames are shown five per line.
  415.  
  416.       To disable wide listings, use /W-
  417.  
  418.       Wide listings are compatible with the /L, /D, /S, /O, and /VQ
  419.       options.  The are overridden by the /B, /T and /VI options.
  420.  
  421. [5.V] Viewing Options (The /V switch)
  422.       ====================================================================
  423.  
  424.       Usage: QAZ archive /V[BCDINQSTUV,0-3]
  425.  
  426.       The /V switch is used to define what is to be viewed or not.  Used
  427.       with no options (ie. QAZ archive /V) it is equivalent to the /V1P
  428.       switch, for compatability with older version of QAZ.
  429.  
  430.       Multiple options may be used with /V (ie. QAZ archive /VNSI).
  431.  
  432.        /VB     Brief. (Not the same as the /B switch!)  Do not show the
  433.                file date/time stamps.  Opposite of /VD.
  434.  
  435.        /VC     Show Comment.  Displays the archive's main comment for
  436.                formats where it is not compressed (ARC, ARJ, GZIP or
  437.                ZIP formats).
  438.  
  439.        /VD     Show Date.  (Default).
  440.  
  441.        /VI     Identify only.  Show only the header which identifies
  442.                the archive type, without listing files.  (Not compatible
  443.                with the /VQ switch).
  444.  
  445.        /VN     Supress error messages and warnings.  QAZ will not show
  446.                error messages or notices that the file contains encrypted
  447.                (passworded) files or authentication information.
  448.  
  449.        /VP     View full pathnames.
  450.  
  451.        /VQ     Quite listing.  Header information is not displayed: this
  452.                is useful for generating picklist files.
  453.  
  454.        /VS     Selective.  List archive (incl. header info) if and ony
  455.                if it contains selected filespecs, dates or sizes.
  456.                Graphics, disk-images and encoded archives are ignored.
  457.  
  458.        /VT     View Text.  Normally, QAZ ignores text files.  If the /VT
  459.                switch is enabled, QAZ will attempt to identify the text
  460.                to see whether it is an AR7, BinHex, UU-Encoded or XX34-
  461.                Encoded file.  (Replaces the /t option in QAZ v2.10c).
  462.  
  463.                If the file appears to be an AR7 or BinHex file, QAZ will
  464.                attempt to do a listing of the archive contained. (This
  465.                option is useful for BBS systems with Mac .HQX files).
  466.  
  467.                Note that decoding a large BinHex file (500k) can take
  468.                several seconds.
  469.  
  470.        /VU     View full pathnames in Unix format (ie. /FOO/BAR).
  471.  
  472.        /V0     View only the original sizes, date/time stamps and file-
  473.                names in the archive.
  474.  
  475.        /V1     Default viewing level.  Shows the original and archived
  476.                sizes, compression ratios, date/time stamps, and filenames
  477.                in the archive.
  478.  
  479.        /V2     Same as default, only shows file attributes if defined.
  480.  
  481.                                 Meaning of file attributes:
  482.                                 ---------------------------
  483.                     a = archive bit set
  484.                    d = directory,   / = pathspec for file
  485.                    v = volume label
  486.                    s = system file
  487.                    h = hidden file
  488.                    w = read/write   r = read only
  489.  
  490.        /V3     Same as default, though with 'extended' file attributes
  491.                (of flags).
  492.  
  493.                     Meaning of extended attributes:
  494.                                 -------------------------------
  495.                    t = text file
  496.                    p = password protected file
  497.                  * ! = authentication codes/secured file
  498.                  * b = backup flag
  499.                    m = file split (multipartite archive)
  500.                    c = comment (usu. compressed)
  501.  
  502.                             * = Tentative (may be changed)
  503.  
  504.  
  505. [5.O] Sorting the Listing (The /O switch)      
  506.       ====================================================================
  507.  
  508.       Usage: QAZ archive /O[-][N,E,D,S,C or R]
  509.  
  510.       The /O switch works similar to the same switch in the DOS 'dir'
  511.       command.  The files are sorted according to the option given.
  512.  
  513.        /O-     Disable sorting (Default).  Lists files as they
  514.                are stored in the archive.
  515.  
  516.        /ON     Sort by Name (Ascending)
  517.        /OE     Sort by Extention
  518.        /OD     Sort by Date
  519.        /OS     Sort by Original Size
  520.        /OC     Sort by Compressed (Archived) Size
  521.        /OR     Sort by Compression Ratio
  522.        /O-N    Sort by Name (Descending/Reverse)
  523.        /O-E    Sort by Extention (Descending)
  524.  
  525.                 et cetera...
  526.  
  527.       Prefixing the sort-type with a hyphen tells QAZ to reverse the sorting
  528.       order.  Only one sorting option may be used at a time.
  529.  
  530.  
  531.  
  532. [5.F] Formatting the output (The /F switch)
  533.       ====================================================================
  534.  
  535.       Usage: QAZ archive /F[ACEMPRVZ:$,0-2]
  536.  
  537.       The /F options are meant for customizing the display as well as to
  538.       override the system's native country-settings.
  539.  
  540.       Multiple options may be used with /F (ie. /F1VP).
  541.  
  542.       o Formatting the date: QAZ looks at the system's country code set-
  543.         tings to determine how to format the date.  This feature was added
  544.         to reduce the ambiguity between American MM-DD-YY and European
  545.         DD-MM-YY formats.  QAZ _should_ show file dates and times in the
  546.         same format that DOS's 'date', 'time' or 'dir' commands will show.
  547.  
  548.         If you prefer a different setup (aside from changing the COUNTRY.SYS
  549.         settings in your CONFIG.SYS file) you can use the /F option to
  550.         reconfigure QAZ's display.
  551.  
  552.          /F-    Use the system's defaults.
  553.          /F0    American date style, MM-DD-YYYY.
  554.          /F1    Eurpean date style,  DD-MM-YYYY.
  555.          /F2    Asian date style,    YYYY-MM-DD.
  556.          /FV    Show verbose months: (the month is written as the
  557.                   three-letter English abbreviation rather than a
  558.                   number).
  559.  
  560.         Note: QAZ will use the most-recently set date style.  This will
  561.               be the style required by the /D option.
  562.  
  563.       o Formatting the ratio: QAZ will normally show the compression ratio
  564.         as a decimal.  If you prefer, you can change this.
  565.  
  566.          /FR    Show as a decimal ratio (Default).
  567.          /FP    Show as a percentage (ie. 0.256 shown as 25.6%).
  568.          /FZ    Show as 'zip'-style percentage (ie. 0.256 as 74.4%).
  569.          /F:    Show as x-to-1 style (ie. 0.256 shown as 4:1).
  570.  
  571.       o Formatting graphics and character sets: miscellaneous options.
  572.         These may be useful for on-line systems and BBSs.
  573.  
  574.          /FA    Use 7-bit ASCII for display.  (This has no effect on
  575.                   the /T option).
  576.  
  577.          /FC    Truncate long filenames (so that they don't extend over
  578.                 80-columns).  Useful for some archives from Amiga, Unix
  579.                 and Macintosh systems which support larger filenames.
  580.                 Truncated filenames will have a '[+]' tacked on the end.
  581.  
  582.          /FE    Enable ANSI.  (Equivalent to the /E option in QAZ v2.00).
  583.                 The listing will me displayed in multiple colors.  This
  584.                 is meant for BBS-usages, and essentially has no effect
  585.                 when used with the /B, /T or /W options.
  586.  
  587.                 The ability to redefine the colors may be added in later
  588.                 versions of QAZ.
  589.  
  590.          /FM    Disable ANSI, use 8-bit 'cp80' ASCII (Default).
  591.  
  592.          /F$    Show filename and identified file format on two lines
  593.                 instead of one.  The filename is also shown with the
  594.                 full pathname.  (This option is automatically enabled
  595.                 when using the /U option).
  596.  
  597. [5.D] Listing only files with/between specified dates (The /D switch)      
  598.       ====================================================================
  599.  
  600.       Usage: QAZ filename /D[ from-date ][,][ to-date ]
  601.  
  602.  
  603.       When you list an archive, you not only have the option of filtering
  604.       which filenames are listed but also their dates.  Thus you can list
  605.       files before, after or between a given set of dates.
  606.  
  607.       Note: that the /D option expects the date to be formatted in the
  608.             same way it will be output.  So American date-styles (/F0)
  609.             would be in MM-DD-YYYY, European styles (/F1) in DD-MM-YYYY
  610.             etc.  (The date _must_ be given in numbers.  The /FV switch
  611.             has no meaning on the /D switch!)
  612.  
  613.       In the diagram below, 'x' and 'y' stand for dates (ie. 7-3-87).
  614.  
  615.        /D-     Disables date filtering (Default).
  616.        /Dx     List only files with date 'x'.
  617.        /D,x    List only files before and up to date 'x'.
  618.        /Dx,    List only files with and after date 'x'.
  619.        /Dx,y   List only files dated between dates 'x' and 'y'.
  620.  
  621.       Only dates are used.  You cannot filter files by their time.
  622.  
  623.       Again: QAZ expects dates to be formatted from the /D switch in the
  624.              same way they are output. This includes the date seperator:
  625.              if QAZ outputs the dates using '/' instead of '-', than QAZ
  626.              expects a '/' between date fields.
  627.  
  628.              There is no error-checking for 'invalid' dates!
  629.  
  630.       The following are valid examples of using the /D switch:
  631.  
  632.         QAZ FOO.BAR /F0 /D01-01-93,12-31-93      (American style)
  633.         QAZ FOO.BAR /F0 /D1-1-1993,12-31-1993
  634.  
  635.         QAZ FOO.BAR /D1-3-89                  (Files dated Jan. 3, 1989)
  636.         QAZ FOO.BAR /D1-3-89,                 (Files after Jan. 2, 1989)
  637.         QAZ FOO.BAR /D,1-3-89                 (Files before Jan. 4, 1989)
  638.         QAZ FOO.BAR /D1-3-89,1-7-89           (Files between Jan 4-7, 1989)
  639.  
  640.         QAZ FOO.BAR /D3-1-89                 (Same as above, European style)
  641.         QAZ FOO.BAR /D89-1-3                 (Same as above, Asian style)
  642.  
  643.       (Months and days need not be two digits. Years need not be 4 digits.)
  644.  
  645.       The /D option has no effect on the /T option.
  646.  
  647. [5.S] Listing only files with/between specified sizes (The /S switch)       
  648.       ====================================================================
  649.  
  650.       Usage: QAZ archive /S[ smallest ][,][ largest ]
  651.  
  652.       The /S option works much the same as the /D option.  You can filter
  653.       the listing by original file-sizes, if they are defined.  The only
  654.       difference is that /S expects numbers, not dates.
  655.  
  656.       Note: Some file formats like JArchive or CP/M-SQ do not store the
  657.             original file size, and thus the /S option will not work prop-
  658.             erly for them.
  659.  
  660.        /S-      Disable size filtering (Default).
  661.        /Sx      List only files in the archive of size 'x'.
  662.        /Sx,     List only files greater-than-or-equal-to size 'x'.
  663.        /S,x     List only files less-than-or-equal-to size 'x'.
  664.        /Sx,y    List only files of sizes between 'x' and 'y'.
  665.  
  666.      The following are some valid examples of the /S option:
  667.  
  668.     QAZ ARCHIVE.LIB /S65536,            (List files >= 65536 bytes.)
  669.         QAZ ARCHIVE.LIB /S64K,              (Same as above.)
  670.     QAZ ARCHIVE.LIB /S,1024             (List files <= 1024 bytes.)
  671.     QAZ ARCHIVE.LIB /S10K,16K           (List files 10240-16384 bytes.)
  672.     QAZ ARCHIVE.LIB /S1M,               (List files >= 1 Megabyte.)
  673.  
  674.      Rather than type 10240 you can type 10k as an abbreviation.  QAZ
  675.      makes no distinctions between 'k' and 'K' or 'm' and 'M' the way
  676.      4DOS supposedly does. xK = x*1024, where 'x' is a number.
  677.  
  678.      Again, there is very little error checking.  Strange 'values' are
  679.      ignored.
  680.       
  681.  
  682. [5.Z] Time Zone Settings (The /Z switch)
  683.       ====================================================================
  684.  
  685.       Usage: QAZ archive /Z[+|-][ timezone ]
  686.  
  687.       The /Z option allows you to enable, disable or set time-zone adjust-
  688.       ments for archiver formats that require it.
  689.  
  690.       By default, QAZ checks the contents of the TZ environment variable,
  691.       and adjusts the time from GMT (or UTC) with it for formats which
  692.       store a file's time-stamp in Unix or Mac formats.
  693.  
  694.       If you prefer to ignore or override this, you can use the /Z option.
  695.  
  696.        /Z       Disable time-zone adjustment (all times GMT)
  697.        /Z-      Same as /Z
  698.        /Z+      Enable time-zone adjustment (Default).  Use the contents
  699.                 of the TZ variable.
  700.        /Zx      Adjust the time-zone to GMT-x hours.  Only whole hour
  701.                 adjustments are used (no half-hour adjustments).  Any
  702.                 integer from -23 to 23 can be used.
  703.  
  704.                 Examples:
  705.  
  706.           QAZ FOO.BAR /Z5   (Adjust to GMT-5 hours = EST)
  707.           QAZ FOO.BAR /Z8   (Adjust to GMT-8 hours = PST)
  708.           QAZ FOO.BAR /Z-1  (Adjust to GMT+1 hours)
  709.  
  710.     The following file formats use Unix or Mac date/time-stamps which
  711.         are usually adjusted for (presumed) time-zones:
  712.  
  713.          Codec3
  714.          Compact Pro (Mac)
  715.          DoubleDisk  (Mac)
  716.      DWC
  717.      GZip        (GNU-Zip)
  718.      HA
  719.      HPACK       (No TZ-adjustments for DOS files)
  720.      JRchive
  721.      LHArc       (Unix, Type-2)
  722.          StuffIt!    (Mac)
  723.      TAR
  724.  
  725.       Note: You can also set your system's TZ variable for the appropriate
  726.         timezone.  Sample settings are TZ=EST5EDT for Eastern Time,
  727.         TZ=PST8PDT for Pacific Time, etc.
  728.  
  729.             QAZ will ignore the TZFIX variable, though.
  730.                    
  731. [5.T] Viewing the archive's directory tree stucture (The /T switch)
  732.       ====================================================================
  733.  
  734.       Usage: QAZ archive /T[F]
  735.  
  736.       The /T option is used to view the directory tree structure of the
  737.       files in the archive.  It is analogous to the 'tree' command in
  738.       DOS.
  739.  
  740.        /T       View archive tree structure.
  741.        /T-      Disable (Default).
  742.        /TF      View tree structure, with filenames (Same as using /T /VP).
  743.        
  744.       The /T option will override the /B or /W switches.  The /FA switch
  745.       has no effect on viewing the tree structure.
  746.  
  747.       Note: in earlier versions of QAZ, the /T option was used as a flag to
  748.             tell QAZ to view the headers of text files.  This option was re-
  749.             moved from QAZ v2.21a and was re-added as /VT in v2.29.
  750.  
  751.  
  752.  
  753. [5.R] Using Return Codes to determine the archive type (The /R switch)
  754.       ====================================================================
  755.  
  756.       Usage: QAZ archive /R[-]
  757.  
  758.       The /R switch is used to tell QAZ to return an exit code identifying
  759.       the archive format so that external software can use QAZ to determine
  760.       which dearchiving or testing utilities are needed.
  761.  
  762.        /R       Return exit-code identifying the archiver or file type.
  763.        /R-      Disable id exit-codes. (Default).
  764.  
  765.       Note: if QAZ examines more than one file (because of wildcards) then
  766.             the identifying code is returned for the last file examined.
  767.  
  768.       See the appropriate section in the Technical Information for a list
  769.       of the exit-codes and their meanings.
  770.  
  771. [5.L] Lowercase filenames (The /L switch)     
  772.       ====================================================================
  773.  
  774.       Usage: QAZ archive /L[+-S]
  775.  
  776.       By default, QAZ displays all path and filenames in uppercase.  You
  777.       can use this option to change the display to lowercase, or even to
  778.       leave the case alone for archives using mixed-case filenames (as in
  779.       many Macintosh archives).
  780.  
  781.         /L      Lowercase filenames.
  782.         /L+     Same as /L.
  783.         /L-     Uppercase (Default).
  784.         /LS     "Sensitive".  Show as it appears in the archive.
  785.                 (Filespec matching is not affected).
  786.  
  787.       Note: When listing Mac files, QAZ changes all carriage-returns,
  788.             control characters, spaces and backslashes to underscores
  789.             ('_').
  790.  
  791.       To prevent filenames that are longer than 22 characters from scroll-
  792.       ing off the screen, use the /FC option.
  793.  
  794.  
  795. [5.U] Recursive Searching (The /U switch)       
  796.       ====================================================================
  797.  
  798.       Usage: QAZ [drive:][path]arch-spec filespecs... /U[ESX+] /VS[TI]
  799.  
  800.       When given a filespec instead of a specific file-name, QAZ will
  801.       naturally examine all files in the specified directory that match
  802.       the filespecs.  When the /U option is used, QAZ will also examine
  803.       all the subdirectories as well--thus adding a powerful ability to
  804.       search for archives which contain a specified set of files on a
  805.       disk.
  806.  
  807.       The /U option _only_ tells QAZ to recursively search subdirectories.
  808.       All files examined will be viewed unless the /VS option is used.
  809.       If you only want the archive filename shown with no listing, use the
  810.       /VSI option.
  811.  
  812.        /U-      No recursive searching (Default).
  813.        /U+      Recursively search subdirectories.
  814.  
  815.        /UX      Show name of files that match given filespecs.  Use
  816.                 this when searching for a file inside of archives to
  817.                 have QAZ note if a matching file was found not inside
  818.                 of an archive.
  819.  
  820.        /US      Load a 'standard' set of common archive filespecs to
  821.                 search for.  This is useful for searching for files
  822.                 in an environment with many archive types.  When this
  823.                 option is used, QAZ will examine files with the
  824.                 following filespecs:
  825.  
  826.                   Filespec:          Archive Type(s):
  827.                   ---------          ----------------
  828.                    *.??Z             Gnu-Zip, Queasy
  829.                    *.AR[CJK]         ARC, ARJ
  830.                    *.CP[TZ]          Compact-Pro, Central-Point Shrink
  831.                    *.DWC             DWC
  832.                    *.EXE             DOS Self-Extracting Archives
  833.                    *.GZ              Gnu-Zip
  834.                    *.HA              HA
  835.                    *.[HZ]PK          HPACK, Zi-Lite (aka ZPACK)
  836.                    *.H[AY]P          HAP, Hyper
  837.                    *.ICE             Reevesoft Freeze for Windows
  838.                    *.SIT             StuffIt!
  839.                    *.L[AB]R          CP/M Archives (*.LAR, *.LBR)
  840.                    *.LI[BFM]         CP/M Archives or Codec3 (*.LIB)
  841.                                      Knowledge Dynamics *.LIF files
  842.                                      Limit files (*.LIM)
  843.                    *.LZ[HS]          LHArc and LArc
  844.                    *.PAK             PAK
  845.                    *.SQZ             Squeeze-It!
  846.                    *.TAR             Unix TAR
  847.                    *.Z               Gnu-Zip
  848.                    *.ZIP             Zip
  849.                    *.ZOO             Zoo
  850.  
  851.         /UE     Load filespecs defined in the QAZSPEC environment variable.
  852.                 This was the primary way of defining filespecs to examine
  853.                 with QAZ v2.21.  You can set QAZSPEC to the archive types
  854.                 that you use, including filespecs that are not used with
  855.                 the /US option.
  856.  
  857.         For example,
  858.  
  859.           SET QAZSPEC=.ZIP .ARJ .ZOO .SQZ .SEA
  860.  
  861.                 If you set QAZSPEC with filespecs that are too vague (such
  862.                 as what was unintentionally recommended in the documentation
  863.                 for QAZ v2.21a) you will have QAZ unnecessarily examining
  864.                 files it does not need to and slowing down the search.
  865.  
  866.         /UT     Shows the approximate search time.  (This feature is some-
  867.                 what buggy and may give strange values.)
  868.  
  869. [5.2] More about using QAZ's search function
  870.       ====================================================================
  871.  
  872.       QAZ will search only the files specicified.  You can use 'pure'
  873.       wildcards for this, but note that you risk crashing your system
  874.       if you have strange files that appear to be something they are
  875.       not.  Although I have done my best to eliminate this problem,
  876.       I could happen.
  877.  
  878.       You also must remember to use the /VS option if you want QAZ to
  879.       search for files in an archive, and not to list every file it
  880.       examines.
  881.  
  882.       If you only want the name of the archive, and not a listing of
  883.       matching filespecs, use /VSI instead.
  884.  
  885.       For example, suppose you want to search drive C for archives
  886.       which contain a file called 'FOOBAR.EXE'.  You'd use:
  887.  
  888.         QAZ C:\ FOOBAR.EXE /U+ /VSI
  889.  
  890.       If we think that FOOBAR.EXE might also be hidden in some forgotten
  891.       directory but not archived, we need not use a seperate file-finder
  892.       utility:
  893.  
  894.         QAZ C:\ FOOBAR.EXE /UX+ /VSI
  895.  
  896.       This search may take too long however, so can do one of the following:
  897.  
  898.         QAZ C:\*.ZIP FOOBAR.EXE /UX+ /VSI
  899.  
  900.       If we know that the file is in a Zip archive, this is the best
  901.       solution.  But what if we're not sure what the filespec used is?
  902.       If it's one of the common one's used for /US, then we can use:
  903.  
  904.         QAZ C:\ FOOBAR.EXE /UXS+ /VSI
  905.  
  906.       There are other methods however.  We can define a list of filespecs
  907.       in the QAZSPEC variable (in which case we'd use /UXE+ or /UXSE+
  908.       instead).  We can either define QAZSPEC in the AUTOEXEC.BAT file
  909.       or spontaneously from the keyboard:
  910.  
  911.         SET QAZSPEC=*.ZIP *.ARJ *.EXE *.LZH
  912.  
  913.         QAZ C:\ FOOBAR.EXE /UXE+ /VSI
  914.  
  915.     o Using Picklists:
  916.       ----------------
  917.  
  918.       Another method is to use a picklist file...
  919.  
  920.       Let's say we have a text file called FOOLIST.TXT which contains only
  921.       the names of files (or filespecs) that we think FOOBAR.EXE might be
  922.       in:
  923.  
  924.         QAZ C:\@FOOLIST.TXT FOOBAR.EXE /U+ /VSI
  925.  
  926.       If we don't actually have the FOOLIST.TXT file on hand, we can type
  927.       in the names from the console:
  928.  
  929.         QAZ C:\@CON FOOBAR.EXE /U+ /VSI
  930.  
  931.       After typing this, we type in the names or filespecs we want QAZ to
  932.       examine (sperated by spaces or a new line), then type Control-Z and
  933.       hit enter.
  934.  
  935.       We can also use the picklist method to give the filespecs we want
  936.       to search for:
  937.  
  938.         QAZ C:\ @PICKLIST.TXT /U+ /VSI
  939.  
  940.       (Whenever a filespec is preceeded by an 'at' symbol ('@') it is
  941.       assumed to be a picklist file.)
  942.  
  943.     o Searching encoded text files:
  944.       -----------------------------
  945.  
  946.       The common extentions for BinHex or UU- or XX-Encoded files are not
  947.       part of the standard (/US) option, so if we want to search them
  948.       as well we must specify the extentions they use _and_ we must tell
  949.       QAZ to examine text files more closely with the /VT option.
  950.  
  951.       For example:
  952.  
  953.         SET QAZSPEC=*.SEA *.HQX
  954.  
  955.         QAZ C:\ FOO.BAR /UE+ /VSIT
  956.  
  957.       Note: QAZ v2.30 only has the ability to examine BinHex and AR7
  958.             encoded archives.  Future versions may also have the ability
  959.             to examine UU-Encoded or XX34-Coded files as well.
  960.  
  961. [5.3] Options removed or changed from previous versions of QAZ
  962.       ====================================================================
  963.  
  964.       If you previously used QAZ v2.10, please read this section.
  965.  
  966.       The /E ('Enable ANSI'), /T ('View text') and /P ('Page break')
  967.       options have been removed since QAZ v2.20.
  968.  
  969.       o Using /T in QAZ v2.20 now has a completely different meaning
  970.         (to view the archive's "tree" structure instead).
  971.  
  972.         Rather than view the first few lines of a text file, use /VT
  973.         to have QAZ try to determine if it is an AR7, BinHex, UU- or
  974.         XX-Encoded file.
  975.  
  976.         If it is an AR7 or BinHex file, QAZ will attempt to list the
  977.         contents.
  978.  
  979.       o Instead of defining one preferred color to use with the old
  980.         /E option, using /FE displays the list in several colors.
  981.  
  982.       o Instead of the /P option, use QAZ with the |MORE pipe. (See
  983.         your DOS User's Guide for more information).
  984.  
  985.       See the appropriate sections on the /T, /VT and /FE options for
  986.       more detailed information.
  987.  
  988. [5.4] Setting Default Options
  989.       ====================================================================
  990.  
  991.       You can set default options using the QAZCMD environment variable
  992.       much in the same way you can use the DIRCMD environment variable for
  993.       the DOS 'dir' command.
  994.  
  995.       Suppose you prefer lowercase listings using verbose, European style 
  996.       dates. and percentages instead of raw ratios.  You would use the 
  997.       following in your AUTOEXEC.BAT file:
  998.  
  999.     SET QAZCMD=/L /F1VP
  1000.  
  1001.       (No space between '=' and QAZCMD.  Case is not important.)
  1002.             
  1003.       These will be the default options (unless they are overriden) whenever
  1004.       you use QAZ.  Setting custom defaults is also a good idea in case QAZ
  1005.       incorrectly reads your system's country-code or time-zome information.
  1006.             
  1007.       Note: if you use an option wrongly in the QAZCMD variable, you'll
  1008.         always get a usage-error whenever you run QAZ.
  1009.  
  1010.       To disable the default options setting, you can use this:
  1011.  
  1012.         SET QAZCMD=
  1013.  
  1014.       With nothing after the '=' sign.
  1015.  
  1016.       Although all the options can be disabled or overrided, it's probably
  1017.       not a good idea to use the /B, /W, /O, /D or /U options as defaults.
  1018.  
  1019.       Note: Adding the /UE or /US switch will automatically add the wild-
  1020.             cards to QAZ's search-specs, thus making it impossible to view
  1021.             a single archive.  Only use /UE or /US when searching for files!
  1022.  
  1023. [5.5] Using extended wildcards and search-specs
  1024.       ====================================================================
  1025.  
  1026.       Aside from the standard DOS '*' and '?' wildcards, QAZ can also
  1027.       handle the 'undocumented' DOS as well as extended Unix-like wild-
  1028.       cards for the archive-file and filespec parameters.
  1029.  
  1030.       Note: filespecs in QAZ are _not_ case-sensitive, even when
  1031.             the /LS option is used.
  1032.  
  1033.       Undocumented DOS wildcards:
  1034.       ---------------------------
  1035.  
  1036.       Many DOS commands (like 'dir') allow an abbreviated file specific-
  1037.       ation format.  QAZ will also accept these:
  1038.  
  1039.        .EXT is equivalent to *.EXT (ie. '.ZIP' = '*.ZIP').
  1040.        NAME is equivalent to NAME.* (ie. 'FOOBAR' = 'FOOBAR.*').
  1041.  
  1042.       Extended wildcards:
  1043.       -------------------
  1044.  
  1045.        o Picklists: a filename (not wildcarded!) preceeded by an 'at'
  1046.          symbol is assumed to be a picklist file in the current dir-
  1047.          ectory.  (A picklist is a text file containing filespecs).
  1048.  
  1049.          For example,
  1050.  
  1051.            QAZ @ONLY.LST
  1052.  
  1053.          will look for a text file called ONLY.LST which contains
  1054.          filespecs or filenames for QAZ to process.  Picklists may
  1055.          also be used as filespecs to look for within the archive:
  1056.  
  1057.            QAZ ARCHIV.LIB @FILES.LST
  1058.  
  1059.          This lists the files within ARCHIV.LIB that match the file-
  1060.          specs in FILES.LST.
  1061.  
  1062.          The filespecs in a picklist can be on seperate lines, or on
  1063.          one line seperated by a space.  Thus,
  1064.  
  1065.            *.DOC *.TXT
  1066.  
  1067.          or
  1068.  
  1069.            *.DOC
  1070.            *.TXT
  1071.  
  1072.          are equally valid.
  1073.  
  1074.        o 'Not'-Specs: A filespec meaning 'all-but' is also supported.
  1075.          Any filespec preceeded by a carat ('^') means all files (that
  1076.          match other filespecs) except that spec.  For example,
  1077.  
  1078.            QAZ ARCHIV.LIB ^.DOC
  1079.  
  1080.          lists all files in an archive except those that match *.DOC.
  1081.  
  1082.          Not-specs can be combined with other filespecs:
  1083.  
  1084.            QAZ ARCHIV.LIB *.C ^FOO*.C
  1085.  
  1086.          Lists all *.C files except FOO*.C files.
  1087.  
  1088.          Note: for some utilities the 'Not' character is often a '!'
  1089.                or '~'.  Since there is no standard, the decision to
  1090.                use the carat is somewhat arbitrary.
  1091.  
  1092.        o Sets: QAZ also supprts (to a limited degree) the set spec-
  1093.          ifications supported by some flavors of Unix.  Thus,
  1094.  
  1095.            QAZ ARCHIV.LIB [a-m]*
  1096.  
  1097.          lists all files in ARCHIV.LIB that begin with characters 'a'
  1098.          through 'm'.
  1099.  
  1100.          The following are valid examples of the same set, 'a'-'e':
  1101.  
  1102.            [a-e]
  1103.            [a,b,c,d,e]
  1104.            [abcde]
  1105.            ["abcde"]
  1106.            [a-c,d,e]
  1107.            ["a","b-e"]
  1108.  
  1109.          Also supported, are 'Not'-sets:
  1110.  
  1111.            [^"x-z"]*.*
  1112.  
  1113.          means all files except those that begin with 'x' through 'z'.
  1114.  
  1115.          Sets are analagous to using the '?' character, only you have
  1116.          the option to define what characters are valid.
  1117.  
  1118.        o Vague Sets: similar to single-character sets are 'vague' or
  1119.          'variable-length' sets which contain none or some of the
  1120.          characters in the field.  Thus,
  1121.  
  1122.            {} is equivalent to '*'
  1123.            X{} is equivalent to 'X*'
  1124.  
  1125.          however(!),
  1126.  
  1127.            X{0-9}
  1128.  
  1129.          is valid for all files from 'X0' to 'X9999999'.
  1130.  
  1131.          The first two examples show some 'bugs' in the use of vague-sets.
  1132.          Earlier releases of QAZ encourages some creative uses of {}-sets
  1133.          that turned out to be equivalent to using '*.*'.  Thus,
  1134.  
  1135.            *.{h}p{a}k
  1136.  
  1137.          was meant to mean *.HPK and *.PAK, however using the vague-set
  1138.          as a first character meant that any extention (ie. '*.*') would
  1139.          be valid.
  1140.  
  1141.        o Text Specs: we can preceed a filespec with a word inside paren-
  1142.          theses to indicate that we want files that contain that 'word'.
  1143.          For example,
  1144.  
  1145.            ("MD5")*.C
  1146.  
  1147.          is valid for all *.C files that contain 'MD5' in the filename
  1148.          field.  Thus 'MD5.C', 'MD5SUM.C', 'CALCMD5.C' and 'HMD5FILE.C'
  1149.          would all be valid.
  1150.  
  1151.       If the extended filespecs seem confusing, try experimenting with a
  1152.       large archive file in order to get a handle on using them.
  1153.  
  1154. [5.6] Using QAZ from a BBS
  1155.       ====================================================================
  1156.  
  1157.       QAZ outputs the listing to STDOUT (stanard output), which means
  1158.       that the output is redirectable. So far (that I know of) QAZ has
  1159.       been used on Renegade and TBBS (via MFM-LAN for a multiline sys-
  1160.       tem) systems with no problems.
  1161.  
  1162.       If you plan to run QAZ on a BBS, consult the documentation for 
  1163.       appropriate macros and defaults on your system, especially where
  1164.       you would install archive viewers.
  1165.  
  1166.       SysOps who ran earlier versions of QAZ (v2.10c and earlier)
  1167.       should read the section on changed options to be sure there
  1168.       are no compatability problems.
  1169.  
  1170.       It's recommended that SysOps _not_ use the /B, /W, /T, /D or /O
  1171.       options for on-line viewing.  In some cases the /R option might
  1172.       also cause problems (as the BBS or LAN software might think an
  1173.       error has occurred).
  1174.  
  1175.       Most certainly you don't want to use the /U option either, since
  1176.       it is unnecessary in the very least, and at most will tie up the
  1177.       users' time. (A BBS-Door that utilizes QAZ to search for an archive
  1178.       that contains a file is in the works.)
  1179.  
  1180.       You might want to use the /FC switch to truncate filenames that are
  1181.       too long (and would overlap to the next line in the display).  If
  1182.       your system also carries many Macintosh files (.SIT, .CPT and .HQX)
  1183.       then you might consider adding the /VT switch for files in BinHex
  1184.       format.
  1185.  
  1186.       If you'd like to use a multi-colored ANSI display, use the /FE
  1187.       option if the system you're using is friendly towards ANSI codes.
  1188.  
  1189.       Note: the /FE switch is equivalent to the old /E switch in QAZ
  1190.             v2.00, although the display looks much better...
  1191.  
  1192.       When in doubt, use no options at all.
  1193.  
  1194. [5.7] Messages
  1195.       ====================================================================
  1196.  
  1197.       An brief explanation of messages (errors and information) which
  1198.       QAZ gives:
  1199.  
  1200.       o Path not found:                QAZ was given an invalid pathspec
  1201.         ---------------                for the archive.
  1202.  
  1203.       o File not found:                QAZ was given an invalid filename
  1204.         ---------------                for the archive or a picklist. The
  1205.                                        file does not exist in the specif-
  1206.                                        ied path.
  1207.  
  1208.       o Unrecognized Option:           QAZ was given an invalid option, or
  1209.         --------------------           the QAZCMD environment variable con-
  1210.                                        tains an invalid option. A carat ('^')
  1211.                                        will point to the offending character
  1212.                                        in the option.
  1213.  
  1214.       o Can't find C:\DOS\QAZ.HLP:     This message occurs if the QAZ.HLP
  1215.         --------------------------     file is not in the same directory as
  1216.                                        QAZ when the help screen is called
  1217.                                        (using QAZ /? or HELP QAZ).  If you
  1218.                                        have the QAZ.HLP file in a different
  1219.                                        directory, you can use the QAZPATH
  1220.                                        variable to define where the help file
  1221.                                        is (ie. SET QAZPATH=C:\DOS\).
  1222.  
  1223.       o Invalid filespecs ignored:     Invalid filespecs or non-existant
  1224.         --------------------------     picklist files (@filename) were given.
  1225.                                        QAZ ignores these.
  1226.  
  1227.       o Unknown File Format:           QAZ cannot identify this file.
  1228.         --------------------
  1229.  
  1230.       o Unknown SFX or not an archive: The file is an executable, but QAZ
  1231.         ------------------------------ cannot identify it. The file is
  1232.                                        either an executable or an unknown
  1233.                                        self-extracting archive or graphics
  1234.                                        format.
  1235.  
  1236.       o Possibe [archive type]:        A file appears to be of a certain
  1237.         -----------------------        archive format, however there are
  1238.                                        errors so that QAZ cannot list any
  1239.                                        files from this archive: it most like-
  1240.                                        ly is not an archive at all, but a
  1241.                                        false positive. (This will occur most
  1242.                                        often for ARC files.)
  1243.  
  1244.       o This file is encoded...:       The file is encrypted and/or the dir-
  1245.         ------------------------       ectory information (if any) is com-
  1246.                                        pressed. Some formats like Unix
  1247.                                        'compress' or UC2 will always generate
  1248.                                        this message. Other types like HPACK
  1249.                                        will generate the message is the
  1250.                                        entire archive is encrypted.
  1251.  
  1252.       o No files!                      QAZ was unable to generate a directory
  1253.         ---------                      listing for this file (possibly a
  1254.                                        false positive) or the given filespecs
  1255.                                        with date- and size filter (/D and /S
  1256.                                        options) do not exist in the archive.
  1257.      
  1258.       o This file is either damaged..: The file is (a) damaged, (b) not com-
  1259.         ------------------------------ patible (new version, or a different
  1260.                                        system, as in Amiga .LHA files), or
  1261.                                        (c) not an archive (probably a false
  1262.                                        positive).
  1263.  
  1264.       o This is part of a multipartite archive: The files is part of a multi-
  1265.         ------------------------------ partite archive, so a complete listing
  1266.                                    (if any) may not be possible. Some
  1267.                                        HPACK and GZIP files may generate this
  1268.                                        message.
  1269.  
  1270.       o This archive contains authentication information: The archive appears
  1271.         ------------------------------ to contain authentication codes.
  1272.                                        Either the entire archive or individ-
  1273.                                        ual files in the archive are authentic-
  1274.                                    ated/secured. QAZ does not check the
  1275.                                        validity of codes, only notes their
  1276.                                        presence. QAZ can only detect this for
  1277.                                        ARJ and HPACK archives.
  1278.       
  1279.       o This archive contains passworded files: At least one file in the ar-
  1280.         ------------------------------ chive is marked as encrypted, (or in
  1281.                                    the case of Codec3 archives the file
  1282.                                        requires a password but may not be
  1283.                                        encrypted).  QAZ can only detect this
  1284.                                        for ARJ, Codec3, HPACK and ZIP arch-
  1285.                                        ives. There is no way to detect
  1286.                                        encrypted ARC files.
  1287.  
  1288.       o This archive contains more files than QAZ can process: The files con-
  1289.         ------------------------------ tains more files than there is memory
  1290.                                        for QAZ to process the archive.
  1291.  
  1292.       o Examined ... matched files:    This message appears when QAZ examines
  1293.         ---------------------------    more than one file. It tells how many
  1294.                                        files/archives were examined, and how
  1295.                                    many files matched the given filespecs
  1296.                                        (and date- or size-filters).
  1297.  
  1298.       o Runtime Error ... :            This message is rare, since most I/O
  1299.         -------------------            errors are taken into account for.
  1300.                                        They've only occurred when using wild-
  1301.                                        cards to search disks that have bad
  1302.                                        sectors or drives that fail periodic-
  1303.                                        ally (one of my disk drives is on it's
  1304.                                        last legs and periodically gives a
  1305.                                    hardware failure error).
  1306.  
  1307. [5.8] Questions/Problems
  1308.       ====================================================================
  1309.  
  1310.       o Why doesn't QAZ show the archive comment when I use the /VC option?
  1311.         ------------------------------------------------------------------
  1312.  
  1313.         Some archivers like LHArc, HPACK or SQZ compress the comments.
  1314.         (In some cases with UC2 or HPACK the comments may even be GIF or
  1315.         JPEG files).  In these cases QAZ shows nothing.
  1316.  
  1317.       o Why does QAZ show a blank field?
  1318.         ------------------------------------------------------------------
  1319.  
  1320.         Depends on the archive.  For some formats information such as file
  1321.         attributes or the original size is undefined.  Sometimes even the
  1322.         filenames may be undefined.
  1323.  
  1324.       o Why does QAZ say there are no files in this archive?
  1325.         ------------------------------------------------------------------
  1326.  
  1327.         No files in the archive fit the given filespecs (including date
  1328.         or size filters).  Change the defined filespecs.  Also check the
  1329.         QAZCMD variable in case /d or /s options were defined.  It's
  1330.         also possible an error occurred (in which case QAZ will tell you)
  1331.  
  1332.       o Why does QAZ search filespecs I don't specify?
  1333.         ------------------------------------------------------------------
  1334.  
  1335.         Check the definitions in your QAZCMD or QAZSPEC variables.   Likely
  1336.         you are using filespecs that are too vague: this was an unforseen
  1337.         'bug' in the QAZ v2.21a release.   Do not start a filespec field
  1338.         (name or extention) with a 'variable length' {}-set.
  1339.  
  1340.       o Why does QAZ show 'garbage' when viewing a file?
  1341.         ------------------------------------------------------------------
  1342.  
  1343.         Likely it's a false positive, or the archive is damaged.  It's
  1344.         also possible that the archiver (such as HPACK) has stored the
  1345.         filename in a non-ASCII format (such as EBCDIC or UniCode).
  1346.  
  1347.       o Why can't QAZ process the archive when the archiver can?
  1348.         ------------------------------------------------------------------
  1349.  
  1350.         A new version of the archiver?  Or something undocumented about
  1351.         the archive format?  Or something I was unable to hack...  In
  1352.         some cases (HPACK) this version of QAZ cannot handle every aspect
  1353.         of the archive format (check the Technical Notes for more inform-
  1354.         ation).
  1355.  
  1356.       o Why does QAZ say the file is an ASCII text file?
  1357.         ------------------------------------------------------------------
  1358.  
  1359.         The file probably is.  If the file is an AR7 or BinHex-encoded
  1360.         archive, you need to use the /vt option, which tells QAZ to
  1361.         take a closer look at the file.
  1362.  
  1363. [6.0] Technical Information
  1364.       ====================================================================
  1365.  
  1366.       QAZ attempts to identify a file by looking at its beginning and
  1367.       end for header/trailer information, or for distinguishing char-
  1368.       acteristics that indicate the file is probably of a certain type.
  1369.       Only in a a couple of cases where the information is vague does
  1370.       QAZ check filenames as added confirmation (in these cases, the
  1371.       filenames are generally required).
  1372.             
  1373.       If the file turns out to be an executable, QAZ checks a set of
  1374.       tables of known self-extracting archives. Generally false posit-
  1375.       ives are rare, however there is a likelyhood that QAZ will not be
  1376.       able to identify a self-extractor that is not in the table (either
  1377.       a new or old, obscure version of the archive).
  1378.  
  1379.       This is a more reliable method of identification than searching
  1380.       through an executable for header-information (which is only worth-
  1381.       while for a few archive types).
  1382.             
  1383.       Another method  would be to examine the EXE-file header information, 
  1384.       which some archivers will do; however I have not found this to be 
  1385.       consistant enough to rely on for more than a few formats.
  1386.  
  1387.       The types of files that QAZ attempts to identify are (a) Archives 
  1388.       files which are collections of other files, sometimes compressed 
  1389.       (b) Compressed files, which may be compressed/encrypted archives 
  1390.       (c) Disk images, which are compressed files containing an 'image' 
  1391.       of a floppy disk, (d) Graphics files (e) And self-extracting ver-
  1392.       sions of the above.
  1393.  
  1394.       For archive files, QAZ gives the directory of files inside.  For 
  1395.       graphics files, QAZ gives the resolution and number of colors.  
  1396.       For other types, QAZ simply identifies the format and notes that 
  1397.       it cannot be viewed.
  1398.     
  1399. [6.1] What files can QAZ recognize?
  1400.       ====================================================================
  1401.  
  1402.       QAZ will recognize and list the following archive formats:
  1403.  
  1404.      * o ARC (ARC, PKARC, PKPAK in various flavors) and PAK v2.51.
  1405.        o Archaic CP/M Library format (LAR, LU).
  1406.      * o ARJ v2.41a.
  1407.        o Central-Point Shrink.
  1408.        o Codec3 (Codec 3.10).
  1409.      * o Compact Pro (Mac).
  1410.      * o DWC A5.01.
  1411.      * o DoubleDisk Archives (Mac).
  1412.        o Gnu-Zip v1.2.4. (Single files.)
  1413.        o HA v0.98.
  1414.        o Hamarsoft's HAP & PAH 3.00 (Should be compatible with 3.14).
  1415.        o HPACK v0.78a0.
  1416.      * o Hyper v2.6.
  1417.      * o JRchive v1.0
  1418.        o Knowledge Dynamic's .LIF format.
  1419.      * o LHArc (Type's 0-2) and relatives (AR, PUT, SAR)
  1420.          as well as the older LArc (.LZS) format.
  1421.        o Queasy (QEZ) v1.2.
  1422.        o ReeveSoft's Freeze for Windows v1.0.
  1423.        o CP/M Squeeze (SQ, SQPC). (Single files.)
  1424.      * o Squeeze-It! (SQZ) v1.08.3E.
  1425.      * o StuffIt! (Mac).
  1426.        o Unix TAR.
  1427.      * o Zip (PKZIP, Info-Zip).
  1428.      * o Zi-Lite (aka ZPACK) v2.20.
  1429.        o Zoo v2.10.
  1430.  
  1431.       QAZ can recognize but cannot list the following formats because
  1432.       the files are compressed, encoded or encrypted:
  1433.  
  1434.        o Diet v1 (Resident, Single files.)
  1435.        o KBoom v1.1. (Single files.)
  1436.        o MiscroSoft COMPRESS v2.00. (Single files.)
  1437.        o PackIt! (Mac).
  1438.        o Pretty Good Privacy (PGP) v2.
  1439.        o Slim (Resident, Single files.)
  1440.        o UltraCompressor II.
  1441.        o Unix Compress (COMPRESS, ZCOMP, EZCOMP) v4.1. (Single files.)
  1442.        o Unix Freeze v2 (Single files.)
  1443.        o UU-Encoded with the /VT option.
  1444.        o XX34-Encoded with the /VT option.
  1445.  
  1446.       QAZ can recognize the following text-encoded (usu. for E-Mail)
  1447.       file formats if the /VT option is used.
  1448.  
  1449.        o AR7 (E-Mailable form of AR.)
  1450.        o BinHex 4.0 (Mac).
  1451.          Archive formats that can be listed from within BinHex:
  1452.           - Compact Pro.
  1453.           - DoubleDisk.
  1454.           - StuffIt!.
  1455.           - All SEA (Self-Extracting Archive) versions of the above.
  1456.        o PGP-Armored Messages (Not nec. encrypted.)
  1457.        o UUENCODE
  1458.        o XX34 v01
  1459.  
  1460.       QAZ can recognize some of the following disk-image formats
  1461.  
  1462.      * o Disk Express (DXP and DSKEXP).
  1463.      * o Disk Image (DIM) v1.4.A
  1464.        o Disk Squeeze v3.00.
  1465.        o IMG v2.0B.
  1466.  
  1467.       QAZ can recognize some of the following graphics file formats:
  1468.  
  1469.        o BMP
  1470.      * o GIF87a and GIF89a
  1471.        o PCX
  1472.  
  1473.       * Some self-extracting forms are recognized.
  1474.  
  1475.       Previous versions of QAZ had a uselessly detailed list that made
  1476.       the number of archivers QAZ could handle look inflated.  This
  1477.       format gives a more realistic account of what QAZ can handle.
  1478.  
  1479.  
  1480. [6.2] What's new about this version of QAZ? (Detailed)
  1481.       ====================================================================
  1482.  
  1483.       The following changes were made since the release of QAZ v2.29ß:
  1484.  
  1485.         o Added /FE option for multicolor ANSI displays.
  1486.  
  1487.         o Rewriting most of the documentation: it really needed it!
  1488.  
  1489.         o Changed Uppercase function to conform to the system's native
  1490.           country settings.
  1491.  
  1492.         o Added recognition of Mac DoubleDisk archives.
  1493.  
  1494.         o Improved handling of Compact Pro archives.  Added recognition of
  1495.           self-extracting StuffIt! and Compact Pro archives.
  1496.  
  1497.         o Added /FE option to enable multi-color ANSI listing for BBS.
  1498.  
  1499.         o Added on-line quick reference screen(s).  Use: QAZ /? (or in
  1500.           DOS 5.0: HELP QAZ)  to view.
  1501.  
  1502.         o QAZ checks the CRC of BinHex files.
  1503.  
  1504.       The following changes were made since the release of QAZ v2.21a:
  1505.  
  1506.         o QAZ can now handle more than 32 filespecs (although in most cases
  1507.           this limit would never have been reached).
  1508.  
  1509.         o Fixed a bug reading certain ZIP files with large 'extra-fields'.
  1510.  
  1511.         o Added recognition of some text-file archive formats (using the
  1512.           /vt option).  Added the ability to decode and list BinHex 4.0
  1513.           and AR7 files.
  1514.  
  1515.         o Added 'flagging' of encrypted files within archive, if detected.
  1516.           Also will note if an archive contains encrypted or authenticated
  1517.           files, if possible.
  1518.  
  1519.     o Added /vn option. Improved /v2,/v3 option for extended attrib-
  1520.           utes.  Added /vc option (works only for ARC, ARJ, GZIP & ZIP
  1521.           archives--notes that comments are encoded for SQZ and HPACK
  1522.           files).  Added /vb and /vd options to (not) view date/time.
  1523.  
  1524.     o Added /fc option to cut off filenames that are larger than 22
  1525.           characters (i.e. they don't fit in the /v1 mode): they are
  1526.           flagged with a '[+]' at the end of the filename.
  1527.  
  1528.     o Fixed bug with /s option (exact size).
  1529.     
  1530.     o Fixed bug with /d option for archives where the date/time is
  1531.           undefined (AR, LAR, BinHex).
  1532.  
  1533.     o Added recognition of archives with authentication information
  1534.       or encrypted files (ARJ, GZIP, HPACK, Codec3, and ZIP).
  1535.     
  1536.     o QAZ can handle archives with more files than before.
  1537.     
  1538.     o Added recogniztion of LArc (.LZS) files and Mac "StuffIt!" (.SIT)
  1539.           files.
  1540.     
  1541.     o Improved handling of HPACK archives.
  1542.     
  1543.     o Better recognition of ZIP files.  No longer confused with certain
  1544.       font files.
  1545.     
  1546.     o Scrapped the filename validation scheme for a 'smarter' method.
  1547.     
  1548.     o The problem that caused QAZ to crash or go into infinite loops 
  1549.       or halt with a funtime error with certain weird files (espec-
  1550.       ially when doing a recursive scan) was fixed.
  1551.     
  1552.     o Breaking out of a recursive scan (either because of a user-
  1553.       break or a runtime error) leaves the user in a different
  1554.       directory in v2.21a.  Changing directories was unncecessary.
  1555.  
  1556.     o /ue+ option doesn't work? Wrong!  Configuring with vague {}
  1557.       sets like .{}z and .{h}p{a}k might be showing off, but it
  1558.       loosens things a bit: .{}z would accept _anything_, and
  1559.       .{h}p{a}k would accept .bak (why?).
  1560.  
  1561.         o Added /us option (use standard extentions) and /ux (if file
  1562.           is found, but not in an archive) options.
  1563.     
  1564.     o QAZ recognizes ARC files with the date undefined.
  1565.     
  1566.     o Improved recursive searching routines.  Apparently QAZ had
  1567.       orphaned some memory when it _wasn't_ recursively searching.
  1568.       Not a major problem.  (Fixed in 2.21a)
  1569.     
  1570.     o Goof in the filename validation scheme bigtime.  QAZ wasn't
  1571.       able to read HPACK archives because of it. (Fixed in 2.21a)
  1572.  
  1573.     o Memory-conservation scheme also muffed up filespec searching
  1574.       with Zi-Lite archives. (Fixed in 2.21a)
  1575.       
  1576.       The following changes were made since the release of QAZ v2.10c:
  1577.  
  1578.     o Removed the /t and /p options.  (The /e option was removed after 
  1579.       QAZ v2.00).  Use the |more pipe as a substitute for the /p 
  1580.       (Page Break) switch.
  1581.  
  1582.     o Added the /t option to view directory trees, similar to the 'tree' 
  1583.       command in DOS.  It is _not_ the same as the old /t option!
  1584.  
  1585.     o Added the /r option to return the identified archive type as an 
  1586.       exit code for other programs to use.
  1587.             
  1588.     o Added multiple levels and viewing options to the /v switch.
  1589.  
  1590.     o Option(s) to sort by compressed size (/oc) and compression 
  1591.       ratio (/or) were added.
  1592.  
  1593.     o Added the /d and /s options to view files between specified
  1594.       dates and-or times.
  1595.  
  1596.     o Default options may be set in the QAZCMD environment variable, 
  1597.       similar to the way the DIRCMD variable is set for 'dir'.
  1598.  
  1599.     o Added the use of 'extended' wildcards for search-specificatios, 
  1600.       including sets and substrings. QAZ can also handle non-DOS file-
  1601.       names (Unix, Amiga) better.
  1602.  
  1603.     o QAZ determinates the system's default characteristics, including 
  1604.       the SwitchChar and Country Code information do that it adapts it-
  1605.       self to the user's native settings.  (Can be changed with new 
  1606.       /f switch.)
  1607.  
  1608.     o Added time-zone adjustment for archives that use it (HA, LHA 
  1609.       type-2, DWC, and others).  Can be set through the TZ variable 
  1610.       or the new /z switch.
  1611.  
  1612.     o Fixed bug in converting Unix-style dates that occurs for dates 
  1613.       after December 26, 1993.
  1614.  
  1615.     o Fixed bug: QAZ now traps invalid directory paths.
  1616.             
  1617.     o Recognition of HYPER archives other than v2.6 (Other versions 
  1618.       were mistaken recognized as ARC v6).
  1619.             
  1620.     o Fixed some bugs with HPACK archives.  QAZ can ignore invalid 
  1621.       filespecs, and can handle subdirectories and comments, as well 
  1622.       as authenticated or encrypted archives better. (Older versions 
  1623.       of QAZ would crash the system when used on some HPACK archives).
  1624.             
  1625.     o Bug where filespecs were reset when viewing multiple archives 
  1626.       was fixed.
  1627.  
  1628.     o Added recognition of LHA Types-1 and -2 archives.
  1629.             
  1630.     o Added recognition of DWC, ReeveSoft Freeze (.ICE), JRchive, 
  1631.       Knowledge Dynamics' LIF, PAK, QEZ, TAR, Codec3, and UC2 arch-
  1632.       ives.  (Note Codec files would be flagged as 'CP/M Squeeze' 
  1633.       in previous versions of QAZ.)
  1634.             
  1635.     o Added recognition of various disk-image file types (including 
  1636.       "Disk eXPress", IMG, and DSQ).
  1637.             
  1638.     o Added recognition of Slim, KBoom and MicroSoft COMPRESS files.
  1639.  
  1640.     o Added processing of GNU-Zip format:  QAZ will now display original 
  1641.       file information on GZIP'd files.
  1642.  
  1643.     o Added processing of CP/M Squeeze format:  QAZ will display the 
  1644.       original filename.
  1645.             
  1646.     o QAZ attempts to distinguish between 'dialects' (such as LHA, IMG, 
  1647.       AR, & SAR; or ARC & PAK, which have similar formats).
  1648.             
  1649.     o Much code-rewriting, 'modularizing', et cetera.
  1650.             
  1651.     o The display is somewhat changed. 
  1652.     
  1653.     o The 'guilty' parameter in unrecognized options is flagged.
  1654.  
  1655. [6.3] Problematic files and known "bugs"
  1656.       ====================================================================
  1657.  
  1658.       Some files are not recognized by QAZ due to certain technical limit-
  1659.       ations.  Other types might not be processed properly because in many 
  1660.       ways QAZ is a hacked-kludge for certain formats for which I have no 
  1661.       documentation for.  Another obvious technical limitation is that
  1662.       .tar and .lar arcvhies which are compressed cannot be viewed.
  1663.  
  1664.       Problems noticed since QAZ v2.21a:
  1665.     
  1666.         o QAZ requires a MacBinary header to identify Compact Pro (.CPT)
  1667.           files.
  1668.  
  1669.     o Using the /E+ option on an entire hard disk which contains a
  1670.       multitude of strange files (using '*.*' as the search spec
  1671.       for the archiver) risks causing some problems for QAZ.
  1672.     
  1673.       Problems known about since QAZ v2.10:  
  1674.     
  1675.     o Multiple extention fields are flakey.  'foo.tar.Z' will match
  1676.           '*.tar.Z' but not '*.Z'.
  1677.  
  1678.     o Self-extracting archives made with ComPack cannot be viewed, 
  1679.       since they are essentially an uncompressed SFX-archive that is 
  1680.       compressed with an executable-file compressor. (Added to this 
  1681.       is that ComPack'd executables will crash my system anyway.)
  1682.  
  1683.     o Self-extracting GIFs made with Graphics WorkShop do not have a 
  1684.       GIF header.  It would take quite a bit of hacking with many 
  1685.       versions of GWS to add this ability.
  1686.             
  1687.     o Some Amiga LArc files (with an .LHA extention) do not seem to 
  1688.       conform to the LHArc standard, and thus QAZ will gag on them and 
  1689.       give a message that the archive is either corrupted or incom-
  1690.       patable.
  1691.  
  1692.     o Some HPACK archives may not be properly processed. Only HPACK 
  1693.       Level 1 archives are supported. Authenticated HPACK files, or 
  1694.       files from some non-DOS systems may not be properly processed 
  1695.       (such as with EBCDIC or UniCode filenames).
  1696.  
  1697.     o File date/time stamps in CP/M Libraries will not be shown. That's
  1698.       because the version I have does not support them. (Pending some
  1699.       documentation or a newer version or LAR or LU...)
  1700.  
  1701.     o Time-Zone conversion is weird for archivers that are weird about 
  1702.       it.  My copy of TAR assumes that it is always PST, and JRchive 
  1703.       and sometimes Codec seem to adjust for GMT-4. QAZ always assumes
  1704.       the TZ adjust-ments are correct.
  1705.  
  1706.     o I have been told that some 256-color GIFs are incorrectly noted 
  1707.       as having less colors.  I have not found this problem with my 
  1708.       GIF collection.
  1709.  
  1710.     o New features being added to QAZ are detection of multipartate 
  1711.       archives and the /v2 option of viewing file attributes, host 
  1712.       operating systems, etc. They are essentially undocumented 'beta' 
  1713.       features, so do not rely on them for this version of QAZ.
  1714.             
  1715.     o QAZ does not support overlayed or interlaced GIFs, (at least not 
  1716.       very well).
  1717.  
  1718. [6.4] Formats _not_ (yet) supported by QAZ
  1719.       ====================================================================
  1720.  
  1721.       Some archive formats just have no discernable header or trailer
  1722.       data to indicate their format--only a filename, if that. Other
  1723.       formats, due to certain technical limitations, cannot be identified
  1724.       (or if id'd, not listed).  Generally most are meant more as demon-
  1725.       strations of compression algorithms than as allpurpose archiving utilities.
  1726.               
  1727.       Thus, the following compression utilities are not (yet?) supported
  1728.       by QAZ:
  1729.  
  1730.     Archiver   Ext    Version  Comments
  1731.     --------   ---    -------  --------
  1732.     GAS       .GAS     2.0
  1733.     LZ                         Pascal version of LZHUFF
  1734.     LZARI
  1735.     LZHUFF                     
  1736.     LZSS
  1737.     LZCOMP             1,2,3
  1738.     RLE8      .R8
  1739.     RLE16     .R16
  1740.     UUENCODE  .UUE             Only superficially recognized.
  1741.     XX34      .XX              Only superficially recognized.
  1742.  
  1743.       Future versions of QAZ may give the ability to view archives that
  1744.       are UU- or XX-Encoded.
  1745.  
  1746. [6.5] Exit codes returned using the /R option
  1747.       ====================================================================
  1748.  
  1749.       When using the /R option, QAZ will return an exit code indicating the
  1750.       file type.  External programs (such as batch files) can use this 
  1751.       information to determine what utilities to use on the file.
  1752.  
  1753.       The following is a list of the return codes:
  1754.  
  1755.       
  1756.     Code            Meaning (or archive type)          QAZ Version
  1757.     ----            ------------------------           -----------
  1758.       0             Unknown file type
  1759.       1             An error has occured (possibly a bad archive)
  1760.       2             Memory overflow
  1761.  
  1762.      15           * Unidentified/Miscellaneous (Reserved)
  1763.      16             Possibly an ASCII (7-bit) text file
  1764.  
  1765.      17             AR v0.02 (Use AR or LHA-compatable)
  1766.      18             AR7                                - QAZ v2.29
  1767.      19             ARC
  1768.      20             ARJ
  1769.      21             Compress (Unix)
  1770.      22             Compact Pro (Mac .CPT)             - QAZ v2.29
  1771.      23             Central Point Shrink (CPSHRINK)
  1772.      24             Diet v1
  1773.      25             DWC
  1774.      26             MiscroSoft Compress (Use EXPAND)
  1775.      27             Freeze v2 (Unix)
  1776.      28             GNU-Zip
  1777.      29             HA
  1778.      30             Hamarsoft HAP
  1779.      31             Hyper
  1780.      32             HPACK                              - QAZ v2.21a
  1781.      33             ReeveSoft Freeze v1.0 (for Windows)
  1782.      34           * (Reserved) 
  1783.      35             KBoom v1.1
  1784.      36             CP/M Library File (Use LAR, LU/LUE)
  1785.      37           * LArc (Amiga .LHA)
  1786.      38           * Knownledge Dynamics .LIF File
  1787.      39             LHArc
  1788.      40             PAK
  1789.      41             PGP-Encrypted (.PGP)
  1790.      42             PackIt (Mac .PIT)                  - QAZ v2.29a
  1791.      43           * PUT (Use LHA-compatable)
  1792.      44             Queasy (.QEZ)
  1793.      45             SLIM
  1794.      46             StuffIt! (Mac .SIT)                - QAZ v2.29
  1795.      47             Squeeze-It! (.SQZ)
  1796.      48             UltraCompressor II (.UC2)          - QAZ v2.21
  1797.      49             CP/M Squeeze (SQ)
  1798.      50             ZIP
  1799.      51             ZOO
  1800.      52             Zi-Lite/ZPack (Usu. SFX)           - QAZ v2.21a
  1801.      53             TAR
  1802.      54             SAR
  1803.      55             Codec3                             - QAZ v2.21
  1804.      56             JRchive                            - QAZ v2.21
  1805.      57             LArc (Use LHA to decompress)       - QAZ v2.29
  1806.          58             BinHex 4.0                         - QAZ v2.29
  1807.          59           * Mac Self-Extracting Archive
  1808.          60             Mac DoubleDisk Archive             - QAZ v2.29a
  1809.  
  1810.     128             BMP Graphics
  1811.     129             GIF    "
  1812.     130           *        "     (Reserved)         
  1813.     131           * JPEG   "
  1814.     132             PCX    "
  1815.     133           * TARGA  "  
  1816.     134           * TIFF   "
  1817.  
  1818.     255             Syntax Error (Bad Option)
  1819.  
  1820.       Note: Formats marked with an asterisk (*) are reserved for future 
  1821.         versions of QAZ.  Formats marked with a version number are
  1822.             not returned by earlier versions of QAZ.
  1823.               
  1824.       StuffIt! or Compact-Pro files encoded with BinHex should return an
  1825.       exit code for BinHex.
  1826.  
  1827.       To suppress output using the /r switch, one can do either of the
  1828.       following:
  1829.               
  1830.         QAZ archname /R /VQ ^*
  1831.     QAZ archname /R /VQI
  1832.     QAZ archname /R > NUL
  1833.  
  1834.       For an example of how to use the /r switch from a batch file, look 
  1835.       at the included file UNQAZ.BAT. This file uses QAZ to identify the 
  1836.       archive type and then attempts to unarchive the file.
  1837.  
  1838.       UNQAZ is only a barebones prototype for DOS, and requires a bit of 
  1839.       tweaking and improvement.
  1840.  
  1841. [6.6] Future Additions to QAZ
  1842.       ====================================================================
  1843.  
  1844.       Aside from newer versions of existing archives (including SFX), 
  1845.       QAZ may also add support for the following archive types, as 
  1846.       information and/or requests come:
  1847.  
  1848.      Ext  Archive Name(?)            Host Operating System(s)
  1849.      ---  ----------------           ------------------------
  1850.         .CMP   Comp-2                     Unix/DOS
  1851.            Compact                    Unix/DOS
  1852.                Disk Expander (?)          Mac
  1853.            Kvetch
  1854.     .LHA   LArc  (?)                  Amiga*
  1855.     .LIM   Limit  1.0                 DOS
  1856.     .LZRW  LZRW2  (?)                 Unix
  1857.     .MD    MD (?)
  1858.     .PIT   PackIt                     Atari/Mac
  1859.     .PP    Power Pack                 Amiga
  1860.     .SEA   Self-Extracting Archive    Mac
  1861.            Shrink                     Unix/DOS
  1862.            Stowaway
  1863.         .UC2  UltraCompressor II          DOS
  1864.     .Y     Yabba                      Unix/DOS
  1865.  
  1866.       * QAZ Amiga .LHA files as LHARC (which they are), though they seem
  1867.     to differ from the standard enough to cause an error.
  1868.  
  1869.       Other file types, including graphics formats like JPEG, Targa, TIFF,
  1870.       may also be added, as well as the ability to read and list UUEncoded,
  1871.       XX34 and PGP-Armored archive or graphics files.
  1872.  
  1873.       A special option used with the /R switch to determine if an id'd
  1874.       file contains authentication info, encrypted/passworded files etc.
  1875.       is another possible addition.
  1876.  
  1877.       Options to manually set the country-code used by QAZ will also be
  1878.       added, once I am able to get the appropriate DOS functions to work 
  1879.       (I think there may be bugs in all DOS versions before 6.0 where this 
  1880.       function does not work properly).
  1881.  
  1882.       Other plans for the future are converting QAZ to C/C++ (all 200k+
  1883.       worth of source-code), more optimization and porting QAZ to other
  1884.       environments (like Amiga, or Unix) are in the works.
  1885.  
  1886. [7.0] Contacting the author
  1887.       ====================================================================
  1888.  
  1889.       If you have any questions, comments, suggestions, bug-reports or
  1890.       contributions, you can attempt to reach me at one of these locations
  1891.       electronically:
  1892.  
  1893.     Internet: robert.rothenburg@asb.com
  1894.                   robert.rothenburg@woodybbs.com
  1895.  
  1896.         Rime: ->5190
  1897.  
  1898.        Snail: Robert Rothenburg Walking-Owl
  1899.           P.O. Box 1327
  1900.           Stony Brook, NY 11790 (USA)
  1901.  
  1902.       (Public-Key available from keyservers.)
  1903.  
  1904.       If you write any utilities which make use of QAZ, please send me
  1905.       a postcard or message.
  1906.  
  1907.  
  1908. [7.1] Thanks and acknowledgements
  1909.       ====================================================================
  1910.  
  1911.       A partial listing of people who've beta-tested, commented on,
  1912.       contributed information or replied to my requests:
  1913.  
  1914.         Timm Erickson
  1915.         Hari Hirvola
  1916.         Joe Jerszynski
  1917.         Todd Kempf
  1918.         Joe Negron
  1919.         Brian Niegocki
  1920.         Walter Scott
  1921.         Jorj Strumolo
  1922.         Nico de Vries
  1923.  
  1924.