Contents Up Previous Next

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.