FileGraph V1.0 for OS/2 and DOS

(C) Copyright 1994 by Paul Mitchell / Mystic Software

Released as freeware 23rd January 1994



What is FileGraph?
------------------
A simple tool to graph the size of each subdirectory on a disk relative to
the total amount of space used on the disk. It is especially useful when
space is tight and you need to delete something. Use FileGraph to determine
which directories use the most space.


Features Common to Both Versions
--------------------------------
a) Fast
b) Supports any reasonable screen size (i.e. 80x50, 132x43)
c) Supports any standard media - floppy, CD-ROM, network drives...


Features Unique to the DOS Version
----------------------------------
Err... um...


Features Unique to the OS/2 Version
-----------------------------------
a) Supports HPFS long file names (only first 64 characters, though)
b) Runs in an OS/2 window
c) Runs on the best desktop operating system available
d) No practical memory limitations
e) Runs in the background
f) Need I say more??? If you don't have OS/2, buy it!


Installing FileGraph
--------------------
After decompressing the archive you should have two executable files,
FGDOS.EXE (the DOS version) and FGOS2.EXE (the OS/2 version). Copy the
version you want to use into a directory on your PATH, and rename the
executable to FG.EXE for convenience.

If you want to use both versions, make sure that the OS/2 version is
in a directory earlier in the PATH than the DOS version.


Running FileGraph
-----------------
If you followed the installation instructions above, you should simple type

        FG

at the command prompt. The current drive will be scanned and the directory
graph will appear. If you wish to scan a drive other that the current one,
add the drive letter to the FileGraph command line i.e.

        FG D       will scan drive D:


Using FileGraph
---------------
By now you should be looking at a fairly standard directory tree. The
cursor directory is highlighted on a red background. You can move this
using the cursor keys, PageUp, PageDown, Home and End.

If at any time you want to exit, press Escape.

You may have noticed that only one level of directory is shown. Also, some
directories have a "+" to the left of the name. This sign indicates that
there are sub-directories under the directory. Move the cursor to a
directory with a "+" beside it and press Enter. One more level of the
tree is displayed. The "+" will also change to a "-" to indicate that the
structure has been expanded. Press Enter again to collapse the tree.


The Information Shown
---------------------
The graph bar after each directory name represents the relative
percentage of the total space occupied by the directory. The graph is
calibrated to the *maximum* percentage occupied by any single
directory. A green bar means that the percentage is less than a third
of the maximum. A yellow bar means less than two thirds and a red bar
means two thirds or over. However, it's really just a pretty picture!

The column of numbers under the title "Files" shows the number of files
contained in the directory. The column titled "Dir Size" shows the number
of bytes occupied by the files, and the final column titled "%Total" shows
the percentage of the used space occupied by the directory.

If a directory has it's structure collapsed (i.e. the "+" sign is showing),
the three figures represent the totals for the directory and all its
subdirectories. Expanding the tree by pressing Enter will change the figures
to show the values for each subdirectory.


Registering FileGraph
---------------------
FileGraph *is* freeware - I don't demand that you pay for it. However, if you
do save time by using FileGraph, send me some email saying that you use and
like it. You can also email me with bug reports or suggestions.

Also, I don't want to discourage anyone from sending me some money. This
will further my research into PC software... actually, it'll help to pay
the bills but I won't tell you that because it'll sound like I'm begging :->

Does anyone want to see an OS/2 PM version? If there's enough demand I'll
do it. Don't request a Windoze or Windoze New Trash version because I won't
do it, never, ever even if you pay me heaps. Of course, I've never been
afraid to re-evaluate my convictions :-)


Contacting the Author
---------------------
I am Paul Mitchell, aka Mystic Software.

Compuserve ID: 73064,761
Internet:      73064.761@compuserve.com

Snail Mail:    Paul Mitchell
               15 Union Street
               Aberdeen
               Scotland, AB1 2BU
               UK



