home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 24 / CD_ASCQ_24_0995.iso / vrac / wiz34.zip / WIZ.DOC < prev    next >
Text File  |  1995-07-20  |  31KB  |  830 lines

  1.  
  2.                 WIZ version 3.4
  3.                by Ray Van Tassle
  4.                1020 Fox Run Lane
  5.              Algonquin, Ill, 60102
  6.                 (708)-658-4941
  7.             internet email: rayvt@comm.mot.com
  8.                      July 20, 1995
  9.  
  10.     WIZ program and manual copyright(c) 1990-1994 by Ray Van Tassle.
  11.  
  12.     Abstract:
  13.     WIZ is a lightning-fast file finder. It will find file(s)
  14.     based on full wildcard specifications (more powerful than
  15.     standard DOS wildcard), and can also filter by file size
  16.     and date.  It can:
  17.        * select only executable files (EXE, COM, BAT).
  18.        * select only archive files (ZIP, ARC, etc.)
  19.        * switch you to the disk\directory of a file that it found.
  20.        * execute a DOS command for each file it finds.
  21.        * look inside archives (ZIP, LZH, & ARJ)
  22.        * recursively look inside archives!
  23.        * Correct handling of the special files/directories created and
  24.          maintained by STACKER, DoubleDisk, DoubleSpace, DriveSpace,
  25.          Norton FILESAVE, and PCTOOLS DATA Sentry.
  26.  
  27.     It will look on multiple disk drives for all matching
  28.     filenames.  You can pre-specify several default lists of
  29.     disk drives for it to search.
  30.  
  31.  
  32.     WIZ program and manual copyright(c) 1990-1994 by Ray Van Tassle.
  33.  
  34.     WIZ is shareware, NOT freeware!!!
  35.  
  36.     You are granted a limited 21 day evaluation license. At the end
  37.     of that period, you should either delete it and stop using it,
  38.     or send in the registration fee of $20 ($15 if you don't want me to
  39.     send you a disk).
  40.  
  41.  
  42.  
  43.     MANUAL
  44.     ------
  45.     I was tempted to call this program YAFF (yet another file
  46.     finder), but I settled on WIZ.  This is a funny acronym for
  47.     "where is". But it's also short for WIZARD, because it's so
  48.     fast it seems like magic, and it's filename matching is so
  49.     powerful.
  50.  
  51.     It looks on one or more disks for all filenames (including
  52.     directories) that match the specified filename. By default, it
  53.     starts on drive C, and goes up until it runs out of disks.
  54.  
  55.     It has been tested, and works, with DOS 3.x, including Zenith
  56.     DOS 3.30, DOS 3.31, DOS 4.01, DOS 5.0, DOS6.2, Windows 95,and 
  57.     On-Track partitioning software.  DOS 3.31+ have large
  58.     (greater than 32MB) partitions with more than 65,536 sectors.
  59.     Zenith DOS 3.30 and On-Track have large partitions by virtue of
  60.     using large sectors (1024, 2048, or 4096 bytes, rather than
  61.     512 bytes).
  62.  
  63.     WIZ normally prints out, for each matching file, the filename,
  64.     date, time, size, and path.  The files are NOT ordered or
  65.     sorted.  All "special" files (hidden, system) are
  66.     flagged with a left-pointing triangle after the filename.
  67.     Optionally, it will list the files in normal fully-pathed form
  68.     (e.g., C:\UTIL\PGMS\ABC.BAT), suitable for processing by a
  69.     program which expects normal filenames.  When the found file
  70.     is inside an archive (-l flag), it will be listed in a form
  71.     suitable for the archiver (e.g.,
  72.     "C:\UTIL\PGMS\FOO.ZIP FILE.EXE")
  73.  
  74.     I deemed that most of the time, people (including me) want it
  75.     to be FAST, rather than in some particular order.
  76.     As WIZ reads the disk, it tries to optimize the head
  77.     motion, so directories are not processed in order of path, but
  78.     in the order that WIZ thinks will be quickest.  However, it will
  79.     generally look at the files in a directory before it looks at
  80.     the sub-directories.  However (especially if you have
  81.     directories with lots of files and sub-directories), it may
  82.     show some files in a directory, then show sub-directories, then
  83.     show more files in the directory.
  84.  
  85.     WIZ will ignore STACKER, DUBLDISK, DRVSPACE, and DBLSPACE container 
  86.     files in the count of files & MB's scanned.  This file has 
  87.     attributes of RHS, and is named "STACVOL.0??", "DUBLSPAC.0??", 
  88.     "DBLSPACE.0??", or "DRVSPACE.0??"
  89.     
  90.     Likewise, WIZ will ignore the special hidden directories where
  91.     Norton's "FILESAVE" and PCTOOLS "DATAMON/SENTRY" move files that
  92.     have been deleted.  These tools & their directories are a super
  93.     undelete, and they are reported by DOS to have been deleted, but
  94.     the respective utilities really just have them tucked away in a
  95.     hidden place.  So WIZ treats these files as not being there, too.
  96.     
  97.  
  98.  
  99.     PERFORMANCE & Comparison with other file-find programs
  100.     ------------------------------------------------------
  101.     Some tests, run on a 486/33mhz, searching for a non-existent
  102.     file on a large disk partitioned into drives C thru J,
  103.     17,000 total files, 747MB in files, in 572 directories.
  104.  
  105.     WIZ 3.1        Target15    FFF45    Seek202
  106.     -------        --------    -----    -------
  107.     19.1        83.3        53.1    47.3       No cache
  108.     
  109.        The command used were:
  110.         WIZ c-j:*qwe*
  111.         TARGET -e -hidden cdefghij: "qwe"
  112.         FFF /e cdefghij: ".*qwe.*"
  113.         SEEK cdefghij:qwe*.* 
  114.     
  115.        Notes:
  116.         TARGET claims to have real regexp's but they aren't.
  117.         FFF appears to have real regexp's.
  118.     
  119.  
  120.     When used with a disk cache, of 2MB (2048K).
  121.  
  122.     WIZ 3.1        Target15    FFF45    Seek202
  123.     -------        --------    -----    -------
  124.     18.7        44.3        40.2    41.5    PC-CACHE v6.01
  125.      1.3        16.3         8.3    13.0     " 2nd command
  126.  
  127.     19.7        37.4        30.2    ?    SMARTDRV v5.0
  128.     19.5        37.8        29.8    ?     " 2nd command
  129.  
  130.     19.7        83.3        50.9    ?    HYPER386 v4.65 
  131.     16.1        53.5        36.7    ?
  132.  
  133.        The first line is just after clearing the cache.
  134.        The next is running the same command again, giving maximum 
  135.        advantage to the cache. In my testing, I have found that PC-CACHE 
  136.        seems to provide the best all-around performance.
  137.        In fact, with WIZ, SMARTDRV actually takes longer!!  Starting with 
  138.        WIZ v2.9, it momentarily disables SMARTDRV while it scans a disk.
  139.        
  140.  
  141.     ERRORLEVEL exit codes
  142.     ---------------------
  143.     0 = Normal exit.
  144.     1 = Normal exit. -g changes disk/path
  145.     2 = Bad command line.
  146.     255 = Internal error.
  147.  
  148.  
  149.     Error Messages
  150.     --------------
  151.     "INVALID directory:"
  152.         Encountered what appears to be an illegal directory
  153.         entry.  This is a clue for a corrupted disk, or a file
  154.         which is NOT a directory masquerading as one.
  155.  
  156.         "Can't tell if FAT-12 or FAT-16. Assuming FAT-16!"
  157.         Just what it says.  I've only seen this on networked
  158.         disk drives.  If you know how to RELIABLY tell what
  159.         type of FAT a disk has (other than going thru DOS),
  160.         please let me know.
  161.  
  162.     "malloc failed for FAT_buf!"
  163.         Can't allocate memory to read a FAT block.  Most
  164.         likely an internal error.
  165.  
  166.      "malloc failed for dir_sec_buf!"
  167.         Can't allocate memory to read in a directory sector.
  168.         Most likely an internal error.
  169.  
  170.     "Sorry, out of memory!!!"
  171.         You lose.
  172.  
  173.     "Can't open file:"
  174.         Failure to open an archive file.  Most likely a disk
  175.         error. Run CHKDSK.
  176.  
  177.     "Internal error in ZIP/LZH/ARJ file"
  178.         The data read from in archive file isn't as expected.
  179.         Most likely the archive has a new format, and WIZ
  180.         hasn't yet been updated.  'Course, the archive file
  181.         may be corrupted.
  182.  
  183.     "INVALID directory"
  184.         A sub-directory (whose name is displayed) is not valid.
  185.         Your directory structure has been corrupted.  You should
  186.         run a utility to fix it--Norton NDD or PC-TOOLS DISKFIX.
  187.  
  188.     "Can't recurse in this!"
  189.         The archive file cannot be recursively searched, because
  190.         it is compressed.
  191.  
  192.     NETWORK DRIVES
  193.     --------------
  194.     WIZ has been tested, and runs ok under several networks: 
  195.     Pathworks (Digital Equipment Corp), $25Network (Information Modes),
  196.     EBOX (Rupp).
  197.     Version 2.7 works on Novell, Lantastic, and other networks.
  198.  
  199.     CD-ROMS
  200.     -------
  201.     WIZ works on CD-ROM's.
  202.  
  203.     BUGS
  204.     ----
  205.     No known bugs.  However, WIZ mostly does not use DOS to
  206.     process a disk, so errors on my part, or a change in the disk
  207.     structure might break it.  The most major bug reported was on
  208.     huge disk partitions under MS-DOS 4.01.  This bug caused WIZ
  209.     to read a random block from the disk, and treat it as a
  210.     directory.  It made a valiant attempt to march down all the
  211.     phony sub-directories, and would actually run for quite a
  212.     while before printing one of the "malloc failure" messages.
  213.  
  214.     If you are having problems, try 1) use the "-v" switch, to
  215.     isolate the error to a specific disk,  2) use "-vv", to see
  216.     as it hits each sub-directory,  3) use "*.*" to see all the
  217.     files, and watch until it walks off the edge of the world.
  218.     Then call or write me.
  219.  
  220.  
  221.     Command Line format and Switches
  222.     --------------------------------
  223.  
  224.     WIZ [disks:]file_pattern [-sN] [-dN] [-p] [-pp] [-gN] [-x] [-mN] 
  225.         [-e] [-qS] [-n] [-4]
  226.         [-a] [-v] [-l[b][l]]  [-cS] [-?] [>output-file-name]
  227.  
  228.     As usual, the stuff inside the square brackets "[]" are
  229.     optional and may be present or omitted. You do NOT include
  230.     the brackets in your command line.
  231.     The various fields and options may appear in any order, in
  232.     either upper or lower case.
  233.     The switch character can be either "-" or "/".
  234.  
  235.     You can have more than one set of "[disk:]pattern", and it
  236.     does the correct thing. That is, it scans each set in turn.
  237.     So you can say: "WIZ c:pyro* cd:*.cfg *.ovr".
  238.  
  239.     In order to fix a possible usage mistake (and to follow the syntax
  240.     of other filefind programs), WIZ will accept a space between the ":"
  241.     and the pattern.  So, "WIZ c:pyro" acts the same as "WIZ c: pyro"
  242.  
  243.     Except for size (-s) and date (-d), the options may be run
  244.     together.
  245.     For example: "WIZ -g20xp"   is the same as  "WIZ -g20 -x -p".
  246.  
  247.  
  248.  
  249.     If you just invoke WIZ without any parameters, it gives you a
  250.     brief help line.  For more info, include '-?'.  For even more,
  251.     include '-??'.
  252.  
  253.     If you leave out a pattern, but do have switche(s), WIZ assumes
  254.     that you want a pattern of "*".
  255.  
  256.     Disk(s): & filename_pattern
  257.     ---------------------------
  258.     1) [disks:]pattern
  259.     2) pattern
  260.     3) :pattern
  261.  
  262.     With format 1, you specify the disk(s) you want it to look at,
  263.     followed by ":".  It will look at those drives, in the order
  264.     you listed them.  If you list the same one twice, it will look
  265.     at it twice.  You can specify a range of disks by using a
  266.     dash--"C-F" is the same as "CDEF".
  267.  
  268.     With format 2, it will look at all drives beginning with C. It
  269.     will stop when it hits a drive that it cannot read.
  270.  
  271.     With format 3, it will look at all drives beginning with A. It
  272.     will stop when it hits a drive that it cannot read, except A &
  273.     B.  If the floppy drive has a disk in, it will look at it,
  274.     otherwise it will ignore the floppy drive.
  275.  
  276.     If you have only one floppy drive, WIZ will check to see if DOS
  277.     last used it as A or B, and will skip the other drive letter
  278.     (B or A).
  279.  
  280.     You do not (and cannot) specify path or directory names,
  281.     because WIZ searches an entire disk.
  282.  
  283.  
  284.     Processing Disk(s) and Environment Variable
  285.     -------------------------------------------
  286.     You can over-ride the disks that WIZ looks at, and their
  287.     order, by making an environment variable "WIZ".  Do:
  288.     "SET WIZ=floppy-disk-list:hard-disk-list". Example:
  289.     "SET WIZ=AB:C-M".  What actually happens is that WIZ will
  290.     try to read all the disks to the left of the colon, then all
  291.     those to the right of the colon.  Those on the left are
  292.     deemed to be floppies, and it will keep going if it can't
  293.     read one.  Those on the right are deemed to be hard drives,
  294.     and it will quit on the first one that it can't read.
  295.     
  296.     You may omit the "default" disk set by leaving a space after
  297.     the "=".  This is most useful when you need only to put the
  298.     "/M" switch, as: "SET WIZ= /M".
  299.     
  300.     
  301.     If you specify disks on the command line, it will try to read
  302.     them all, even if it can't read one.
  303.  
  304.     The list may be discontiguous, (e.g., "C-FL-M").  This is
  305.     mostly useful if you are on a network, which tends to make
  306.     the networked disks at the higher letters, and leaves a hole
  307.     before them.
  308.  
  309.  
  310.     Pre-defined Drive Sets
  311.     ----------------------
  312.     You can actually have several pre-defined sets of disks to
  313.     search. If the disk-specifier on the command line is a single
  314.     digit (0-9), it will look for that specifier in the WIZ
  315.     variable.  For example, you might say:
  316.         "SET WIZ=AB:C-F  1=CDEF 2=AB:  3=C-Z 4=C-Z:"
  317.  
  318.     As above, those to the left of the colon are deemed floppies,
  319.     and WIZ will keep going if it can't read one; those to the
  320.     right are hard drives, and WIZ will quit if it can't read one.
  321.     However, if there isn't a colon, then they are ALL deemed to
  322.     be hard drives.
  323.  
  324.     The command "WIZ z.z", will look on ABCDEF.
  325.     The command "WIZ 1:z.z", will look on CDEF.
  326.     The command "WIZ 2:z.z", will look on AB.
  327.     The command "WIZ 3:z.z", will look on all drives C-Z (and
  328.         will quit at the first on that it can't read).
  329.     The command "WIZ 4:z.z", will look on all drives C-Z (and it
  330.         will attempt to read each and every one of them).
  331.     The command "WIZ 9:z.z", will give an error message.
  332.  
  333.  
  334.  
  335.  
  336.  
  337.     PATTERN:
  338.     --------
  339.     I call it "pattern" rather than "filename", because WIZ
  340.     does a full pattern-match against the actual filenames it
  341.     reads from the disk.  The pattern has four special characters
  342.     (called meta-characters), plus all the other characters
  343.     possible in a filename.
  344.     (These are the same wildcard patterns as in 4DOS.)
  345.  
  346.     1)  "*" (star)
  347.     2)  "?" (question mark)
  348.     3)  "[" (square bracket)
  349.     4)  "." (dot),
  350.  
  351.  
  352.     1) "*"    This is the "rubber" wildcard meta-character.  The
  353.         star will match as many characters as possible, from
  354.         none to the entire filename.  It is "rubber", because
  355.         it will shrink & stretch to match as many characters
  356.         as required.
  357.  
  358.     2) "?"    This is the "single" wildcard meta-character.  It will
  359.         match exactly ONE character in the filename.
  360.  
  361.     3) "[...]" This will match any single character within the brackets,
  362.         including a range of characters.  For example:
  363.              [abcw-z] will match any of:
  364.             a or b or c or w or x or y or z
  365.         If the very next character after the "[" is a "!", then
  366.         it is inverted---this will match any character that 
  367.         is NOT specified.  For example:
  368.              [!aeiou] will match any character EXCEPT a vowel.
  369.  
  370.     4) "."  This is the "separator" meta-character (it is NOT a
  371.         wildcard character).
  372.         If you specify a dot in the pattern, the disk filename
  373.         (and the pattern) is treated as having two parts,
  374.         one before the dot, and one after the dot.
  375.         Each part undergoes it's own pattern matching.
  376.  
  377.     If you don't have any meta-characters in the filename pattern,
  378.     WIZ appends a "*" on the end of what you specified.
  379.  
  380.     Proper pattern matching (like WIZ does) is almost a D.W.I.M.
  381.     (do what I mean) operation.  DOS's wildcards are so primitive
  382.     that it is professionally embarrassing.  Not only that, but the
  383.     pattern-matching subroutine in WIZ is only a couple of dozen
  384.     lines of code.  And it's surprisingly fast.
  385.  
  386.     To give some examples:
  387.     *A*     means:
  388.         any file which has an A anywhere in it, on either side
  389.         of the dot.
  390.  
  391.     Z*    Any file that starts with a Z
  392.         (ZZBC.BAT    Z.Z)
  393.  
  394.     ?.    Any filename that has exactly one character in it, and
  395.         has no extent.  (A.   B.   but not    AB.   or A.BAT)
  396.  
  397.     ?*      Any filename that isn't totally blank.
  398.  
  399.     A*T    any file that starts with A and ends with T in the
  400.         extent. (ABCDE.BAT     A.T    AB.ERT but not ABCERT.)
  401.  
  402.     A*T.    any file that starts with A and ends with T, and
  403.         has no extent. (ABCERT.      but not ABCERT.RST)
  404.  
  405.     A*T.*    any file that starts with A and ends with T, whether or
  406.         not it has an extent.
  407.         (ABCERT.    ABCERT.RST    ABCDET.COM)
  408.  
  409.     A*B*Z.* any file that starts with A, then somewhere to the right
  410.         has a B, then ends with Z, and has any extent.
  411.         (ABZ.BAT    AMNOBPQRZ.   ABYXZ.COM)
  412.  
  413.     *.C    any file with an extent of C
  414.  
  415.     W*.C    any file that starts with W and has a C extent. (W.C
  416.         WIZ.C  WIZ14.C)
  417.  
  418.     W*4.C    any file that starts with W, ends with 4, and has an
  419.         extent of C.
  420.  
  421.     ???.C    any file that has exactly 3 characters in the name, and
  422.         an extent of C.
  423.  
  424.     Directories also participate in the filename matching.  A lot
  425.     of other whereis programs don't tell you about directory names
  426.     that match.  I find this annoying, because many times I can
  427.     remember the directory name (or at least part of it), but not
  428.     the file names.  This is especially true for things that I
  429.     have downloaded.  Since directories normally don't have an
  430.     extent (although they can), for matching purposes a directory
  431.     that does not have an extent is treated as if it has a blank
  432.     extent, so it has a dot.  But when it is printed out, this
  433.     implied dot isn't printed.
  434.  
  435.     POPDROP.  will match the directory name "POPDROP"
  436.           and the filename "POPDROP.", but not "POPDROP.COM"
  437.  
  438.     POPDROP.* will match all of the above
  439.  
  440.     POPDROP   will match all of the above, but also POPDROP2.COM
  441.           etc.
  442.  
  443.  
  444.  
  445.  
  446.     -s Size qualifier
  447.     -----------------
  448.     Files may be further filtered by their size. Either or both
  449.     minimum and maximum size may be specified. A file will match
  450.     only if it's size falls between the two limits, inclusive.
  451.     Note that a directory, while it is really a file, is not
  452.     considered to have a size, so directories will NEVER show up
  453.     if you give a size qualifier. This gives a way to never show
  454.     directories: just add "-s0".  All other files have a size
  455.     that is greater than or equal to zero.
  456.  
  457.     -s[low_limit][:hi_limit]
  458.  
  459.     -s100        Files that are 100 or more bytes large.
  460.  
  461.     -s:10000    Files that are 10000 or less bytes large.
  462.  
  463.     -s500:600    Files whose size is greater than or equal to
  464.             500 bytes, and less than or equal to 600 bytes.
  465.  
  466.     -s1000:1000    Files that are exactly 1000 bytes large.
  467.  
  468.  
  469.  
  470.     -d Date qualifier
  471.     -----------------
  472.     Files may also be filtered by date.  Either or both
  473.     lowest & highest date may be specified. A file will match
  474.     only if it's date falls between the two limits, inclusive.
  475.  
  476.     -d[low_date][:high_date]
  477.  
  478.     The format for date is MM/DD/YY or MM-DD-YY or "*" or "*-N".
  479.     The year can be given as either "91" or "1991".  
  480.     "*" means the current date.
  481.     "*-N" means "N" days before the current date.
  482.     
  483.     -d1/1/90    Files dated on or after Jan 1, 1990.
  484.  
  485.     -d:12-31-87    Files dated on or before Dec 31, 1987.
  486.  
  487.     -d1-1-90:12-31-1990  Files dated anytime in 1990.
  488.  
  489.     -d12/12/90:11/11/90  No files---it's impossible for a file to
  490.             be dated after Dec 12, 1990 and before
  491.             Nov 11, 1990 (inclusive)
  492.     -d*        Files dated today or after today.
  493.     -d:*        Files dated before today.
  494.     -d*:*        Files dated today only.
  495.     -d*-10        Files dated within the last 10 days.
  496.     -d*-365        Files dated within the last year (365 days).
  497.     
  498.  
  499.     -e    Extended precision in time display
  500.     ----------------------------------------
  501.     Displays seconds also in the date/time information.
  502.  
  503.     -4    Look at 4DOS file descriptions
  504.     ------------------------------------
  505.     Rather than looking at filenames, WIZ will look at the 4DOS
  506.     (and NDOS) file descriptions (found in a hidden file in
  507.     each directory, named DESCRIPT.ION).  The default without any
  508.     "?" or "*" in the pattern is changed to be "*pattern*", so that
  509.     it will find any occurance of the word(s) you give.
  510.     With this option, WIZ will just print the path, filename, and
  511.     description.  Date and size are not examined, so they can't be
  512.     used as a filter, and will not be printed.
  513.  
  514.     -n    Skip over network drives
  515.     ------------------------------
  516.     Many network drives can only be accessed in the "proper" way.
  517.     This slows down WIZ quite a bit.  This option will force WIZ to
  518.     omit any drive that it figures requires this slow access method.
  519.     Novell and Lantastic are two networks that will be slow.  
  520.     Little-Big-Lan (by Information Modes) is a great little lan that
  521.     allows WIZ to use it's fast access method.
  522.  
  523.     -p    List in canonical pathname format
  524.     ---------------------------------------
  525.     The matching files are listed in normal DOS format:
  526.         disk:\path\name.ext
  527.     If the "-l" flag ("look inside archives") is given,
  528.     the format is:
  529.         disk\path\archive-name.zip filename.ext
  530.  
  531.     Date, time, size are not given.  This type of list
  532.     is presumably going to be fed into a program as a
  533.     list of files, so directories will not be listed.
  534.     
  535.     -pp   List in pathname format, without header/trailer
  536.     -----------------------------------------------------
  537.     Same as "-p", except the header and trailer information
  538.     is omitted.  This is particularly useful when the output
  539.     is to be fed into another program, as a list of (only) matching
  540.     filenames.
  541.     
  542.     -q     Limit scan to certain path(s)
  543.     ------------------------------------
  544.     This will allow you to limit the search to certain directory
  545.     name(s).  The format is:
  546.             -qDIRECTORY-NAME
  547.       
  548.     If it starts with "\", then this is the path from the root.
  549.     If it doesn't, then this is the trailing part of the path.
  550.     If it ends with "\", then this is for all the subdirectories, too.
  551.     If it doesn't, then this is for only this directory, 
  552.     not any sub-directories.
  553.        
  554.     -qdos         Will scan files in "\dos",  "\abc\dos", but not 
  555.              "\abc\dos\xyz".
  556.     -q\dos         Will scan files in "\dos", but not "\abc\dos".
  557.     -q\abc\dos   Will scan files in "\abc\dos", but not "\dos".
  558.     -qdos\         Will scan files in "\dos", "\dos\abc", and 
  559.              "\abc\dos\xyz".
  560.     -qray\van    Will scan files in "\dos\ray\van", but not
  561.              "\dos\ray\xyz" or "\dos\ray\van\tmp".
  562.     -q\         Will scan only the root directory.
  563.  
  564.     
  565.     -g     Go to directory
  566.     ----------------------
  567.     This will change your path to the disk & directory of the
  568.     Nth file in the list of files that matched.  If you omit
  569.     N (or N is zero), it will ask you at each match if that is
  570.     where you want to go.
  571.  
  572.     If that file is a directory, WIZ will set the path to that
  573.     directory.  On the other hand, if it is a file, WIZ will set
  574.     the path to be the directory that the file is in.
  575.  
  576.     Obviously, if N is larger than the number of files that match,
  577.     nothing will happen.
  578.  
  579.     -g5    Will change to the path of the 5th listed file.
  580.     -g1    Will change to the path of the first listed file.
  581.     -g    Will ask you at each matched file if it should change
  582.         to the path of the listed file.
  583.  
  584.  
  585.     -x    Executable files
  586.     ----------------------
  587.     This switch will set a pre-filter, and select only executable
  588.     files (.BAT, .COM, .EXE) that pass the other filters (size,
  589.     date, pattern).  For this to work properly, the pattern should
  590.     either not have a dot, or terminate with ".*" (because this is
  591.     just an additional filter, albeit one with three holes).
  592.  
  593.     I added this because a lot of times I find myself looking for
  594.     a handy but seldom-used program, and I can never remember if
  595.     it's a COM or an EXE file.  And if I put "*FOO*.*", WIZ lists
  596.     everything, including the directory, DOC, README, etc.
  597.  
  598.  
  599.     -m    More (pause)
  600.     ------------------
  601.     Act like "MORE"--pause and wait for a key to be hit after each
  602.     screenful of lines have been displayed.  It checks how many
  603.     lines are actually displayed on the screen (25, 28, 43, 50, etc.)
  604.     You can give a number after the "m", and it will use that size
  605.     instead.
  606.  
  607.  
  608.     -a    Archive files
  609.     -------------------
  610.     This works just like "-x", except it's for archive files.
  611.     These are ZIP, ARC, LZH, ZOO, ARJ, PAK.
  612.  
  613.  
  614.     -v    Verbose
  615.     -------------
  616.     If you have this flag once, WIZ will print the disk name when
  617.     it starts as it starts on a disk.  If you have it twice
  618.     (-vv), it will also print the name of each directory as it
  619.     starts processing it.  This is mostly useful for trouble
  620.     shooting, or to see a progress indication.
  621.  
  622.  
  623.     -l    Look inside archives
  624.     --------------------------
  625.     This switch will make it look inside archives (ZIP, LZH, and
  626.     ARJ archives only), for a matching filespec.  Note that all
  627.     the filters apply to the file INSIDE the archive, and NOT to
  628.     the archive itself.  The disk list will, however, still
  629.     specify the disks to look at.
  630.  
  631.     Both PKZIP and ARJ come with information on the internal
  632.     format of their archive files, including the header.  Neither
  633.     LHARC nor LHA do, but it was pretty easy for me to figure
  634.     out.  I do ZIP's because that is currently the most common
  635.     type of archive.  LHA compresses smaller, but lacks a few
  636.     features, and is slower in compressing.  ARJ is the BEST.  It
  637.     packs 5% - 10% tighter than ZIP (but is slower in
  638.     compressing), and includes all the nice features of ZIP,
  639.     including encryption, comments, etc, and also can
  640.     automagically create a segmented archive, so you can put a
  641.     huge archive onto several floppy disks, without having to use
  642.     SLICE/SPLICE.  It also comes with a handy utility to convert
  643.     any other archive type to ARJ's.  I didn't do any other
  644.     archivers, because 1) I don't have information on the
  645.     internal format, 2) these three are the most common, and
  646.     best, and 3) I don't want WIZ to get any larger than
  647.     necessary.
  648.  
  649.     -ll    Look inside archives recursively
  650.     ---------------------------------------
  651.     This switch will tell WIZ that you want it to also look
  652.     inside archives that are themselves in an archive.  Naturally,
  653.     WIZ can only do this if the inside archive is "stored" (no
  654.     compression).  However, ARJ and PKZIP v2, can (and WILL)
  655.     compress a ZIP file as it adds it to an archive!!
  656.  
  657.     In the output, these show up with a "@" where you would
  658.     normally see "\", which indicates that it's "kind of like" a
  659.     path.  If this pseudo-pathname gets too long, a "+" is tacked
  660.     on at the end, instead of the actual filename; one for each
  661.     level that is being omitted.
  662.  
  663.     You can also use the "-c" switch, but the filename that
  664.     replaces the "*" in the command won't make any kind of sense
  665.     to DOS, ARJ, LHA ZIP, etc., because of the "@" characters.
  666.  
  667.     -b    Both
  668.     ------------
  669.     This switch is used with "-l" to look both at normal files,
  670.     and inside archives.
  671.  
  672.  
  673.  
  674.     -c    Execute a command
  675.     -------------------------
  676.     This lets you execute a DOS command for each matching file.
  677.     The format is '-cCOMMAND' or '-c COMMAND'. However, if the
  678.     COMMAND has any special characters (space, |, <, >, etc.) you
  679.     must enclose it in quotes: '-c"COMMAND"'.
  680.  
  681.     Each occurance (if any) of the character "*" in the command is
  682.     replaced by the complete file-name (including disk and path).
  683.  
  684.     WIZ will spawn a new copy of the command-line shell
  685.     (COMMAND.COM, 4DOS, etc.), and pass it the built command. The
  686.     one exception is that the command "del*" or "del *" (to
  687.     delete the file) is handled internally by WIZ itself.  (Note
  688.     that you can use the form: '-cdel*', and you do not need a
  689.     space before the '*', nor do you need to enclose the command
  690.     in quotes.)  For this command, WIZ will prompt you to confirm
  691.     each file to be deleted.  (I did this because deleting files
  692.     is a handy thing to do, and it's quicker to do it inside of
  693.     WIZ than to spawn a shell to do it.  But I'm no fool!! You
  694.     have to confirm that you want delete, for each file.  No
  695.     way am I going to let it merrily delete every file on my
  696.     disk(s) just because I make one little mistake on the command
  697.     line!!)   If you prefer to have the shell handle the file
  698.     deletions, use "erase *" or "delete *".
  699.  
  700.     You can't do "-cdel*" along with "-l".  If you have given the
  701.     -l switch, the '*" is replaced with the complete filename of
  702.     the archive (.ZIP, .LZH, .ARJ), a space, and then the
  703.     filename.
  704.  
  705.     Examples:
  706.         -c"type *"    -- type each matching file
  707.         -c"more <*"    -- ditto, with a pause for each page
  708.         -c"copy * a:\"    -- copy each matching file to A:
  709.         -c"set"        -- display the environment at each
  710.                    matching file.
  711.         -c"pkunzip *"    -- extract matching files from a ZIP
  712.                    archive.
  713.  
  714.  
  715.  
  716.  
  717.  
  718.     Coming Attractions
  719.     ------------------
  720.     An interactive screen interface.
  721.     It will gather the file names instead of just printing them
  722.     out.  Then you will be able to sort by name, extent, disk,
  723.     date, size.  You'll also be able to tag files and delete, copy,
  724.     move them, and find duplicates.
  725.     Plus other things I think of, or get suggested.
  726.  
  727.     This is shareware, so I'm probably more interested and 
  728.     receptive in hearing comments and suggestions than a commercial 
  729.     software publisher would be.  Just send them in, or give me a 
  730.     call.  I can't promise to fix bugs, or add specific features, 
  731.     but I'll listen to everything.  Even if you're cheap and 
  732.     haven't registered.
  733.  
  734.     
  735.     BBS Support & New Versions
  736.     --------------------------
  737.     There is no "official" support BBS.  However, I frequent a couple
  738.     of local BBS's:
  739.         Chicken Coop       (708)658-1545   RIMENET =>THECOOP
  740.         Emporium           (708)551-4275   Fidonet 1:155/551
  741.  
  742.     I also release it to the internet, on SimTel and Garbo.
  743.         
  744.  
  745.     ********
  746.     Programming notes (if anyone is interested):
  747.  
  748.     The way I scan thru the disk, it pretty much sweeps thru
  749.     the disk from front to back, without (much) hopping back &
  750.     forth.  So it scans the 1st cluster of ALL the directories
  751.     and sub-directories on the disk, then makes a pass thru the
  752.     FAT (from start to end within the FAT), and so on.
  753.  
  754.     This optimization of head movement really helps to speed it
  755.     up, especially if you don't have a fast disk.  The
  756.     unfortunate side effect is that it looks at a directory one
  757.     chunk at a time, interspersed with chunks of other
  758.     directories.  But it sure is fast!!
  759.  
  760.  
  761.  
  762.                            --------------------------
  763.                              INVOICE / REGISTRATION
  764.                            --------------------------
  765.  
  766.  
  767.  
  768.           Sold to: ___________________________________________________
  769.  
  770.                    ___________________________________________________
  771.  
  772.                    ___________________________________________________
  773.  
  774.  
  775.              Date: ______________________________
  776.  
  777.  
  778.           ============================================================
  779.  
  780.  
  781.     I will normally send you the latest version on 5 1/4" disk.
  782.     Add $2 for 3 1/2" disk. (Net $22)
  783.     Deduct $5 (per copy) if you DON'T want me to send you a disk!
  784.  
  785.           _____ copies of WIZ version 3.4 at $20 each $____________
  786.  
  787.           _____ copies of RCD version ___ at $20 each $____________
  788.  
  789.           _____ add $2 for 3.5" disk              $____________
  790.  
  791.       _____ deduct $5 per copy for no disk (net $15)
  792.  
  793.         DISCOUNT for registering both is
  794.         $5 off.                  ____________
  795.  
  796.  
  797.  
  798.                                 TOTAL ENCLOSED.......  $____________
  799.     NOTE:
  800.     If you have the current version, I will send you
  801.     a disk with the NEXT version, when I release it,
  802.     unless you check here:
  803.  
  804.     Ray, YES, send me a disk NOW, even though I already
  805.     have the current version:  [__]
  806.  
  807.  
  808.  
  809.  
  810.       Where did you get your copy of WIZ?
  811.       Shareware distributor name:___________________
  812.       BBS name: ____________________
  813.       BBS phone #:  ____________________
  814.  
  815.  
  816.                       Send this invoice and your check to:
  817.  
  818.                 Ray Van Tassle
  819.                 1020 Fox Run Lane
  820.                 Algonquin, Il. 60102
  821.                 (708)-658-4941
  822.       email: rayvt@comm.mot.com
  823.  
  824.  
  825.  
  826.           =============================================================
  827.  
  828.           Thank you for your support ............... Ray Van Tassle
  829.  
  830.