Problem : What is eating up all the space on my disk?
-------

Solution : DAAG (Disk-at-a-Glance) Version 3.2, April 1993
-------

Purpose : - To provide a tree structured directory "map" of your
------- hard disk(s), with Directory Sizes and Branch Sizes!

- To make it easy to Change Directories
(never type "CD\... " again!)

- Printed Report helps you know "What's installed where?"
Useful for Corporate Customers to track software
installed on multiple machines.

========================= Key Features ============================
| * Tree-structured Directory Map with Directory & Branch Sizes |
| * Quickly LOCATE directory by typing in partial name |
| * Useful statistics relating to File and Directory Size |
| * "Drill Down" gives useful summary of File Extensions |
| * Quickly Change Directory / Logical Drive |
| * Shows Hidden Directories |
| * 3 Piecharts and Bar Graphs (need EGA or VGA!) |
| * Includes Delta-DAAG, a program to TRACK FILE CHANGES !!! |
| * Includes a Graphic front end program (DFE) |
| * Includes a file BROWSE program (SHOW.EXE) |
| * Can "launch" programs without taking up any extra memory! |
| * Printed Report helps inventory installed software |
| * Handles up to 5000 directories! |
| * Mouse Aware - can even "type" in run parms with the Mouse |
===================================================================

Installation : Simply copy DAAG.EXE, DELTAD.EXE, DFE.EXE, and SHOW.EXE
------------ into any directory in your PATH.

Type "DAAG" at the DOS prompt; then READ THE SCREEN!


Moving through the Tree Map
---------------------------

Use the UP and DOWN ARROW KEYS, PGUP, PGDN, HOME, and END to scroll
through the directory map.

Alternately, type part of the directory name, and the light bar will jump
to that directory as you type.

If your system is equipped with a mouse, you can move the mouse cursor to
the desired directory and click the Left Button, or click on the up and
down arrow pointers located at the ends of the Scroll Bars.

If you are using a mouse, you can click on amy of the Function Key literals
on the bottom line (hint line) of your screen.

These keys and their functions are summarized below:


Notes on the Scrolling Tree Map
-------------------------------

- The "AO date" is the date that the Tree Map file was last generated.
You should periodically regenerate this file with the F7 key.

- Hidden directories will appear with an "(H)" following the directory name.

- The Cumulative size column for any directory refers to the number of
bytes in all the child directories of THAT directory, plus the number
of bytes in the directory itself. If the directory has no subdirectories,
then the cumulative value is left blank (since it is the same as the
directory).

- The "% of disk" column indicates what percent of the Total Disk is used
by each directory.

However, on the Pie Charts, each slice represents which percent of the
"used disk space" is taken up by a directory. This is required so that
the Pie Chart percents will always add up (approximately, due to rounding)
to 100%.

- The "Dirs" column gives a count of how many directories are in this
branch, including itself. However, if there are no subdirectories,
(meaning the count is 1) the number is not displayed (to reduce clutter,
in the same manner that the cumulative size is blank).

By looking at the value for the root Directory, you can immediately
see how many directories are on the disk.

*** Remember: If you add or deleted directories, they will not show up
on the Tree Map until you Regen the Tree (with the F7 key).

F2 - To Change to Another Drive
-------------------------------

Hitting F2 from the main window will present you with a list of other
available logical disk drives (Note "A" and "B" are not included).

Use the arrow keys to select a drive and hit enter, -or-
type the drive letter, -or- click on the desired letter to change to
the requested disk drive.

You may also make DAAG start on a drive other than the current drive by
adding the destination drive followed by a colon to the command line.
For example, typing "DAAG D:" at the DOS prompt will cause DAAG to start on
drive "D", regardless of which drive you are currently on.

Note: Typing a nonexistant drive will be ignored.

F3, F4, F5: PIECHARTS & GRAPHS
------------------------------

Hit F3 to get a piechart of the top 16 directories by number of bytes
of disk used. If you have more than 16 directories, then the smallest
ones are grouped collectively under "Other".

F4 produces a similar piechart, however, only the FIRST LEVEL directories
are shown. This means that only the directories that are directly under
the Root Directory are shown. The file sizes for each include ALL the
subdirectories under the first level directory.

F5 produces a piechart similar to the F3 option, but considers only the
current BRANCH (hilighted directory AND all subdirectories under it).
Hitting F5 with the light bar on the Root Directory produces a pie chart
identical to that of hitting F3.

Regardless of which pie chart is selected, hitting Enter or Escape, or
clicking either Mouse button takes you to the BAR GRAPHS screen.

Purpose of the BAR GRAPHS
-------------------------

The piecharts show "the top 15" directories, as far as being space hogs.
(Everything else is lumped together under "All Other"). When you get a
hard disk with 200 or more directories, the ALL OTHER gets too big, and
every other "slice" is too small.

The BAR graphs show ALL directories, but only about 50 can be seen at
a time (or the directory names start to collide). The density of the
bars graphs is controlled by F3 (increase by 5) and F4 (decrease by 5).

If the biggest directory is much larger than the others, then the graph
scale range is only good when seeing that big directory. As soon as you
shift right, the scale is readjusted so that the biggest directory in the
group you are currently looking at takes up the whole scale.

Note that this screen shows ALL DIRECTORIES for the type of pie chart
selected (All, First Level , or Branch).

Hit or click the Left and Right Arrow Keys to shift the bar graph left or
right 1 bar at a time. Hit CTRL + Left or CTRL + Right to shift left and
right 5 bars at a time.


Use the UP and Down arrows (or click the up/down icon) to shift the graph
up and down, allowing more or less of the directory names to show.

Hit ENTER, ESCAPE, or click the Exit button to return to the Tree Map.

The piecharts and graphs require an EGA or VGA monitor.

ENTER - Drill Down
------------------

Hitting ENTER (Drill Down) from the main screen will give you a summary of
the highlighted directory - displaying a scrolling window of files and
sizes, grouped by EXTENSION.

Hitting any key will cause the light bar to jump to the first entry
beginning the with that letter.

File List by Extension ("Drill Down")
-------------------------------------

Hitting enter (or clicking the left mouse button with the cursor on the
OK box) opens up a third scrolling window of FILE NAMES containing the
hilighted extension.

This window is also sortable by FILENAME or by SIZE.

Individual files in this third scrolling window may be deleted
by hitting the DEL key, or clicking on the DEL literal.

Printing the Report
-------------------
Hit the F8 key, or click on the "*" on the bottom line to print the Tree
Map Report. A dialog box will prompt you to enter an optional Machine ID,
which is useful if you manage several different machines. If using a mouse,
you can click within the dialog box to get the on screen keyboard, and type
in the Machine Id entirely with the mouse.

Printing in Batch Mode
-----------------------
If you run DAAG by typing "DAAG PRINT" (where "PRINT" is in capital letters)
DAAG will print the tree map for the current drive, then end. This way, the
report can be printed from a batch file, which could run "DAAG PRINT" for
several different drives as follows:
(sample bat file)
C:
DAAG PRINT
D:
DAAG PRINT
E:
DAAG PRINT
(end sample bat file)

Program Launch & File Browse
----------------------------

Hitting ENTER when in the third scrolling window will allow you
to RUN ("launch") the highlighted filename if it is a program (has a file
extension of "EXE" or "COM". A Dialog box will popup, in which you can
enter run time (or Command Line) parameters. If you have a mouse, you can
"click" inside the dialog box (not on the OK button) and you will get an
"on screen keyboard" so you can type in the parameters with the mouse!

Note: If the parameters and the program name exceed 16 characters the
keyboard buffer will fill up, and you will have to re-type any additional
characters at the DOS prompt.

Browse
------

If the highlighted filename has an extension other than "EXE" or "COM", DAAG
will Browse the file provided that you have a browse program named "SHOW.EXE"
available along your search PATH.

If you prefer to use a different file browse program, such as LIST.COM or
even the DOS editor EDIT.COM, simply create an environment variable called
"DAGBR" set to the browse program name. For example, the statement
"SET DAGBR=LIST.COM" (without the quotes) would create the environment
variable for List.Com. You can then type the word "SET" by itself at the
DOS prompt to see all environment variables that are set.

You should add the "SET DAGBR=pgmname" statement to your autoexec.bat file.


SHOW.EXE
--------

For people that do not have LIST.COM, enclosed with DAAG is a workable
but limited browse program called "SHOW.EXE". It is not as good as
LIST.COM, but is included for anyone who does not have a stand alone
browse program.

However, the program is mouse aware (you can even type a search string
with the mouse by clicking on an "on-screen keyboard"), and can browse
text files larger than 64k.

Hot Keys to DFE and DELTA-DAAG
------------------------------
To leave DAAG and "jump into" DFE, press Shift and F2 simultaneously.
To leave DAAG and "jump into" Delta-DAAG, press Shift and F4 simulataneously.


F7 - Regen Tree
---------------

The DAAG statistics are only as current as your last "snapshot". Periodically,
you should take a new snapshot to bring you Tree Map up to date. Hitting
(or clicking with the mouse on) F7 will create a new snapshot and make the
tree map current.

The MAP File
------------

The first time DAAG runs, it will scan your disk and create a "snapshot"
of your directory structure (tree map).

Normally, DAAG stores the tree map in a disk file called "DAG32.TRE", in
your ROOT Directory.

On some networks you do not have "rights" to the root directory.

If you do not want DAAG to store this file in the root directory, then
create a subdirectory named DAAG. (Type "CD\", then type "MD DAAG").

DAAG checks for a directory name of "\DAAG". If it exists, it stores the
tree map file there. Otherwise, it stores it in the root directory.


Changing the Color Scheme
-------------------------

There is no longer a color installation program for DAAG. Rather, there are
5 predefined color combinations (palettes) from which to choose.
You specify which palette to use in one of two ways:

1) Enter a number from 1 to 5 on the command line after "DAAG".
For example, type "DAAG 3" to see DAAG with color combination number 3.

2) Add the line "SET DAAG=n" (where n is a number from 1 to 5) to your
AUTOEXEC.BAT file. This will create an environment variable called DAAG
that contains the value of the desired palette.
(Note: You will have to reboot your system in order for the change in
your Autoexec.bat file to take effect).

MEMORY REQUIREMENTS
-------------------

DAAG requires about 370k of memory.


A note on adding up the file sizes
----------------------------------

Notice that the sum of all directories (the Cum. Size for the ROOT
Directory) is not exactly equal to the Current Used Space listed at the
bottom of the screen (total disk size minus the space available).

This is because DOS allocates file space in CLUSTERS (usually 2048 or 4096
bytes to a cluster). Even a 20 byte batch file will actually use 2048 or 4096 bytes
(depending on cluster size).

Warranty:
---------

There is no warranty, period.
Steve Leonard specifically disclaims all warranties, expressed or implied.

Use this product (DAAG.EXE, DFE.EXE, DELTAD.EXE, and SHOW.EXE)
at your own risk.

In no event shall Steve Leonard be liable for any loss of profit,
or any other damages or loss incurred because of this product.


Distribution of these programs:
-------------------------------

DAAG, DFE, Delta-DAAG, and SHOW may be used by anyone FREE of charge,
for an initial 30 day evaluation. Additionally, they may be distributed
by Shareware companies for a reasonable fee not to exceed $8 per diskette.

The only requirement is that this DOC file is included, and not altered.

If you continue to use these programs after an initial 30 day evaluation
period, then you are required to send a $15 payment plus $2 shipping to :

Note that the $15 covers all 4 programs: DAAG.EXE, DELTAD.EXE, DFE.EXE,
and SHOW.EXE

Steve Leonard
212 Green Springs Ln.
Madison, AL 35758

I may be reached on Compuserve at : 73557,203

Updates for Registered Users of earlier versions of DAAG: $6
------------------------------------------------------------
(Sorry, cannot register the upgrade on Compuserve - must mail
$6 and approximate date of registration directly to Steve Leonard.


***************************************************************************
* Fast! Convenient! Register on Compuserve !!!!! *
* *
* I am in the process of establishing a relationship with Compuserve to *
* accept DAAG registrations from Compuserve members. Please type *
* "Go SWREG" and search the database using "DAAG32" as a keyword. *
* *
***************************************************************************

Benefits of Registration
------------------------
1. Receive a printed User Manual.

2. You are fulfilling a moral obligation. The author has spent over
$1000 on compilers, toolboxes, and books required to write this
program, as well as hundreds of hours of time. Since you are given
the opportunity to try the program first, why not pay for its
continued use?

3. You will receive a BONUS DISK, containing the latest version
of the program, along with some other utility programs that I have
written, including:

* NUSTUFF, an ancient but still useful utility that scans your entire
hard disk for files that are a user-specified number of days old.
Good for finding that file you created last week, but can't
remember what you called it, or where you put it.

* View2, a text file compare utility that lets you browse 2 files
side by side, each in its own resizable window. Perfect for
programmers who need to compare the current program to the "*.BAK"
file. Lets you manually resynch the compare when large blocks of
code have been added or deleted.

* CHAAG (Charts-at-a-Glance). This program draws hierarchical
charts directly from text files, using indentation to denote levels
of subordination. Turns your outlines into pictures.

* VO (View Open) - A memory resident program that shows what files
are open at any point in time. Useful for programmer debugging or
just general snooping. See what files that program is using.

* LASER1 - prints single mailing labels to laser printers. It allows
you to specify which position on the sheet to print to, so that
you can later reuse the same sheet, printing to a different
position. Is memory resident and uninstallable, so that your
existing applications can print a single label to the laser printer.
You create a config file, indicating which positions on the screen
to capture the data from. Works only for 1 3/4" by 4" (2 up)
labels, such as AVERY 5262.

All programs will be in ZIP format on a 5-1/4 inch DSHD (1.2meg) floppy disk.

Attention Corporate Users:
--------------------------

Why not buy a DAAG "site" license and use DAAG on all your machines?
Printing the Tree Map is an easy way to track what is installed on which
machines.

The cost is minimal: Unlimited machines $149