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 "". 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