NOTE: The directory program D45 and its documentation are parts of a larger
collection of programs called DStuff. This release of D45 by itself is a
special edition of the program prepared for COMPUTE!'s PC Magazine by the
author.

As a special offer to our readers, TOADWare Software will send
you an unregistered copy of the complete DStuff on disk for only $3.00. You
can apply the $3.00 later as a credit if you decide to register your
copy of DStuff. You can also register for DStuff at the regular
registration prices of $15.00 and $25.00 and receive the latest
version of DStuff. See the information at the end of the documentation for
more details about registering DStuff.

------------------------------------------------------------------------

D45 - The Colorful Directory Program
TOADWare Software Systems
Version 4.5
August 9, 1989

Introduction:

D45 displays any DOS directory in a paged format.
Normally the directory information is sorted and displayed
in ascending order by file name, but with command line switches
the information can also be sorted by the file size in ascending
or descending order. If needed, the display can also be switched
to display the date the file was last written to instead of its size.

This program was designed to display the most needed
directory information as quickly as possible on the computer
screen. The program displays all the files (including hidden
files) and their sizes in screens of 60 entries at a time. By using
color, the current DOS attributes for each file will also be shown.

Attributes Used:

Normal DOS File (files that have not been modified since the last back up),
Archive File (files that have been modified), Sub Directory,
Hidden or System File (files that have been hidden from the DOS dir
command), and Read Only File (files that cannot be removed with the
DOS DEL command).

Screen Information:

The disk label (if one exists) and file mask D45 is using
are displayed on the top line in yellow.

The bottom line of the final screen has the number of files
that match the mask, the disk space taken by those files, the
total disk space taken on the entire disk, and the total free
space remaining on the disk.

Any command line entry format that can be understood by the
DOS DIR command can also be understood by D45. If an empty
screen is displayed, examine the mask on the top line to be sure
D45 correctly parsed the command line entry.

Finally, the program can be stopped during multiple screen
displays at any time by pressing CTRL-C or the ESCape key.
The program finishes the current screen and returns to DOS with
a "Program Stopped" message on the bottom line.

Default Screen Colors:

These are the initial screen colors used and their meanings
(these can be changed with the /C option).
.
Foreground Background Meaning

__________ __________ _______
Light Blue Black Frame
Light Gray Black Normal File
Light Cyan Black Hidden File
Light Red Black System File
Light Green Black Sub Directory
Light Magenta Black Read Only File
Bright White Black Archive Bit Set

Command Line Entries:

Some examples of command line entries are (assuming
currently logged drive is C:)

Command Mask Comment
D C:*.* All of the files in the
current directory.
D \ C:\*.* All of the files in the root
directory.
D \COPY C:\COPY\*.* All of the files in the
COPY subdirectory on the
current drive.
D \*.COM C:\*.COM All of the .COM files in the
root directory.
D A: A:\*.* All of the files in the
root directory of the A
drive.

Command Line Options:

/I - This option displays an information screen containing
the valid command line options and their meanings, how
to contact TOADWare, and the currently defined screen
colors.
/C - This option allows the operator to customize the
foreground and background colors used for all fields.
/L - By using this option on an EGA or VGA video system, a
greater amount of information can be shown at one time.
Normally, information is displayed in screens of 25
lines at a time. By using this option the same
information is displayed in 43 (EGA) or 50 (VGA)
lines at a time. If this option is enabled on a CGA or
Monochrome video system, it is ignored.

Normally the directory is sorted alphabetically by the file
name. This can be changed to sort the directory by file size in
ascending or descending order using the following command line
switches :
/A This option causes the directory to be sorted
in ascending order by file size (smallest first).
/D This option causes the directory to be sorted
in descending order by file size (largest first).
/T This option switches the displayed information
from the file size to the date the file was last
written to.

Displayed Entries Per Screen:

CGA (25 lines) EGA (43 lines) VGA (50 lines)
_________________________________________________

Per Column 20 38 45
Per Screen 60 114 134

Color System Support :

If an EGA or VGA display system is being used, then direct
screen writing is used. If a CGA system is being used, then
the retrace signal is monitored so no snow appears. All color
systems have access to the basic 16 colors of EGA, VGA and
CGA systems.

Configuring Screen Colors with /C:

The foreground and background colors for all of the fields
can be reconfigured with the command line option '/C'. You can use
a Microsoft-compatible mouse to select colors if you wish.

System Requirements:

D45 requires DOS 2.1 or higher. With PC-DOS 2.1 and Tandy MS-DOS 2.11,
you won't be able to use the screen configure option. An EGA or VGA
video system is recommended but not required.

Warranty:

With respect to the physical disk, TOADWare Software Systems
warrants the same to be free of defects in materials and
workmanship for a period of 30 days from the date of purchase. In
the event of notification within the warranty period of defects
in material or workmanship, TOADWare Software Systems will
replace the defective diskette. The extent of this warranty shall
be limited to replacement and shall not encompass any other
damages, including but not limited to loss of profit, and
special, incidental, consequential, or other similar claims.

TOADWare Software Systems specifically disclaims all other
warranties, expressed or implied, including but not limited to
implied warranties of merchantability and fitness for a
particular purpose with respect to defects in the diskette and
documentation. In no event shall TOADWare Software Systems be
liable for any loss of profit or any other commercial damage,
including but not limited to special, incidental, consequential
or other damages.

TOADWare Software Systems retains all rights to the DSTUFF
package and the right to make updates to this package and its
documentation without notification to the purchaser. This package
is sold and distributed "as is."

Newsletter:

TOADWare Software Systems also has a free monthly newsletter
that discusses TOADWare products (both current and future) and
different applications for these products. If you wish to be
included (at no cost or obligation), just check the proper line on
the order form and mail it to us. Registered users automatically
receive the newsletter.

DSTUFF:

D45 is part of the DSTUFF shareware package (where it's named
D.EXE). DSTUFF also includes:

DARC.EXE--This program displays the internal directory of the members
in a SEA "ARC" file.
DDBASE.EXE--This program displays the structure information of
any dBASE or compatible file.
DZIP.EXE--This program displays the internal directory of the members
in a PKWare "ZIP" file.

Registration:

D45 is a Shareware program and is not a public domain or free
program. Individuals are granted a free license to use the program
for up to 30 days on one Computer for evaluation purposes. To
continue D45 after that time, you must register DStuff in one of the
following manners.

Basic Individual - To use what you have.
Update notification.
Monthly Newsletter.

For $15, as an individual, you register for the full version
of DStuff. You are then granted a license to use the software contained
in the DStuff package on any computer as long as only one copy of each
of the programs in the DStuff package is ever in use at any one time.
You'll also be notified of updates to the DStuff package (there will
be a small handling fee).

Commercial or
Full Individual - A disk with the latest version.
1 Free major upgrade.
Hard copy of the documentation.
Monthly Newsletter.
Notification of updates.

For $25, you'll receive the latest version of the DStuff
package (or the next available version if you have the latest)
and a hard copy of the documentation. You'll also receive the
next major upgrade automatically and from that time on you'll
be notified of updates to the DStuff package (these are free when
you send a blank disk upon notification). You are then granted a
license to use the software contained in the latest version of
the DStuff package on any computer as long as only one copy of
each of the programs in the DStuff package is ever in use at any
one time.


Order Form:

Name : __________________________________________________

Address : __________________________________________________

City : __________________________________________________

State : ________________________ Zip : ___________________


Quantity Description Cost Total

_______ Basic Registration $15.00 _____
Update Notification.
Newsletter

_______ Commercial Registration with :
Latest Version.
1 Free Major Update.
Update Notification.
Newsletter
Printed Manual $25.00 _____

_______ 3 1/2" Media (720K) $ 2.00 _____

_______ Newsletter Subscription FREE 0.00

Shipping and Handling 2.00

Total $ _____

Send this form (with payment of course) to :

Richard A. Nichols
TOADWare Software Systems
3045 Argonaut Ave.
Rocklin, Ca. 95677


Thank you for ordering the DSTUFF Package and supporting Shareware.