home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / d / dst.zip / DST.DOC next >
Text File  |  1992-12-25  |  15KB  |  378 lines

  1.  
  2.  
  3.  
  4.  
  5.                        DST:  Disk Searching Tool v1.0
  6.  
  7.                             Released Dec 25, 1992
  8.  
  9.                      A DR-DOS / MS-DOS Fast File Finder
  10.  
  11.  
  12.  
  13.           Electronic mail on GEnie: J.Kowalczyk1
  14.  
  15.  
  16.   Program and Documentation are Copyright (c) 1991-1992 by:
  17.   Bits, Bytes &  PC's                  All rights reserved.
  18.  
  19.  
  20.   Portions Copyright Borland, International.  DST is written in Borland C.
  21.  
  22.  
  23.  
  24.                              DST v1.0                                 Page 1
  25.  
  26.  
  27.                             Definition of ShareWare                         
  28.  
  29.  
  30.  
  31.  
  32.     Shareware distribution gives users a chance to try software before
  33.     buying it.  If you agree with the license agreement and continue
  34.     using DST after 30 days, support the shareware concept by
  35.     registering. By sending in the registration form you will receive
  36.     the latest version of DST  registered in you name.
  37.  
  38.     Copyright laws apply to both Shareware and commercial software,
  39.     and the copyright holder retains all rights, with a few specific
  40.     exceptions as stated below. Shareware authors are accomplished
  41.     programmers, just like commercial authors, and the programs are
  42.     of comparable quality. (In both cases, there are good programs
  43.     and bad ones!) The main difference is in the method of distribution.
  44.     The author specifically grants the right to copy and distribute the
  45.     software, either to all and sundry or to a specific group.
  46.     For example, some authors require written permission before a
  47.     commercial disk vendor may copy their Shareware.
  48.  
  49.     Shareware is a distribution method, not a type of software. You
  50.     should find software that suits your needs and pocketbook,
  51.     whether it's commercial or Shareware. The Shareware system makes
  52.     fitting your needs easier, because you can try before you buy.
  53.     And because the overhead is low, prices are low also. Shareware
  54.     has the ultimate money-back guarantee -- if you don't use the
  55.     product, you don't pay for it.
  56.  
  57.                              DST v1.0                                 Page 2
  58.  
  59.  
  60.                              Disclaimer - Agreement                         
  61.  
  62.  
  63.  
  64.  
  65.     Users of DST must accept this disclaimer of warranty:
  66.     "DST is supplied as is.  The author disclaims all warranties, expressed
  67.     or implied, including, without limitation, the warranties of
  68.     merchantability and of fitness for any purpose.  The author assumes no
  69.     liability for damages, direct or consequential, which may result from
  70.     the use of DST."
  71.  
  72.     DST is a "shareware program" and is provided at no charge to the user
  73.     for evaluation.  Feel free to share it with your friends, but please
  74.     do not give it away altered or as part of another system.  Shareware
  75.     software is a way to provide personal computer users with quality
  76.     software without paying high prices, and yet to provide incentive for
  77.     programmers to  continue to develop new software.  If you find this
  78.     program useful and find that you are using DST and continue to use
  79.     DST after 30 days, you must become a registered owner of this software.
  80.     You do this by filing out the registration form that came with DST
  81.     and mail it in along with your payment.   The registration fee will
  82.     license you to use DST for use on any and all DR-DOS or MS-DOS based
  83.     computers you or your company owns.  This is a special licensing, just
  84.     for DST and only DST.
  85.  
  86.  
  87.     Please help distribute DST by giving your friends a copy to try and
  88.     upload it to your favorite Bulletin Board System.  Most BBS want you
  89.     to upload a file after so many downloads, so please upload it.
  90.     All registered users will receive a copy of the latest version
  91.     of the DST program, registered in their name or company name.
  92.  
  93.                              DST v1.0                                Page 3
  94.  
  95.  
  96.                                   Introduction                              
  97.  
  98.  
  99.    Thank you for taking the time to try out DST v1.0. I developed DST to
  100.    help me find files on my hard disk using various searching methods. DST
  101.    will not delete file(s) unless you answer a 'y' when asked to delete
  102.    a file. I believe this is what scares most new users, DST is a fast
  103.    file finding tool used to locate file(s) by Name, Date and Size. Even
  104.    if you never used a tool like DST before please try it out, try doing
  105.    something simple like looking for all the files that have a ext of DOC
  106.    example  C:\>dst *.doc -p this will locate all file(s) with extension of
  107.    doc in any directory on your c: hard drive and pause after screen is
  108.    full, it's that simple, once you try it you'll like it, I'm sure. DST also
  109.    shows time in standard time format AM and PM  3:00p for 3 pm not 17:00
  110.    like most other file finders. DST when used with -p allow you to quit a
  111.    search by entering a 'q' when it show's ---- more ---- (Y\N\Q).  This is
  112.    very handy and will take you back to starting directory well this was
  113.    just a brief explanation of DST, complete instructions will follow later
  114.    in this documentation.
  115.    Registered users will not have to pay for any future versions of DST,
  116.    they will receive a registration number that will register all
  117.    versions of DST to them.  Registration will remove the shareware
  118.    screen from help and after using DST. There are a lot of disk
  119.    searching programs out there, but I believe for the price DST is the
  120.    best value and of course the source code is available for a small
  121.    fee. Please register and support shareware THANK YOU...
  122.  
  123.    here are the options available to date:
  124.  
  125.  
  126.      The ability to search for file by date, size or name using wildcard
  127.         characters.
  128.  
  129.      The ability to delete files once found.
  130.  
  131.      The ability to change to the directory where file found resides.
  132.  
  133.      The ability to send output to screen and printer.
  134.  
  135.      The ability to end search when asked (Y\N\Q) by entering 'Q'
  136.  
  137.      DST builds a window and displays search item and parameters above
  138.      this window and all output in this window so you can see what you
  139.      are searching for at all times.
  140.  
  141.    I believe that you will find this software very useful if you have a
  142. hard disk in your computer, If you would like to see more features or a
  143. specific feature please list it on you registration form under comments.
  144. Or if you are a C programmer mail for the source code to DST and change
  145. or add any feature you like.  All I ask of you if you purchase source
  146. code and modify it, is to include a message that thanks Bits, Bytes & PC's
  147. for the availability of the source code. Getting the source code
  148. and modifying it to your needs could be a real learning tool for a starting
  149. C programmer.
  150.  
  151.  
  152.  
  153.  
  154.  
  155.                              DST v1.0                                  Page 4
  156.  
  157.  
  158.                                   Introduction                              
  159.  
  160.  
  161.  
  162.    When you send in your registration fee, you will receive a disk with the
  163. most recent version of DST.  You will receive unlimited telephone support for
  164. the program.   Registered DST users may call me at (208) 362-1151 between the
  165. hours of 6:00 pm - 10:00 pm (Mountain Time) Monday-Friday, and from 7 am
  166. - 10 pm on the weekends.   Thank you for supporting DST.
  167.  
  168.  
  169.  
  170.                                  Using DST
  171.  
  172.  
  173.  
  174.   DST helps hard drive owners locate and perform certain tasks on file(s)
  175.   scattered over their hard drive(s) in different directories.   We've all
  176.   had situations where we worked on a file or program but don't remember the
  177.   name and or where it is located, with DST you can search the hard disk for
  178.   this file by name (including wildcards) date and size using various
  179.   options that I will list in more detail in a minute.
  180.  
  181.  
  182.  
  183.  
  184.  
  185.                              DST v1.0                             Page 5
  186.  
  187.  
  188.                              OPTIONS:
  189.  
  190.  
  191.   by typing DST by itself with no arguments will display a list of
  192.   command parameters that are currently available. Example: C:\>DST
  193.  
  194.   Well this is probably the only area you will read so here are the
  195.   options:
  196.  
  197.   DST *.doc                     will search default drive for any filename
  198.                                 with extension of doc and display output
  199.                                 to the screen.
  200.  
  201.   DST *.doc -p                  will search default drive for any filename
  202.                                 with extension of doc and will stop after
  203.                                 filling screen and only continue after
  204.                                 you tap a key on the keyboard.
  205.  
  206.   DST d:*.doc -p                same as above except will search the D
  207.                                 drive.
  208.  
  209.   DST myprog                    search entire default drive looking for
  210.                                 "myprog.*" (DST will append a ".*" to
  211.                                 a filename when no extension is specified).
  212.  
  213.   DST myprog -gt122592          search entire default drive looking for
  214.                                 "myprog", only with file date equal to
  215.                                 or greater than dec 25, 1992.
  216.  
  217.  
  218.                              DST v1.0                             Page 6
  219.  
  220.  
  221.                                  OPTIONS:
  222.  
  223.  
  224.      Option:  -G or -g
  225.               Will allow you to change to directory where found file
  226.               resides by answering with a 'y' or continuing by using
  227.               a 'n', you also can enter a 'q' or 'Q' to quit the search
  228.               you can enter options in either lower or upper case DST
  229.               understands both so from this point on all reference to
  230.               said options will be in lower case.
  231.  
  232.     example:  dst *.doc -g
  233.  
  234.      Option:  -D or -d
  235.               Will allow you to DELETE found file, if you enter a 'y'
  236.               to prompt (Y/N/Q/) ? . If you enter a 'y' file will be
  237.               deleted and message Removed will appear on screen, Kept
  238.               will appear if you answer with 'n'. you also can quit by
  239.               answering prompt with 'q'.
  240.  
  241.  
  242.      Option:  -GT or -gt
  243.               Will search for all file(s) equal to or greater than this
  244.               date and list to screen.
  245.  
  246.     example: dst -gt112792 will list all file(s) equal to or greater
  247.              than Nov 27, 1992.
  248.  
  249.  
  250.      Option: -LT or -lt
  251.              will find all file(s) less than this date and can only be
  252.              used in conjunction with -gt option
  253.  
  254.     example: dst  -gt112792 -lt122592
  255.              Will find all file(s) equal to or greater than Nov 27,1992
  256.              and all file(s) less than Dec 25, 1992.
  257.  
  258.      Option:  -P
  259.     Meaning:  pause and wait for a key when the screen fills up
  260. Description:  A very handy switch, best used when set in your environment
  261.               variable.   It will cause DST to pause the screen when it
  262.               fills up, so you don't have to go crazy trying to hit the
  263.               control-c key or pause key. You also can enter a 'Q' or
  264.               'q' when screen fills up. this will discontinue search and
  265.               take you back to starting directory.
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                              DST v1.0                             Page 7
  272.  
  273.  
  274.                                  OPTIONS:
  275.  
  276.  
  277.  
  278.      Option:  -PR or -pr
  279.               Will allow send all output from find to local printer
  280.  
  281.     example:  dst *.doc -pr
  282.  
  283.      Option:  -ET or -et
  284.               Will find all file(s) equal to this date and only this
  285.               date.
  286.  
  287.     example:  dst -et122592
  288.  
  289.      Option:  -FG or -fg
  290.               Will find all file(s) equal to and greater than filesize
  291.               in bytes.
  292.  
  293.     example:  -fg500000
  294.  
  295.      Option:  -FL or -fl
  296.               Will find all file(s) with filesize less than this amount.
  297.               this option can only be used in conjunction with -fg
  298.               option.
  299.     example: -fg 500000 -fl100000
  300.  
  301.  
  302.      Option: -FE or -fe
  303.              Will find all file(s) with file size equal to this amount
  304.              and only this amount.
  305.  
  306.     example: dst -fe50000
  307.  
  308.      Option:  Wildcard searching:
  309.  
  310.     example: dst ???-* or ???-*.*
  311.              will find all file(s) with - in forth position with any
  312.              characters or numbers in first three positions.
  313.              files found might be: A-B-C.DOC, ART-1.EXE OR DOR--.COM
  314.  
  315.  
  316.                              DST v1.0                             Page 8
  317.  
  318.  
  319.                                  OPTIONS:
  320.  
  321.  
  322.  
  323.      Option:  dst -gt112792 -lt122592 -g -d
  324.               Will find all file(s) with dates greater than or equal to
  325.               Nov 27, 1992 and less than Dec 25, 1992  and will allow
  326.               you to go to this directory or delete said found file. You
  327.               will also have at -g or -d the option of quitting this
  328.               search by hitting a 'Q' or 'q'.
  329.  
  330.      
  331.      Option: dst -gt112792 -lt122592 -fg500 -fl100000 -g -d
  332.              This will find all file(s) greater than or equal to date
  333.              entered in -gt and less than file date in -lt with file
  334.              size greater than or equal to  and filesize less than in
  335.              -lt plus all you to change to directory where file was
  336.              found or delete said found file.
  337.  
  338.      
  339.      Option: dst -gt112792 -lt122592 -fg500 -fl100000 -p
  340.              This will find all file(s) greater than or equal to date
  341.              entered in -gt and less than file date in -lt with file
  342.              size greater than or equal to  and filesize less than in
  343.              -lt plus will stop and pause after screen is full and will
  344.              wait for you to touch a key before continuing or you can
  345.              hit a 'Q' or 'q' to quit and return to starting directory.
  346.  
  347.   as you can see you can mix many of the commands together to search for
  348.   file(s) the way you want.
  349.  
  350.   For DST to work correctly, you need to put the file DST.EXE in a directory
  351. in you path, best place is in DOS directory or if you prefer somewhere else.
  352. At the dos prompt c:\>path  and hit enter.
  353.  
  354. example of path:  path=c:\dos;c:\borlandc\bin;c:\windows;c:\dir\etc\
  355. use dos copy command to put in directory of your choice.
  356. example: c:\>copy dst.exe \dos  and hit enter key.
  357. That's all that's required to use DST.
  358.  
  359.  
  360.                              DST v1.0                             Page 9
  361.  
  362.  
  363.  
  364. The source code to this program is available for $10.00 U.S. currency
  365. to obtain the commented source code please send payment to:
  366.  
  367. Bits, Bytes & PC's
  368. c/o Joseph J Kowalczyk
  369. 11712 Gila dr.
  370. Kuna Id, 83634-2640
  371.  
  372. This will also make you a registered owner of DST and now you can add
  373. any feature(s) you wish and you don't have to pay any royalties for
  374. any updates or enhancements you make to this program. You can even
  375. change name, add new features and sell the program yourself. All I ask is
  376. you mention who the starting author was somewhere in your documentation.
  377. End of document.
  378.