
WinDirUsage V1.3
 1993 by Kevin Routley.  All rights reserved.

WinDirUsage is a shareware MS-Windows utility that provides
a graphical display of disk space usage.  This is a
convenient way to identify those directories which are the
biggest disk space consumers.  WinDirUsage uses a pie chart
format and permits the examination of any directory on any
drive.

Several new features have been added to WinDirUsage since
V1.0, primarily customization of the font and labelling,
and a file pie chart.

Getting Started
===============

WinDirUsage initially reads the drive it was executed on.
So if you run WinDirUsage from a floppy disk or another
drive which has no subdirectories, the pie chart will merely
show a circle and 100% of the disk space used by the files 
in the root directory.

WinDirUsage allows you to select any drive on your system.
Click on the down arrow next to the pulldown menu in the
upper left corner to see available drives.  The drive type
(floppy, hard-disk, RAM-disk, network, or CD-ROM) is
indicated by a small picture next to the drive letter.
When a drive has been selected, WinDirUsage will read the 
contents of the new drive.  

For a directory that has subdirectories, WinDirUsage will
show a pie chart that has slices showing the size of each
directory tree.  For a directory that has subdirectories,
WinDirUsage will show a pie chart that has slices showing the
size of each directory tree.  The list box also shows each
directory, sorted in order of size, largest listed first.
The smallest directories will not be shown in the pie chart
but are shown in the list box.  

You can select a new directory to view in more detail by
either selecting the new directory in the list box, or by
clicking on the section in the pie chart.

When you select a new directory to view, two new entries
will be added to the list box.  "Root directory", when
selected, will cause WinDirUsage to redisplay the root
directory of the current drive.  Selecting the "Parent
directory" item will make WinDirUsage redisplay the contents
of the directory one level up from the current directory.
The labels for these two entries may be changed, see the
"Labelling and Font Options" section below.

The WinDirUsage window can be resized.  The pie chart and
list box will expand to the new size of the window.  The
window cannot be made smaller than its initial size.

Files Display
=============

In each directory there is an entry in the list box labelled
"<files>".  This represents the files at the root of the 
current directory tree.  Clicking on this entry, or its
corresponding pie segment invokes the files display.

The files display consists of a pie chart and list box showing
the relative sizes of the files at the root of the current
directory tree.  The percentage shown is relative to the total
space at the root of the current directory tree, not relative
to the entire disk.

In WinDirUsage V1.3, no manipulation of the files display is
supported.  The window may not be resized, nor is the selection 
of files in the display supported.

Labelling and Font Options
==========================

Two dialog boxes are available from the WinDirUsage system
menu (ALT-Space).  The Font... dialog box allows you to
select the font used.  

The Labelling Options ... dialog box allows you to 
customize several aspects of WinDirUsage.  You may choose 
among several labels for the "Parent Directory" and "Root
Directory" entries.  You may label the pie chart segments
in Percentage, Kilobytes, or Megabytes.  You may choose to
show names in upper or lower case.

The 'Reset' button restores the options in the "Labelling
Options..." dialog box to their original settings.  The
'Defaults' button sets the options to the default options.

Your font and labelling choices are stored in WINDIRU.INI
which will be created in your windows directory.  Currently,
the size and placement of the WinDirUsage windows is not
stored in the .INI file.

Limitations Fixed
=================

WinDirUsage V1.3 has fixed some of the limitations that 
existed in V1.0.  The limitations fixed are:

	- The 50 directory limit has been removed.
	  WinDirUsage can now handle as many directories
	  as memory permits.

	- The color limit has been fixed.  WinDirUsage
          V1.3 starts over with the list of colors instead
	  of displaying random colors.

	- WinDirUsage V1.0 may not have properly supported
	  80286 machines or machines with no math coprocessor.
	  These limits have been fixed.

        - WinDirUsage has been tested successfully with Windows
          NT (Intel and AXP versions), with the exception of 
          the HPFS.

Limitations
===========

WinDirUsage V1.3 has a few limitations that may be fixed
in future updates:

	- WinDirUsage will always read the contents of the
	  drive whenever a disk or directory is selected,
	  even if that directory has already been read once.
	  Only registered users will receive a version of
	  WinDirUsage that has this limitation removed.

        - Invoking the Labelling Options... dialog box causes
          a disk read.  This is not a limitation in the 
          registered version.

	- WinDirUsage doesn't handle empty floppy drives.  If
	  you select a floppy drive to read there must be a
	  floppy disk in it.

	- The mouse is required to use WinDirUsage, the
	  keyboard is not supported.

	- WinDirUsage has not been tested with Windows V3.0
	  or OS/2.

        - WinDirUsage doesn't fully support the High Performance
          File System.  HPFS files with names that don't fit
          the MS-DOS naming convention will be ignored, 
          resulting in incorrect disk usage/percent information.

        - WinDirUsage will read recursive disk pointers until
          memory is exhausted.  This is primarily a problem with
          corrupt MS-DOS disk structures and with OpenVMS [000000] 
          directories.
          
        - The "Indicate Expandable Branches" and "Show space data 
	  in List Box" options are not implemented.

	- Switching the case of file names will not take effect
          until the next disk read.

Registration
============

WinDirUsage is shareware, which means it is not free.  If
you find WinDirUsage useful, please send in the registration
fee of $10 (U.S.).

Those who register of WinDirUsage will receive:

	- A registered copy of the most recent version of
	  WinDirUsage.  Only registered copies of WinDirUsage
	  will not always re-read the contents of the drive.

	- Notification of new versions of WinDirUsage and
	  low-cost upgrades.  Upgrades are currently $6 for
	  registered users.

        - Preferred technical support and new features.

        - Participation in beta test for the next version.

	- Satisfaction from supporting the shareware concept

The registration fee should be sent to:

	Kevin Routley
	Tekra Software
	P.O. Box 7198
	Nashua, NH  03060-7198

Please specify your preferred floppy disk size (5 1/4" or
3 1/2").  If no size is indicated you will be sent a 5 1/4"
diskette.  Site liscensing is negotiable.

$5 (U.S.) to the above address will get you the most recent
unregistered version of WinDirUsage.

Please contact me for instructions regarding registration
with non-U.S. funds.

These fees are guarenteed to be effective through 
December 31, 1994.

Future
======

New versions of WinDirUsage will be released over time,
depending on demand and how quickly I can add new features.
I have over 40 features or tweaks on my list.  Some of the
features planned or being considered include:

	- more colors, color customization
	- remembering windows placement and dimensions
	- file manager drag-and-drop support
	- displaying the largest file in the directory
	- on-line help
	- keyboard support
        - multiple disk charts displayable at the same time
        - refresh disk/directory buttons
	- detailed directory/file information available
        - indicate expandable branches
        - cluster size effeciency report

Other suggestions, ideas, or constructive criticism are
appreciated!  I can be reached at the above mail address or 
via the Internet address below.  I hope you find WinDirUsage 
useful!

					Kevin Routley
					routley@4gl.enet.dec.com
                                        routley@decral.enet.dec.com
					October 11, 1993



