                   ShowMan - Disk Utilisation Pie-Chart

Purpose:

The ShowMan utility was written to help you keep disk space under control.  It 
does this by presenting a pie chart of what is on your hard disk or network 
drive, and allowing you to drill down into different sub-folders.  In this way, 
you can quickly identify what is taking up most space on your hard disk, and 
decide what to delete.  ShowMan is purely a read-only tool, quite deliberately 
it does not include any way of deleting files or folders!  You could consider my 
WinTidy program for removing backup and other temporary files, or my FindDupl 
program for detecting and deleting duplicate files.  ShowMan knows about hard 
disk cluster sizes, and will normally report the actual space occupied on the 
disk, rather than the nominal file size.  In this way, the full penalty of 
having a large number of small files is clearly visible.


Installation & Usage:

Extract ShowMan.exe from the zip file to a suitable location and run it!

If you don't already have Borland's run-time library, you will also need to 
download the file VCL30.zip from any site offering it.  For example:
  http://www.user.globalnet.co.uk/~hermes02/Freeware/VCL30.zip
Extract the file VCL30.DPL from this archive and copy to your Windows System
folder (e.g. \Windows\System or \WinNT\System32).  

There is no need to extract any of the source files which are also in the ZIP 
archive.  They are not required to run ShowMan.  When run, ShowMan will 
automatically scan the current folder, and most likely if you have extracted all 
the files in this archive to one folder, ShowMan.exe itself will be the biggest 
file.  Try using the Open menu or toolbar button to select another folder.  Also 
note that all files are found, even those marked with the hidden or system 
attributes.  While you shouldn't delete such files unless you _really_ know what 
you are doing, that's no reason for not being aware of the space they occupy.

Optionally, if you make a shortcut for ShowMan, you can have one parameter which 
causes the initial folder to be set and scanned.  

ShowMan will attempt to add a registry entry so that right-clicking a folder 
will include a "Usage PieChart" menu item to invoke ShowMan for that folder 
tree.  You can prevent this behaviour with the View, Options dialog.  If you 
remove ShowMan you will manually need to remove the registry key:

  HKEY_CLASSES_ROOT\Folder\shell\Usage Pie Chart\command

to remove the right-click menu entry.  Please exercise care when editing the 
registry.  


Notes:

The program is written for Borland's Delphi 3.02, and most source is included.  
You do not need access to Delphi to run ShowMan.  The program runs on 
Windows 95, 98 and Windows NT 4.0.

When dealing with NTFS-compressed files, the "nominal" display refers to the 
compressed size, and the "allocated" display refers to the cluster size 
quantised space actually allocated on disk by the compressed file.  This 
behaviour can be prevented by using the View, Options, Compression tab.

You can get the program to automatically repeat the scan, for example if you 
are monitoring a server.  See the View, Options, Timer tab.


Release information:

V1.0    1993 Feb 08  First version for Borland's Turbo Pascal for Windows
V2.0.0  1996 Apr 14  Version for Borland's Delphi 2.0
V2.0.2  1996 Apr 16  Pre-load Open dialog with '*.*' file name
                     Add number of files and folders display
V2.0.4  1996 May 26  Add E-mail address to About box
V2.1.0  1996 Jul 20  Add auto-registration as Folder Shell Extension
                     Collect size, allocated and slack simultaneously
                     Add option for displaying in bytes, kilobytes or megabytes
                     Save current displayed folder across option selection
V2.1.2  1996 Oct 20  Don't count folders as files (they are, but...)
V2.1.4  1996 Dec 08  Change to "standard" main form (was ToolWin)
                     Revise logo to mimic PieChart colours better
V2.1.6  1997 Feb 08  Add right-click on pie-chart file properties
V2.1.8  1997 Feb 16  Update PieChart to use Begin/EndUpdate for list box output
                     Use inherited, rather than copied, About box
V2.2.0  1997 Mar 01  Handle NTFS compressed files by recording the actual disk
                     space occupied rather than the nominal file size
V2.2.2  1997 Mar 15  Recompile for updated Pie Chart component
V2.3.0  1997 May 10  Version for Delphi 3.0
V2.3.2  1997 May 18  Updates following H J Harvey suggestions
                       - bitmap Up button
                       - split Status bar display
                     Allow user choice of fonts, saved in registry
                     Make Timer initially enabled, not in Create
                     Make PieChart derivative of MultiColourControl
                     Save PieChart colours in registry
                     Remove small hint status bar panel
                     Update more items on status bar while scanning
                     Make form resizable
                     Make ListBox hint reflect the file name clicked
                     Correct incorrect sequential display of compressed properties
V2.3.4  1997 May 23  Add updated glyph for Folder Back (from HH) and Open buttons
                     Disable Open button while scanning
                     Make status-bar updates more timely
                     Make right-click menu addition optional
                     Make About box read version info from the .EXE file 
                       - with Brad Stowers VersInfo unit
V2.3.6  1997 Sep 13  Version for Delphi 3.01
                     Handle "large fonts" more elegantly
V2.3.8  1997 Oct 06  Add maximum filename length display (for CD-ROM writing)
V2.4.0  1997 Nov 15  Add option to display free disk space (from Peter Jaspers-Fayer)
                     Prevent display of properties for non-existant files
                     Update FileInfo for Delphi bug in FindClose
                     Add "count of files" display
                     Build for use with VCL30.DPL
V2.4.2  1997 Dec 05  Version for Delphi 3.02
                     Handle disks > 2GB
                     Use ShellBrowseForFolder (from Brad Stowers BrowseDr unit)
V2.4.4  1997 Dec 12  Add simple print capability
                     (Requested by: Mark Watkins, mwatkins@telepath.com)
                     Only display NTFS "Compressed" label on NTFS volumes
                     Don't display free bytes if there aren't any, e.g. CD-ROMs
                     Remove Exit speed button, not used in most standard apps
V2.4.6  1998 Jan 11  Only force "compressed" display when showing free space
                     Provide Title for printed output
V2.4.8  1998 Feb 16  Correct registry entry to allow spaces in folder names
V2.5.0  1998 Jun 19  Add Windows 95 OSR 2 large disk info function
                     Add repeated scan option
                     Make the Display Free Disk function enabled by default
V2.5.2  1998 Aug 23  Correct intermittent failure to find updated large disk
                       function on original Windows 95      
V2.5.4  1998 Sep 25  Use low-level functions for correct cluster size on FAT32
V2.5.6  1998 Oct 02  Change registry entry to avoid "special" folders, e.g. Desktop


Program Status & Distribution:

This program is freeware, and remains copyright of David J Taylor, Edinburgh, 
1997-8.  This program is provided "as is", without any support.  Whilst I cannot 
answer queries relating to the use of this program, I'd value any comments or 
suggestions for improvements you may have (and there is considerable feedback 
from users in the present version of ShowMan).  Requests for distribution must 
be referred to the author, but will usually be granted if no commercial gain is 
involved.

TVersionInfoResource & TBrowseDirectoryDlg are from Brad Stowers
  http://www.pobox.com/~bstowers/delphi/
  Copyright bstowers@pobox.com (CompuServe 72733,3374)


Contacting the author:

Web site: http://www.users.globalnet.co.uk/~hermes02/
E-mail: david.taylor@gecm.com
1998 October 02
