How to annotate text

The annotator allows to write comments about a part of your electronic
document exactly as you would write notes in the margin of a paper.
You indicate the relevant section of text, create an ANNOTATION WINDOW
in which to write your comment, and edit in the annotation window just
as in the main document.

To annotate a section of text, first select the region you wish to
annotate.  This region is called the annotation's POINTER STRING.
Then type C-c C-a; this pops up a menu of different types annotations.
The types of annotations differs as follows: [For now, The different
types of annotations differ only in the messages they contain.  I have
no idea what the ultimate spec is going to be.]

Select a type by clicking any mouse button on it, or click Quit in the
pop-up menu to return to normal editing.

If you select an annotation, a small window should appear to the left
of the main editing window.  [It will already contain some text,
dependent on its type.]  You may type and edit text in this window
using the normal editing commands.  Your annotation is just like any
other X window, you can move or resize it using window manager
commands.  The window acts like a view onto an "infinite" piece of
paper;  if you type text that goes outside the window, it is not
lost.  Simply resize the window to view the whole text.

To hide your new annotation from view, type C-c C-h.  To unhighlight
the pointer string, type C-c C-u (which unhighlights all pointer
strings), or move the cursor with the mouse.


How to read an annotated document

You can read the annotations in a document using a few simple
commands.  To see what regions of the document are anntated, type C-c
C-l.  This highlights the "pointer strings," the regions that have an
associated annotation.  To view the annotations, type C-c C-v.  The
annotation windows will appear along the right side of the buffer
window near their associated pointer string. [Is this behavior spec'ed
anywhere?  What happens when pointer strings are off the screen?
packed close together?]  As before, you may edit, move, or resize the
annotation windows as you wish.


Annotation command summary [We may not need this in the main doc]

Annotate highlighted region	C-c C-a
View annotations		C-c C-v
Hide annotations		C-c C-h
highLight pointer strings	C-c C-l
Unhighlight pointer strings	C-c C-u