How To Make Index Entries in the Manual
Here is a quick summary of how to put index entries into the LaTeX source for the manual. The index itself is automatically generated when the manual is made.
Simple index entries
The simplest index entries are of the form
\index{the entry}
This places the string "the entry" into the index, tagged with an appropriate section number (html) or page (pdf), and alphabetized.
An index entry that has 2 levels appears as
\index{main entry!subentry}
If you look at the manual's index at the very end, you can see examples that are generated by
\index{Windows NT!HTCondor daemon names} \index{Windows NT!manual install}
More complex index entries
If a range of sections (pages) should be in an index entry (as opposed to a single section number or page), then two index entries identify the endpoints of the sections (pages) that are included. The opening entry appears as
\index{the entry|(}
\index{the entry|)}
Again look at the manual's index at the very end, and you will see examples that are generated by
\index{Windows NT!introduction|(} \index{Windows NT!introduction|)} \index{Windows NT!release notes|(} \index{Windows NT!release notes|)} \index{Windows NT!starting the HTCondor service|(} \index{Windows NT!starting the HTCondor service|)}
Alphabetization under Font Changes
Simplified, if a different font is to be used, but the same alphabetization is desired, an index entry appears of the form
\index{entry where it should be alphabetically@appearance of entry}
Here is an example:
\index{daemon!condor\_master@\Condor{master}}
Configuration Macros
Index entries for the configuration macros are automatically generated when using the LaTeX macro
\Macro{macro's name here}
To suppress the automatic generation of index entries, use the LaTeX macro
\MacroNI{macro's name here}
\Macro{macro's name here}