
This directory contains the source of the glossary database (the data,
not the programs themselves).

The procedure for changing a glossary definition:

 ==>>> THIS IS THE NEW PROCEDURE FOR EDITING FILES HERE!  (as of Oct 11) <<===

 1. Determine which file to edit. (files are named "gloss[A-Z]", where the
    last letter of the file is the first letter of the term).

 2. Check out and lock the file.  e.g. "g-co glossX".

 3. Edit the file.  e.g. "vi glossX".

 4. Check in the file.  e.g. "g-ci glossX".  This will check for errors in
    glossX, and if there are none, check the file into RCS.  Please
    leave a comment for the RCS log of what you changed.

 5. Install the changes using "./g-update".  This should place the files
    in the correct directory to be used by the DTE tools.  (Warning: do not
    depend on things to reside under /project/tools. (i.e. do not just copy
    the files to where you think they should live)  Use the program.)

WARNING:
    Some versions of RCS on the HPs are old and will not work!
    Suggestion for HP users: use the RCS programs (ci, co, rcs, rlog) in
    /project/tools/bin/hp300/.  Put this directory in your path BEFORE
    /usr/bin (which is where HP's outdated version lives.)


Below is the format of the glossX files.  The words in upper case are
REQUIRED keywords, lower case is example.

Also see the glossary man page.

|.TERM|cancel
|.ACR|
   |.DEFIN|1|To end a task before it is completed.
      |.XREF|
      |.BOOK|
      |.TOPIC|
|.TERM|child
|.ACR|
   |.DEFIN|1|Pertaining to a secured resource, either a file or library, that
uses the user list of a parent resource. A child resource can have only one
parent resource.
      |.XREF|child process
      |.XREF|fork
      |.BOOK|
      |.TOPIC|
   |.DEFIN|2|In the Operating System, a child is a process, spawned by a
parent process, that shares the resources of the parent process. Contrast
with parent.
      |.XREF|
      |.BOOK|
      |.TOPIC|
|.TERM|CAI
|.ACR|
   |.DEFIN|1|*
      |.XREF|computer aided instruction
      |.BOOK|
      |.TOPIC|

Some notes:
  o Multiple definitions are designated by numbers.
  o Each TERM has at most one acronym (ACR).  If there is none, the empty
    field must remain.
  o A definition may span several lines.
  o For each DEFIN (definition) there must be at least one entry for XREF,
    BOOK, and TOPIC even though the entries are blank.
  o Each definition may "belong" to many books, meaning that the term
    will appear in each of those books.  Similarly, each definition may
    belogn to many topics.
  o There may be multiple entries for each XREF, BOOK, and TOPIC.  Simply use
    multiple lines as shown above.
  o If a TERM has an XREF, but no DEFIN, use "*" for the definition.

