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 >
Wrap
Text File
|
1992-12-25
|
15KB
|
378 lines
DST: Disk Searching Tool v1.0
Released Dec 25, 1992
A DR-DOS / MS-DOS Fast File Finder
Electronic mail on GEnie: J.Kowalczyk1
Program and Documentation are Copyright (c) 1991-1992 by:
Bits, Bytes & PC's All rights reserved.
Portions Copyright Borland, International. DST is written in Borland C.
DST v1.0 Page 1
Definition of ShareWare
Shareware distribution gives users a chance to try software before
buying it. If you agree with the license agreement and continue
using DST after 30 days, support the shareware concept by
registering. By sending in the registration form you will receive
the latest version of DST registered in you name.
Copyright laws apply to both Shareware and commercial software,
and the copyright holder retains all rights, with a few specific
exceptions as stated below. Shareware authors are accomplished
programmers, just like commercial authors, and the programs are
of comparable quality. (In both cases, there are good programs
and bad ones!) The main difference is in the method of distribution.
The author specifically grants the right to copy and distribute the
software, either to all and sundry or to a specific group.
For example, some authors require written permission before a
commercial disk vendor may copy their Shareware.
Shareware is a distribution method, not a type of software. You
should find software that suits your needs and pocketbook,
whether it's commercial or Shareware. The Shareware system makes
fitting your needs easier, because you can try before you buy.
And because the overhead is low, prices are low also. Shareware
has the ultimate money-back guarantee -- if you don't use the
product, you don't pay for it.
DST v1.0 Page 2
Disclaimer - Agreement
Users of DST must accept this disclaimer of warranty:
"DST is supplied as is. The author disclaims all warranties, expressed
or implied, including, without limitation, the warranties of
merchantability and of fitness for any purpose. The author assumes no
liability for damages, direct or consequential, which may result from
the use of DST."
DST is a "shareware program" and is provided at no charge to the user
for evaluation. Feel free to share it with your friends, but please
do not give it away altered or as part of another system. Shareware
software is a way to provide personal computer users with quality
software without paying high prices, and yet to provide incentive for
programmers to continue to develop new software. If you find this
program useful and find that you are using DST and continue to use
DST after 30 days, you must become a registered owner of this software.
You do this by filing out the registration form that came with DST
and mail it in along with your payment. The registration fee will
license you to use DST for use on any and all DR-DOS or MS-DOS based
computers you or your company owns. This is a special licensing, just
for DST and only DST.
Please help distribute DST by giving your friends a copy to try and
upload it to your favorite Bulletin Board System. Most BBS want you
to upload a file after so many downloads, so please upload it.
All registered users will receive a copy of the latest version
of the DST program, registered in their name or company name.
DST v1.0 Page 3
Introduction
Thank you for taking the time to try out DST v1.0. I developed DST to
help me find files on my hard disk using various searching methods. DST
will not delete file(s) unless you answer a 'y' when asked to delete
a file. I believe this is what scares most new users, DST is a fast
file finding tool used to locate file(s) by Name, Date and Size. Even
if you never used a tool like DST before please try it out, try doing
something simple like looking for all the files that have a ext of DOC
example C:\>dst *.doc -p this will locate all file(s) with extension of
doc in any directory on your c: hard drive and pause after screen is
full, it's that simple, once you try it you'll like it, I'm sure. DST also
shows time in standard time format AM and PM 3:00p for 3 pm not 17:00
like most other file finders. DST when used with -p allow you to quit a
search by entering a 'q' when it show's ---- more ---- (Y\N\Q). This is
very handy and will take you back to starting directory well this was
just a brief explanation of DST, complete instructions will follow later
in this documentation.
Registered users will not have to pay for any future versions of DST,
they will receive a registration number that will register all
versions of DST to them. Registration will remove the shareware
screen from help and after using DST. There are a lot of disk
searching programs out there, but I believe for the price DST is the
best value and of course the source code is available for a small
fee. Please register and support shareware THANK YOU...
here are the options available to date:
The ability to search for file by date, size or name using wildcard
characters.
The ability to delete files once found.
The ability to change to the directory where file found resides.
The ability to send output to screen and printer.
The ability to end search when asked (Y\N\Q) by entering 'Q'
DST builds a window and displays search item and parameters above
this window and all output in this window so you can see what you
are searching for at all times.
I believe that you will find this software very useful if you have a
hard disk in your computer, If you would like to see more features or a
specific feature please list it on you registration form under comments.
Or if you are a C programmer mail for the source code to DST and change
or add any feature you like. All I ask of you if you purchase source
code and modify it, is to include a message that thanks Bits, Bytes & PC's
for the availability of the source code. Getting the source code
and modifying it to your needs could be a real learning tool for a starting
C programmer.
DST v1.0 Page 4
Introduction
When you send in your registration fee, you will receive a disk with the
most recent version of DST. You will receive unlimited telephone support for
the program. Registered DST users may call me at (208) 362-1151 between the
hours of 6:00 pm - 10:00 pm (Mountain Time) Monday-Friday, and from 7 am
- 10 pm on the weekends. Thank you for supporting DST.
Using DST
DST helps hard drive owners locate and perform certain tasks on file(s)
scattered over their hard drive(s) in different directories. We've all
had situations where we worked on a file or program but don't remember the
name and or where it is located, with DST you can search the hard disk for
this file by name (including wildcards) date and size using various
options that I will list in more detail in a minute.
DST v1.0 Page 5
OPTIONS:
by typing DST by itself with no arguments will display a list of
command parameters that are currently available. Example: C:\>DST
Well this is probably the only area you will read so here are the
options:
DST *.doc will search default drive for any filename
with extension of doc and display output
to the screen.
DST *.doc -p will search default drive for any filename
with extension of doc and will stop after
filling screen and only continue after
you tap a key on the keyboard.
DST d:*.doc -p same as above except will search the D
drive.
DST myprog search entire default drive looking for
"myprog.*" (DST will append a ".*" to
a filename when no extension is specified).
DST myprog -gt122592 search entire default drive looking for
"myprog", only with file date equal to
or greater than dec 25, 1992.
DST v1.0 Page 6
OPTIONS:
Option: -G or -g
Will allow you to change to directory where found file
resides by answering with a 'y' or continuing by using
a 'n', you also can enter a 'q' or 'Q' to quit the search
you can enter options in either lower or upper case DST
understands both so from this point on all reference to
said options will be in lower case.
example: dst *.doc -g
Option: -D or -d
Will allow you to DELETE found file, if you enter a 'y'
to prompt (Y/N/Q/) ? . If you enter a 'y' file will be
deleted and message Removed will appear on screen, Kept
will appear if you answer with 'n'. you also can quit by
answering prompt with 'q'.
Option: -GT or -gt
Will search for all file(s) equal to or greater than this
date and list to screen.
example: dst -gt112792 will list all file(s) equal to or greater
than Nov 27, 1992.
Option: -LT or -lt
will find all file(s) less than this date and can only be
used in conjunction with -gt option
example: dst -gt112792 -lt122592
Will find all file(s) equal to or greater than Nov 27,1992
and all file(s) less than Dec 25, 1992.
Option: -P
Meaning: pause and wait for a key when the screen fills up
Description: A very handy switch, best used when set in your environment
variable. It will cause DST to pause the screen when it
fills up, so you don't have to go crazy trying to hit the
control-c key or pause key. You also can enter a 'Q' or
'q' when screen fills up. this will discontinue search and
take you back to starting directory.
DST v1.0 Page 7
OPTIONS:
Option: -PR or -pr
Will allow send all output from find to local printer
example: dst *.doc -pr
Option: -ET or -et
Will find all file(s) equal to this date and only this
date.
example: dst -et122592
Option: -FG or -fg
Will find all file(s) equal to and greater than filesize
in bytes.
example: -fg500000
Option: -FL or -fl
Will find all file(s) with filesize less than this amount.
this option can only be used in conjunction with -fg
option.
example: -fg 500000 -fl100000
Option: -FE or -fe
Will find all file(s) with file size equal to this amount
and only this amount.
example: dst -fe50000
Option: Wildcard searching:
example: dst ???-* or ???-*.*
will find all file(s) with - in forth position with any
characters or numbers in first three positions.
files found might be: A-B-C.DOC, ART-1.EXE OR DOR--.COM
DST v1.0 Page 8
OPTIONS:
Option: dst -gt112792 -lt122592 -g -d
Will find all file(s) with dates greater than or equal to
Nov 27, 1992 and less than Dec 25, 1992 and will allow
you to go to this directory or delete said found file. You
will also have at -g or -d the option of quitting this
search by hitting a 'Q' or 'q'.
Option: dst -gt112792 -lt122592 -fg500 -fl100000 -g -d
This will find all file(s) greater than or equal to date
entered in -gt and less than file date in -lt with file
size greater than or equal to and filesize less than in
-lt plus all you to change to directory where file was
found or delete said found file.
Option: dst -gt112792 -lt122592 -fg500 -fl100000 -p
This will find all file(s) greater than or equal to date
entered in -gt and less than file date in -lt with file
size greater than or equal to and filesize less than in
-lt plus will stop and pause after screen is full and will
wait for you to touch a key before continuing or you can
hit a 'Q' or 'q' to quit and return to starting directory.
as you can see you can mix many of the commands together to search for
file(s) the way you want.
For DST to work correctly, you need to put the file DST.EXE in a directory
in you path, best place is in DOS directory or if you prefer somewhere else.
At the dos prompt c:\>path and hit enter.
example of path: path=c:\dos;c:\borlandc\bin;c:\windows;c:\dir\etc\
use dos copy command to put in directory of your choice.
example: c:\>copy dst.exe \dos and hit enter key.
That's all that's required to use DST.
DST v1.0 Page 9
The source code to this program is available for $10.00 U.S. currency
to obtain the commented source code please send payment to:
Bits, Bytes & PC's
c/o Joseph J Kowalczyk
11712 Gila dr.
Kuna Id, 83634-2640
This will also make you a registered owner of DST and now you can add
any feature(s) you wish and you don't have to pay any royalties for
any updates or enhancements you make to this program. You can even
change name, add new features and sell the program yourself. All I ask is
you mention who the starting author was somewhere in your documentation.
End of document.