home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / fileutil / aff0917.arj / AFF.DOC < prev    next >
Encoding:
Text File  |  1991-09-17  |  9.9 KB  |  284 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                       AFF.EXE
  10.  
  11.                                 Another File Finder
  12.  
  13.                                  September 17, 1991
  14.  
  15.  
  16.                                  Brought to you by
  17.  
  18.                                  The Tech Line BBS
  19.                                    (301) 696-1393
  20.  
  21.                       * USR Dual Standard - 24 Hours - Free *
  22.  
  23.  
  24.  
  25.  
  26.      Usage:    AFF [d:] string [string] [...] [/? | /A | /H]
  27.  
  28.  
  29.                Where d: is an optional drive letter and 'string' is the
  30.                string of characters within a file name.
  31.  
  32.                You can specify more than one string to search for on
  33.                the command line, and the program will match all
  34.                files with any of these strings in the name.  It's a
  35.                logical OR match.  The list of strings can be as long
  36.                as the command line will allow.
  37.  
  38.                The SPACE between the drive and string is important!
  39.  
  40.                /A searches ALL Drives
  41.  
  42.                /H searches ALL HARD Drives - skips floppies
  43.  
  44.                NOTE:  AFF will always skip floppy drives if no floppy is
  45.                inserted, and all SUBST and ASSIGN drives.  AFF assumes all
  46.                networked drives are hard drives.
  47.  
  48.                /? gives program information.
  49.  
  50.  
  51.  
  52.      INTRODUCTION
  53.  
  54.      Another File Find (AFF) will search and find a file, anywhere on a disk,
  55.      which contains the string specified.  To specify the file to find, the
  56.      program accepts a string (or set of strings) on the command line.  This
  57.      is a string of characters which can be anywhere in the file name.
  58.  
  59.      There are many programs available that *seem* to perform this same task. 
  60.      However, this program is unique from other file find programs because
  61.      other programs use the file specification exactly like DOS.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.      For example, if you give the DOS command:
  70.  
  71.                                    "DIR *COM*.*"
  72.  
  73.      DOS would give you ALL files just as if you had given it the command
  74.  
  75.                                      "DIR *.*"
  76.  
  77.  
  78.      This is not what you may want to do in many situations.  With this file
  79.      finding program you can give the command:
  80.  
  81.                                      "AFF COM"
  82.  
  83.      and AFF will show you any file on the disk with the characters "COM"
  84.      anywhere in the name.  When I do this on my disk I see files like:
  85.  
  86.                                     COMMAND.COM
  87.                                     TSRCOMM.ZIP
  88.                                     TCOMM.ZIP
  89.                                     TCOMM5.ZIP
  90.  
  91.  
  92.      Try finding those files with the standard file find programs out there!
  93.  
  94.  
  95.  
  96.      USING AFF
  97.  
  98.      AFF has a point and shoot type operation.  A window will appear allowing
  99.      you to scroll through the list of files which were found.
  100.  
  101.      Use the normal movement keys to scroll through the list - PgUp, PgDn, Up
  102.      Arrow, Down Arrow, End, Home, etc.
  103.  
  104.  
  105.      TO DELETE FILES          You can delete files by moving the selection bar
  106.                               to the file you want to delete, and press the
  107.                               Del Key.
  108.  
  109.  
  110.      TO CHANGE DIRECTORIES    You can change to a Directory and Exit the
  111.                               program by moving the selection bar to a File or
  112.                               Directory line and press the Enter Key.
  113.  
  114.  
  115.      ONLINE HELP              Pressing F1 gives you online Help information.
  116.  
  117.  
  118.      STATS                    Pressing F2 gives you some statistics on the
  119.                               system and the files found
  120.  
  121.  
  122.      MOUSE HELP               Although the F3 selection is not shown on the
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                               screen, it will give you information on using
  131.                               the mouse.  A mouse selection area is on the
  132.                               screen for mouse help, if the mouse is present
  133.                               and enabled.
  134.  
  135.      VIEWING A FILE           You can View the contents of a file by pressing
  136.                               Alt-V while the selection bar is on the file you
  137.                               want to view.  AFF will Shell to DOS and run a
  138.                               batch file named AFFVIEW.BAT.
  139.  
  140.                               A sample AFFVIEW.BAT batch file is included in
  141.                               this ZIP, which shows the different parameters
  142.                               that are passed to the batch file, then calls
  143.                               BROWSE.COM (a PC Magazine file viewer).  You can
  144.                               use any file viewer/lister you wish, like Vernon
  145.                               Beurg's LIST, etc.  AFFVIEW.BAT must be in a
  146.                               directory in your PATH statement.  See the
  147.                               sample batch file included for instructions on
  148.                               how to make full use of this feature.
  149.  
  150.  
  151.      You can specify more than one string on the command line.  For example:
  152.  
  153.                                   "AFF PORT COMM"
  154.  
  155.      will show you all files with "PORT" or "COMM" in the the name.  This is a
  156.      logical OR search.  The list of strings can be as long as the command
  157.      line will allow.
  158.  
  159.  
  160.  
  161.      USING THE MOUSE
  162.  
  163.      Simply move the cursor around the screen while holding the LEFT button
  164.      down, and drag the cursor to the file you want to select, delete, or
  165.      view.
  166.  
  167.      Once pointing to the desired file a Double Click of one of the mouse
  168.      buttons will perform an action:
  169.  
  170.           LEFT      Select the file     (Same as Enter)
  171.           RIGHT     Delete the file     (Same as Del)
  172.           MIDDLE    View the file       (Same as Alt-V)
  173.  
  174.  
  175.      You can move the mouse to the Top or Bottom LEFT Corners of the window
  176.      and Click the LEFT mouse button to perform a Page Up or Page Down.  This
  177.      is the same as pressing the PgUp and PgDn keys.
  178.  
  179.      You can move the mouse to the Top or Bottom RIGHT Corners of the window,
  180.      and as long as the LEFT mouse button is held down (Pressed), the screen
  181.      will scroll up or down just like pressing the Up and Down Arrows.
  182.  
  183.      When the mouse is enabled you will also see some selections on the top
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.      row of the screen.  Click the LEFT mouse button on these areas to make
  192.      the selection.  Selections available at the top of the screen include
  193.      Help, Status, Mouse Help, View a File, and Quit the program.
  194.  
  195.      When you have chosen to delete a file, a window will appear and ask if
  196.      you are sure you want to delete this file.  You can move the mouse cursor
  197.      to the desired Yes or No selection and click the LEFT button to select. 
  198.      However, if you click the RIGHT mouse button it is the same as pressing
  199.      Enter (which by default chooses Yes).  This makes it quicker to delete
  200.      files since you don't have to move the mouse cursor over to the Yes
  201.      selection and click -- you can just click the RIGHT button to select Yes.
  202.  
  203.  
  204.  
  205.      THIS IS FREEWARE!
  206.  
  207.      This program is released as a FREE program.  Use at your own risk, and
  208.      enjoy!  I enjoy seeing people get good use of my programs, especially
  209.      when they are free.  Please call my board and let me know how you are
  210.      using this program.
  211.  
  212.  
  213.  
  214.      OUR BBS
  215.  
  216.      You are welcome to call our Bulletin Board and check for the latest
  217.      release of this program, or some of my other programs.  Give The Tech
  218.      Line BBS a call at 301-696-1393 anytime 24 hours a day.  We run PCBoard
  219.      software and have a USR HST Dual Standard Modem.  You will have access to
  220.      this file on your first call.
  221.  
  222.  
  223.  
  224.      HISTORY
  225.  
  226.           This program is not made with "version" numbers.  I use dates
  227.           to show when the program was compiled.
  228.  
  229.  
  230.      05/18/91  Initial release to the public.
  231.  
  232.      05/24/91  Added the ability to VIEW files via the Alt-V key, which calls
  233.                the AFFVIEW.BAT batch file.  Cleaned up the code and operation
  234.                a little.  Added a Control-Break handler and some neat-looking
  235.                growing windows.  AFF is now Desqview aware.
  236.  
  237.  
  238.      09/17/91  Added the ability to search for more than one string!
  239.  
  240.                MOUSE Support has been added!
  241.  
  242.                More files can be loaded into the list in memory at one time!
  243.  
  244.                Now we turn off the cursor - looks better.
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.                Changed the color of some of the screens to make them look
  253.                better when running on Monochrome systems.
  254.  
  255.                Added a fifth parameter for the AFFVIEW.BAT batch file.  Now %5
  256.                is the EXTension of the file.  This allows you to check the
  257.                extension and run PKZip (etc) if it is a .ZIP file and use the
  258.                BROWSE or LIST program for other files.
  259.  
  260.                /A and /H parameters added.
  261.  
  262.                Made colors look correct when system is running in BW80 mode,
  263.                like many users have on their laptop systems.
  264.  
  265.                Supports video modes with more than 25 lines on the screen!
  266.  
  267.  
  268.  
  269.  
  270.  
  271.      DISCLAIMER
  272.  
  273.      I, JOHN CROUCH (HEREAFTER KNOWN AS "AUTHOR"), HEREBY DISCLAIM ALL
  274.      WARRANTIES RELATING TO THIS SOFTWARE, WHETHER EXPRESS OR IMPLIED,
  275.      INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR
  276.      FITNESS FOR A PARTICULAR PURPOSE.  THE AUTHOR WILL NOT BE LIABLE FOR ANY
  277.      SPECIAL, INCIDENTAL, CONSEQUENTIAL, INDIRECT OR SIMILAR DAMAGES DUE TO
  278.      LOSS OF DATA OR ANY OTHER REASON, EVEN IF AUTHOR OR AN AGENT OF AUTHOR
  279.      HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  IN NO EVENT SHALL
  280.      AUTHORS' LIABILITY FOR ANY DAMAGES EVER EXCEED THE PRICE PAID FOR THE
  281.      LICENSE TO USE SOFTWARE (WHICH IS $0), REGARDLESS OF THE FORM OF THE
  282.      CLAIM.  THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE QUALITY
  283.      AND PERFORMANCE OF THE SOFTWARE.
  284.