PC World Komputer 1998 June B/Pcwk6b98.iso/Sharew31/Dstopo31/DISKTOPO.TXT

Text File | 1997-04-16 | 15KB | 360 lines

                    +--------------------------+
                    |    DISK  TOPOGRAPHER     |
                    |      USER'S MANUAL       |
                    |       Version 2.0        |
                    +--------------------------+

                           27 March 1997


                 Copyright 1996,1997 Niguel Software
==================================================================

                            TO BE NOTED

Thanks for your interest in Disk Topographer!  Disk Topographer is
a Shareware program which may be freely distributed subject to the
restrictions given in the Disclaimer and Licensing sections below.
If the software meets your needs and will continue to be used,
then the user is requested to please send $20.00 to:

                          Niguel Software
                          11 Taylor Place
                     Laguna Niguel,  CA   92677

By registering, you will be kept up to date as to releases of
future versions of Disk Topographer and will be able to access
free support via e-mail.

Disclaimer

This software should perform substantially as documented herein.
While having made every effort to minimize defects and/or errors
in the software, we do not warrant that the software will meet
your requirements.  The user assumes all risk of damage arising
from the inability to use, or consequential to the use of, this
software.

You are granted the right to use and to make an unlimited number
of copies of the Shareware version of this program but may not
reverse engineer or change any portion of this program.  The
software cannot be sold and cannot be bundled with any commercial
package or distributed by itself or accompanying books or
magazines without express written permission from the author.

Licensing, Registration, and Distribution

This is not free software.  You are licensed to evaluate Disk
Topographer for a period of four weeks.  If you continue to use
the software, then you are required to pay the registration fee of
$20 to Niguel Software.  Each concurrent user of Disk Topographer
must be registered.  Multiple user discounts are available.

Questions or comments may be directed via e-mail to [e-mail].

Copyright (c) 1996,1997  Niguel Software
All Rights Reserved

==================================================================

1. INTRODUCTION

Disk Topographer provides the user with a means for graphically
visualizing the distribution of files throughout your disks. Disk
Topographer provides a number of filters which allow the user to
define what type of files are mapped.

This manual gives the user a quick overview of Disk Topographer
and how it is used.  There are two versions of Disk Topographer:
one for Windows 3.1 and one for Windows 95.  The two versions are
identical in functionality.  The Windows 3.1 version is not
recommended for use on Windows 95.

Installation:

Disk Topographer was developed using Delphi and does not require
the installation of any support libraries (DLL's) or an
interpreter.  Three files are installed:
  - Executable file (DiskTopographer.exe or Dsktop32.exe for
    Windows 95 or disktopo.exe for Windows 3.1)
  - Disk Topographer icon (disktopo.ico)
  - This text file (disktopo.txt)
If you are installing from a Niguel Software disk, then
installation is accomplished by either double clicking the
dt32.exe (for Windows 95) or dt16.exe (for Windows 3.1) file on
the installation disk.  In Windows 95, you may also select "Run"
from your menu bar Start button and enter "a:\dt32" or "b:\dt32".
For Windows 3.1, select "Run" from the "File" pull-down of the
Program Manager window and enter "a:\dt16" or "b:\dt16".

The installation will not add Disk Topographer to the Task Bar
list of programs (Windows 95) or establish a program group icon
(Windows 3.1).  To add Disk Topographer to the Task Bar under
Windows 95:
  - Select Start/Settings/Task Bar using the Task Bar Start
    button.
  - Click on the "Start Menu Programs" tab.
  - Click "Add" then "Browse" to find the DiskTopographer.exe
    or Dsktop32.exe file and double-click the file name.
  - Click "Next" then select a folder (such as Accessories) under
    the 'Programs' folder or define a new utilities folder.
  - Click "Next" and give a name to the shortcut ("Disk
    Topographer") and click "Finish".
To add Disk Topographer to a program group in Windows 3.1:
  - Open an appropriate program group such as Accessories then,
    under the Program Manager File item, select "New".
  - Click "Program Item" then "OK".
  - Enter "Disk Topographer" as the Description then click
    "Browse".
  - Find the disktopo.exe file and double-click the file name
    which will define the command line.
  - Click "OK" - a Disk Topographer icon should now appear in the
    selected Program Group.


Removal:

Just delete the directory in which you installed Disk Topographer
(no other files need to be deleted).

To remove Disk Topographer from the Task Bar under Windows 95:
  - Select Start/Setting/Task Bar using the Task Bar Start button.
  - Click on the "Start Menu Programs" tab.
  - Click "Remove" then click the Disk Topographer folder and the
    "Remove" button.
To remove Disk Topographer from a program group in Windows 3.1:
  - Open the Program Group and click on the Disk Topographer icon.
  - Click "Delete" under the Program Manager File item.
  - Click "Yes" to delete the icon.

==================================================================

2. SETTING THE CRITERIA

a. Select a Disk

Click the pull-down arrow at the right end of this field to get a
list of drives on the system.  Find the disk you want and click on
it.  You may need to scroll up or down in the list to find the
disk.

b. Select the Directory

The directory list contains an entry for the selected disk plus
the directories on that disk.  The directory list is structured as
follows (assuming the selected disk is c:):

 *c:                             c:
    directory 1a                   directory 1a
    directory 1b-->double click-->*directory 1b
    directory 1c                     directory 2a
                                     directory 2b
                                   directory 1c

The currently selected directory (indicated by an * above) will
have its icon grayed.  As shown above, double clicking or
selecting a directory will cause the next level of directories
below the selected directory to be displayed.  When you first
start Disk Topographer or select a disk, the selected directory
list entry may be a sub-directory on the selected disk.  If you
want to view all the selected disk, then be sure that the
selected disk is high-lighted or grayed in this view.  Disk
Topographer will map whichever disk/directory is selected.

c. Select Display Mode

Disk Topographer can display file counts ("Ct" - total number
of files in each directory) or file sizes ("Sz" - total size
for all files in each directory).  Click on the option you want.

d. File Type

The three characters to the right of the period in the file name
("DOS name" in Windows 95) indicate what type of data is in the
file.  This is the file name extension.  If you want to limit Disk
Topographer to files of a given type, then click the pull-down
arrow and select the type.  If the type is not in the list, then
drag over the currently selected type to highlight it and enter
the three character extension of interest.  The default value
("*.*") will select all files.

e. File Size Criteria

If displaying file counts, then you can tell Disk Topographer to
limit the counts to those files whose sizes are greater than
("Gt") or less than ("Lt") a given value.  Click on the option
which you desire then click on the pull-down arrow to select the
limiting size.  If the size you want is not in the list, then
drag over the currently selected size to highlight it and enter
the size you want.  Note that the defaults are "greater than"
and "zero" for the size -- this will count all files.

f. Click Calculate Size Button

This begins the mapping process.  Disk Topographer will search the
disk, checking all files within the selected disk/directory
against the selected criteria.  The text field in the center of
the window will display the name of the directory which Disk
Topographer is currently checking.

==================================================================

3. THE DISPLAY

a. The Bar Graph

The results are plotted as a bar graph in the bottom half of the
window.  The first bar represents the size or file count for the
files in the selected disk/directory but not in the directories
within that disk/directory.  The remaining bars represent the
sizes or counts for each directory one level below the selected
disk/directory.  Using the selected directory shown in 2.b above:

    directory 1b
      files-------------------->bar 1
      directory 2a------------->bar 2
        directory 3a
          directory 4a
        directory 3b
      directory 2b------------->bar 3
        directory 3c
          directory 4b
          directory 4c

Three bars will appear in the chart corresponding to files,
directory 2a, and directory 2b.  Bar 2 will show the size or file
count for all the files and subdirectories in directory 2a (i.e.,
files in the following directories: 2a, 3a, 4a, and 3b).  The
file list to the right above the graph lists the files mapped
into bar 1.

If the bar graph ever disappears, then just click in the bar
graph area and it will reappear.

b. File Size/Count Totals

If displaying by file size, then the total file size for all the
files represented by the bar graph, the size of the disk, and
the free space on the disk are shown.  If displaying by file
count, then the total number of files represented by the bar
graph and the total number of files on the disk are shown.  The
total number of files on the disk is only shown if the full disk
has been displayed in the latest or a prior request.

c. Storage Efficiency

This is displayed only when the full disk is mapped and the file
size option is selected.  This represents the ratio of the
actual file size total to the amount of disk space allocated for
those files.  Windows allocates disk space in clusters.  The
clusters range in size up to 32Kbytes - the larger the disk
partition the larger the cluster.  For a 2GB disk partition, a
100 byte file will use 32KB - leading to poor storage efficiency
for large partitions with a lot of small files.  Upcoming
versions of Windows may decrease the sizes of the clusters.

d. File Size Graph

This horizontal bar represents the total disk size with a red
bar representing the disk space requirements for the files
represented by the bar graph (if displaying by file size) and
the black bar representing the amount of free space.

==================================================================
4. SAVING THE RESULTS

The "Save New" command under the File menu option (at the top of
the screen) allows you to save the results to a file on the disk.
A File Save dialog box will appear.  Select the directory in which
you wish to save the file, then enter the name of the file.  Disk
Topographer will append a ".dtp" extension to the file and save
the file.  The file is formatted for display with a spreadsheet
program (such as Excel).  To access the file, open it as a text
file with a comma as the field separator ("Open", "Text" button,
click comma, "OK", change "List Files of Type" to all files,
select file, then "OK" under Excel 4.0).  Don't over-write the
".dtp" with the new spreadsheet formatted data -- save the data in
a new spreadsheet file (e.g., xyz.xls).  If you over-write the
.dtp file, then Disk Topographer will not be able to append to it.

The "Print" command will print the same data as is saved by the
Save New command.

The "Save Append" command allows you to append the current results
to the results in an existing "dtp" file.  The appended file shows
each result as a separate column when opened by spreadsheet
software.  The results are displayed as shown below:

   Disk Report

   Disk:             c
   Directory:        \

   Disk Size         255,877,120   255,877,120
   Free Space         24,829,952    24,835,856
   Total File Size   204,098,027   204,098,737
   No. of Files            5,195         5,196

   Data                File Size    File Count
   File Extension:       *.*            *.*
   2
   Date                  3/26/97       3/26/97
   No. of Directories         32
   Files                  87,604            12
   ast-save               51,018            30
   astdu              16,750,995            29
   cardsoft              336,258            32
   ccscore               156,434            10
   delphi             20,433,957           663
   disktopo              700,447            10
   . . . .

The Data and File Extension lines indicate what type of data is
being displayed and what type of filtering.  By placing only file
counts or file sizes in a file, you can use the spreadsheet
options to produce three-dimensional graphs of the changes in
your disk usage with time.

==================================================================
5. EXAMINING THE RESULTS

Click on any of the bars and the directory name and size/count for
that bar will display in the text area above the chart.  (If you
click between two bars, the display will not change.)

Double click on any of the files in the file list and a window
will display showing the name, path, size, and date for the file.
The option to delete the file is available by clicking the Delete
File button.

==================================================================

6. NO MOUSE - NOW WHAT?

If you don't have a mouse or your mouse has died, then Disk
Topographer provides keyboard alternatives which allow you to
complete the tasks at hand.  The following will move you through
the various windows and menus:

Control Key plus Letter
            To select an item from the menu just
            press the key marked "Ctrl" along with
            the underlined letter in the menu item.

Tab
            The tab key will move the cursor from one
            field or button in a window to the next.
            Once in the field or button you need,
            then type in the required text, move
                        through a list with the arrow keys, or
            press the Enter (or carriage return) key
            for a button.

Arrow Keys
            If in a field which has a list (such as
            the list of file sizes or the list of file
            types), you can move from item to item in
            the list by pressing the up or down arrow
            keys.