                     SAGE REFERENCE MANUAL README.txt

The reference manual is a combination of hand-written sections and
sections that are automatically generated from the Sage library Python
code.  The autogenerated content is all located in the subdirectory
sage/.  To add a new file to the list of autogenerated content you
should:

   (1) ADD FILE: Add the file to the ref/files.  Use the same format
       as the others files in that file.  In particular, replace _
       (underscore) by - (dash) in the module names.

   (2) EDIT .tex: By hand edit one of the human-written .tex files
       that is included by ref.tex, or create a new one and include it
       in ref.tex.  Copy the format that is used by the numerous files
       already there.

   (3) TEST: Now type, e.g., ./build_pdf to rebuild the PDF of the
       documentation and test that your new section was correctly
       autogenerated and included in the reference manual.

AUTHORS:
   -- William Stein (2006, 2007, 2008) -- wrote the documentation
      autogeneration system, and this README.txt
