...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Sometimes when you need to exclude certain sections of text from indexing, then you can achieve this with the following XML processing instructions:
Instruction |
Effect |
---|---|
|
Causes the whole of the current section to be excluded from indexing. By "section" we mean either a true "section" or any sibling XML element: "dedication", "toc", "lot", "glossary", "bibliography", "preface", "chapter", "reference", "part", "article", "appendix", "index", "setindex", "colophon", "sect1", "refentry", "simplesect", "section" or "partintro". |
|
Causes the whole of the current text block to be excluded from indexing. A text block may be any of the section/chapter elements listed above, or a paragraph, code listing, table etc. The complete list is: "calloutlist", "glosslist", "bibliolist", "itemizedlist", "orderedlist", "segmentedlist", "simplelist", "variablelist", "caution", "important", "note", "tip", "warning", "literallayout", "programlisting", "programlistingco", "screen", "screenco", "screenshot", "synopsis", "cmdsynopsis", "funcsynopsis", "classsynopsis", "fieldsynopsis", "constructorsynopsis", "destructorsynopsis", "methodsynopsis", "formalpara", "para", "simpara", "address", "blockquote", "graphic", "graphicco", "mediaobject", "mediaobjectco", "informalequation", "informalexample", "informalfigure", "informaltable", "equation", "example", "figure", "table", "msgset", "procedure", "sidebar", "qandaset", "task", "productionset", "constraintdef", "anchor", "bridgehead", "remark", "highlights", "abstract", "authorblurb" or "epigraph". |
For Quickbook users the file auto_index_helpers.qbk contains a helper template that assists in inserting these processing instructions, for example:
[AutoIndex IgnoreSection]
Will cause that section to not be indexed.