| <?xml version="1.0" standalone="yes"?> |
| <!-- |
| Copyright (c) 2002 Douglas Gregor <doug.gregor -at- gmail.com> |
| |
| Distributed under the Boost Software License, Version 1.0. |
| (See accompanying file LICENSE_1_0.txt or copy at |
| http://www.boost.org/LICENSE_1_0.txt) |
| --> |
| <chapter id="reference"> |
| <title>Reference</title> |
| <para>Elements:<itemizedlist spacing="compact"><listitem><simpara><link linkend="boostbook.dtd.access">Element <sgmltag>access</sgmltag> - Declares an access specification for class members</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.boostbook">Element <sgmltag>boostbook</sgmltag> - Defines a BoostBook book</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.class">Element <sgmltag>class</sgmltag> - Declares a class or class template</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.class-specialization">Element <sgmltag>class-specialization</sgmltag> - A specialization (partial or full) of a class template</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.code">Element <sgmltag>code</sgmltag> - Mimics the <sgmltag>code</sgmltag> tag in HTML</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.compile-fail-test">Element <sgmltag>compile-fail-test</sgmltag> - A testcase that should fail to compile</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.compile-test">Element <sgmltag>compile-test</sgmltag> - A testcase that should compile correctly</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.complexity">Element <sgmltag>complexity</sgmltag> - The time/space/etc. complexity of a function</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.constructor">Element <sgmltag>constructor</sgmltag> - Declares a constructor of the enclosing class</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.copy-assignment">Element <sgmltag>copy-assignment</sgmltag> - Declares a copy-assignment operator</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.data-member">Element <sgmltag>data-member</sgmltag> - Declares a data member of a class</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.default">Element <sgmltag>default</sgmltag> - The default value of a function or template parameter</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.description">Element <sgmltag>description</sgmltag> - Detailed description of a construct</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.destructor">Element <sgmltag>destructor</sgmltag> - Declares a destructor for the enclosing class</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.effects">Element <sgmltag>effects</sgmltag> - Declares the side effects of a function</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.enum">Element <sgmltag>enum</sgmltag> - Declares an enumeration type</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.enumname">Element <sgmltag>enumname</sgmltag> - References an enumeration type with the given name</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.enumvalue">Element <sgmltag>enumvalue</sgmltag> - A single value of an enumeration</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.free-function-group">Element <sgmltag>free-function-group</sgmltag> - A set of functions that are grouped together under one name</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.function">Element <sgmltag>function</sgmltag> - Declares a function</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.functionname">Element <sgmltag>functionname</sgmltag> - References a function with the given name</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.globalname">Element <sgmltag>globalname</sgmltag> - References a global with the given name</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.header">Element <sgmltag>header</sgmltag> - Declares a C++ header with the given name</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.headername">Element <sgmltag>headername</sgmltag> - References a C++ header with the given name</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.if-fails">Element <sgmltag>if-fails</sgmltag> - What it means when a testcase fails</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.inherit">Element <sgmltag>inherit</sgmltag> - Declares a base class of the enclosing class or struct</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.lib">Element <sgmltag>lib</sgmltag> - A library dependency</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.library">Element <sgmltag>library</sgmltag> - Top-level element for a library</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.library-reference">Element <sgmltag>library-reference</sgmltag> - Declares the reference material for a library</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.librarycategory">Element <sgmltag>librarycategory</sgmltag> - Declares that the enclosing library is in this category</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.librarycategorydef">Element <sgmltag>librarycategorydef</sgmltag> - Defines a new library category</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.librarycategorylist">Element <sgmltag>librarycategorylist</sgmltag> - Categorized listing of libraries</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.libraryinfo">Element <sgmltag>libraryinfo</sgmltag> - Provides information about a library</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.librarylist">Element <sgmltag>librarylist</sgmltag> - Placeholder for an alphabetical list of libraries</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.libraryname">Element <sgmltag>libraryname</sgmltag> - References a library of the given name</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.librarypurpose">Element <sgmltag>librarypurpose</sgmltag> - Describes in one short sentence or phrase the purpose of a library</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.link-fail-test">Element <sgmltag>link-fail-test</sgmltag> - Declares a test that should compile but fail to link</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.link-test">Element <sgmltag>link-test</sgmltag> - Declares a test that should compile and link</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.macroname">Element <sgmltag>macroname</sgmltag> - References a macro with the given name</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.method">Element <sgmltag>method</sgmltag> - Declares a method, i.e., a member function</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.method-group">Element <sgmltag>method-group</sgmltag> - A set of methods that are grouped together under one name</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.namespace">Element <sgmltag>namespace</sgmltag> - Declares a namespace</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.notes">Element <sgmltag>notes</sgmltag> - Non-normative notes about a function's semantics</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.overloaded-function">Element <sgmltag>overloaded-function</sgmltag> - An overloaded function</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.overloaded-method">Element <sgmltag>overloaded-method</sgmltag> - An overloaded method</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.parameter">Element <sgmltag>parameter</sgmltag> - A function parameter</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.paramtype">Element <sgmltag>paramtype</sgmltag> - The type of a function parameter</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.postconditions">Element <sgmltag>postconditions</sgmltag> - Conditions that must hold after the function returns</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.precondition">Element <sgmltag>precondition</sgmltag> - Conditions that must be met prior to executing a function</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.programlisting">Element <sgmltag>programlisting</sgmltag> - A sample of program code</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.purpose">Element <sgmltag>purpose</sgmltag> - A short description of an entity's use</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.rationale">Element <sgmltag>rationale</sgmltag> - Describes the rationale for a particular function's design</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.requirement">Element <sgmltag>requirement</sgmltag> - A requirement/property in the Jamfile for a testcase</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.requires">Element <sgmltag>requires</sgmltag> - Declares the requirements of a function</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.returns">Element <sgmltag>returns</sgmltag> - Description of the return value of a function</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.run-fail-test">Element <sgmltag>run-fail-test</sgmltag> - A testcase that should compile and link, but fail on execution</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.run-test">Element <sgmltag>run-test</sgmltag> - A testcase that should compile, link, and execute</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.signature">Element <sgmltag>signature</sgmltag> - One signature of an overloaded function or method</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.snippet">Element <sgmltag>snippet</sgmltag> - Pulls in a code snippet from a <sgmltag>programlisting</sgmltag> element</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.source">Element <sgmltag>source</sgmltag> - Defines source code for a test</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.specialization">Element <sgmltag>specialization</sgmltag> - Defines the specialization arguments for a class specialization</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.static-constant">Element <sgmltag>static-constant</sgmltag> - Declares a static constant, e.g., <code>const int foo = 5;</code>.</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.struct">Element <sgmltag>struct</sgmltag> - Declares a C++ struct</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.struct-specialization">Element <sgmltag>struct-specialization</sgmltag> - A specialization (full or partial) of a struct template</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.template">Element <sgmltag>template</sgmltag> - Declares the template parameters of a class or function</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.template-arg">Element <sgmltag>template-arg</sgmltag> - A template argument in a specialization</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.template-nontype-parameter">Element <sgmltag>template-nontype-parameter</sgmltag> - A nontype template parameter</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.template-type-parameter">Element <sgmltag>template-type-parameter</sgmltag> - Declares a template type parameter</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.template-varargs">Element <sgmltag>template-varargs</sgmltag> - Declares a variable-length list of template parameters</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.testsuite">Element <sgmltag>testsuite</sgmltag> - Describes a library testsuite</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.throws">Element <sgmltag>throws</sgmltag> - Description of the exceptions thrown by a function</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.type">Element <sgmltag>type</sgmltag> - The type of an element or return type of a function</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.typedef">Element <sgmltag>typedef</sgmltag> - Declares a typedef</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.union">Element <sgmltag>union</sgmltag> - Declares a C++ union or union template</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.union-specialization">Element <sgmltag>union-specialization</sgmltag> - A specialization (full or partial) of a union template</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.using-class">Element <sgmltag>using-class</sgmltag> - Injects the method and function names of a class into the local scope</link></simpara></listitem><listitem><simpara><link linkend="boostbook.dtd.using-namespace">Element <sgmltag>using-namespace</sgmltag> - Injects the declared names from a namespace into the local scope</link></simpara></listitem></itemizedlist></para> |
| <refentry id="boostbook.dtd.class-specialization"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>class-specialization</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>class-specialization</refname> |
| <refpurpose>A specialization (partial or full) of a class template</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>class-specialization ::= |
| (<link linkend="boostbook.dtd.template">template</link>?, <link linkend="boostbook.dtd.specialization">specialization</link>?, <link linkend="boostbook.dtd.inherit">inherit</link>?, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, (<link linkend="boostbook.dtd.access">access</link>| <link linkend="boostbook.dtd.static-constant">static-constant</link>| <link linkend="boostbook.dtd.typedef">typedef</link>| <link linkend="boostbook.dtd.enum">enum</link>| <link linkend="boostbook.dtd.copy-assignment">copy-assignment</link>| <link linkend="boostbook.dtd.constructor">constructor</link>| <link linkend="boostbook.dtd.destructor">destructor</link>| <link linkend="boostbook.dtd.method-group">method-group</link>| <link linkend="boostbook.dtd.free-function-group">free-function-group</link>| <link linkend="boostbook.dtd.function">function</link>| <link linkend="boostbook.dtd.method">method</link>| <link linkend="boostbook.dtd.overloaded-function">overloaded-function</link>| <link linkend="boostbook.dtd.overloaded-method">overloaded-method</link>| <link linkend="boostbook.dtd.data-member">data-member</link>| <link linkend="boostbook.dtd.class">class</link>| <link linkend="boostbook.dtd.class-specialization">class-specialization</link>| <link linkend="boostbook.dtd.struct">struct</link>| <link linkend="boostbook.dtd.struct-specialization">struct-specialization</link>| <link linkend="boostbook.dtd.union">union</link>| <link linkend="boostbook.dtd.union-specialization">union-specialization</link>)*) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.link-test"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>link-test</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>link-test</refname> |
| <refpurpose>Declares a test that should compile and link</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>link-test ::= |
| (<link linkend="boostbook.dtd.source">source</link>*, <link linkend="boostbook.dtd.lib">lib</link>*, <link linkend="boostbook.dtd.requirement">requirement</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>, <link linkend="boostbook.dtd.if-fails">if-fails</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>filename</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the file associated with this element</entry></row> |
| <row><entry>name</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.link-fail-test"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>link-fail-test</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>link-fail-test</refname> |
| <refpurpose>Declares a test that should compile but fail to link</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>link-fail-test ::= |
| (<link linkend="boostbook.dtd.source">source</link>*, <link linkend="boostbook.dtd.lib">lib</link>*, <link linkend="boostbook.dtd.requirement">requirement</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>, <link linkend="boostbook.dtd.if-fails">if-fails</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>filename</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the file associated with this element</entry></row> |
| <row><entry>name</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.typedef"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>typedef</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>typedef</refname> |
| <refpurpose>Declares a typedef</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>typedef ::= |
| (<link linkend="boostbook.dtd.type">type</link>, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.static-constant"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>static-constant</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>static-constant</refname> |
| <refpurpose>Declares a static constant, e.g., <code>const int foo = 5;</code>.</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>static-constant ::= |
| (<link linkend="boostbook.dtd.type">type</link>, <link linkend="boostbook.dtd.default">default</link>, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.code"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>code</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>code</refname> |
| <refpurpose>Mimics the <sgmltag>code</sgmltag> tag in HTML</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>code ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>Text within a <sgmltag>code</sgmltag> tag is generally typeset |
| in a different, monospaced font so that it stands out as code. The |
| <sgmltag>code</sgmltag> tag in BoostBook is transformed directly |
| into the <sgmltag>computeroutput</sgmltag> tag in DocBook.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.destructor"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>destructor</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>destructor</refname> |
| <refpurpose>Declares a destructor for the enclosing class</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>destructor ::= |
| (<link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, <link linkend="boostbook.dtd.requires">requires</link>?, <link linkend="boostbook.dtd.effects">effects</link>?, <link linkend="boostbook.dtd.postconditions">postconditions</link>?, <link linkend="boostbook.dtd.returns">returns</link>?, <link linkend="boostbook.dtd.throws">throws</link>?, <link linkend="boostbook.dtd.complexity">complexity</link>?, <link linkend="boostbook.dtd.notes">notes</link>?, <link linkend="boostbook.dtd.rationale">rationale</link>?) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>General documentation on functions in BoostBook is provided in |
| the <link linkend="boostbook.dtd.function"><sgmltag>function</sgmltag></link> |
| element documentation.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>specifiers</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The specifiers for this function, e.g., inline, static, etc.</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.template-type-parameter"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>template-type-parameter</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>template-type-parameter</refname> |
| <refpurpose>Declares a template type parameter</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>template-type-parameter ::= |
| (<link linkend="boostbook.dtd.default">default</link>?, <link linkend="boostbook.dtd.purpose">purpose</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>pack</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to '1' if the parameter is a parameter pack.</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.description"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>description</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>description</refname> |
| <refpurpose>Detailed description of a construct</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>description ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>Although the context model for this element is |
| <code>ANY</code>, detailed descriptions should contain structured |
| DocBook elements that occur within sections, e.g., paragraphs |
| (<sgmltag>para</sgmltag>, <sgmltag>simpara</sgmltag>), lists |
| (<sgmltag>orderedlist</sgmltag>, <sgmltag>itemizedlist</sgmltag>), |
| tables (<sgmltag>informaltable</sgmltag>, <sgmltag>table</sgmltag>), |
| etc.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.librarylist"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>librarylist</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>librarylist</refname> |
| <refpurpose>Placeholder for an alphabetical list of libraries</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>librarylist ::= |
| EMPTY |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>Developers aren't generally expected to use this element. Its existence is mainly as a placeholder in <filename>boost.xml</filename> for the alphabetical list of libraries.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.library-reference"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>library-reference</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>library-reference</refname> |
| <refpurpose>Declares the reference material for a library</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>library-reference ::= |
| (title?, section*, (<link linkend="boostbook.dtd.header">header</link>| <link linkend="boostbook.dtd.library-reference">library-reference</link>)*) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>Reference documentation for a library is contained with a |
| <library-reference> element. The <library-reference> |
| element has no attributes, and contains as children only |
| <header> elements.</para> |
| |
| <para>The <header> element defines a C++ header file. Within |
| each C++ header file lie the definitions of C++ constructs to be |
| documented. The <code>name</code> attribute of the <header> |
| element gives the name of the header, as one would specify when |
| including the header. For instance, the <library-reference> |
| for the <libraryname>Any</libraryname> library may look like |
| this:</para> |
| |
| <programlisting><library-reference> |
| <header name="boost/any.hpp"> |
| <!-- C++ constructs in this header --> |
| </header> |
| </library-reference></programlisting> |
| |
| <para>If the <libraryname>Any</libraryname> library contained |
| multiple headers, we would list them all as children of the |
| <library-reference> element.</para> |
| |
| <para><sgmltag>library-reference</sgmltag> elements can be nested, |
| so that reference material can be divided into separate sections |
| that each contain different headers.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.boostbook"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>boostbook</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>boostbook</refname> |
| <refpurpose>Defines a BoostBook book</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>boostbook ::= |
| (title, (chapter| <link linkend="boostbook.dtd.library">library</link>)*) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <simpara>This element is the topmost level defined by |
| <filename>boost.xml</filename> for all Boost documentation. It will |
| not generally be used by developers.</simpara> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.union"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>union</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>union</refname> |
| <refpurpose>Declares a C++ union or union template</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>union ::= |
| (<link linkend="boostbook.dtd.template">template</link>?, <link linkend="boostbook.dtd.inherit">inherit</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, (<link linkend="boostbook.dtd.access">access</link>| <link linkend="boostbook.dtd.static-constant">static-constant</link>| <link linkend="boostbook.dtd.typedef">typedef</link>| <link linkend="boostbook.dtd.enum">enum</link>| <link linkend="boostbook.dtd.copy-assignment">copy-assignment</link>| <link linkend="boostbook.dtd.constructor">constructor</link>| <link linkend="boostbook.dtd.destructor">destructor</link>| <link linkend="boostbook.dtd.method-group">method-group</link>| <link linkend="boostbook.dtd.free-function-group">free-function-group</link>| <link linkend="boostbook.dtd.function">function</link>| <link linkend="boostbook.dtd.method">method</link>| <link linkend="boostbook.dtd.overloaded-function">overloaded-function</link>| <link linkend="boostbook.dtd.overloaded-method">overloaded-method</link>| <link linkend="boostbook.dtd.data-member">data-member</link>| <link linkend="boostbook.dtd.class">class</link>| <link linkend="boostbook.dtd.class-specialization">class-specialization</link>| <link linkend="boostbook.dtd.struct">struct</link>| <link linkend="boostbook.dtd.struct-specialization">struct-specialization</link>| <link linkend="boostbook.dtd.union">union</link>| <link linkend="boostbook.dtd.union-specialization">union-specialization</link>)*) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.inherit"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>inherit</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>inherit</refname> |
| <refpurpose>Declares a base class of the enclosing class or struct</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>inherit ::= |
| (<link linkend="boostbook.dtd.type">type</link>, <link linkend="boostbook.dtd.purpose">purpose</link>?) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>This element contains the type of the class inherited.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>access</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The access specifier ("public", "private", or "protected") of the inheritance.</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>pack</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to '1' if this is a pack exapansion.</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.template-varargs"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>template-varargs</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>template-varargs</refname> |
| <refpurpose>Declares a variable-length list of template parameters</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>template-varargs ::= |
| EMPTY |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>Variable-length template parameter lists are not allowed in |
| C++, but because they are sometimes needed in documentation they are |
| allowed in BoostBook. This element generally expands to "..." and |
| can be used anywhere any other template parameter can be |
| used.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.source"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>source</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>source</refname> |
| <refpurpose>Defines source code for a test</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>source ::= |
| (#PCDATA| <link linkend="boostbook.dtd.snippet">snippet</link>)* |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>This element will contain the source code for a testcase that |
| will be generated from the documentation. To reduce the amount of escaping in the text, it is recommended to use CDATA sections, which look like this: |
| |
| <programlisting><![CDATA[ |
| <your program text here: no escaping needed!> |
| ]]></programlisting> |
| </para> |
| |
| <para>In addition to CDATA sections, code snippets can be pulled in |
| from <sgmltag>programlisting</sgmltag> elements using the <link linkend="boostbook.dtd.snippet"><sgmltag>snippet</sgmltag></link> |
| element.</para> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.function"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>function</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>function</refname> |
| <refpurpose>Declares a function</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>function ::= |
| (<link linkend="boostbook.dtd.template">template</link>?, <link linkend="boostbook.dtd.type">type</link>, <link linkend="boostbook.dtd.parameter">parameter</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, <link linkend="boostbook.dtd.requires">requires</link>?, <link linkend="boostbook.dtd.effects">effects</link>?, <link linkend="boostbook.dtd.postconditions">postconditions</link>?, <link linkend="boostbook.dtd.returns">returns</link>?, <link linkend="boostbook.dtd.throws">throws</link>?, <link linkend="boostbook.dtd.complexity">complexity</link>?, <link linkend="boostbook.dtd.notes">notes</link>?, <link linkend="boostbook.dtd.rationale">rationale</link>?) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>BoostBook functions are documented by specifying the |
| function's interface (e.g., its C++ signature) and its |
| behavior. Constructors, destructors, member functions, and free |
| functions all use the same documentation method, although the |
| top-level tags differ.</para> |
| |
| <para>The behavior of functions in BoostBook is documenting using a |
| style similar to that of the C++ standard, with clauses describing |
| the requirements, effects, postconditions, exception behavior, and |
| return values of functions.</para> |
| |
| <para>The following example illustrates some constructors and a |
| destructor for <classname>boost::any</classname>. Note that one of |
| the constructors takes a single parameter whose name is "other" and |
| whose type, <code>const any&</code> is contained in the |
| <paramtype> element; any number of parameters may be specified |
| in this way.</para> |
| |
| <programlisting><class name="any"> |
| <constructor> |
| <postconditions><para><this->empty()></para></postconditions> |
| </constructor> |
| |
| <constructor> |
| <parameter name="other"> |
| <paramtype>const <classname>any</classname>&amp;</paramtype> |
| </parameter> |
| |
| <effects> |
| <simpara> Copy constructor that copies |
| content of <code>other</code> into the new instance, |
| so that any content is equivalent in both type and value to the |
| content of <code>other</code>, or empty if |
| <code>other</code> is |
| empty. |
| </simpara> |
| </effects> |
| |
| <throws> |
| <simpara>May fail with a |
| <classname>std::bad_alloc</classname> exception or any |
| exceptions arising from the copy constructor of the |
| contained type. |
| </simpara> |
| </throws> |
| </constructor> |
| |
| <destructor> |
| <effects><simpara>Releases any and all resources used in |
| management of instance.</simpara></effects> |
| |
| <throws><simpara>Nothing.</simpara></throws> |
| </destructor> |
| </class></programlisting> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>specifiers</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The specifiers for this function, e.g., inline, static, etc.</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.macroname"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>macroname</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>macroname</refname> |
| <refpurpose/> |
| </refnamediv> |
| <refsynopsisdiv>macroname ::= |
| (#PCDATA) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>alt</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry/></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.postconditions"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>postconditions</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>postconditions</refname> |
| <refpurpose>Conditions that must hold after the function returns</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>postconditions ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.compile-test"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>compile-test</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>compile-test</refname> |
| <refpurpose>A testcase that should compile correctly</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>compile-test ::= |
| (<link linkend="boostbook.dtd.source">source</link>*, <link linkend="boostbook.dtd.lib">lib</link>*, <link linkend="boostbook.dtd.requirement">requirement</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>, <link linkend="boostbook.dtd.if-fails">if-fails</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>filename</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the file associated with this element</entry></row> |
| <row><entry>name</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.method"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>method</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>method</refname> |
| <refpurpose>Declares a method, i.e., a member function</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>method ::= |
| (<link linkend="boostbook.dtd.template">template</link>?, <link linkend="boostbook.dtd.type">type</link>, <link linkend="boostbook.dtd.parameter">parameter</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, <link linkend="boostbook.dtd.requires">requires</link>?, <link linkend="boostbook.dtd.effects">effects</link>?, <link linkend="boostbook.dtd.postconditions">postconditions</link>?, <link linkend="boostbook.dtd.returns">returns</link>?, <link linkend="boostbook.dtd.throws">throws</link>?, <link linkend="boostbook.dtd.complexity">complexity</link>?, <link linkend="boostbook.dtd.notes">notes</link>?, <link linkend="boostbook.dtd.rationale">rationale</link>?) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>General documentation on functions in BoostBook is provided in |
| the <link linkend="boostbook.dtd.function"><sgmltag>function</sgmltag></link> |
| element documentation.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>cv</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>cv-qualifiers for this method, e.g., const volatile</entry></row> |
| <row><entry>specifiers</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The specifiers for this function, e.g., inline, static, etc.</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.snippet"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>snippet</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>snippet</refname> |
| <refpurpose>Pulls in a code snippet from a <sgmltag>programlisting</sgmltag> element</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>snippet ::= |
| EMPTY |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the <sgmltag>programlisting</sgmltag> element to insert</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.constructor"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>constructor</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>constructor</refname> |
| <refpurpose>Declares a constructor of the enclosing class</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>constructor ::= |
| (<link linkend="boostbook.dtd.template">template</link>?, <link linkend="boostbook.dtd.parameter">parameter</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, <link linkend="boostbook.dtd.requires">requires</link>?, <link linkend="boostbook.dtd.effects">effects</link>?, <link linkend="boostbook.dtd.postconditions">postconditions</link>?, <link linkend="boostbook.dtd.returns">returns</link>?, <link linkend="boostbook.dtd.throws">throws</link>?, <link linkend="boostbook.dtd.complexity">complexity</link>?, <link linkend="boostbook.dtd.notes">notes</link>?, <link linkend="boostbook.dtd.rationale">rationale</link>?) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>General documentation on functions in BoostBook is provided in |
| the <link linkend="boostbook.dtd.function"><sgmltag>function</sgmltag></link> |
| element documentation.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>specifiers</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The specifiers for this function, e.g., inline, static, etc.</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.namespace"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>namespace</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>namespace</refname> |
| <refpurpose>Declares a namespace</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>namespace ::= |
| (<link linkend="boostbook.dtd.class">class</link>| <link linkend="boostbook.dtd.class-specialization">class-specialization</link>| <link linkend="boostbook.dtd.struct">struct</link>| <link linkend="boostbook.dtd.struct-specialization">struct-specialization</link>| <link linkend="boostbook.dtd.union">union</link>| <link linkend="boostbook.dtd.union-specialization">union-specialization</link>| <link linkend="boostbook.dtd.typedef">typedef</link>| <link linkend="boostbook.dtd.enum">enum</link>| <link linkend="boostbook.dtd.free-function-group">free-function-group</link>| <link linkend="boostbook.dtd.function">function</link>| <link linkend="boostbook.dtd.overloaded-function">overloaded-function</link>| <link linkend="boostbook.dtd.namespace">namespace</link>)* |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>BoostBook namespaces are declared via the <namespace> |
| element. As in C++, namespaces can be nested and contain other C++ |
| constructs, such as classes or functions. The <code>name</code> |
| attribute of a <namespace> element gives the namespace name |
| (e.g., "boost"). The <libraryname>Any</libraryname> library is |
| defined entirely within namespace boost by:</para> |
| |
| <programlisting><library-reference> |
| <header name="boost/any.hpp"> |
| <namespace name="boost"> |
| <!-- C++ constructs in the boost namespace --> |
| </namespace> |
| </header> |
| </library-reference></programlisting> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.if-fails"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>if-fails</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>if-fails</refname> |
| <refpurpose>What it means when a testcase fails</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>if-fails ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para> |
| Describes to the user the effect a certain failing testcase will |
| have on the usefulness of a library. This field is useful in cases |
| where a failed testcase does not mean that the library won't be |
| useful, but may mean that certain library features will not be |
| available. |
| </para> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.headername"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>headername</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>headername</refname> |
| <refpurpose/> |
| </refnamediv> |
| <refsynopsisdiv>headername ::= |
| (#PCDATA) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>alt</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry/></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.free-function-group"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>free-function-group</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>free-function-group</refname> |
| <refpurpose>A set of functions that are grouped together under one name</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>free-function-group ::= |
| (<link linkend="boostbook.dtd.function">function</link>| <link linkend="boostbook.dtd.overloaded-function">overloaded-function</link>)* |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.functionname"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>functionname</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>functionname</refname> |
| <refpurpose>References a function with the given name</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>functionname ::= |
| (#PCDATA) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>If a function (or overloaded function) with the given, |
| possibly-qualified name is found, this generates a link to that |
| function. Lookups obey currently-active <link linkend="boostbook.dtd.using-class"><sgmltag>using-class</sgmltag></link> |
| and <link linkend="boostbook.dtd.using-namespace"><sgmltag>using-namespace</sgmltag></link> |
| directives to aid in the search, along with searching within the |
| current scope.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>alt</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry/></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.librarycategory"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>librarycategory</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>librarycategory</refname> |
| <refpurpose>Declares that the enclosing library is in this category</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>librarycategory ::= |
| (#PCDATA) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.notes"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>notes</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>notes</refname> |
| <refpurpose>Non-normative notes about a function's semantics</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>notes ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.data-member"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>data-member</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>data-member</refname> |
| <refpurpose>Declares a data member of a class</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>data-member ::= |
| (<link linkend="boostbook.dtd.type">type</link>, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>specifiers</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The specifiers for this function, e.g., inline, static, etc.</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.specialization"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>specialization</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>specialization</refname> |
| <refpurpose>Defines the specialization arguments for a class specialization</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>specialization ::= |
| (<link linkend="boostbook.dtd.template-arg">template-arg</link>)* |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.union-specialization"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>union-specialization</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>union-specialization</refname> |
| <refpurpose>A specialization (full or partial) of a union template</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>union-specialization ::= |
| (<link linkend="boostbook.dtd.template">template</link>?, <link linkend="boostbook.dtd.specialization">specialization</link>?, <link linkend="boostbook.dtd.inherit">inherit</link>?, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, (<link linkend="boostbook.dtd.access">access</link>| <link linkend="boostbook.dtd.static-constant">static-constant</link>| <link linkend="boostbook.dtd.typedef">typedef</link>| <link linkend="boostbook.dtd.enum">enum</link>| <link linkend="boostbook.dtd.copy-assignment">copy-assignment</link>| <link linkend="boostbook.dtd.constructor">constructor</link>| <link linkend="boostbook.dtd.destructor">destructor</link>| <link linkend="boostbook.dtd.method-group">method-group</link>| <link linkend="boostbook.dtd.free-function-group">free-function-group</link>| <link linkend="boostbook.dtd.function">function</link>| <link linkend="boostbook.dtd.method">method</link>| <link linkend="boostbook.dtd.overloaded-function">overloaded-function</link>| <link linkend="boostbook.dtd.overloaded-method">overloaded-method</link>| <link linkend="boostbook.dtd.data-member">data-member</link>| <link linkend="boostbook.dtd.class">class</link>| <link linkend="boostbook.dtd.class-specialization">class-specialization</link>| <link linkend="boostbook.dtd.struct">struct</link>| <link linkend="boostbook.dtd.struct-specialization">struct-specialization</link>| <link linkend="boostbook.dtd.union">union</link>| <link linkend="boostbook.dtd.union-specialization">union-specialization</link>)*) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.throws"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>throws</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>throws</refname> |
| <refpurpose>Description of the exceptions thrown by a function</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>throws ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.template-arg"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>template-arg</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>template-arg</refname> |
| <refpurpose>A template argument in a specialization</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>template-arg ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>pack</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to '1' if this is a pack exapansion.</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.globalname"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>globalname</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>globalname</refname> |
| <refpurpose/> |
| </refnamediv> |
| <refsynopsisdiv>globalname ::= |
| (#PCDATA) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>alt</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry/></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.method-group"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>method-group</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>method-group</refname> |
| <refpurpose>A set of methods that are grouped together under one name</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>method-group ::= |
| (<link linkend="boostbook.dtd.method">method</link>| <link linkend="boostbook.dtd.overloaded-method">overloaded-method</link>)* |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.requirement"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>requirement</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>requirement</refname> |
| <refpurpose>A requirement/property in the Jamfile for a testcase</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>requirement ::= |
| (#PCDATA) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>A requirement is part of the dependencies of a target in a |
| Jamfile. The <code>name</code> attribute of a requirement element |
| gives the name of the Boost.Build feature and the content of the |
| requirement gives the value of that feature. A requirement such as |
| <code><includes>foo.hpp</code> would be encoded as |
| <code><requirement |
| name="includes">foo.hpp</requirement></code>.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.precondition"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>precondition</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>precondition</refname> |
| <refpurpose>Conditions that must be met prior to executing a function</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>precondition ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.paramtype"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>paramtype</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>paramtype</refname> |
| <refpurpose>The type of a function parameter</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>paramtype ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.using-class"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>using-class</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>using-class</refname> |
| <refpurpose>Injects the method and function names of a class into the local scope</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>using-class ::= |
| EMPTY |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.run-test"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>run-test</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>run-test</refname> |
| <refpurpose>A testcase that should compile, link, and execute</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>run-test ::= |
| (<link linkend="boostbook.dtd.source">source</link>*, <link linkend="boostbook.dtd.lib">lib</link>*, <link linkend="boostbook.dtd.requirement">requirement</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>, <link linkend="boostbook.dtd.if-fails">if-fails</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>filename</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the file associated with this element</entry></row> |
| <row><entry>name</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.librarypurpose"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>librarypurpose</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>librarypurpose</refname> |
| <refpurpose>Describes in one short sentence or phrase the purpose of a library</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>librarypurpose ::= |
| (#PCDATA| <link linkend="boostbook.dtd.code">code</link>| ulink| <link linkend="boostbook.dtd.functionname">functionname</link>| methodname| classname| <link linkend="boostbook.dtd.macroname">macroname</link>| <link linkend="boostbook.dtd.headername">headername</link>| <link linkend="boostbook.dtd.enumname">enumname</link>| <link linkend="boostbook.dtd.globalname">globalname</link>)* |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.copy-assignment"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>copy-assignment</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>copy-assignment</refname> |
| <refpurpose>Declares a copy-assignment operator</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>copy-assignment ::= |
| (<link linkend="boostbook.dtd.template">template</link>?, <link linkend="boostbook.dtd.type">type</link>?, <link linkend="boostbook.dtd.parameter">parameter</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, <link linkend="boostbook.dtd.requires">requires</link>?, <link linkend="boostbook.dtd.effects">effects</link>?, <link linkend="boostbook.dtd.postconditions">postconditions</link>?, <link linkend="boostbook.dtd.returns">returns</link>?, <link linkend="boostbook.dtd.throws">throws</link>?, <link linkend="boostbook.dtd.complexity">complexity</link>?, <link linkend="boostbook.dtd.notes">notes</link>?, <link linkend="boostbook.dtd.rationale">rationale</link>?) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>The return type of the copy-assignment operator does not need |
| to be specified. If left unspecified, it will default to an |
| unqualified reference to the enclosing class type.</para> |
| |
| <para>General documentation on functions in BoostBook is provided in |
| the <link linkend="boostbook.dtd.function"><sgmltag>function</sgmltag></link> |
| element documentation.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>cv</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>cv-qualifiers for this method, e.g., const volatile</entry></row> |
| <row><entry>specifiers</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The specifiers for this function, e.g., inline, static, etc.</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.run-fail-test"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>run-fail-test</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>run-fail-test</refname> |
| <refpurpose>A testcase that should compile and link, but fail on execution</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>run-fail-test ::= |
| (<link linkend="boostbook.dtd.source">source</link>*, <link linkend="boostbook.dtd.lib">lib</link>*, <link linkend="boostbook.dtd.requirement">requirement</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>, <link linkend="boostbook.dtd.if-fails">if-fails</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>filename</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the file associated with this element</entry></row> |
| <row><entry>name</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.template"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>template</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>template</refname> |
| <refpurpose>Declares the template parameters of a class or function</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>template ::= |
| (<link linkend="boostbook.dtd.template-type-parameter">template-type-parameter</link>| <link linkend="boostbook.dtd.template-nontype-parameter">template-nontype-parameter</link>| <link linkend="boostbook.dtd.template-varargs">template-varargs</link>)* |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.compile-fail-test"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>compile-fail-test</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>compile-fail-test</refname> |
| <refpurpose>A testcase that should fail to compile</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>compile-fail-test ::= |
| (<link linkend="boostbook.dtd.source">source</link>*, <link linkend="boostbook.dtd.lib">lib</link>*, <link linkend="boostbook.dtd.requirement">requirement</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>, <link linkend="boostbook.dtd.if-fails">if-fails</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>filename</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the file associated with this element</entry></row> |
| <row><entry>name</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.returns"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>returns</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>returns</refname> |
| <refpurpose>Description of the return value of a function</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>returns ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.default"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>default</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>default</refname> |
| <refpurpose>The default value of a function or template parameter</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>default ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.parameter"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>parameter</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>parameter</refname> |
| <refpurpose>A function parameter</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>parameter ::= |
| (<link linkend="boostbook.dtd.paramtype">paramtype</link>, <link linkend="boostbook.dtd.default">default</link>?, <link linkend="boostbook.dtd.description">description</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>name</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>pack</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to '1' if the parameter is a parameter pack.</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.signature"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>signature</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>signature</refname> |
| <refpurpose>One signature of an overloaded function or method</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>signature ::= |
| (<link linkend="boostbook.dtd.template">template</link>?, <link linkend="boostbook.dtd.type">type</link>, <link linkend="boostbook.dtd.parameter">parameter</link>*) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para> |
| A signature refers to one declaration of an overloaded function or |
| method. The signature itself has no name, because the name of the |
| overloaded function or method is used. An overloaded function or |
| method will have several signatures that will generally be typeset |
| together. |
| </para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>cv</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>cv-qualifiers for this method, e.g., const volatile</entry></row> |
| <row><entry>specifiers</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The specifiers for this function, e.g., inline, static, etc.</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.overloaded-function"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>overloaded-function</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>overloaded-function</refname> |
| <refpurpose>An overloaded function</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>overloaded-function ::= |
| (<link linkend="boostbook.dtd.signature">signature</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, <link linkend="boostbook.dtd.requires">requires</link>?, <link linkend="boostbook.dtd.effects">effects</link>?, <link linkend="boostbook.dtd.postconditions">postconditions</link>?, <link linkend="boostbook.dtd.returns">returns</link>?, <link linkend="boostbook.dtd.throws">throws</link>?, <link linkend="boostbook.dtd.complexity">complexity</link>?, <link linkend="boostbook.dtd.notes">notes</link>?, <link linkend="boostbook.dtd.rationale">rationale</link>?) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>General documentation on functions in BoostBook is provided in |
| the <link linkend="boostbook.dtd.function"><sgmltag>function</sgmltag></link> |
| element documentation.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.access"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>access</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>access</refname> |
| <refpurpose>Declares an access specification for class members</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>access ::= |
| (<link linkend="boostbook.dtd.static-constant">static-constant</link>| <link linkend="boostbook.dtd.typedef">typedef</link>| <link linkend="boostbook.dtd.enum">enum</link>| <link linkend="boostbook.dtd.copy-assignment">copy-assignment</link>| <link linkend="boostbook.dtd.constructor">constructor</link>| <link linkend="boostbook.dtd.destructor">destructor</link>| <link linkend="boostbook.dtd.method-group">method-group</link>| <link linkend="boostbook.dtd.method">method</link>| <link linkend="boostbook.dtd.overloaded-method">overloaded-method</link>| <link linkend="boostbook.dtd.data-member">data-member</link>| <link linkend="boostbook.dtd.class">class</link>| <link linkend="boostbook.dtd.class-specialization">class-specialization</link>| <link linkend="boostbook.dtd.struct">struct</link>| <link linkend="boostbook.dtd.struct-specialization">struct-specialization</link>| <link linkend="boostbook.dtd.union">union</link>| <link linkend="boostbook.dtd.union-specialization">union-specialization</link>)+ |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>The access specifications of class members (public, private, or protected) may be determined by enclosing them in an <access> element.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the access specification, e.g. "public", "private", or "protected".</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.class"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>class</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>class</refname> |
| <refpurpose>Declares a class or class template</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>class ::= |
| (<link linkend="boostbook.dtd.template">template</link>?, <link linkend="boostbook.dtd.inherit">inherit</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, (<link linkend="boostbook.dtd.access">access</link>| <link linkend="boostbook.dtd.static-constant">static-constant</link>| <link linkend="boostbook.dtd.typedef">typedef</link>| <link linkend="boostbook.dtd.enum">enum</link>| <link linkend="boostbook.dtd.copy-assignment">copy-assignment</link>| <link linkend="boostbook.dtd.constructor">constructor</link>| <link linkend="boostbook.dtd.destructor">destructor</link>| <link linkend="boostbook.dtd.method-group">method-group</link>| <link linkend="boostbook.dtd.free-function-group">free-function-group</link>| <link linkend="boostbook.dtd.function">function</link>| <link linkend="boostbook.dtd.method">method</link>| <link linkend="boostbook.dtd.overloaded-function">overloaded-function</link>| <link linkend="boostbook.dtd.overloaded-method">overloaded-method</link>| <link linkend="boostbook.dtd.data-member">data-member</link>| <link linkend="boostbook.dtd.class">class</link>| <link linkend="boostbook.dtd.class-specialization">class-specialization</link>| <link linkend="boostbook.dtd.struct">struct</link>| <link linkend="boostbook.dtd.struct-specialization">struct-specialization</link>| <link linkend="boostbook.dtd.union">union</link>| <link linkend="boostbook.dtd.union-specialization">union-specialization</link>)*) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>C++ classes and class templates are described via the |
| <class> element. Each class has a name (e.g., "any") given by |
| the <code>name</code> attribute, a purpose given by the |
| <purpose> element, documentation, and a set of types, |
| functions, base classes, and data members. Here is a minimal |
| definition of the <classname>boost::any</classname> class:</para> |
| |
| <programlisting><namespace name="boost"> |
| <class name="any"> |
| <purpose> |
| A class whose instances can hold instances of any type that satisfies |
| ValueType requirements. |
| </purpose> |
| </class> |
| </namespace></programlisting> |
| |
| <para>Additional class documentation can be contained in a |
| <sgmltag>description</sgmltag> element following the <purpose> |
| element. This documentation will be typeset prior to documentation |
| for specific elements in the class (e.g., constructors or |
| methods).</para> |
| |
| <para>Class inheritance is described via the <inherit> |
| element. The <inherit> element requires an <code>access</code> |
| attribute which must be one of <emphasis>public</emphasis>, |
| <emphasis>protected</emphasis>, or <emphasis>private</emphasis>. The |
| content of the <inherited> element in C++ code that names the |
| class inherited, and may contain markup to link to the class. The |
| following description of the class |
| <classname>boost::bad_any_cast</classname> describes public |
| inheritance from the class <classname>std::bad_cast</classname>. It |
| also defines the <purpose> element, which contains a short |
| description of the use of the class.</para> |
| |
| <programlisting><class name="bad_any_cast"> |
| <inherit access="public"><classname>std::bad_cast</classname></inherit> |
| <purpose><para>The exception thrown in the event of a failed |
| <functionname>any_cast</functionname> of an |
| <classname>any</classname> value.</para></purpose> |
| </class></programlisting> |
| |
| <para>Class templates are defined by <class> elements with a |
| <template> child element at the beginning.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.librarycategorydef"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>librarycategorydef</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>librarycategorydef</refname> |
| <refpurpose>Defines a new library category</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>librarycategorydef ::= |
| (#PCDATA) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>All library category definitions should be in <filename>doc/src/boost.xml</filename>, and the names of categories must be prefixed with "<code>category:</code>".</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.type"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>type</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>type</refname> |
| <refpurpose>The type of an element or return type of a function</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>type ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.enumvalue"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>enumvalue</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>enumvalue</refname> |
| <refpurpose>A single value of an enumeration</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>enumvalue ::= |
| (<link linkend="boostbook.dtd.default">default</link>?, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.overloaded-method"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>overloaded-method</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>overloaded-method</refname> |
| <refpurpose>An overloaded method</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>overloaded-method ::= |
| (<link linkend="boostbook.dtd.signature">signature</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, <link linkend="boostbook.dtd.requires">requires</link>?, <link linkend="boostbook.dtd.effects">effects</link>?, <link linkend="boostbook.dtd.postconditions">postconditions</link>?, <link linkend="boostbook.dtd.returns">returns</link>?, <link linkend="boostbook.dtd.throws">throws</link>?, <link linkend="boostbook.dtd.complexity">complexity</link>?, <link linkend="boostbook.dtd.notes">notes</link>?, <link linkend="boostbook.dtd.rationale">rationale</link>?) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>General documentation on functions in BoostBook is provided in |
| the <link linkend="boostbook.dtd.function"><sgmltag>function</sgmltag></link> |
| element documentation.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.programlisting"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>programlisting</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>programlisting</refname> |
| <refpurpose>A sample of program code</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>programlisting ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>name</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.complexity"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>complexity</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>complexity</refname> |
| <refpurpose>The time/space/etc. complexity of a function</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>complexity ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.purpose"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>purpose</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>purpose</refname> |
| <refpurpose>A short description of an entity's use</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>purpose ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.template-nontype-parameter"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>template-nontype-parameter</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>template-nontype-parameter</refname> |
| <refpurpose>A nontype template parameter</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>template-nontype-parameter ::= |
| (<link linkend="boostbook.dtd.type">type</link>, <link linkend="boostbook.dtd.default">default</link>?, <link linkend="boostbook.dtd.purpose">purpose</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>pack</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to '1' if the parameter is a parameter pack.</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.library"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>library</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>library</refname> |
| <refpurpose>Top-level element for a library</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>library ::= |
| (<link linkend="boostbook.dtd.libraryinfo">libraryinfo</link>, (title, ((section| <link linkend="boostbook.dtd.library-reference">library-reference</link>| <link linkend="boostbook.dtd.testsuite">testsuite</link>))+)?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>dirname</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry/></row> |
| <row><entry>url</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry/></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| <row><entry>html-only</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry/></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.librarycategorylist"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>librarycategorylist</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>librarycategorylist</refname> |
| <refpurpose>Categorized listing of libraries</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>librarycategorylist ::= |
| (<link linkend="boostbook.dtd.librarycategorydef">librarycategorydef</link>)* |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>This element is not intended for use by developers, but is |
| used by <filename>doc/src/boost.xml</filename> as a |
| placeholder.</para> |
| </refsection> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.using-namespace"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>using-namespace</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>using-namespace</refname> |
| <refpurpose>Injects the declared names from a namespace into the local scope</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>using-namespace ::= |
| EMPTY |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.enumname"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>enumname</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>enumname</refname> |
| <refpurpose/> |
| </refnamediv> |
| <refsynopsisdiv>enumname ::= |
| (#PCDATA) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>alt</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry/></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.struct-specialization"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>struct-specialization</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>struct-specialization</refname> |
| <refpurpose>A specialization (full or partial) of a struct template</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>struct-specialization ::= |
| (<link linkend="boostbook.dtd.template">template</link>?, <link linkend="boostbook.dtd.specialization">specialization</link>?, <link linkend="boostbook.dtd.inherit">inherit</link>?, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, (<link linkend="boostbook.dtd.access">access</link>| <link linkend="boostbook.dtd.static-constant">static-constant</link>| <link linkend="boostbook.dtd.typedef">typedef</link>| <link linkend="boostbook.dtd.enum">enum</link>| <link linkend="boostbook.dtd.copy-assignment">copy-assignment</link>| <link linkend="boostbook.dtd.constructor">constructor</link>| <link linkend="boostbook.dtd.destructor">destructor</link>| <link linkend="boostbook.dtd.method-group">method-group</link>| <link linkend="boostbook.dtd.free-function-group">free-function-group</link>| <link linkend="boostbook.dtd.function">function</link>| <link linkend="boostbook.dtd.method">method</link>| <link linkend="boostbook.dtd.overloaded-function">overloaded-function</link>| <link linkend="boostbook.dtd.overloaded-method">overloaded-method</link>| <link linkend="boostbook.dtd.data-member">data-member</link>| <link linkend="boostbook.dtd.class">class</link>| <link linkend="boostbook.dtd.class-specialization">class-specialization</link>| <link linkend="boostbook.dtd.struct">struct</link>| <link linkend="boostbook.dtd.struct-specialization">struct-specialization</link>| <link linkend="boostbook.dtd.union">union</link>| <link linkend="boostbook.dtd.union-specialization">union-specialization</link>)*) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.struct"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>struct</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>struct</refname> |
| <refpurpose>Declares a C++ struct</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>struct ::= |
| (<link linkend="boostbook.dtd.template">template</link>?, <link linkend="boostbook.dtd.inherit">inherit</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?, (<link linkend="boostbook.dtd.access">access</link>| <link linkend="boostbook.dtd.static-constant">static-constant</link>| <link linkend="boostbook.dtd.typedef">typedef</link>| <link linkend="boostbook.dtd.enum">enum</link>| <link linkend="boostbook.dtd.copy-assignment">copy-assignment</link>| <link linkend="boostbook.dtd.constructor">constructor</link>| <link linkend="boostbook.dtd.destructor">destructor</link>| <link linkend="boostbook.dtd.method-group">method-group</link>| <link linkend="boostbook.dtd.free-function-group">free-function-group</link>| <link linkend="boostbook.dtd.function">function</link>| <link linkend="boostbook.dtd.method">method</link>| <link linkend="boostbook.dtd.overloaded-function">overloaded-function</link>| <link linkend="boostbook.dtd.overloaded-method">overloaded-method</link>| <link linkend="boostbook.dtd.data-member">data-member</link>| <link linkend="boostbook.dtd.class">class</link>| <link linkend="boostbook.dtd.class-specialization">class-specialization</link>| <link linkend="boostbook.dtd.struct">struct</link>| <link linkend="boostbook.dtd.struct-specialization">struct-specialization</link>| <link linkend="boostbook.dtd.union">union</link>| <link linkend="boostbook.dtd.union-specialization">union-specialization</link>)*) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.lib"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>lib</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>lib</refname> |
| <refpurpose>A library dependency</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>lib ::= |
| (#PCDATA) |
| </refsynopsisdiv> |
| <refsection><title>Description</title> |
| <para>Declares a library dependency on the library named by the content of this element, to be emitted in a Jamfile.</para> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.enum"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>enum</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>enum</refname> |
| <refpurpose>Declares an enumeration type</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>enum ::= |
| (<link linkend="boostbook.dtd.enumvalue">enumvalue</link>*, <link linkend="boostbook.dtd.purpose">purpose</link>?, <link linkend="boostbook.dtd.description">description</link>?) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.requires"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>requires</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>requires</refname> |
| <refpurpose>Declares the requirements of a function</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>requires ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.effects"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>effects</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>effects</refname> |
| <refpurpose>Declares the side effects of a function</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>effects ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.libraryname"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>libraryname</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>libraryname</refname> |
| <refpurpose>References a library of the given name</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>libraryname ::= |
| (#PCDATA) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.libraryinfo"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>libraryinfo</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>libraryinfo</refname> |
| <refpurpose>Provides information about a library</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>libraryinfo ::= |
| (author+, copyright*, legalnotice*, <link linkend="boostbook.dtd.librarypurpose">librarypurpose</link>, <link linkend="boostbook.dtd.librarycategory">librarycategory</link>*) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.testsuite"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>testsuite</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>testsuite</refname> |
| <refpurpose>Describes a library testsuite</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>testsuite ::= |
| ((<link linkend="boostbook.dtd.compile-test">compile-test</link>| <link linkend="boostbook.dtd.link-test">link-test</link>| <link linkend="boostbook.dtd.run-test">run-test</link>| <link linkend="boostbook.dtd.compile-fail-test">compile-fail-test</link>| <link linkend="boostbook.dtd.link-fail-test">link-fail-test</link>| <link linkend="boostbook.dtd.run-fail-test">run-fail-test</link>)+) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.header"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>header</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>header</refname> |
| <refpurpose>Declares a C++ header with the given name</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>header ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>name</entry><entry>#REQUIRED</entry><entry>CDATA</entry><entry>The name of the element being declared to referenced</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| <refentry id="boostbook.dtd.rationale"> |
| <refmeta> |
| <refentrytitle> |
| BoostBook element <sgmltag>rationale</sgmltag></refentrytitle> |
| <manvolnum>9</manvolnum> |
| </refmeta> |
| <refnamediv> |
| <refname>rationale</refname> |
| <refpurpose>Describes the rationale for a particular function's design</refpurpose> |
| </refnamediv> |
| <refsynopsisdiv>rationale ::= |
| (ANY) |
| </refsynopsisdiv> |
| <refsection> |
| <title>Attributes</title> |
| <informaltable> |
| <tgroup cols="4"> |
| <thead> |
| <row> |
| <entry>Name</entry> |
| <entry>Type</entry> |
| <entry>Value</entry> |
| <entry>Purpose</entry> |
| </row> |
| </thead> |
| <tbody> |
| |
| <row><entry>last-revision</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Set to $Date: 2009-10-10 10:53:46 -0400 (Sat, 10 Oct 2009) $ to keep "last revised" information in sync with CVS changes</entry></row> |
| <row><entry>id</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>A global identifier for this element</entry></row> |
| <row><entry>xml:base</entry><entry>#IMPLIED</entry><entry>CDATA</entry><entry>Implementation detail used by XIncludes</entry></row> |
| </tbody> |
| </tgroup> |
| </informaltable> |
| </refsection> |
| </refentry> |
| </chapter> |
| |