RoomMate v1.0
                                   July 1991


Well, it's not a GeoWorks app, but it's a start!

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.
This version (being written before 1.2 was available) is currently hard coded
to work with version 1.0 ONLY.  As soon as I get my upgrade I'll check out what
is required to get it working and re-release it.  Nothing major is expected,
but...


                                 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.

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 and also asking if you wish to
save your changes if any were made, 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).  Once again, please
bring any questions you have to the GEOWORKS RT on GEnie and we'll see what we
can do to help.


                                 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).  Due to work on it, I have a feeling that I
may be able to write an icon editor for the DOS room as well.  Stay tuned for
further details as things (if things) develop.