RememberOpenDrawers
~~~~~~~~~~~~~~~~~~~
RememberOpenDrawers is a small collection of ARexx scripts which allow Workbench
to remember which windows you had open and reopen them on startup. It adds menu
items to the Tools menu which allow you to save the current list of open
windows, or to forget the list to start up the next time with no windows open.

I wrote the scripts to help me with my development of other programs - I find it
quite useful to have my documentation and project drawers open when I turn on
my computer.

It optionally supports snapshotting window sizes and positions, remembering
positions without snapshotting, and remembering persistently or forgetting each
time Workbench starts.


Requirements
~~~~~~~~~~~~
RememberOpenDrawers requires:

- OS 3.5+ (Tested on OS4.1)
- ARexx running (RexxMast should be started at a higher priority if it's in
WBStartup so that it's available before the script starts)

It will not work under MorphOS due to differences in the implementation of
ARexx in Ambient.


Installation
~~~~~~~~~~~~
Installation by hand is easy:

1) Copy ForgetOpenDrawers.rexx and SaveOpenDrawers.rexx to REXX:

2) If you have a WBStartup drawer (OS3.5-4.0 and early updates of 4.1), copy
RememberOpenDrawers.rexx there. If you have an up-to-date OS4.1 installation,
copy it to REXX: along with the other two scripts and add
RememberOpenDrawers.rexx to your WBStartup prefs.


Configuration
~~~~~~~~~~~~~
There are a couple of options available for these scripts which you can change
by opening the scripts in a text editor. They are as follows:

- SaveOpenDrawers.rexx:

   snapshot_windows=0
This option allows the script to snapshot all open windows as it saves the list
to hard drive. It is the same as clicking on each open window in Workbench and
selecting the menu Window->Snapshot->Window on each one. This is disabled by
default as you might have some carefully resized windows you wouldn't like to be
changed. Enable it by setting it to 1.

- RememberOpenDrawers.rexx:

   remember_until_forgotten=1
When this option is enabled, the saved list of drawers is kept until you either
store a new set of open drawers, or use the menu option "Forget Open Drawers".
This will mean that the same windows will open every time Workbench starts.
Disable this by setting it to 0, which will cause the list to be erased once the
remembered windows have been opened on startup.

   remember_window_positions=0
This option is an alternative to the snapshot_windows option above. When this
setting is enabled (by setting it to 1), each window will be set to the size and
position it had when it was last "remembered". The advantage of this method is
that it does not interfere with your windows' snapshot positions, however it's
disabled by default because it's not particularly elegant to see in action: each
window is opened at its snapshot size and position, and then resized. It works
fine, but is a little clumsy to watch...

   add_tools_menuitems=1
This option tells the script to add the required entries to Workbench's Tools
menu for remembering and forgetting the drawer window positions. This should
normally be left enabled, but can be disabled if needed for certain
situations. Examples where this might be useful are if you want to add the menu
items manually (e.g. using THE), or wish to add the scripts as dockies, or run
them from other scripts. In these situations, you will still need
RememberOpenDrawers.rexx in your WBStartup, but you can run the
ForgetOpenDrawers.rexx and SaveOpenDrawers.rexx scripts from wherever you like.


Usage
~~~~~
Usage is easy, and if installed as described above, the next time you boot you
should have an extra menu item or two in the Tools menu. These are:

- Remember Open Drawers
This item will save a list of the currently open drawers to your hard drive,
overwriting any previously remembered list. It will only remember Workbench
drawer windows, not any applications you might have open...

- Forget Open Drawers
This item will only be available if you have enabled the persistent remembering
feature (see Configuration above). Selecting this wll clear the currently saved
list of open windows, so the next time the computer boots, no windows will be
opened.


History
~~~~~~~
1.1 (29.03.2014)
 - Added option to disable automatically adding items to Tools menu.
 - Included OS3.5/3.9 GlowIcons icon for the main script.
 - Fixed readme errors.

1.0 (18.02.2012)
First release. Works fine for me and thought others might find it useful too...

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                 3311    6056  54.7% -lh5- 57f4 Mar 29 17:57 RememberOpenDrawers.info
[unknown]                  182     233  78.1% -lh5- 1dd5 Feb 18  2012 RememberOpenDrawers/ForgetOpenDrawers.rexx
[unknown]                 8776   10243  85.7% -lh5- 36a2 Mar 29 17:57 RememberOpenDrawers/ForgetOpenDrawers.rexx.info
[unknown]                 1360    1694  80.3% -lh5- 93f1 Mar 29 17:57 RememberOpenDrawers/OS3.5 Icon.info
[unknown]                 6660    9058  73.5% -lh5- 0dd5 Apr  3 21:12 RememberOpenDrawers/OS3.5 Icon/RememberOpenDrawers.info
[unknown]                 2035    4750  42.8% -lh5- 9c0b Apr  3 21:28 RememberOpenDrawers/RememberOpenDrawers.readme
[unknown]                 3298    6098  54.1% -lh5- f615 Mar 29 17:57 RememberOpenDrawers/RememberOpenDrawers.readme.info
[unknown]                  957    2267  42.2% -lh5- c831 Mar 29 16:52 RememberOpenDrawers/RememberOpenDrawers.rexx
[unknown]                11084   16415  67.5% -lh5- 5efd Mar 29 17:57 RememberOpenDrawers/RememberOpenDrawers.rexx.info
[unknown]                  588    1304  45.1% -lh5- 7d86 Feb 18  2012 RememberOpenDrawers/SaveOpenDrawers.rexx
[unknown]                 8758   10227  85.6% -lh5- 93ec Mar 29 17:57 RememberOpenDrawers/SaveOpenDrawers.rexx.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        11 files   47009   68345  68.8%            Apr  3 21:15