Special sections
The treatment of bibliography, glossary and index are worth special mention.
Bibliography
Glossary
Index
Bibliography
Tex2RTF recognises standard LaTeX bibliography files (usually with .bib extension)
and resolves citations. The \bibliography
command reads the given .bib file and includes a list of
references at that point in the input. Only numbered, unsorted
references are catered for at the moment, with no variation in
bibliography style. A References heading is placed in the contents
section. Note that Tex2RTF must be run twice to ensure the citations are
resolved properly.
Tex2RTF can also cope with the \thebibliography environment, with
\bibitem commands, so long as the text following the first \bibitem
argument is enclosed in braces as if it were a second argument.
Glossary
Glossaries are formatted according to the following scheme.
The \helpglossary environment is used together with
the \gloss command for glossary entries. In LaTeX this
is interpreted as a description list, and each glossary entry is an item.
In on-line help, each glossary entry is a section.
A labelled glossary entry command may be referenced by \popref
to provide a quick popup explanation of a term.
Index
The explicit index is assumed to be redundant in on-line help, since
search facilities are provided. Therefore the \printindex command
does nothing in on-line versions. In linear RTF an index field is
added, and \index marks words for inserting in the index.
In Windows Help, all section headings and C++ function names are treated
as keywords. A keyword may be ambiguous, that is, refer to more than one
section in the help file. This automatic indexing may not always be
adequate, so the LaTeX \index command may be used
to add keywords.
In wxHelp, all section headings are indexed.