

12th August 1995


Hi, this is V0.815 of HDSPACE.EXE.

Whats New?
==========

This version now has a "MAP" function, and gives information
about how much space you could save by converting a FAT drive
to HPFS.
See the detailed description at the end of this readme.
I now save the window position and reuse it at program start.

--------------------------------------------------------------

I'll write a HELP sometime later. In the meantime
a double click with the left mouse button on the window
where the drives are shown will hide the PM Controls,
same again to get them back. You must click on the background
though as I'm not sure if all situations of clicking on the
sliders or text will get processed (still in Beta).

Right Mouse Button on one of the drives Icons to get a Menu of
things you can do or see for a Drive.

Added an activity indicator to the totals window. This shows when
HDSPACE is getting information about the drives. Unfortunately (?)
on my PC (I486DX33) its so fast when just getting fixed disks that
its hard to see. If getting info for floppies too then its easy too
see as that takes a while longer.
It's the light on the Totals disk Icon.

Total disk space shows the totals space on all local fixed disks
in the system.

Swapper display is shown as part of the used disk space, swapper
size is shown in red. I don't display the size as a number,
but this way you see how much of your disk space swapper is using.
To see more details about swapper, the Details Notebook for the
swapper drive now has a "Swapper" page, there you can see the exact
size of swapper.

A small window during startup shows what refresh interval is set.
If Refresh=0, then no automatic refresh is carried out.

All internal settings are saved to HDSPACE.INI file when HDSPACE
is stopped. At startup HDSPACE tries to read that file,
if it can't then defaults are used. At the moment the window size and
position are not saved, this will be added later. If you break HDSPACE
somehow, then delete HDSPACE.INI and restart it. This way default settings
are used.

When selecting a VIEW of a drive, HDSPACE minimizes itself (so its
out of the way), you can get it back from the tasklist. It was possible
to get the VIEW ontop in OS/2 V2.1 but since Warp I can't get that to
work any more.

HDSpace now writes its information to a file HDSPACE.LOG.
If you select "Dump Data", then all the internal data about
the disks is written to the log at that time.

Due to popular (?) demand I removed the "Removables" and "Redirected"
menu points and I now treat all drives equally. You can hide drives
individually, RMB on the Icons to get the Drive Menu, that now has
a "Hide" item. To get a drive back, select "Show Drives", it gives
you a list of hidden drives, select the ones you want to see again.
The window is updated when you dismiss this menu.

The refresh function now refreshes the size for all drives that are
visible. I did once notice a situation where the window did not size
correctly as drives were hidden, but I cannot reproduce that. There
are some hooks in the trace written to HDSPACE.LOG to catch that, if
it happens then please let me know.

Another bug I am searching for overlays the totals stuff onto drive
A: sometimes. This occurs if totals are hidden and then drive A:
is "unhidden". Still not found the reason though!

In some cases the window will spring back to its old position,
known bug.


"MAP" function.
===============

This tries to show you what sub-directories are using the space on
your disk. This is the first version with a simple reporting function.
The information provided will be enhanced as I go along.

On opening the "MAP" window (which is in the DETAILS dialog,
RMB on a drive Icon to get this Dialog) a scan of the selected
drive is started, this gathers information about the structure
and files on the drive. You can re-run this at any time by selecting
the "SCAN" button on the dialog. Once done a "MAP" of the space being
used is created. If you close the dialog or select a different page,
the information is not lost, it is thrown away when HDSpace is closed.
Pressing the right-hand mouse botton (RMB) on a part of the map will
cause the directory name and size to be displayed on the dialog (this
is what will be enhanced). At the moment the display only goes down 3
levels of the directory structure (I'll make such things customizable
later). Directories that use little (percentage wise) or no space are
not displayed.

How to read the map!
Imagine this directory structure on a diskette:

  A:\                     1,000,000 bytes used on the diskette
   ROOT                  100,000 bytes
   CBOOK                 220,000 bytes
   IBMCPP                360,000 bytes
         BIN             260,000 bytes
         DLL             160,000 bytes

It'll look like this (without the text):

    *---*-----*--------------------------------------*
    ! R !  C  !      IBMCPP                          !
    ! O !  B  *------------*-------*                 !
    ! O !  O  !            !       !                 !
    ! T !  O  !   BIN      ! DLL   !                 !
    !   !  K  !            !       !                 !
    !   !     !            !       !                 !
    !   !     !            !       !                 !
    !   !     !            !       !                 !
    !   !     !            !       !                 !
    *---*-----*------------*-------*-----------------*
        10%   22%          48%     64%               100%


ROOT is shown as using space as there are files directly in the root.
CBOOK also uses space. Then IBMCPP uses a total of 78% of the USED!!!!!
space on the drive. Of this about 36% are files in the directory \IBMCCP,
26% used by files in \BIN and 16% in \DLL. The space used "LEFT to RIGHT"
depicts how much space the directory uses. To "visualize" the directory
structure read from top to bottom, it should be clear ;-).

If you click on IBMCPP you will be shown the value of 780,000 bytes, thats
because the files in IBMCPP and the directories under it use that amount
of space in total.

This is the first version, as I said it will be enhanced and made more
customizable as time goes on. At the moment I use 16 colours, 3 levels of
directories and a small dialog window, but it is quite fast!


HPFS
====

Notebook page on FAT drives gives information about the actual
sum of all file sizes on the drive, the amount of space allocated
to store these files. Then calculates how much space could be stored
(approx.) if the user were to convert this drive to HPFS. The larger
the partition (larger the cluster size) the more space can be saved
by converting.


Not all error conditions (none at all) are checked yet
when drawing this page.



Error reports to:

Brian Dorling @ MS3

or bdorling @ IBM.NET

or Brian_Dorling@ms3.maus.westfalen.de


Planned enhancements.


V0.81  The first part of the mapper will be in this one. This
        will probably just be limited to an overview of the
        drive. I plan to enhance it to then give a list box of
        the files in a sub-dir, sorted by size.

V0.82  Function to show how much disk space the user would save
        if he converted the selected FAT drive to HPFS.

V0.90  Add some help screens to this release.

??????  Colour and font selection dialogs.
        Save window size and position.
        Recognize when multiple drive letters all refer to the same
        physical drive (mostly seen on networks).
        Only show diskette B: if it really exists.


Suggestions ?



Fix History:

V0.80   Added display of swapper.dat size.
         To find the swapper, the boot drive is determined
         then the config.sys on that drive is read to find
         the SWAPPATH statement. Then I try to query the file
         to verify the correct path and filename.

V0.801  Last version did not find swapper path correctly when
         SWAPPATH=x:\ (where x: could be any drive letter) was
         specified in config.sys.

V0.802  Found another case where previous version did not find
         the swapper correctly.

V0.808  Removed "removables" and "redirected" differentiation. Now
         allow every drive to be hidden or shown as desired.

V0.809  Now stop the user from hiding all drives and the Totals at
         the same time. If totals are shown, then all drives can be hidden.
         If totals are hidden, then the last drive will not hide.

V0.815  Added "MAP" function. Save window position at program exit.
         Various small fixes.




