
                                 NUKE v4.0
                              Short Text File
                        Written by Michael MacDonald
                                 09/09/90
                               rev 03/01/91
                               rev 03/10/92

     NUKE is a compiled clipper PRG program.   It is  'freeware'.  No fee
     is expected for  it's use.    It's  purpose is to  check  RoboComm's
     NEWxx.DBF  (the database  that keeps track of new files on the BBS's
     you call)  for strings of text that you input,  then mark as deleted
     any matches it finds.   It  will first ask if you want to search the
     filename field.   For instance, if you want to delete all files with
     an extension of GIF, you would input  '.GIF'.  Note the period. With
     it, NUKE would bypass filenames like VIEWGIF.ZIP. If you wanted that
     file to be picked  up as well,  you  would not use the period in the
     text you input.  NUKE  will  search   for the occurrence of the text
     anywhere in the filename. ie BTM2GIF3.ZIP or GIF2BTM.ZIP or GIRL.GIF
     would all get picked up by the 'GIF' input.

     NUKE will then ask you  if  you want to search the description field.
     Here is  where you would input  'game'  to delete all files with the
     word  'game' in their descriptions. Or input  'window'  to get files
     with the  word  'window'  in the description.  Be careful here.  For
     instance, if you input  'win'  NUKE will delete a file with the word
     'shoWINg' in the description.  Use as much text as you think you can.
     ie, To delete Windows programs,  use 'window' as the input, or 'win3'
     vs using  'win'.  NUKE  may  miss a  few this way, but the chance of
     'false  hits'  will be greatly reduced.   You  can input the text in
     upper or lower case, or even a combination  if  you were so inclined.
     NUKE will automatically take care of searching for all the different
     combinations that may occur.  ie,  If you input  'window', NUKE will
     search for 'WINDOW, window, or Window'.

     A final note. NUKE is thorough, but may not find every occurrence of
     the string you input. For instance,  the description field that NUKE
     searches  contains  only  the  first  45  characters  of  the file's
     description. The 2,3,4, etc lines of the file description are stored
     in a separate file.  (ROBOCOMM.DBV)   Most of the time, I have found
     that the 'key' text is  contained in the first 45 characters. ie, If
     a program is a game, the word  'game' is usually there. If a program
     is for use under  Windows,  you'll find the word  'Windows'  or 'Win'
     almost immediately.

     NUKE will also allow command line parameters. They must  be  entered
     as follows

                NUKE /t /f<text> /d<text>

                t=tag
                f=filename,
                d=description
                <text>= the text to search for.

       examples:

     NUKE                      Prompt for input, don't tag files
     NUKE /t                   Prompt for input and tag files
     NUKE /fgif                Search filename for 'gif'
                               but don't tag files

     NUKE /fgif /dgif          Search filename and desc for 'gif',
                               but don't tag files

     NUKE /t /dwin3            Search desc for 'win3' and tag files
     NUKE /dpc~mag             Search desc for 'PC MAG'. Don't tag files
     NUKE /t /fgif /dpc_mag    Search filename for 'gif',desc for 'PC MAG'
                               and tag all matches

     If you want to search both the filename AND  description,  you  MUST
     enter the filename parameter before the  description  parameter.  If
     you want NUKE to tag the files it deletes  then  '/t'  must  be  the
     first switch. The input is not case  sensitive  NUKE  will write the
     names of the  files  it  marks  as  deleted  to  a  text file called
     DELETED.FIL. (This is the same file  DUP,  another Robo  utility  by
     yours truly, will write to.) You'll  only  see the first line of the
     description in there.  In addition to being able  to  view the files
     marked deleted in the text file, if you use the '/t' switch then you
     can also view them in RoboComm, sorted together.  To do this use the
     sort key called 'Tagged'.  Just  press  'S' and choose 'Tagged' then
     press CNTL/PGDN,  and all the deleted files will be at the bottom of
     the list, lumped together.

     If there are spaces in the search string you must use one of the the
     following  three  characters  instead of the space: The underline, _
     the tilde, ~ or the star *. You can use 1, 2 or all three of them in
     any order in place of a space.  You CAN'T use the same one twice. So,
     to  search  for  'PC Magazine',  you  would  enter  the   following:
     '/dpc_magazine' or '/dpc~magazine'  or  '/dpc*magazine'. To find the
     string 'Clipper source incl' you'd enter '/dclipper_source~incl'. Or
     use any of the other combinations possible. I think you get the idea
     If  you  needed  to  search  for  something  with more than 3 spaces,
     that'd  be  4  words  and  I think by then you may as well just load
     RoboComm and find it.



     NUKE can reside anywhere, but you must be in the directory where you
     keep your RoboComm files when you invoke it. Since NUKE rewrites the
     index  NTAG.NTX, if you use the  '/t' switch, don't invoke NUKE with
     that switch  while shelled  out  from RoboComm.   This  could create
     problems  since  that file  is  already open.   The  source code has
     been included for any Clipper users that wish to play with it.

                              Michael MacDonald
                         4273 148th Ave NE  Apt E-104
                             Bellevue, WA  98007
