                        The Read and Write Variables.
  The (Read) variables are used when DOC is extracting programmer
  comments from the code it is reading.  The (Write) variables determine
  how the headers look in the output code, action diagrams, function
  reports and Norton Guides.  Therefore, if you have programmer comments in
  headers created by DOC that you want to retain you need to set the (Read)
  variables the way the matching (Write) variables were set the last time
  DOC was run.

                  The First and Last Header line variables.
  You must make absolutely sure that no other lines in you code match the
  First and Last Header line variables.  You also must be aware that if you
  do not have the "(Read) Purpose Heading" varia- ble set correctly, (it
  does not match the existing headers ) DOC will not find you comments and
  that if you do not have the "(Read) Last Header Line" variable set
  correctly DOC will treat your entire source code like a comment and not
  document anything [this does, however, speed up the processing <g>].

                         Leading and trailing spaces
  DOC rtrims these variables so spaces on the left are signifi- cant, but
  spaces on the right are ignored.

                       See Also and Ngo File Headings
  Any programmer's comments placed in See Also and NGO file sections of the
  function headers have special meanings to DOC when it creates the Norton
  Guide database. If a Norton Guide database is not to be created then
  these sections can be retitled and used for something else, such as
  "History :" or "Changes :". See the chapter on Norton Guide Database
  creation for more information on how DOC uses the programmer's comments
  typed into these sections of the function headers.

                        Blanks Lines Between Sections
  If this is set to Y[es], the default, then a blank line is inserted
  between sections of the headers created by DOC.  If N[o] the blank lines
  are omitted.

                            List Functions Called
  If this is set to N[o], DOC does not create the "Calls" and "Called by"
  sections of the function and procedure headers which list the functions
  which are called by and which call the current function or procedure.
  If set to Y[es], the default, then DOC creates these listings.

