using the revision librarian
----------------------------

Create a document.  Drag its icon onto the "do revision control .bat"
icon, or right click and select "Send To> Revision Librarian".

You will see a list of options appear in a DOS box window.  You must
enter the desired option by pressing the appropriate letter on the
keyboard.  (You won't get a chance to press the [Enter] key, just the
option letter.)

Select option "P" to put the document into the revision library.  The 
document icon will be replaced with a new icon of type ".Title".  This 
icon provides a handle that can be grabbed later with the mouse.  The 
file it represents is an empty file (length zero bytes) so it takes up 
no space. The RCS control file(s) will be kept in the subdirectory RCS 
of the documents original location.

To access the document click on the new icon that was created in the 
document's original folder.  Initially the icon has the type ".Title", 
though this may change as described below.  When the new icon is opened, 
the revision librarian is started.  It provides options to access the 
latest version of the original document, or to perform other RCS tasks 
on this document.

The type of the icon may be ".Title", ".Copy", or ".Master",
representing the different stages of the document.  Normally only one of
these icons is left in the directory by the librarian.  

A ".Title" icon is simply a handle to grab for drag and drop with a 
mouse.  

A ".Copy" icon is for a file which is checked out but not locked.  In 
our analogy, it is a copy of the original, not the original itself.  
Changes to this file cannot (easily) be put back into the controlled 
document.  

A ".Master" icon is for an editable copy.  In our analogy, this is the 
master copy of the document, of which there is only one copy, and which 
can be updated.  In RCS terms this file was locked when checked out.
The librarian knows when the master copy is being checked in later
because the document has the extension .Master, and because the same
person is checking the document in as checked it out.

A document may appear to become inaccessible because the icon for the
document is removed.  For example if the ".Master" document is moved
from the original directory to be edited elsewhere.  In this case open
the RCS subdirectory and double click on the associated ".Revisions"
file.  The librarian will provide a menu which includes retrieving the
".Title" icon back into the document directory.

A master copy may be moved to another location for editing.  This
presents a minor problem when the file is to be put back into the
revision library as the document itself has no data about where it is
supposed to be stored.  When you open a master document which isn't in
its original directory then the displayed library options do not include
an option to put the document back into the library.

The "do revision librarian .bat" icon provides a means to get around
this problem, and you may want to permanently leave a copy of this icon
in each directory containing controlled documents.  A master copy can
then be checked in to its library by dragging it onto the correct 
"do revision librarian .bat" icon, no matter where the master copy is
currently stored.

Alternatively, you can simply copy the document to its proper location
before opening it to get the librarian functions for the document.

Some other RCS options can be accessed by opening (double clicking) the
.revisions file in the RCS directory.  This includes retrieving a previous
version of a document.  

More complex functions must be accessed from the command line using
standard RCS utilities.  Note that the librarian renames files in an
otherwise non-standard manner to get the win95 extensions to work nicely.
When accessing a file from the command line, you may have to take this
into account.


drag and drop, and double click capabilities
-------------------------------------------

Icons of type .Title, .Copy, .Master, and .Revisions can be double clicked
to start up the "revision librarian" to access the associated document file.  
They can also be dragged or sent to the librarian.

For many tasks, the librarian may assume the document being opened is
still in its original location.  To be precise, the document is in the
same folder as the RCS folder which has the documents RCS control file.
The use of the pseudo sym link RCS appears to work, but I haven't really
tested it, and it may not work for some operations.

Other files must be dragged onto the librarian or sent to it using 
"Send To >".  

A folder can be dragged or sent to the librarian.  However in this 
version none of the listed functions are implemented.  If the RCS folder 
is sent to the librarian then the parent directory is the directory 
accessed, though again, the functions aren't implemented.

The librarian can be double clicked, and a description of its use is
displayed, and if the icon is within a directory with an RCS directory
then the (not-yet-implemented) folder functions are also provided.
