------------------------------------------------------------------------------
| DOR.EXE |
| COPYRIGHT (C) 1990 Tim Ward |
| |
------------------------------------------------------------------------------

Many people are often annoyed by the DIR command built-in to DOS. They
say that it doesn't really tell them what they want to know, and users on
color systems especially complain about that bland monochromatic text that
DOS likes to throw at them. DOR was an effort to correct some of these minor
deficiencies. Actually, DOR does far more than DIR, and can and does perform
features found in DOS's CHKDSK command, in the SIZE command that some users
may be familiar with, and also the LOCATE command.
With DOR, you can list all files on your disk at once. If you wanted to
make a file containing a list of all files currently on your disk, you would
simply enter a command like "DOR \*.*/E-D > MYFILES.LOG" DOR can also calculate
how much space files REALLY take up on your disk, as with the SIZE program.
It of course, like DOS's DIR, gives you a count of how many files, and the
amount of free space left on the drive, as well as the total capacity of the
disk. You should note, that to retain similarity to DIR, the file count
includes any subdirectories, UNLESS YOU INCLUDE THE "/E" PARAMETER.
Unlike DIR and other utilities, DOR automatically inserts COMMAS into
number to make them more readable. It tries to find out the total memory
of your system (under DOS, it will probably only find 640K maximum - an early
silly oversight on the part of IBM (DOR does not search for extended or
expanded RAM. If your system has more, it may not be reported )) and the amount
free at the time (Naturally, it tries to underestimate if possible, and takes
into account some of its own size.)

To get help with the DOR syntax, simply enter "DOR /?" at the DOS prompt.
DOR is probably of more use to you if you occasionally "loose" hidden and
system files. And yes,DOR can search through hidden and system subdirectories.
It can display files in two columns, one column plus either file attributes,
plain, or real space used on disk, or four columns like BASICA's FILES.
To terminate the listing of filenames, use either Ctrl-C or the Esc key.
(DOR unfortunately still does not recognize the Ctrl-Break sequence.).
NOTE: This will not work unless DOR is actually printing filenames.

DOR 2.1 has a few changes over its previous incarnation, mainly in the
way it treats hidden and system files, along with some code refinements to
improve the way it handles subdirectory listings. Example - "DOR \D*" will
list all directories starting with "D" that are one level down from the root
directory. It also handles user key input better. Also improved is the way
DOR recovers from errors or user breaks, and the way it handles subdirectories.
(see note on following page)




-----------------------------------------------------------------------------
Directories and subdirectories.

DIR can usually find the subdirectory that you are referring to. DOR tries
its hardest to see which subdirectory you want to look into.
Say that your hard disk had a directory called "QUUX" and that you now were
in directory "FOO", and you issued the command "DOR QUUX" . DOR would
first look to see if there is a file called "FOO" in the directory QUUX. It
would then attempt to see if there was a subdirectory of QUUX called FOO.
Failing all else, it would then proceed to see if there was a directory called
FOO one level down from the root directory (i.e. "\FOO"). Sometimes DOR does
show you a directory that you didn't want, this occurs only when you misspell
the name of directory/file that you wanted to see, and THIS IS YOUR OWN FAULT !
Otherwise, it should show you what you want. Experiment! You might not guess
offhand that the easiest way to list all files on the disk was "DOR \/e+s+h"
You don't actually need to put spaces in separating the parameters.

-----------------------------------------------------------------------------
DOR is just another example of the mindless creations brought about by
Kawonk Experimental Software Projects. Later this year we hope to have a
prototype of the adventure game RUNCIBAL QUEST ready for release (you won't
be able to run it on a system with only 256K). Or, wait for the (possible but
at the moment improbable) release of the arcade game
"Revenge of the Ovuloid Citruses."
-------------------------------------------------------------------------------

DOR.EXE is NOT Public domain software. You are encouraged to test it and
give away as many copies of it as you like. However, if you do use DOR on
a regular basis, you are encouraged to send a contribution to the author.

Tim H. Ward
131 Naples St.
Corpus Christi
TX 78404

June 14, 1990.
---------------------------------------------------------->THaW<------------
Changes:
I have done a bit of minor rework to ensure more graceful exits from certain
error conditions (whereas before you might have been left in a different
directory from that which you started in), and cleared up a bit of confusion
about disks that have no volume label. Also have corrected a minor misfeature
that was noticeable only to users with a mono system (such as myself !!)
NOTE: Some people have asked about the /2 switch. In this listing mode, a "R"
will be displayed next to the file size if it is READ-ONLY. Also, in this mode,
files that have a "N" on their line DO NOT have the usual archive bit set.
A "*" appearing on the file's line indicates that it is unusual, either in
being READ-ONLY,HIDDEN,SYSTEM, or not having the ARC bit set. That's all that
it means, really. Sorry if there was some confusion.
June 21, 1990.
----------------------------------------------------------->THaW<---------------