DrawerSize
----------

Copyright (C) 1995, Howard Brown & Stephen Rouse.

Freely distributable as archive DRWSIZ.LHA containing the following files:

    DrawerSize.doc  (this document)
    DrawerSize.BB2  (the Blitz Basic source code)
    DrawerSize      (the actual program)
    DrawerSize.info (the custom tool icon)

No charge to be made for copying other than the reasonable cost of a diskette.


What is it?
-----------
DrawerSize is a utility program run by Workbench from the WBStartup drawer
which attaches a menu item to the Workbench "Tools" menu called "Drawer Size".

When selected the program will scan all the files in a highlighted drawer
and display the total size of the drawer in bytes along the Workbench screen
titlebar. 

Useful? We like to think so, especially for transferring drawers between
machines using floppy- no more five minute coffee grinding followed by a
"Disk Full" error.

Why was it written?
-------------------
  1) To fulfil the above need.
  2) To use the fabulous Blitz Basic to program a "serious" application.
  3) To learn how to program the Amiga's operating system
     (We learned a hell of a lot in the end!)
  4) To help other people learn how to program the Amiga's operating system.
     (The enclosed source code is fully documented and should be fairly
      easy to translate into other languages. Not that you'd want to, 
      having programmed in Blitz :-)  )

Which Amigas?
-------------
Needs Kickstart 2.04 or higher. 
Tested (so far) on A500+ with fast RAM, an unexpanded A1200 and an 
accelerated A1200 with fast RAM.

How is it installed?
--------------------
Copy the program (including icon, CLI users!) into the WBStartup drawer.
Reboot to run the program.

How is it used?
---------------
Select a drawer icon (single click, LMB) and choose Drawer Size from Workbench
"Tools" menu. The size of the drawer is displayed on the screen titlebar.

Also accepts group-selected icons.

On choosing menu with no icon selected, last selection is redisplayed.

DrawerSize icon has two tooltypes:
    DONOTWAIT  must be present if run from WBStartup drawer.
    DELAY=<seconds> number of seconds for which output displayed on titlebar
                    defaults to 2 seconds.

Acknowledgements.
-----------------
Acid Software for the thinking man's programming language.
Paul Andrews and Aaron Koolen for a couple of file system routines.

Program history.
----------------
It works now, so who cares?!