3 <meta http-equiv=
"Content-Type" content=
"text/html; charset=US-ASCII">
4 <title>Step
6: Using XML processing instructions to control what gets indexed.
</title>
5 <link rel=
"stylesheet" href=
"../../../../../../doc/src/boostbook.css" type=
"text/css">
6 <meta name=
"generator" content=
"DocBook XSL Stylesheets V1.77.1">
7 <link rel=
"home" href=
"../../index.html" title=
"Boost.AutoIndex">
8 <link rel=
"up" href=
"../tut.html" title=
"Getting Started and Tutorial">
9 <link rel=
"prev" href=
"entries.html" title=
"Step 5: Add Manual Index Entries to Docbook XML - Optional">
10 <link rel=
"next" href=
"build_docs.html" title=
"Step 7: Build the Docs">
12 <body bgcolor=
"white" text=
"black" link=
"#0000FF" vlink=
"#840084" alink=
"#0000FF">
13 <table cellpadding=
"2" width=
"100%"><tr>
14 <td valign=
"top"><img alt=
"Boost C++ Libraries" width=
"277" height=
"86" src=
"../../../../../../boost.png"></td>
15 <td align=
"center"><a href=
"../../../../../../index.html">Home
</a></td>
16 <td align=
"center"><a href=
"../../../../../../libs/libraries.htm">Libraries
</a></td>
17 <td align=
"center"><a href=
"http://www.boost.org/users/people.html">People
</a></td>
18 <td align=
"center"><a href=
"http://www.boost.org/users/faq.html">FAQ
</a></td>
19 <td align=
"center"><a href=
"../../../../../../more/index.htm">More
</a></td>
22 <div class=
"spirit-nav">
23 <a accesskey=
"p" href=
"entries.html"><img src=
"../../../../../../doc/src/images/prev.png" alt=
"Prev"></a><a accesskey=
"u" href=
"../tut.html"><img src=
"../../../../../../doc/src/images/up.png" alt=
"Up"></a><a accesskey=
"h" href=
"../../index.html"><img src=
"../../../../../../doc/src/images/home.png" alt=
"Home"></a><a accesskey=
"n" href=
"build_docs.html"><img src=
"../../../../../../doc/src/images/next.png" alt=
"Next"></a>
26 <div class=
"titlepage"><div><div><h3 class=
"title">
27 <a name=
"boost_autoindex.tut.pis"></a><a class=
"link" href=
"pis.html" title=
"Step 6: Using XML processing instructions to control what gets indexed.">Step
6: Using XML processing
28 instructions to control what gets indexed.
</a>
29 </h3></div></div></div>
31 Sometimes when you need to exclude certain sections of text from indexing,
32 then you can achieve this with the following XML processing instructions:
34 <div class=
"informaltable"><table class=
"table">
55 <code class=
"computeroutput"><span class=
"special"><?
</span><span class=
"identifier">BoostAutoIndex
</span>
56 <span class=
"identifier">IgnoreSection
</span><span class=
"special">?
></span></code>
61 Causes the whole of the current section to be excluded from indexing.
62 By
"section" we mean either a true
"section"
63 or any sibling XML element:
"dedication",
"toc",
64 "lot",
"glossary",
"bibliography",
65 "preface",
"chapter",
"reference",
66 "part",
"article",
"appendix",
"index",
67 "setindex",
"colophon",
"sect1",
68 "refentry",
"simplesect",
"section"
76 <code class=
"computeroutput"><span class=
"special"><?
</span><span class=
"identifier">BoostAutoIndex
</span>
77 <span class=
"identifier">IgnoreBlock
</span><span class=
"special">?
></span></code>
82 Causes the whole of the current text block to be excluded from
83 indexing. A text block may be any of the section/chapter elements
84 listed above, or a paragraph, code listing, table etc. The complete
85 list is:
"calloutlist",
"glosslist",
"bibliolist",
86 "itemizedlist",
"orderedlist",
"segmentedlist",
87 "simplelist",
"variablelist",
"caution",
88 "important",
"note",
"tip",
"warning",
89 "literallayout",
"programlisting",
"programlistingco",
90 "screen",
"screenco",
"screenshot",
91 "synopsis",
"cmdsynopsis",
"funcsynopsis",
92 "classsynopsis",
"fieldsynopsis",
"constructorsynopsis",
93 "destructorsynopsis",
"methodsynopsis",
"formalpara",
94 "para",
"simpara",
"address",
"blockquote",
95 "graphic",
"graphicco",
"mediaobject",
96 "mediaobjectco",
"informalequation",
"informalexample",
97 "informalfigure",
"informaltable",
"equation",
98 "example",
"figure",
"table",
"msgset",
99 "procedure",
"sidebar",
"qandaset",
100 "task",
"productionset",
"constraintdef",
101 "anchor",
"bridgehead",
"remark",
102 "highlights",
"abstract",
"authorblurb"
110 For Quickbook users the file auto_index_helpers.qbk contains a helper template
111 that assists in inserting these processing instructions, for example:
113 <pre class=
"programlisting">[AutoIndex IgnoreSection]
</pre>
115 Will cause that section to not be indexed.
118 <table xmlns:
rev=
"http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width=
"100%"><tr>
119 <td align=
"left"></td>
120 <td align=
"right"><div class=
"copyright-footer">Copyright
© 2008,
2011 John Maddock
<p>
121 Distributed under the Boost Software License, Version
1.0. (See accompanying
122 file LICENSE_1_0.txt or copy at
<a href=
"http://www.boost.org/LICENSE_1_0.txt" target=
"_top">http://www.boost.org/LICENSE_1_0.txt
</a>)
127 <div class=
"spirit-nav">
128 <a accesskey=
"p" href=
"entries.html"><img src=
"../../../../../../doc/src/images/prev.png" alt=
"Prev"></a><a accesskey=
"u" href=
"../tut.html"><img src=
"../../../../../../doc/src/images/up.png" alt=
"Up"></a><a accesskey=
"h" href=
"../../index.html"><img src=
"../../../../../../doc/src/images/home.png" alt=
"Home"></a><a accesskey=
"n" href=
"build_docs.html"><img src=
"../../../../../../doc/src/images/next.png" alt=
"Next"></a>