home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / memmanagement / discspace_1 / !DiscSpace / !Help < prev    next >
Text File  |  1996-10-09  |  6KB  |  128 lines
  1. DiscSpace 1.11 (09-Oct-1996)
  2.  
  3. Purpose: Display of graphical disc usage statistics for directories
  4. Author:  Martin Wuerthner
  5.          Jahnstrasse 18
  6.          71116 Gaertringen
  7.          (Germany)
  8.          e-mail: wuerthne@minnie.informatik.uni-stuttgart.de
  9. Runs under: RISC OS 2 or higher
  10.             supports RISC OS 3 image files and DragASprite
  11.             StrongARM compatible
  12. Status: FREEWARE (see below)
  13.  
  14.  
  15. What is does:
  16. -------------
  17.  
  18. Have you ever wondered where all the free space on your hard disc has
  19. gone? Do you want to know which directories consume most of your hard
  20. disc space without having to count each directory using the filer?
  21.  
  22. This application shows a diagram of disc usage, displaying a bar for
  23. each directory. The whole directory tree is cached so you can open
  24. subdirectories similar to using a filer window.
  25.  
  26. How to use it:
  27. --------------
  28.  
  29. The main menu item 'Count' leads to a standard RISC OS save box. Drag
  30. the 'filer window icon' to the directory you are interested in (e.g.
  31. the root directory of a drive).
  32.  You may also simply drag a directory to the icon bar icon of the
  33. application. This is the easier way as long as you don't want to
  34. scan the root directory of a drive.
  35.  DiscSpace scans the directory and all its subdirectories displaying
  36. some kind of FilerAction window (offering the menu options 'Faster'
  37. and 'Verbose' like the real FilerAction window). Note that counting
  38. may take some time if the chosen directory is a top-level one.
  39.  
  40. Having finished the 'Count' operation, DiscSpace displays a window
  41. which shows a 'Total' bar for the whole directory and a bar for each
  42. subdirectory indicating how much disc space it consumes. By
  43. double-clicking on a subdirectory, it is opened and the window is
  44. replaced by a display of the corresponding subdirectory. By chosing
  45. 'Open parent' from the menu or by Adjust-clicking on the Close icon
  46. or by Adjust double-clicking anywhere inside the window, you can go
  47. up one level in the directoy tree (but no further up if yor are at
  48. your starting directory, in this case you will hear a beep).
  49. By default files are not shown in the window. Instead, there is one
  50. item which shows how much space all the files in the directory consume
  51. together. If you double-click on this item or choose 'Show files' from
  52. the menu, this item is replaced by one item for each file in the
  53. directory. Double-clicking on any of these file icons or choosing
  54. 'Show Files' again switches back to the original display mode. By
  55. choosing 'Open filer' from the menu, a filer window on the currently
  56. displayed directory is opened.
  57. Choose 'Rescan' from the menu to have the directory scanned again
  58. (useful if you have deleted objects in the meantime).
  59. The current limit for file and directory names is 12 characters.
  60. This corresponds to the limits of RISC OS (FileCore) and DOS file names.
  61. Longer file names are simply truncated, longer directory names cause
  62. the application to fail when trying to display the window for such
  63. a directory.
  64.  
  65. The main menu item 'Images' determines whether DiscSpace also scans
  66. the directory trees of image files (DOSDisc files or archives when
  67. used with !SparkFS). If it is not ticked, images are treated as files.
  68. The displayed size of an image file is always the size of the file
  69. (not the sum of the sizes of the objects inside the image). So for a
  70. DOSDisc image, the overall size usually differs from the sum of the
  71. sizes of the objects inside (as there may be unused space inside the
  72. image).
  73.  
  74. DiscSpace uses outline fonts wherever possible (i.e. for all icons
  75. and menus). If you do not want this feature or if your version of the
  76. WindowManager already uses outline fonts instead of the system font,
  77. you may switch it off by commenting out the following line in the !Run
  78. file:
  79.   Set DiscSpace$UseFont TRUE
  80. or by setting the variable to FALSE.
  81.  
  82. If the application is used on a RISC PC (i.e. under RISC OS 3.5 or higher),
  83. this option is set to FALSE automatically.
  84.  
  85. You may change the font to be used and its size by modifying the
  86. lines:
  87.   Set DiscSpace$Font ...
  88.   SetEval DiscSpace$FontWidth ...
  89.   SetEval DiscSpace$FontHeight ...
  90. to suit your own taste. Note that if the font is not found, the
  91. application reverts to using the system font.
  92.  
  93. History:
  94.   version 1.03 (05-Feb-1994):  - first version sent to Hensa
  95.   version 1.04 (10-Feb-1994):  - fixed bug:
  96.                                - Rescan took the currently displayed directory
  97.                                  as starting directory for the scan instead of
  98.                                  the previous starting directory
  99.   version 1.05 (17-Aug-1994):  - switches UseFont off if run under RO 3.5 or higher
  100.                                - contains style guide compliant templates (RO3 only)
  101.   version 1.06 (23-Aug-1994):  - accepts a directory dragged to the icon bar
  102.                                - contains sprites for iconised windows
  103.   version 1.07 (19-Dec-1994):  - contains code to work around a small bug in ArcFS 2
  104.                                  (still present in current version which is 0.71)
  105.   version 1.08 (26-Jan-1995):  - minor bug fix
  106.   version 1.09 (31-Jan-1995):  - Sorry, forgot a file in 1.08 (Templates3)
  107.                                - also forgot to change the Templates after a major
  108.                                  library revision (changed the way fonts in icons
  109.                                  are handled)
  110.   version 1.09b (10-Jun-1995): - Adjust double-click on the window can be used
  111.                                  instead of Adjust closing the window (open parent)
  112.                                  (suggested by Sergio Monesi)
  113.   version 1.10  (23-Jun-1996): - when an error occurs while counting (e.g. Broken
  114.                                  directory), counting is not aborted
  115.   version 1.11  (09-Oct-1996): - StrongARM compatible
  116.  
  117. To do:
  118.   - allow multiple windows (like the filer)
  119.   - allow multiple directory trees
  120.   - cope with longer file leaf names/directory names
  121.   - include options to count only files after a certain date, only certain file types,
  122.     not to count applications, etc.
  123.  
  124. This application is FREEWARE, i.e. it may be copied freely provided
  125. that all files are distributed together and that none of them is
  126. changed. Distribution is only allowed if it is not for profit or
  127. after prior arrangement with the author.
  128.