                           RoomMate v1.21 by J. Sheridan
                                   August 1991


RoomMate was written not so much to fill a gaping void as to provide a
challenge while waiting for the Software Development Kit (SDK).  It does,
however, provide some features that GeoWorks currently lacks.  Since this is
not developed with the SDK I can make not particular claims about it's
robustness, suitability, etc.  I recommend that you backup your DOS room file
(it's called DOS_ROOM.000 in the GEOWORKS\SYSTEM\WELCOME directory) before
using it "just in case" and relay any problems back to the GEOWORKS RT on GEnie
(support is currently available in Category 9, Topic 1).


                            Support for Ensemble 1.2


This edition of RoomMate should work fine with version 1.0 OR 1.2 of Ensemble.
An extra field has been added in the button information window and a couple of
error messages were tweaked slightly.  Nothing else was required to support 1.2.
When 2.0 is released I'll have to look at whether RoomMate is still needed and
what it will take to ensure that it works properly.


                                 Why RoomMate?


The DOS room of GeoWorks allows users to create "buttons" that, when selected,
swap GeoWorks out of memory and run the desired program under DOS.
Unfortunately, there is no provision for organising these "buttons" in any
other way than creating and deleting them in the correct sequence.  RoomMate
addresses this lack.  With it the user may sort the "buttons" (with the single
exception of the DOS button which must always be the first), move them around,
or examine their attributes.  It does not currently provide an interface for
adding or deleting buttons since GeoWorks does that itself quite well.


                               How to Use RoomMate


The command syntax for RoomMate may be viewed by typing

          roommate -?

Once RoomMate is running, you may get a list of the active keys by pressing the
F1 key (this is also indicated in the top right corner of the screen).  The
method used to position or swap buttons is that of a "marked" button and a
"current" button.  The current button is highlighted (in RED on a colour display
and reverse video on a monochrome system) and can be moved with the cursor keys.
On a colour display, the marked button is highlighted in MAGENTA and on a
monochrome display, the button number is highlighted.  Play around with it for
a few moments and you should quickly get the idea.  Once you have marked a
particular button you may then choose to view the particulars (name, path,
command line options, etc), or reposition it.  The reposition is accomplished
by moving the "cursor" and then indicating whether you wish to move the marked
one "before" or "after" the current button or simply swap them.  Again, play
with it for a bit; nothing you do is permanent unless you explicitly ask for it
to be.

Once you have everything set up the way you want, you can either QUIT with
RoomMate asking you if you really wish to quit (also asking if you wish to
save your changes, if you made any) or SAVE without quitting.


                              Where to run RoomMate


Finally, due to the way GeoWorks swaps out to run DOS programs, RoomMate works
fine in the DOS room itself.  It has also been tested with over 200 DOS buttons
(something I suspect very few people, if any, will attempt).


                           Online Support for RoomMate


Please bring any questions you have to the GEOWORKS RT on GEnie (page 1050) and
we'll see what we can do to help (support should be in Category 9, Topic 1).
If you're shy about posting in public, send me a message; my e-mail address is
J.SHERIDAN4 on GEnie. I am also more than willing to listen to any ideas you
have on ways to improve RoomMate - I already plan to add customizable colours.


                                  Miscellaneous


RoomMate was written using Borland C++ 2.0 on an IBM PS/1 (I know, I'm getting
a bigger machine Real Soon Now).


                                 Change History


1.21 - Added sorting on icon numbers (Alt-I).  When sorting by title, buttons
       with the same text will then be sorted based on the icon number.  When
       sorting by icon number, buttons with the same icon will then be sorted
       by title.  This feature provides a means of creating "groups" of similar
       buttons (ie. communication, tools, etc.).  Thanks Dan!

1.20 - Supports Ensemble upgrade to 1.2.  Will also work with no ill effects on
       1.0 systems.  Added new info field to the button information window to
       reflect the new feature in Ensemble 1.2 that allows you to return to
       GEOS without having to be asked first (when running a DOS app).  Added a
       line to a error message to refer the user to the /? option (ie. HELP).

1.10 - There is no 1.10.  :)

1.00 - Initial release.
