Boost logo

Boost-Commit :

Subject: [Boost-commit] svn:boost r75697 - in trunk/tools/quickbook: src test
From: dnljms_at_[hidden]
Date: 2011-11-27 16:41:45


Author: danieljames
Date: 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
New Revision: 75697
URL: http://svn.boost.org/trac/boost/changeset/75697

Log:
Quickbook: Remove files left over after merge.
Removed:
   trunk/tools/quickbook/src/id_generator.cpp
   trunk/tools/quickbook/test/anchor.gold
   trunk/tools/quickbook/test/blocks.gold
   trunk/tools/quickbook/test/callouts.gold
   trunk/tools/quickbook/test/callouts.quickbook
   trunk/tools/quickbook/test/code-block-1.gold
   trunk/tools/quickbook/test/code-block-2.gold
   trunk/tools/quickbook/test/code-block-3.gold
   trunk/tools/quickbook/test/code-block-3.quickbook
   trunk/tools/quickbook/test/code-block-cpp.gold
   trunk/tools/quickbook/test/code-block-python.gold
   trunk/tools/quickbook/test/code-block-teletype.gold
   trunk/tools/quickbook/test/code-block.gold
   trunk/tools/quickbook/test/heading_1_1.gold
   trunk/tools/quickbook/test/heading_1_1.quickbook
   trunk/tools/quickbook/test/heading_1_3.gold
   trunk/tools/quickbook/test/heading_1_3.quickbook
   trunk/tools/quickbook/test/heading_1_5.gold
   trunk/tools/quickbook/test/heading_1_6.gold
   trunk/tools/quickbook/test/identifier_1_5.gold
   trunk/tools/quickbook/test/identifier_1_6.gold
   trunk/tools/quickbook/test/import.gold
   trunk/tools/quickbook/test/import.quickbook
   trunk/tools/quickbook/test/preformatted.gold
   trunk/tools/quickbook/test/quickbook-manual.gold
   trunk/tools/quickbook/test/section_1_5-unclosed.gold
   trunk/tools/quickbook/test/section_1_5-unclosed.quickbook
   trunk/tools/quickbook/test/template-section.gold
   trunk/tools/quickbook/test/templates.gold
   trunk/tools/quickbook/test/unicode-escape.gold
   trunk/tools/quickbook/test/utf-8-bom.gold
   trunk/tools/quickbook/test/utf-8.gold

Deleted: trunk/tools/quickbook/src/id_generator.cpp
==============================================================================
--- trunk/tools/quickbook/src/id_generator.cpp 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,455 +0,0 @@
-/*=============================================================================
- Copyright (c) 2011 Daniel James
-
- Use, modification and distribution is subject to 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)
-=============================================================================*/
-
-#include "id_generator.hpp"
-#include "markups.hpp"
-#include "phrase_tags.hpp"
-#include <cctype>
-#include <boost/lexical_cast.hpp>
-#include <algorithm>
-#include <vector>
-
-namespace quickbook
-{
- // string_ref
-
- struct string_ref
- {
- public:
- typedef std::string::const_iterator iterator;
-
- private:
- iterator begin_, end_;
-
- public:
- string_ref() : begin_(), end_() {}
-
- explicit string_ref(iterator b, iterator e)
- : begin_(b), end_(e) {}
-
- explicit string_ref(std::string const& x)
- : begin_(x.begin()), end_(x.end()) {}
-
- iterator begin() const { return begin_; }
- iterator end() const { return end_; }
-
- std::size_t size() const
- {
- return static_cast<std::size_t>(end_ - begin_);
- }
- };
-
- bool operator==(string_ref const& x, string_ref const& y);
- bool operator<(string_ref const& x, string_ref const& y);
-
- inline bool operator==(string_ref const& x, std::string const& y)
- {
- return x == string_ref(y);
- }
-
- inline bool operator==(std::string const& x, string_ref const& y)
- {
- return string_ref(x) == y;
- }
-
- inline bool operator<(string_ref const& x, std::string const& y)
- {
- return x < string_ref(y);
- }
-
- inline bool operator<(std::string const& x, string_ref const& y)
- {
- return string_ref(x) < y;
- }
-
- bool operator==(string_ref const& x, string_ref const& y)
- {
- return x.size() == y.size() &&
- std::equal(x.begin(), x.end(), y.begin());
- }
-
- bool operator<(string_ref const& x, string_ref const& y)
- {
- return std::lexicographical_compare(
- x.begin(), x.end(), y.begin(), y.end());
- }
-
- //
- // id_generator
- //
-
- static const std::size_t max_size = 32;
-
- namespace
- {
- std::string normalize_id(std::string const& id)
- {
- std::string result;
-
- std::string::const_iterator it = id.begin();
- while (it != id.end()) {
- if (*it == '_') {
- do {
- ++it;
- } while(it != id.end() && *it == '_');
-
- if (it != id.end()) result += '_';
- }
- else {
- result += *it;
- ++it;
- }
- }
-
- return result;
- }
- }
-
- id_generator::id_generator()
- {
- }
-
- id_generator::~id_generator()
- {
- }
-
- std::string id_generator::add(
- std::string const& value,
- id_generator::categories category)
- {
- std::string result;
-
- id_data& data = ids.emplace(boost::unordered::piecewise_construct,
- boost::make_tuple(value),
- boost::make_tuple(value, category)).first->second;
-
- // Doesn't check if explicit ids collide, could probably be a warning.
- if (category == explicit_id)
- {
- data.category = category;
- data.used = true;
- result = value;
- }
- else
- {
- if (category < data.category) data.category = category;
-
- // '$' can't appear in quickbook ids, so use it indicate a
- // placeholder id.
- result = "$" +
- boost::lexical_cast<std::string>(placeholders.size());
- placeholders.push_back(placeholder_id(category, &data));
- }
-
- return result;
- }
-
- string_ref id_generator::get(string_ref value)
- {
- // If this isn't a placeholder id.
- if (value.size() <= 1 || *value.begin() != '$')
- return value;
-
- placeholder_id* placeholder = &placeholders.at(
- boost::lexical_cast<int>(std::string(
- value.begin() + 1, value.end())));
-
- if (placeholder->final_id.empty())
- {
- if (placeholder->category < id_generator::numbered &&
- !placeholder->data->used &&
- placeholder->data->category == placeholder->category)
- {
- placeholder->data->used = true;
- placeholder->final_id = placeholder->data->name;
- }
- else
- {
- generate_id(placeholder);
- }
- }
-
- return string_ref(placeholder->final_id);
- }
-
- void id_generator::generate_id(placeholder_id* placeholder)
- {
- id_data* data = placeholder->data;
-
- if (!data->generation_data)
- {
- std::string const& name = data->name;
-
- std::size_t seperator = name.rfind('.') + 1;
- data->generation_data.reset(new id_generation_data(
- std::string(name, 0, seperator),
- normalize_id(std::string(name, seperator))
- ));
-
- try_potential_id(placeholder);
- }
-
- while(!try_counted_id(placeholder)) {};
- }
-
- bool id_generator::try_potential_id(placeholder_id* placeholder)
- {
- placeholder->final_id =
- placeholder->data->generation_data->parent +
- placeholder->data->generation_data->base;
-
- // Be careful here as it's quite likely that final_id is the
- // same as the original id, so this will just find the original
- // data.
- //
- // Not caring too much about 'category' and 'used', would want to if
- // still creating ids.
- std::pair<boost::unordered_map<std::string, id_data>::iterator, bool>
- insert = ids.emplace(boost::unordered::piecewise_construct,
- boost::make_tuple(placeholder->final_id),
- boost::make_tuple(placeholder->final_id,
- placeholder->category, true));
-
- if (insert.first->second.generation_data)
- {
- placeholder->data->generation_data =
- insert.first->second.generation_data;
- }
- else
- {
- insert.first->second.generation_data =
- placeholder->data->generation_data;
- }
-
- return insert.second;
- }
-
- bool id_generator::try_counted_id(placeholder_id* placeholder)
- {
- std::string name =
- placeholder->data->generation_data->base +
- (placeholder->data->generation_data->needs_underscore ? "_" : "") +
- boost::lexical_cast<std::string>(
- placeholder->data->generation_data->count);
-
- if (name.length() > max_size)
- {
- std::size_t new_end =
- placeholder->data->generation_data->base.length() -
- (name.length() - max_size);
-
- while (new_end > 0 &&
- std::isdigit(placeholder->data->generation_data->base[new_end - 1]))
- --new_end;
-
- placeholder->data->generation_data->base.erase(new_end);
- placeholder->data->generation_data->new_base_value();
-
- // Return result of try_potential_id to use the truncated id
- // without a number.
- try_potential_id(placeholder);
- return false;
- }
-
- placeholder->final_id =
- placeholder->data->generation_data->parent + name;
-
- std::pair<boost::unordered_map<std::string, id_data>::iterator, bool>
- insert = ids.emplace(boost::unordered::piecewise_construct,
- boost::make_tuple(placeholder->final_id),
- boost::make_tuple(placeholder->final_id,
- placeholder->category, true));
-
- ++placeholder->data->generation_data->count;
-
- return insert.second;
- }
-
- void id_generator::id_generation_data::new_base_value() {
- count = 0;
- needs_underscore = !base.empty() &&
- std::isdigit(base[base.length() - 1]);
- }
-
- // Very simple xml subset parser which replaces id values.
- //
- // I originally tried to integrate this into the post processor
- // but that proved tricky. Alternatively it could use a proper
- // xml parser, but I want this to be able to survive badly
- // marked up escapes.
-
- struct xml_processor
- {
- xml_processor();
-
- std::string escape_prefix;
- std::string escape_postfix;
- std::string processing_instruction_postfix;
- std::string comment_postfix;
- std::string whitespace;
- std::string tag_end;
- std::string name_end;
- std::string attribute_assign;
- std::vector<std::string> id_attributes;
-
- std::string replace(std::string const&, id_generator&);
- };
-
- std::string id_generator::replace_placeholders(std::string const& source)
- {
- xml_processor processor;
- return processor.replace(source, *this);
- }
-
- namespace
- {
- char const* id_attributes_[] =
- {
- "id",
- "linkend",
- "linkends",
- "arearefs"
- };
- }
-
- xml_processor::xml_processor()
- : escape_prefix("<!--quickbook-escape-prefix-->")
- , escape_postfix("<!--quickbook-escape-postfix-->")
- , processing_instruction_postfix("?>")
- , comment_postfix("-->")
- , whitespace(" \t\n\r")
- , tag_end(" \t\n\r>")
- , name_end("= \t\n\r>")
- , attribute_assign("= \t\n\r")
- {
- static int const n_id_attributes = sizeof(id_attributes_)/sizeof(char const*);
- for (int i = 0; i != n_id_attributes; ++i)
- {
- id_attributes.push_back(id_attributes_[i]);
- }
-
- std::sort(id_attributes.begin(), id_attributes.end());
- }
-
- std::string xml_processor::replace(std::string const& source, id_generator& ids)
- {
- std::string result;
-
- typedef std::string::const_iterator iterator;
-
- // copied is the point up to which the source has been copied, or
- // replaced, to result.
- iterator copied = source.begin();
-
- iterator end = source.end();
-
- for(iterator it = copied; it != end; it = std::find(it, end, '<'))
- {
- assert(copied <= it && it <= end);
-
- if (static_cast<std::size_t>(end - it) > escape_prefix.size() &&
- std::equal(escape_prefix.begin(), escape_prefix.end(), it))
- {
- it = std::search(it + escape_prefix.size(), end,
- escape_postfix.begin(), escape_postfix.end());
-
- if (it == end) break;
-
- it += escape_postfix.size();
- continue;
- }
-
- ++it;
- if (it == end) break;
-
- switch(*it)
- {
- case '?':
- it = std::search(it, end,
- processing_instruction_postfix.begin(),
- processing_instruction_postfix.end());
- break;
-
- case '!':
- if (end - it > 3 && it[1] == '-' && it[2] == '-')
- {
- it = std::search(it + 3, end,
- comment_postfix. begin(), comment_postfix.end());
- if (it != end) it += comment_postfix.size();
- }
- else
- {
- it = std::find(it, end, '>');
- }
- break;
-
- default:
- if ((*it >= 'a' && *it <= 'z') ||
- (*it >= 'A' && *it <= 'Z') ||
- *it == '_' || *it == ':')
- {
- it = std::find_first_of(
- it + 1, end, tag_end.begin(), tag_end.end());
-
- for (;;) {
- while(it != end &&
- std::find(whitespace.begin(),
- whitespace.end(), *it)
- != whitespace.end())
- ++it;
-
- iterator name_start = it;
-
- it = std::find_first_of(
- it, end, name_end.begin(), name_end.end());
-
- if (it == end || *it == '>') break;
-
- string_ref name(name_start, it);
- ++it;
-
- while (it != end &&
- std::find(attribute_assign.begin(),
- attribute_assign.end(), *it)
- != attribute_assign.end())
- ++it;
-
- if (it == end || (*it != '"' && *it != '\'')) break;
-
- char delim = *it;
- ++it;
-
- iterator value_start = it;
-
- it = std::find(it, end, delim);
- string_ref value(value_start, it);
- if (it == end) break;
- ++it;
-
- if (std::find(id_attributes.begin(), id_attributes.end(),
- name)
- != id_attributes.end())
- {
- result.append(copied, value.begin());
- string_ref x = ids.get(value);
- result.append(x.begin(), x.end());
- copied = value.end();
- }
- }
- }
- else
- {
- it = std::find(it, end, '>');
- }
- }
- }
-
- result.append(copied, source.end());
- return result;
- }
-}

Deleted: trunk/tools/quickbook/test/anchor.gold
==============================================================================
--- trunk/tools/quickbook/test/anchor.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,86 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="anchor_test" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Anchor Test</title>
- <section id="anchor_test.anchors">
- <title>Anchors</title>
- <para>
- <anchor id="a1"/>A paragraph containing several anchors. <anchor id="a2"/>We
- want to make sure they appear in the correct place. <anchor id="a3"/>
- </para>
- <bridgehead renderas="sect3" id="anchor_test.anchors.h0">
- <phrase id="anchor_test.anchors.this_heading_shouldn_t_pick_up_the_previous_anchor"/><link
- linkend="anchor_test.anchors.this_heading_shouldn_t_pick_up_the_previous_anchor">This
- heading shouldn't pick up the previous anchor</link>
- </bridgehead>
- <anchor id="a4"/>
- <bridgehead renderas="sect3" id="anchor_test.anchors.h1">
- <phrase id="anchor_test.anchors.this_heading_should_pick_up_the_previous_anchor"/><link
- linkend="anchor_test.anchors.this_heading_should_pick_up_the_previous_anchor">This
- heading should pick up the previous anchor</link>
- </bridgehead>
- <anchor id="a5"/>
- <bridgehead renderas="sect3" id="anchor_test.anchors.h2">
- <phrase id="anchor_test.anchors.and_this_one"/><link linkend="anchor_test.anchors.and_this_one">And
- this one</link>
- </bridgehead>
- <anchor id="a6"/>
- <bridgehead renderas="sect3" id="anchor_test.anchors.h3">
- <phrase id="anchor_test.anchors.also_this_one"/><link linkend="anchor_test.anchors.also_this_one">Also
- this one</link>
- </bridgehead>
- <anchor id="a7"/>
- <bridgehead renderas="sect3" id="anchors.finally_this">
- Finally this
- </bridgehead>
- <anchor id="a8"/>
- </section>
- <section id="anchor_test.section_anchor">
- <title><anchor id="a9"/>Section Anchor</title>
- <section id="anchor_test.nested_section">
- <title><anchor id="a10"/>Nested Section</title>
- </section>
- <anchor id="a11"/>
- </section>
- <section id="anchor_test.conditional_section_anchor">
- <title><anchor id="a12"/>Conditional Section Anchor</title>
- </section>
- <section id="anchor_test.lists">
- <title>Lists</title> <anchor id="a14"/>
- <itemizedlist>
- <listitem>
- <simpara>
- Item 1
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Item 2
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Nested List <anchor id="a15"/>
- <itemizedlist>
- <listitem>
- <simpara>
- Nested Item 1
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Nested Item 2
- </simpara>
- </listitem>
- </itemizedlist>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Item 3
- </simpara>
- </listitem>
- </itemizedlist>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/blocks.gold
==============================================================================
--- trunk/tools/quickbook/test/blocks.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,111 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="various_blocks" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Various blocks</title>
- <bridgehead renderas="sect2" id="various_blocks.h0">
- <phrase id="various_blocks.blockquotes"/><link linkend="various_blocks.blockquotes">Blockquotes</link>
- </bridgehead>
- <para>
- Here's a blockquote:
- </para>
- <blockquote>
- <para>
- Blockquote.
- </para>
- </blockquote>
- <para>
- And another:
- </para>
- <blockquote>
- <para>
- Blockquote first paragraph.
- </para>
- <para>
- Blockquote second paragraph.
- </para>
- </blockquote>
- <bridgehead renderas="sect2" id="various_blocks.h1">
- <phrase id="various_blocks.admonitions"/><link linkend="various_blocks.admonitions">Admonitions</link>
- </bridgehead>
- <warning>
- <para>
- Warning
- </para>
- </warning>
- <caution>
- <para>
- Caution
- </para>
- </caution>
- <important>
- <para>
- Important
- </para>
- </important>
- <note>
- <para>
- Note
- </para>
- </note>
- <tip>
- <para>
- Tip
- </para>
- </tip>
- <warning>
- <para>
- Warning first paragraph.
- </para>
- <para>
- Warning second paragraph.
- </para>
- </warning>
- <bridgehead renderas="sect2" id="various_blocks.h2">
- <phrase id="various_blocks.blurb"/><link linkend="various_blocks.blurb">Blurb</link>
- </bridgehead>
- <sidebar role="blurb">
- <para>
- Blurb
- </para>
- </sidebar>
- <bridgehead renderas="sect2" id="various_blocks.h3">
- <phrase id="various_blocks.inline_blocks"/><link linkend="various_blocks.inline_blocks">Inline
- blocks</link>
- </bridgehead>
- <blockquote>
- <para>
- Blockquote containing a footnote<footnote id="various_blocks.f0">
- <para>
- Here it is!
- </para>
- </footnote>.
- </para>
- </blockquote>
- <para>
- [tipping point]
- </para>
- <para>
- Multiple paragraphs because of the inline blocks.
- </para>
- <warning>
- <para>
- Warning
- </para>
- </warning>
- <para>
- This line should appear as a separate paragraph.
- </para>
- <warning>
- <para>
- Warning
- </para>
- </warning>
- <itemizedlist>
- <listitem>
- <simpara>
- This should be a list item because it's preceded by block markup.
- </simpara>
- </listitem>
- </itemizedlist>
-</article>

Deleted: trunk/tools/quickbook/test/callouts.gold
==============================================================================
--- trunk/tools/quickbook/test/callouts.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,251 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="callout_tests" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Callout Tests</title>
- <para>
- Example 1:
- </para>
- <para>
- Now we can define a function that simulates an ordinary six-sided die.
- </para>
- <para>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">roll_die</phrase><phrase role="special">()</phrase> <phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="identifier">dist</phrase><phrase role="special">(</phrase><phrase role="number">1</phrase><phrase role="special">,</phrase> <phrase role="number">6</phrase><phrase role="special">);</phrase> <co id="callout_tests.c0" linkends="callout_tests.c1" />
-<phrase role="special">}</phrase>
-
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="callout_tests.c0" id="callout_tests.c1">
- <para>
- create a uniform_int distribution
- </para>
- </callout>
- </calloutlist>
- <para>
- Example 2:
- </para>
- <para>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">roll_die</phrase><phrase role="special">()</phrase> <phrase role="special">{</phrase>
- <co id="callout_tests.c2" linkends="callout_tests.c3" /><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">variate_generator</phrase><phrase role="special">&lt;</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">mt19937</phrase><phrase role="special">&amp;,</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="special">&gt;</phrase> <phrase role="identifier">die</phrase><phrase role="special">(</phrase><phrase role="identifier">gen</phrase><phrase role="special">,</phrase> <phrase role="identifier">dist</phrase><phrase role="special">);</phrase>
-<phrase role="special">}</phrase>
-
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="callout_tests.c2" id="callout_tests.c3">
- <important>
- <para>
- test
- </para>
- </important>
- </callout>
- </calloutlist>
- <para>
- Example 3:
- </para>
- <para>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">roll_die</phrase><phrase role="special">()</phrase> <phrase role="special">{</phrase>
- <co id="callout_tests.c4" linkends="callout_tests.c5" /><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">variate_generator</phrase><phrase role="special">&lt;</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">mt19937</phrase><phrase role="special">&amp;,</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="special">&gt;</phrase> <phrase role="identifier">die</phrase><phrase role="special">(</phrase><phrase role="identifier">gen</phrase><phrase role="special">,</phrase> <phrase role="identifier">dist</phrase><phrase role="special">);</phrase>
-<phrase role="special">}</phrase>
-
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="callout_tests.c4" id="callout_tests.c5">
- <important>
- <para>
- test
- </para>
- </important>
- </callout>
- </calloutlist>
- <para>
- Example 3 (again!):
- </para>
- <para>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">roll_die</phrase><phrase role="special">()</phrase> <phrase role="special">{</phrase>
- <co id="callout_tests.c6" linkends="callout_tests.c7" /><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">variate_generator</phrase><phrase role="special">&lt;</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">mt19937</phrase><phrase role="special">&amp;,</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="special">&gt;</phrase> <phrase role="identifier">die</phrase><phrase role="special">(</phrase><phrase role="identifier">gen</phrase><phrase role="special">,</phrase> <phrase role="identifier">dist</phrase><phrase role="special">);</phrase>
-<phrase role="special">}</phrase>
-
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="callout_tests.c6" id="callout_tests.c7">
- <important>
- <para>
- test
- </para>
- </important>
- </callout>
- </calloutlist>
- <para>
- Example 4:
- </para>
- <para>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">roll_die</phrase><phrase role="special">()</phrase> <phrase role="special">{</phrase>
- <co id="callout_tests.c8" linkends="callout_tests.c9" /><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">variate_generator</phrase><phrase role="special">&lt;</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">mt19937</phrase><phrase role="special">&amp;,</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="special">&gt;</phrase> <phrase role="identifier">die</phrase><phrase role="special">(</phrase><phrase role="identifier">gen</phrase><phrase role="special">,</phrase> <phrase role="identifier">dist</phrase><phrase role="special">);</phrase>
-<co id="callout_tests.c10" linkends="callout_tests.c11" /><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="identifier">dist</phrase><phrase role="special">(</phrase><phrase role="number">1</phrase><phrase role="special">,</phrase> <phrase role="number">6</phrase><phrase role="special">);</phrase> <co id="callout_tests.c12" linkends="callout_tests.c13" />
-<phrase role="special">}</phrase>
-
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="callout_tests.c8" id="callout_tests.c9">
- <para>
- callout 1
- </para>
- </callout>
- <callout arearefs="callout_tests.c10" id="callout_tests.c11">
- <para>
- callout 2
- </para>
- </callout>
- <callout arearefs="callout_tests.c12" id="callout_tests.c13">
- <para>
- create a uniform_int distribution
- </para>
- </callout>
- </calloutlist>
- <para>
-<programlisting><co id="callout_tests.c14" linkends="callout_tests.c15" /><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="identifier">dist</phrase><phrase role="special">(</phrase><phrase role="number">1</phrase><phrase role="special">,</phrase> <phrase role="number">6</phrase><phrase role="special">);</phrase> <co id="callout_tests.c16" linkends="callout_tests.c17" />
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="callout_tests.c14" id="callout_tests.c15">
- <para>
- callout 2
- </para>
- </callout>
- <callout arearefs="callout_tests.c16" id="callout_tests.c17">
- <para>
- create a uniform_int distribution
- </para>
- </callout>
- </calloutlist>
- <section id="callout_tests.test_section">
- <title><link linkend="callout_tests.test_section">Try callouts in a section</link></title>
- <para>
- Example 1:
- </para>
- <para>
- Now we can define a function that simulates an ordinary six-sided die.
- </para>
- <para>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">roll_die</phrase><phrase role="special">()</phrase> <phrase role="special">{</phrase>
- <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="identifier">dist</phrase><phrase role="special">(</phrase><phrase role="number">1</phrase><phrase role="special">,</phrase> <phrase role="number">6</phrase><phrase role="special">);</phrase> <co id="callout_tests.test_section.c0" linkends="callout_tests.test_section.c1" />
-<phrase role="special">}</phrase>
-
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="callout_tests.test_section.c0" id="callout_tests.test_section.c1">
- <para>
- create a uniform_int distribution
- </para>
- </callout>
- </calloutlist>
- <para>
- Example 2:
- </para>
- <para>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">roll_die</phrase><phrase role="special">()</phrase> <phrase role="special">{</phrase>
- <co id="callout_tests.test_section.c2" linkends="callout_tests.test_section.c3" /><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">variate_generator</phrase><phrase role="special">&lt;</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">mt19937</phrase><phrase role="special">&amp;,</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="special">&gt;</phrase> <phrase role="identifier">die</phrase><phrase role="special">(</phrase><phrase role="identifier">gen</phrase><phrase role="special">,</phrase> <phrase role="identifier">dist</phrase><phrase role="special">);</phrase>
-<phrase role="special">}</phrase>
-
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="callout_tests.test_section.c2" id="callout_tests.test_section.c3">
- <important>
- <para>
- test
- </para>
- </important>
- </callout>
- </calloutlist>
- <para>
- Example 3:
- </para>
- <para>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">roll_die</phrase><phrase role="special">()</phrase> <phrase role="special">{</phrase>
- <co id="callout_tests.test_section.c4" linkends="callout_tests.test_section.c5" /><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">variate_generator</phrase><phrase role="special">&lt;</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">mt19937</phrase><phrase role="special">&amp;,</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="special">&gt;</phrase> <phrase role="identifier">die</phrase><phrase role="special">(</phrase><phrase role="identifier">gen</phrase><phrase role="special">,</phrase> <phrase role="identifier">dist</phrase><phrase role="special">);</phrase>
-<phrase role="special">}</phrase>
-
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="callout_tests.test_section.c4" id="callout_tests.test_section.c5">
- <important>
- <para>
- test
- </para>
- </important>
- </callout>
- </calloutlist>
- <para>
- Example 3 (again!):
- </para>
- <para>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">roll_die</phrase><phrase role="special">()</phrase> <phrase role="special">{</phrase>
- <co id="callout_tests.test_section.c6" linkends="callout_tests.test_section.c7" /><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">variate_generator</phrase><phrase role="special">&lt;</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">mt19937</phrase><phrase role="special">&amp;,</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="special">&gt;</phrase> <phrase role="identifier">die</phrase><phrase role="special">(</phrase><phrase role="identifier">gen</phrase><phrase role="special">,</phrase> <phrase role="identifier">dist</phrase><phrase role="special">);</phrase>
-<phrase role="special">}</phrase>
-
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="callout_tests.test_section.c6" id="callout_tests.test_section.c7">
- <important>
- <para>
- test
- </para>
- </important>
- </callout>
- </calloutlist>
- <para>
- Example 4:
- </para>
- <para>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">roll_die</phrase><phrase role="special">()</phrase> <phrase role="special">{</phrase>
- <co id="callout_tests.test_section.c8" linkends="callout_tests.test_section.c9" /><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">variate_generator</phrase><phrase role="special">&lt;</phrase><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">mt19937</phrase><phrase role="special">&amp;,</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="special">&gt;</phrase> <phrase role="identifier">die</phrase><phrase role="special">(</phrase><phrase role="identifier">gen</phrase><phrase role="special">,</phrase> <phrase role="identifier">dist</phrase><phrase role="special">);</phrase>
-<co id="callout_tests.test_section.c10" linkends="callout_tests.test_section.c11" /><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="identifier">dist</phrase><phrase role="special">(</phrase><phrase role="number">1</phrase><phrase role="special">,</phrase> <phrase role="number">6</phrase><phrase role="special">);</phrase> <co id="callout_tests.test_section.c12" linkends="callout_tests.test_section.c13" />
-<phrase role="special">}</phrase>
-
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="callout_tests.test_section.c8" id="callout_tests.test_section.c9">
- <para>
- callout 1
- </para>
- </callout>
- <callout arearefs="callout_tests.test_section.c10" id="callout_tests.test_section.c11">
- <para>
- callout 2
- </para>
- </callout>
- <callout arearefs="callout_tests.test_section.c12" id="callout_tests.test_section.c13">
- <para>
- create a uniform_int distribution
- </para>
- </callout>
- </calloutlist>
- <para>
-<programlisting><co id="callout_tests.test_section.c14" linkends="callout_tests.test_section.c15" /><phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">uniform_int</phrase><phrase role="special">&lt;&gt;</phrase> <phrase role="identifier">dist</phrase><phrase role="special">(</phrase><phrase role="number">1</phrase><phrase role="special">,</phrase> <phrase role="number">6</phrase><phrase role="special">);</phrase> <co id="callout_tests.test_section.c16" linkends="callout_tests.test_section.c17" />
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="callout_tests.test_section.c14" id="callout_tests.test_section.c15">
- <para>
- callout 2
- </para>
- </callout>
- <callout arearefs="callout_tests.test_section.c16" id="callout_tests.test_section.c17">
- <para>
- create a uniform_int distribution
- </para>
- </callout>
- </calloutlist>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/callouts.quickbook
==============================================================================
--- trunk/tools/quickbook/test/callouts.quickbook 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,51 +0,0 @@
-[article Callout Tests
- [quickbook 1.5]
-]
-
-[import callouts.cpp]
-
-Example 1:
-
-[example1]
-
-Example 2:
-
-[example2]
-
-Example 3:
-
-[example3]
-
-Example 3 (again!):
-
-[example3]
-
-Example 4:
-
-[example4]
-[example4a]
-
-[section:test_section Try callouts in a section]
-
-Example 1:
-
-[example1]
-
-Example 2:
-
-[example2]
-
-Example 3:
-
-[example3]
-
-Example 3 (again!):
-
-[example3]
-
-Example 4:
-
-[example4]
-[example4a]
-
-[endsect]
\ No newline at end of file

Deleted: trunk/tools/quickbook/test/code-block-1.gold
==============================================================================
--- trunk/tools/quickbook/test/code-block-1.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,20 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="code_block_1" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Code Block 1</title>
- <section id="code_block_1.a_code_block">
- <title>A code block</title>
- <para>
- A code block with proper indentation ;-)
- </para>
-<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special">&lt;</phrase><phrase role="identifier">iostream</phrase><phrase role="special">&gt;</phrase>
-
-<phrase role="keyword">int</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special">&lt;&lt;</phrase> <phrase role="string">&quot;Hello, World!&quot;</phrase> <phrase role="special">&lt;&lt;</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
- <phrase role="keyword">return</phrase> <phrase role="number">0</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase>
-</programlisting>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/code-block-2.gold
==============================================================================
--- trunk/tools/quickbook/test/code-block-2.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,22 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="code_block_2" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Code Block 2</title>
- <section id="code_block_2.a_code_block">
- <title>A code block</title>
- <para>
- A code block with proper indentation ;-)
- </para>
- <para>
-<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special">&lt;</phrase><phrase role="identifier">iostream</phrase><phrase role="special">&gt;</phrase>
-
-<phrase role="keyword">int</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special">&lt;&lt;</phrase> <phrase role="string">&quot;Hello, World!&quot;</phrase> <phrase role="special">&lt;&lt;</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
- <phrase role="keyword">return</phrase> <phrase role="number">0</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase>
-</programlisting>
- </para>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/code-block-3.gold
==============================================================================
--- trunk/tools/quickbook/test/code-block-3.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,23 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="code_block_3" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Code Block 3</title>
- <section id="code_block_3.python_code_block">
- <title>Python code block</title>
- <para>
-<programlisting><phrase role="keyword">print</phrase> <phrase role="string">&quot;\xfabln\xeck&quot;</phrase>
-</programlisting>
- </para>
- </section>
- <section id="code_block_3.c___code_block">
- <title>C++ code block</title>
- <para>
- This isn't valid C++ but I think we should accept it;
- </para>
- <para>
-<programlisting><phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase><phrase role="special">&lt;&lt;</phrase><phrase role="string">&quot;\xfabln\xeck&quot;</phrase><phrase role="special">&lt;&lt;</phrase><phrase role="string">&quot;\n&quot;</phrase><phrase role="special">;</phrase>
-</programlisting>
- </para>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/code-block-3.quickbook
==============================================================================
--- trunk/tools/quickbook/test/code-block-3.quickbook 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,21 +0,0 @@
-[article Code Block 3]
-
-[section Python code block]
-
-[python]
-``
- print "\xfabln\xeck"
-``
-
-[endsect]
-
-[section C++ code block]
-
-This isn't valid C++ but I think we should accept it;
-
-[c++]
-``
- std::cout<<"\xfabln\xeck"<<"\n";
-``
-
-[endsect]

Deleted: trunk/tools/quickbook/test/code-block-cpp.gold
==============================================================================
--- trunk/tools/quickbook/test/code-block-cpp.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,27 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="c___code_blocks" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>C++ Code Blocks</title>
-<programlisting><phrase role="comment">// No escape</phrase>
-<phrase role="comment">/* No escape */</phrase>
-<phrase role="comment">/* No escape
- * with newlines
- */</phrase>
-<phrase role="comment">// In Header: &lt;<ulink url="boost:/boost/optional/optional.hpp">boost/optional/optional.hpp</ulink>&gt;</phrase>
-<phrase role="comment">/* In Header: &lt;<ulink url="boost:/boost/optional/optional.hpp">boost/optional/optional.hpp</ulink>&gt; */</phrase>
-<phrase role="comment">/* Multiple escapes: <emphasis>italic</emphasis>
- * <emphasis role="underline">underline</emphasis><emphasis role="bold">bold</emphasis>
- */</phrase>
-</programlisting>
- <para>
- A badly formed comment:
- </para>
-<programlisting><phrase role="comment">/* Oh dear
-</phrase></programlisting>
- <para>
- A badly formed comment with an escape:
- </para>
-<programlisting><phrase role="comment">/* Oh dear <emphasis role="bold">bold</emphasis>
-</phrase></programlisting>
-</article>

Deleted: trunk/tools/quickbook/test/code-block-python.gold
==============================================================================
--- trunk/tools/quickbook/test/code-block-python.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,10 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="python_code_blocks" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Python Code Blocks</title>
-<programlisting><phrase role="comment"># No escape</phrase>
-<phrase role="comment"># Escape: <emphasis role="bold">bold</emphasis></phrase>
-<phrase role="comment"># Escape: <emphasis role="underline">underline</emphasis><emphasis>italic</emphasis></phrase>
-</programlisting>
-</article>

Deleted: trunk/tools/quickbook/test/code-block-teletype.gold
==============================================================================
--- trunk/tools/quickbook/test/code-block-teletype.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="code_block_teletype_1" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Code Block Teletype 1</title>
- <section id="code_block_teletype_1.a_code_block">
- <title><link linkend="code_block_teletype_1.a_code_block">A code block</link></title>
-<programlisting>Just some plain text.
-With some <emphasis role="bold">quickbook</emphasis> thrown in?
-</programlisting>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/code-block.gold
==============================================================================
--- trunk/tools/quickbook/test/code-block.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,37 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="indented_code_blocks" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Indented code blocks</title>
- <para>
- In a paragraph. Still in a paragraph.
- </para>
-<programlisting>In a code block.
-</programlisting>
- <para>
- Back in a paragraph.
- </para>
-<programlisting> Code block line 1.
-Code block line 2.
- Code block line 3.
-</programlisting>
- <para>
- Paragraph.
- </para>
-<programlisting>Code block with no trailing blank lines.
-</programlisting>
- <para>
- Paragraph.
- </para>
- <bridgehead renderas="sect2" id="indented_code_blocks.h0">
- <phrase id="indented_code_blocks.code_blocks_separated_by_comment"/><link linkend="indented_code_blocks.code_blocks_separated_by_comment">Code
- blocks separated by comment</link>
- </bridgehead>
-<programlisting>First code block.
-</programlisting>
-<programlisting>Second code block.
-[/ Comment in second code block]
-Still second code block.
-[/ Comment trailing second code block]
-</programlisting>
-</article>

Deleted: trunk/tools/quickbook/test/heading_1_1.gold
==============================================================================
--- trunk/tools/quickbook/test/heading_1_1.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,15 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="heading_1_1" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Heading 1.1</title>
- <bridgehead renderas="sect1" id=".first_heading">
- First heading
- </bridgehead>
- <section id="heading_1_1.section">
- <title>Section</title>
- <bridgehead renderas="sect2" id="section.second_heading">
- Second heading
- </bridgehead>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/heading_1_1.quickbook
==============================================================================
--- trunk/tools/quickbook/test/heading_1_1.quickbook 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,9 +0,0 @@
-[article Heading 1.1]
-
-[h1 First heading]
-
-[section Section]
-
-[h2 Second heading]
-
-[endsect]
\ No newline at end of file

Deleted: trunk/tools/quickbook/test/heading_1_3.gold
==============================================================================
--- trunk/tools/quickbook/test/heading_1_3.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,24 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="header" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $" xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Header</title>
- <bridgehead renderas="sect2" id="header.h0">
- <phrase id="header.header_test"/><link linkend="header.header_test">Header Test</link>
- </bridgehead>
- <para>
- Testing headers without sections.
- </para>
- <bridgehead renderas="sect2" id="header.h1">
- <phrase id="header._not_an_id"/><link linkend="header._not_an_id">:Not an Id</link>
- </bridgehead>
- <para>
- Paragraph.
- </para>
- <bridgehead renderas="sect3" id="header.h2">
- <phrase id="header._not_an_id_again"/><link linkend="header._not_an_id_again">:Not
- an Id again</link>
- </bridgehead>
- <para>
- Paragraph.
- </para>
-</article>

Deleted: trunk/tools/quickbook/test/heading_1_3.quickbook
==============================================================================
--- trunk/tools/quickbook/test/heading_1_3.quickbook 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,16 +0,0 @@
-[article Header
- [quickbook 1.3]
- [id header]
-]
-
-[heading Header Test]
-
-Testing headers without sections.
-
-[heading:Not an Id]
-
-Paragraph.
-
-[h3:Not an Id again]
-
-Paragraph.
\ No newline at end of file

Deleted: trunk/tools/quickbook/test/heading_1_5.gold
==============================================================================
--- trunk/tools/quickbook/test/heading_1_5.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,78 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="heading_test_1_5" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Heading Test 1.5</title>
- <bridgehead renderas="sect2" id="heading_test_1_5.h0">
- <phrase id="heading_test_1_5.generic_header"/><link linkend="heading_test_1_5.generic_header">Generic
- header</link>
- </bridgehead>
- <bridgehead renderas="sect1" id="heading_test_1_5.h2">
- <phrase id="heading_test_1_5.level_1"/><link linkend="heading_test_1_5.level_1">Level
- 1</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="heading_test_1_5.h3">
- <phrase id="heading_test_1_5.level_2"/><link linkend="heading_test_1_5.level_2">Level
- 2</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="heading_test_1_5.h4">
- <phrase id="heading_test_1_5.level_3"/><link linkend="heading_test_1_5.level_3">Level
- 3</link>
- </bridgehead>
- <bridgehead renderas="sect4" id="heading_test_1_5.h5">
- <phrase id="heading_test_1_5.level_4"/><link linkend="heading_test_1_5.level_4">Level
- 4</link>
- </bridgehead>
- <bridgehead renderas="sect5" id="heading_test_1_5.h6">
- <phrase id="heading_test_1_5.level_5"/><link linkend="heading_test_1_5.level_5">Level
- 5</link>
- </bridgehead>
- <bridgehead renderas="sect6" id="heading_test_1_5.h8">
- <phrase id="heading_test_1_5.level_6"/><link linkend="heading_test_1_5.level_6">Level
- 6</link>
- </bridgehead>
- <bridgehead renderas="sect1" id="heading_test_1_5.h9">
- <phrase id="heading_test_1_5._emphasis_role__bold__bold__emphasis_"/><link linkend="heading_test_1_5._emphasis_role__bold__bold__emphasis_"><emphasis
- role="bold">Bold</emphasis></link>
- </bridgehead>
- <bridgehead renderas="sect1" id="heading_test_1_5.h10">
- <phrase id="heading_test_1_5.comment"/><link linkend="heading_test_1_5.comment">Comment</link>
- </bridgehead>
- <bridgehead renderas="sect1" id="heading_test_1_5.h11">
- <phrase id="heading_test_1_5._notanid"/><link linkend="heading_test_1_5._notanid">:notanid</link>
- </bridgehead>
- <bridgehead renderas="sect1" id="heading_test_1_5.h12">
- <phrase id="heading_test_1_5._also_not_an_id"/><link linkend="heading_test_1_5._also_not_an_id">:also
- not an id</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="heading_test_1_5.h13">
- <phrase id="heading_test_1_5.h1"/><link linkend="heading_test_1_5.h1">H1</link>
- </bridgehead>
- <section id="heading_test_1_5.s1">
- <title><link linkend="heading_test_1_5.s1">S1</link></title>
- <bridgehead renderas="sect2" id="heading_test_1_5.s1.h0">
- <phrase id="heading_test_1_5.s1.h2"/><link linkend="heading_test_1_5.s1.h2">H2</link>
- </bridgehead>
- <section id="heading_test_1_5.s1.s2">
- <title><link linkend="heading_test_1_5.s1.s2">S2</link></title>
- <bridgehead renderas="sect3" id="heading_test_1_5.s1.s2.h0">
- <phrase id="heading_test_1_5.s1.s2.h3"/><link linkend="heading_test_1_5.s1.s2.h3">H3</link>
- </bridgehead>
- </section>
- <bridgehead renderas="sect2" id="heading_test_1_5.s1.h1">
- <phrase id="heading_test_1_5.s1.h4"/><link linkend="heading_test_1_5.s1.h4">H4</link>
- </bridgehead>
- <section id="heading_test_1_5.s1.s3">
- <title><link linkend="heading_test_1_5.s1.s3">S3</link></title>
- <bridgehead renderas="sect4" id="heading_test_1_5.s1.s3.h0">
- <phrase id="heading_test_1_5.s1.s3.h5"/><link linkend="heading_test_1_5.s1.s3.h5">H5</link>
- </bridgehead>
- </section>
- <bridgehead renderas="sect2" id="heading_test_1_5.s1.h3">
- <phrase id="heading_test_1_5.s1.h6"/><link linkend="heading_test_1_5.s1.h6">H6</link>
- </bridgehead>
- </section>
- <bridgehead renderas="sect1" id="heading_test_1_5.h14">
- <phrase id="heading_test_1_5.h7"/><link linkend="heading_test_1_5.h7">H7</link>
- </bridgehead>
-</article>

Deleted: trunk/tools/quickbook/test/heading_1_6.gold
==============================================================================
--- trunk/tools/quickbook/test/heading_1_6.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,25 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="header" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $" xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Header</title>
- <bridgehead renderas="sect2" id="header.h0">
- <phrase id="header.header_test"/><link linkend="header.header_test">Header Test</link>
- </bridgehead>
- <para>
- Paragraph.
- </para>
- <bridgehead renderas="sect2" id="header.h1">
- <phrase id="header.heading_id"/><link linkend="header.heading_id">Heading with
- an id</link>
- </bridgehead>
- <para>
- Paragraph.
- </para>
- <bridgehead renderas="sect3" id="header.h2">
- <phrase id="header.heading_id2"/><link linkend="header.heading_id2">Heading with
- an id</link>
- </bridgehead>
- <para>
- Paragraph.
- </para>
-</article>

Deleted: trunk/tools/quickbook/test/identifier_1_5.gold
==============================================================================
--- trunk/tools/quickbook/test/identifier_1_5.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,610 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="identifiers_in_quickbook_1_5" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Identifiers in quickbook 1.5</title>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h0">
- <phrase id="identifiers_in_quickbook_1_5.test_heading_with__code__phrase_role__identifier__code__phrase___code_"/><link
- linkend="identifiers_in_quickbook_1_5.test_heading_with__code__phrase_role__identifier__code__phrase___code_">Test
- heading with <code><phrase role="identifier">code</phrase></code></link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h1">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10_0"/><link linkend="identifiers_in_quickbook_1_5.identifier_10_0">Identifier
- 10</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h2">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10_1"/><link linkend="identifiers_in_quickbook_1_5.identifier_10_1">Identifier
- 10</link>
- </bridgehead>
- <table frame="all" id="identifiers_in_quickbook_1_5.identifier_10_2">
- <title>Identifier 10</title>
- <tgroup cols="1">
- <tbody>
- <row>
- <entry>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h3">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_duplicate_it_by_having_several_headers"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_duplicate_it_by_having_several_headers">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h4">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d0"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d0">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h5">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_duplicate_it_by_having_lots_of_headers"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_duplicate_it_by_having_lots_of_headers">Generate
- a really long id and duplicate it by having lots of headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h6">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d1"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d1">Generate
- a really long id and duplicate it by having lots of headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h7">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d2"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d2">Generate
- a really long id and duplicate it by having lots of headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h8">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d3"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d3">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h9">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d5"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d5">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h10">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d6"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d6">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h11">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d7"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d7">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h12">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_duplicate_it_by_having_too_many_headers"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_duplicate_it_by_having_too_many_headers">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h13">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d8"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d8">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h14">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d9"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d9">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h15">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_0"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_0">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h16">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_1"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_1">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h17">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_2"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_2">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h18">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_3"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_3">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h19">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_4"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_4">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h20">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_5"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_5">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h21">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_6"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_6">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h22">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_7"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_7">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h23">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_8"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_8">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h24">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_9"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_9">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h25">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_10"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_10">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h26">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_11"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_11">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h27">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_12"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_12">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h28">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_13"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_13">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h29">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_14"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_14">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h30">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_16"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_16">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h31">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_17"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_17">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h32">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_18"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_18">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h33">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_19"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_19">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h34">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_20"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_20">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h35">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_21"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_21">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h36">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_22"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_22">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h37">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_23"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_23">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h38">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_24"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_24">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h39">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_25"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_25">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h40">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_26"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_26">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h41">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_duplicate_it_by_having_even_more_headers"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_duplicate_it_by_having_even_more_headers">Generate
- a really long id and duplicate it by having even more headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h42">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_27"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_27">Generate
- a really long id and duplicate it by having even more headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h43">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_28"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_28">Generate
- a really long id and duplicate it by having even more headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h44">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_29"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_29">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h45">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d4"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_d4">Generate
- a really long id and d4</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h46">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_15"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_15">Generate
- a really long id and 15</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h47">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_30"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_30">Generate
- a really long id and d4</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h48">
- <phrase id="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_31"/><link
- linkend="identifiers_in_quickbook_1_5.generate_a_really_long_id_and_31">Generate
- a really long id and 15</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h49">
- <phrase id="identifiers_in_quickbook_1_5.a2345678901234567890123456789012"/><link
- linkend="identifiers_in_quickbook_1_5.a2345678901234567890123456789012">a2345678901234567890123456789012</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h50">
- <phrase id="identifiers_in_quickbook_1_5.a0"/><link linkend="identifiers_in_quickbook_1_5.a0">a2345678901234567890123456789012</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h51">
- <phrase id="identifiers_in_quickbook_1_5.abcdefghijklmnopqrstuvwxyzabcdef"/><link
- linkend="identifiers_in_quickbook_1_5.abcdefghijklmnopqrstuvwxyzabcdef">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h52">
- <phrase id="identifiers_in_quickbook_1_5.abcdefghijklmnopqrstuvwxyzabcde0"/><link
- linkend="identifiers_in_quickbook_1_5.abcdefghijklmnopqrstuvwxyzabcde0">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h53">
- <phrase id="identifiers_in_quickbook_1_5.abcdefghijklmnopqrstuvwxyzabcde1"/><link
- linkend="identifiers_in_quickbook_1_5.abcdefghijklmnopqrstuvwxyzabcde1">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h54">
- <phrase id="identifiers_in_quickbook_1_5.abcdefghijklmnopqrstuvwxyzabcde2"/><link
- linkend="identifiers_in_quickbook_1_5.abcdefghijklmnopqrstuvwxyzabcde2">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h55">
- <phrase id="identifiers_in_quickbook_1_5.markup_in__code__phrase_role__identifier__heading__phrase___code___in__emphasis_role__bold__order__emphasis__to_test_normalization"/><link
- linkend="identifiers_in_quickbook_1_5.markup_in__code__phrase_role__identifier__heading__phrase___code___in__emphasis_role__bold__order__emphasis__to_test_normalization">Markup
- in <code><phrase role="identifier">heading</phrase></code> in <emphasis role="bold">order</emphasis>
- to test normalization</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h56">
- <phrase id="identifiers_in_quickbook_1_5.markup_in_code_phrase_role_iden0"/><link
- linkend="identifiers_in_quickbook_1_5.markup_in_code_phrase_role_iden0">Markup
- in <code><phrase role="identifier">heading</phrase></code> in <emphasis role="bold">order</emphasis>
- to test normalization</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_5.h57">
- <phrase id="identifiers_in_quickbook_1_5.markup_in_code_phrase_role_iden1"/><link
- linkend="identifiers_in_quickbook_1_5.markup_in_code_phrase_role_iden1">Markup
- in <code><phrase role="identifier">heading</phrase></code> in <emphasis role="bold">order</emphasis>
- to test normalization</link>
- </bridgehead>
- <section id="identifiers_in_quickbook_1_5.identifier_10">
- <title><link linkend="identifiers_in_quickbook_1_5.identifier_10">Identifier
- 10</link></title>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h0">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_several_headers"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_several_headers">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h1">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d0"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d0">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h2">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_lots_of_headers"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_lots_of_headers">Generate
- a really long id and duplicate it by having lots of headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h4">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d1"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d1">Generate
- a really long id and duplicate it by having lots of headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h5">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d2"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d2">Generate
- a really long id and duplicate it by having lots of headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h6">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d3"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d3">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h7">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d5"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d5">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h8">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d6"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d6">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h9">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d7"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d7">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h10">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_too_many_headers"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_too_many_headers">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h11">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d8"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d8">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h12">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d9"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d9">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h13">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_0"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_0">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h14">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_1"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_1">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h15">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_2"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_2">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h16">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_3"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_3">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h17">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_4"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_4">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h18">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_5"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_5">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h19">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_6"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_6">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h20">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_7"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_7">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h21">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_8"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_8">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h22">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_9"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_9">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h23">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_10"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_10">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h24">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_11"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_11">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h25">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_12"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_12">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h26">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_13"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_13">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h27">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_14"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_14">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h28">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_16"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_16">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h29">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_17"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_17">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h30">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_18"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_18">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h31">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_19"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_19">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h32">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_20"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_20">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h33">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_21"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_21">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h34">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_22"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_22">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h35">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_23"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_23">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h36">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_24"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_24">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h37">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_25"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_25">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h38">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_26"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_26">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h39">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_even_more_headers"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_even_more_headers">Generate
- a really long id and duplicate it by having even more headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h40">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_27"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_27">Generate
- a really long id and duplicate it by having even more headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h41">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_28"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_28">Generate
- a really long id and duplicate it by having even more headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h42">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_29"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_29">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h43">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d4"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_d4">Generate
- a really long id and d4</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h44">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_15"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_15">Generate
- a really long id and 15</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h45">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_30"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_30">Generate
- a really long id and d4</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h46">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_31"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.generate_a_really_long_id_and_31">Generate
- a really long id and 15</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h47">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.a2345678901234567890123456789012"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.a2345678901234567890123456789012">a2345678901234567890123456789012</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h48">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.a0"/><link linkend="identifiers_in_quickbook_1_5.identifier_10.a0">a2345678901234567890123456789012</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h49">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.abcdefghijklmnopqrstuvwxyzabcdef"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.abcdefghijklmnopqrstuvwxyzabcdef">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h50">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.abcdefghijklmnopqrstuvwxyzabcde0"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.abcdefghijklmnopqrstuvwxyzabcde0">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h51">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.abcdefghijklmnopqrstuvwxyzabcde1"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.abcdefghijklmnopqrstuvwxyzabcde1">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h52">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.abcdefghijklmnopqrstuvwxyzabcde2"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.abcdefghijklmnopqrstuvwxyzabcde2">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h53">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.markup_in__code__phrase_role__identifier__heading__phrase___code___in__emphasis_role__bold__order__emphasis__to_test_normalization"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.markup_in__code__phrase_role__identifier__heading__phrase___code___in__emphasis_role__bold__order__emphasis__to_test_normalization">Markup
- in <code><phrase role="identifier">heading</phrase></code> in <emphasis role="bold">order</emphasis>
- to test normalization</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h54">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.markup_in_code_phrase_role_iden0"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.markup_in_code_phrase_role_iden0">Markup
- in <code><phrase role="identifier">heading</phrase></code> in <emphasis role="bold">order</emphasis>
- to test normalization</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.identifier_10.h55">
- <phrase id="identifiers_in_quickbook_1_5.identifier_10.markup_in_code_phrase_role_iden1"/><link
- linkend="identifiers_in_quickbook_1_5.identifier_10.markup_in_code_phrase_role_iden1">Markup
- in <code><phrase role="identifier">heading</phrase></code> in <emphasis role="bold">order</emphasis>
- to test normalization</link>
- </bridgehead>
- <table frame="all" id="identifiers_in_quickbook_1_5.identifier_10.h3">
- <title>h3</title>
- <tgroup cols="1">
- <tbody>
- <row>
- <entry>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- <table frame="all" id="identifiers_in_quickbook_1_5.identifier_10.h3_0">
- <title>h3</title>
- <tgroup cols="1">
- <tbody>
- <row>
- <entry>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </section>
- <section id="identifiers_in_quickbook_1_5.punctuation___stuff">
- <title><link linkend="identifiers_in_quickbook_1_5.punctuation___stuff">Punctuation
- &amp; stuff</link></title>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.punctuation___stuff.h0">
- <phrase id="identifiers_in_quickbook_1_5.punctuation___stuff.a___b"/><link
- linkend="identifiers_in_quickbook_1_5.punctuation___stuff.a___b">A + B</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_5.punctuation___stuff.h1">
- <phrase id="identifiers_in_quickbook_1_5.punctuation___stuff.a_b0"/><link linkend="identifiers_in_quickbook_1_5.punctuation___stuff.a_b0">A
- + B</link>
- </bridgehead>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/identifier_1_6.gold
==============================================================================
--- trunk/tools/quickbook/test/identifier_1_6.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,609 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="identifiers_in_quickbook_1_6" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Identifiers in quickbook 1.6</title>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h0">
- <phrase id="identifiers_in_quickbook_1_6.test_heading_with__code_"/><link linkend="identifiers_in_quickbook_1_6.test_heading_with__code_">Test
- heading with <code><phrase role="identifier">code</phrase></code></link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h1">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10_0"/><link linkend="identifiers_in_quickbook_1_6.identifier_10_0">Identifier
- 10</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h2">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10_1"/><link linkend="identifiers_in_quickbook_1_6.identifier_10_1">Identifier
- 10</link>
- </bridgehead>
- <table frame="all" id="identifiers_in_quickbook_1_6.identifier_10_2">
- <title>Identifier 10</title>
- <tgroup cols="1">
- <tbody>
- <row>
- <entry>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h3">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_duplicate_it_by_having_several_headers"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_duplicate_it_by_having_several_headers">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h4">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d0"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d0">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h5">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_duplicate_it_by_having_lots_of_headers"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_duplicate_it_by_having_lots_of_headers">Generate
- a really long id and duplicate it by having lots of headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h6">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d1"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d1">Generate
- a really long id and duplicate it by having lots of headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h7">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d2"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d2">Generate
- a really long id and duplicate it by having lots of headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h8">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d3"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d3">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h9">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d5"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d5">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h10">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d6"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d6">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h11">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d7"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d7">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h12">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_duplicate_it_by_having_too_many_headers"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_duplicate_it_by_having_too_many_headers">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h13">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d8"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d8">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h14">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d9"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d9">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h15">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_0"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_0">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h16">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_1"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_1">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h17">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_2"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_2">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h18">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_3"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_3">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h19">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_4"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_4">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h20">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_5"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_5">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h21">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_6"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_6">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h22">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_7"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_7">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h23">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_8"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_8">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h24">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_9"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_9">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h25">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_10"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_10">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h26">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_11"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_11">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h27">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_12"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_12">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h28">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_13"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_13">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h29">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_14"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_14">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h30">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_16"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_16">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h31">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_17"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_17">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h32">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_18"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_18">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h33">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_19"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_19">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h34">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_20"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_20">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h35">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_21"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_21">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h36">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_22"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_22">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h37">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_23"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_23">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h38">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_24"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_24">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h39">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_25"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_25">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h40">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_26"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_26">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h41">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_duplicate_it_by_having_even_more_headers"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_duplicate_it_by_having_even_more_headers">Generate
- a really long id and duplicate it by having even more headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h42">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_27"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_27">Generate
- a really long id and duplicate it by having even more headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h43">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_28"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_28">Generate
- a really long id and duplicate it by having even more headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h44">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_29"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_29">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h45">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d4"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_d4">Generate
- a really long id and d4</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h46">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_15"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_15">Generate
- a really long id and 15</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h47">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_30"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_30">Generate
- a really long id and d4</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h48">
- <phrase id="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_31"/><link
- linkend="identifiers_in_quickbook_1_6.generate_a_really_long_id_and_31">Generate
- a really long id and 15</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h49">
- <phrase id="identifiers_in_quickbook_1_6.a2345678901234567890123456789012"/><link
- linkend="identifiers_in_quickbook_1_6.a2345678901234567890123456789012">a2345678901234567890123456789012</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h50">
- <phrase id="identifiers_in_quickbook_1_6.a0"/><link linkend="identifiers_in_quickbook_1_6.a0">a2345678901234567890123456789012</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h51">
- <phrase id="identifiers_in_quickbook_1_6.abcdefghijklmnopqrstuvwxyzabcdef"/><link
- linkend="identifiers_in_quickbook_1_6.abcdefghijklmnopqrstuvwxyzabcdef">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h52">
- <phrase id="identifiers_in_quickbook_1_6.abcdefghijklmnopqrstuvwxyzabcde0"/><link
- linkend="identifiers_in_quickbook_1_6.abcdefghijklmnopqrstuvwxyzabcde0">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h53">
- <phrase id="identifiers_in_quickbook_1_6.abcdefghijklmnopqrstuvwxyzabcde1"/><link
- linkend="identifiers_in_quickbook_1_6.abcdefghijklmnopqrstuvwxyzabcde1">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h54">
- <phrase id="identifiers_in_quickbook_1_6.abcdefghijklmnopqrstuvwxyzabcde2"/><link
- linkend="identifiers_in_quickbook_1_6.abcdefghijklmnopqrstuvwxyzabcde2">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h55">
- <phrase id="identifiers_in_quickbook_1_6.markup_in__heading___in__order__to_test_normalization"/><link
- linkend="identifiers_in_quickbook_1_6.markup_in__heading___in__order__to_test_normalization">Markup
- in <code><phrase role="identifier">heading</phrase></code> in <emphasis role="bold">order</emphasis>
- to test normalization</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h56">
- <phrase id="identifiers_in_quickbook_1_6.markup_in_heading_in_order_to_t0"/><link
- linkend="identifiers_in_quickbook_1_6.markup_in_heading_in_order_to_t0">Markup
- in <code><phrase role="identifier">heading</phrase></code> in <emphasis role="bold">order</emphasis>
- to test normalization</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="identifiers_in_quickbook_1_6.h57">
- <phrase id="identifiers_in_quickbook_1_6.markup_in_heading_in_order_to_t1"/><link
- linkend="identifiers_in_quickbook_1_6.markup_in_heading_in_order_to_t1">Markup
- in <code><phrase role="identifier">heading</phrase></code> in <emphasis role="bold">order</emphasis>
- to test normalization</link>
- </bridgehead>
- <section id="identifiers_in_quickbook_1_6.identifier_10">
- <title><link linkend="identifiers_in_quickbook_1_6.identifier_10">Identifier
- 10</link></title>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h0">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_several_headers"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_several_headers">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h1">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d0"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d0">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h2">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_lots_of_headers"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_lots_of_headers">Generate
- a really long id and duplicate it by having lots of headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h4">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d1"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d1">Generate
- a really long id and duplicate it by having lots of headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h5">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d2"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d2">Generate
- a really long id and duplicate it by having lots of headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h6">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d3"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d3">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h7">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d5"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d5">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h8">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d6"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d6">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h9">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d7"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d7">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h10">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_too_many_headers"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_too_many_headers">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h11">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d8"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d8">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h12">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d9"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d9">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h13">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_0"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_0">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h14">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_1"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_1">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h15">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_2"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_2">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h16">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_3"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_3">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h17">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_4"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_4">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h18">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_5"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_5">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h19">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_6"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_6">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h20">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_7"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_7">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h21">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_8"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_8">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h22">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_9"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_9">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h23">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_10"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_10">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h24">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_11"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_11">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h25">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_12"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_12">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h26">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_13"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_13">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h27">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_14"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_14">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h28">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_16"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_16">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h29">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_17"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_17">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h30">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_18"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_18">Generate
- a really long id and duplicate it by having too many headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h31">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_19"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_19">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h32">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_20"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_20">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h33">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_21"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_21">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h34">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_22"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_22">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h35">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_23"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_23">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h36">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_24"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_24">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h37">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_25"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_25">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h38">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_26"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_26">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h39">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_even_more_headers"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_duplicate_it_by_having_even_more_headers">Generate
- a really long id and duplicate it by having even more headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h40">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_27"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_27">Generate
- a really long id and duplicate it by having even more headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h41">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_28"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_28">Generate
- a really long id and duplicate it by having even more headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h42">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_29"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_29">Generate
- a really long id and duplicate it by having several headers</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h43">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d4"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_d4">Generate
- a really long id and d4</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h44">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_15"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_15">Generate
- a really long id and 15</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h45">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_30"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_30">Generate
- a really long id and d4</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h46">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_31"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.generate_a_really_long_id_and_31">Generate
- a really long id and 15</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h47">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.a2345678901234567890123456789012"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.a2345678901234567890123456789012">a2345678901234567890123456789012</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h48">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.a0"/><link linkend="identifiers_in_quickbook_1_6.identifier_10.a0">a2345678901234567890123456789012</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h49">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.abcdefghijklmnopqrstuvwxyzabcdef"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.abcdefghijklmnopqrstuvwxyzabcdef">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h50">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.abcdefghijklmnopqrstuvwxyzabcde0"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.abcdefghijklmnopqrstuvwxyzabcde0">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h51">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.abcdefghijklmnopqrstuvwxyzabcde1"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.abcdefghijklmnopqrstuvwxyzabcde1">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h52">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.abcdefghijklmnopqrstuvwxyzabcde2"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.abcdefghijklmnopqrstuvwxyzabcde2">abcdefghijklmnopqrstuvwxyzabcdef</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h53">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.markup_in__heading___in__order__to_test_normalization"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.markup_in__heading___in__order__to_test_normalization">Markup
- in <code><phrase role="identifier">heading</phrase></code> in <emphasis role="bold">order</emphasis>
- to test normalization</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h54">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.markup_in_heading_in_order_to_t0"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.markup_in_heading_in_order_to_t0">Markup
- in <code><phrase role="identifier">heading</phrase></code> in <emphasis role="bold">order</emphasis>
- to test normalization</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.identifier_10.h55">
- <phrase id="identifiers_in_quickbook_1_6.identifier_10.markup_in_heading_in_order_to_t1"/><link
- linkend="identifiers_in_quickbook_1_6.identifier_10.markup_in_heading_in_order_to_t1">Markup
- in <code><phrase role="identifier">heading</phrase></code> in <emphasis role="bold">order</emphasis>
- to test normalization</link>
- </bridgehead>
- <table frame="all" id="identifiers_in_quickbook_1_6.identifier_10.h3">
- <title>h3</title>
- <tgroup cols="1">
- <tbody>
- <row>
- <entry>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- <table frame="all" id="identifiers_in_quickbook_1_6.identifier_10.h3_0">
- <title>h3</title>
- <tgroup cols="1">
- <tbody>
- <row>
- <entry>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </section>
- <section id="identifiers_in_quickbook_1_6.punctuation___stuff">
- <title><link linkend="identifiers_in_quickbook_1_6.punctuation___stuff">Punctuation
- &amp; stuff</link></title>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.punctuation___stuff.h0">
- <phrase id="identifiers_in_quickbook_1_6.punctuation___stuff.a___b"/><link
- linkend="identifiers_in_quickbook_1_6.punctuation___stuff.a___b">A + B</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="identifiers_in_quickbook_1_6.punctuation___stuff.h1">
- <phrase id="identifiers_in_quickbook_1_6.punctuation___stuff.a_b0"/><link linkend="identifiers_in_quickbook_1_6.punctuation___stuff.a_b0">A
- + B</link>
- </bridgehead>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/import.gold
==============================================================================
--- trunk/tools/quickbook/test/import.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,139 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="import" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $" xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Import</title>
- <para>
- This is the <emphasis role="bold"><emphasis>foo</emphasis></emphasis> function.
- </para>
- <para>
- This description can have paragraphs...
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- lists
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- etc.
- </simpara>
- </listitem>
- </itemizedlist>
- <para>
- And any quickbook block markup.
- </para>
- <para>
-<programlisting><phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="identifier">foo</phrase><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
- <phrase role="comment">// return 'em, foo man!</phrase>
- <phrase role="keyword">return</phrase> <phrase role="string">&quot;foo&quot;</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase>
-</programlisting>
- </para>
- <para>
- This is the Python <emphasis role="bold"><emphasis>foo</emphasis></emphasis>
- function.
- </para>
- <para>
- This description can have paragraphs...
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- lists
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- etc.
- </simpara>
- </listitem>
- </itemizedlist>
- <para>
- And any quickbook block markup.
- </para>
- <para>
-<programlisting><phrase role="keyword">def</phrase> <phrase role="identifier">foo</phrase><phrase role="special">():</phrase>
- <phrase role="comment"># return 'em, foo man!</phrase>
- <phrase role="keyword">return</phrase> <phrase role="string">&quot;foo&quot;</phrase>
-
-</programlisting>
- </para>
- <para>
- This is the C <emphasis role="bold"><emphasis>foo</emphasis></emphasis> function.
- </para>
- <para>
- This description can have paragraphs...
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- lists
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- etc.
- </simpara>
- </listitem>
- </itemizedlist>
- <para>
- And any quickbook block markup.
- </para>
- <para>
-<programlisting><phrase role="keyword">char</phrase><phrase role="special">*</phrase> <phrase role="identifier">foo</phrase><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
- <phrase role="comment">// return 'em, foo man!</phrase>
- <phrase role="keyword">return</phrase> <phrase role="string">&quot;foo&quot;</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase>
-</programlisting>
- </para>
- <para>
-<programlisting><phrase role="keyword">class</phrase> <phrase role="identifier">x</phrase>
-<phrase role="special">{</phrase>
-<phrase role="keyword">public</phrase><phrase role="special">:</phrase>
-
- <co id="import.c0" linkends="import.c1" /><phrase role="identifier">x</phrase><phrase role="special">()</phrase> <phrase role="special">:</phrase> <phrase role="identifier">n</phrase><phrase role="special">(</phrase><phrase role="number">0</phrase><phrase role="special">)</phrase>
- <phrase role="special">{</phrase>
- <phrase role="special">}</phrase>
-
- <co id="import.c2" linkends="import.c3" /><phrase role="special">~</phrase><phrase role="identifier">x</phrase><phrase role="special">()</phrase>
- <phrase role="special">{</phrase>
- <phrase role="special">}</phrase>
-
- <co id="import.c4" linkends="import.c5" /><phrase role="keyword">int</phrase> <phrase role="identifier">get</phrase><phrase role="special">()</phrase> <phrase role="keyword">const</phrase>
- <phrase role="special">{</phrase>
- <phrase role="keyword">return</phrase> <phrase role="identifier">n</phrase><phrase role="special">;</phrase>
- <phrase role="special">}</phrase>
-
- <co id="import.c6" linkends="import.c7" /><phrase role="keyword">void</phrase> <phrase role="identifier">set</phrase><phrase role="special">(</phrase><phrase role="keyword">int</phrase> <phrase role="identifier">n_</phrase><phrase role="special">)</phrase>
- <phrase role="special">{</phrase>
- <phrase role="identifier">n</phrase> <phrase role="special">=</phrase> <phrase role="identifier">n_</phrase><phrase role="special">;</phrase>
- <phrase role="special">}</phrase>
-<phrase role="special">};</phrase>
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="import.c0" id="import.c1">
- <para>
- Constructor
- </para>
- </callout>
- <callout arearefs="import.c2" id="import.c3">
- <para>
- Destructor
- </para>
- </callout>
- <callout arearefs="import.c4" id="import.c5">
- <para>
- Get the <code><phrase role="identifier">n</phrase></code> member variable
- </para>
- </callout>
- <callout arearefs="import.c6" id="import.c7">
- <para>
- Set the <code><phrase role="identifier">n</phrase></code> member variable
- </para>
- </callout>
- </calloutlist>
-</article>

Deleted: trunk/tools/quickbook/test/import.quickbook
==============================================================================
--- trunk/tools/quickbook/test/import.quickbook 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,13 +0,0 @@
-[article Import]
-
-[import stub.c]
-[import stub.py]
-[import stub.cpp]
-
-[foo]
-
-[foo_py]
-
-[foo_c]
-
-[class_]
\ No newline at end of file

Deleted: trunk/tools/quickbook/test/preformatted.gold
==============================================================================
--- trunk/tools/quickbook/test/preformatted.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,26 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="preformatted" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Preformatted</title>
- <section id="preformatted.preformatted">
- <title>Preformatted</title>
- <para>
- Here's the ubiquitous <emphasis>Hello World</emphasis> program in C++.
- </para>
-<programlisting>#include &lt;iostream&gt;
-
-int main()
-{
- std::cout &lt;&lt; &quot;Hello, World!&quot; &lt;&lt; std::endl;
- return 0;
-}
-</programlisting>
- <para>
- The code should appear as a single block of code in a monospaced font and with
- no syntax highlighting. The fifth and sixth lines should appear indented to
- the right, aligning under <code><phrase role="identifier">main</phrase></code>,
- on line 3.
- </para>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/quickbook-manual.gold
==============================================================================
--- trunk/tools/quickbook/test/quickbook-manual.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,3944 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="quickbook" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $" xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Quickbook 1.4</title>
- <articleinfo>
- <authorgroup>
- <author>
- <firstname>Joel</firstname> <surname>de Guzman</surname>
- </author>
- <author>
- <firstname>Eric</firstname> <surname>Niebler</surname>
- </author>
- </authorgroup>
- <copyright>
- <year>2002</year> <year>2004</year> <year>2006</year> <holder>Joel de Guzman,
- Eric Niebler</holder>
- </copyright>
- <legalnotice id="quickbook.legal">
- <para>
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at <ulink url="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt>)
- </para>
- </legalnotice>
- <articlepurpose>
- <emphasis>WikiWiki</emphasis> style documentation tool
- </articlepurpose>
- </articleinfo>
- <section id="quickbook.intro">
- <title><link linkend="quickbook.intro">Introduction</link></title>
- <blockquote>
- <para>
- <emphasis role="bold"><emphasis><quote>Why program by hand in five days what
- you can spend five years of your life automating?</quote></emphasis></emphasis>
- </para>
- <para>
- -- Terrence Parr, author ANTLR/PCCTS
- </para>
- </blockquote>
- <para>
- Well, QuickBook started as a weekend hack. It was originally intended to be
- a sample application using <ulink url="
http://spirit.sourceforge.net">Spirit</ulink>.
- What is it? What you are viewing now, this documentation, is autogenerated
- by QuickBook. These files were generated from one master:
- </para>
- <blockquote>
- <para>
- <ulink url="../quickbook.qbk">quickbook.qbk</ulink>
- </para>
- </blockquote>
- <para>
- Originally named QuickDoc, this funky tool that never dies evolved into a funkier
- tool thanks to Eric Niebler who resurrected the project making it generate
- <ulink url="http://www.boost.org/doc/html/boostbook.html">BoostBook</ulink>
- instead of HTML. The <ulink url="http://www.boost.org/doc/html/boostbook.html">BoostBook</ulink>
- documentation format is an extension of <ulink url="http://www.docbook.org/">DocBook</ulink>,
- an SGML or XML based format for describing documentation.
- </para>
- <para>
- QuickBook is a WikiWiki style documentation tool geared towards C++ documentation
- using simple rules and markup for simple formatting tasks. QuickBook extends
- the WikiWiki concept. Like the WikiWiki, QuickBook documents are simple text
- files. A single QuickBook document can generate a fully linked set of nice
- HTML and PostScript/PDF documents complete with images and syntax- colorized
- source code.
- </para>
- <para>
- Features include:
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- generate <ulink url="http://www.boost.org/doc/html/boostbook.html">BoostBook</ulink>
- xml, to generate HTML, PostScript and PDF
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- simple markup to link to Doxygen-generated entities
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- macro system for simple text substitution
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- simple markup for italics, bold, preformatted, blurbs, code samples, tables,
- URLs, anchors, images, etc.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- automatic syntax coloring of code samples
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- CSS support
- </simpara>
- </listitem>
- </itemizedlist>
- </section>
- <section id="quickbook.change_log">
- <title><link linkend="quickbook.change_log">Change Log</link></title>
- <bridgehead renderas="sect3" id="quickbook.change_log.h0">
- <phrase id="quickbook.change_log.version_1_3"/><link linkend="quickbook.change_log.version_1_3">Version
- 1.3</link>
- </bridgehead>
- <itemizedlist>
- <listitem>
- <simpara>
- Quickbook file inclusion [include].
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Better xml output (pretty layout). Check out the generated XML.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Regression testing facility: to make sure your document will always be
- compatible (full backward compatibility) regardless of changes to QuickBook.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Code cleanup and refactoring.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Allow phrase markup in the doc-info.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Preformatted code blocks via ``code`` (double ticks) allows code in tables
- and lists, for example.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Quickbook versioning; allows full backward compatibility. You have to add
- [quickbook 1.3] to the doc-info header to enable the new features. Without
- this, QuickBook will assume that the document is a pre-1.3 document.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Better (intuitive) paragraph termination. Some markups may terminate a
- paragraph. Example:
-<programlisting><phrase role="special">[</phrase><phrase role="identifier">section</phrase> <phrase role="identifier">x</phrase><phrase role="special">]</phrase>
-<phrase role="identifier">blah</phrase><phrase role="special">...</phrase>
-<phrase role="special">[</phrase><phrase role="identifier">endsect</phrase><phrase role="special">]</phrase></programlisting>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Fully qualified section and headers. Subsection names are concatenated
- to the ID to avoid clashing. Example: <code><phrase role="identifier">doc_name</phrase><phrase
- role="special">.</phrase><phrase role="identifier">sect_name</phrase><phrase
- role="special">.</phrase><phrase role="identifier">sub_sect_name</phrase><phrase
- role="special">.</phrase><phrase role="identifier">sub_sub_sect_name</phrase></code>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Better &amp;nbsp; and whitespace handling in code snippets.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- [xinclude] fixes up the relative path to the target XML file when input_directory
- is not the same as the output_directory.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Allow untitled tables.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Allow phrase markups in section titles.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Allow escaping back to QuickBook from code, code blocks and inline code.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Footnotes, with the [footnote This is the footnote] syntax.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Post-processor bug fix for escaped XML code that it does not recognize.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Replaceable, with the [~replacement] syntax.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Generic Headers
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Code changes to allow full recursion (i.e. Collectors and push/pop functions)
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Various code cleanup/maintenance
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Templates!
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- [conceptref] for referencing BoostBook &lt;concept&gt; entities.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Allow escape of spaces. The escaped space is removed from the output. Syntax:
- <code><phrase role="special">\</phrase> </code>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Nested comments are now allowed.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Quickbook blocks can nest inside comments.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <link linkend="quickbook.syntax.block.import">Import</link> facility.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Callouts on imported code
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Simple markups can now span a whole block.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <link linkend="quickbook.syntax.block.blurbs">Blurbs</link>, <link linkend="quickbook.syntax.block.admonitions">Admonitions</link>
- and table cells (see <link linkend="quickbook.syntax.block.tables">Tables</link>)
- may now contain paragraphs.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <code><phrase role="special">\</phrase><phrase role="identifier">n</phrase></code>
- and <code><phrase role="special">[</phrase><phrase role="identifier">br</phrase><phrase
- role="special">]</phrase></code> are now deprecated.
- </simpara>
- </listitem>
- </itemizedlist>
- </section>
- <section id="quickbook.syntax">
- <title><link linkend="quickbook.syntax">Syntax Summary</link></title>
- <para>
- A QuickBook document is composed of one or more blocks. An example of a block
- is the paragraph or a C++ code snippet. Some blocks have special mark-ups.
- Blocks, except code snippets which have their own grammar (C++ or Python),
- are composed of one or more phrases. A phrase can be a simple contiguous run
- of characters. Phrases can have special mark-ups. Marked up phrases can recursively
- contain other phrases, but cannot contain blocks. A terminal is a self contained
- block-level or phrase-level element that does not nest anything.
- </para>
- <para>
- Blocks, in general, are delimited by two end-of-lines (the block terminator).
- Phrases in each block cannot contain a block terminator. This way, syntax errors
- such as un-matched closing brackets do not go haywire and corrupt anything
- past a single block.
- </para>
- <section id="quickbook.syntax.comments">
- <title><link linkend="quickbook.syntax.comments">Comments</link></title>
- <para>
- Can be placed anywhere.
- </para>
-<programlisting><!--quickbook-escape-prefix-->[/ comment (no output generated) ]<!--quickbook-escape-postfix-->
-</programlisting>
-<programlisting><!--quickbook-escape-prefix-->[/ comments can be nested [/ some more here] ]<!--quickbook-escape-postfix-->
-</programlisting>
-<programlisting><!--quickbook-escape-prefix-->[/ Quickbook blocks can nest inside comments. [*Comment this out too!] ]<!--quickbook-escape-postfix-->
-</programlisting>
- </section>
- <section id="quickbook.syntax.phrase">
- <title><link linkend="quickbook.syntax.phrase">Phrase Level Elements</link></title>
- <section id="quickbook.syntax.phrase.font_styles">
- <title><link linkend="quickbook.syntax.phrase.font_styles">Font Styles</link></title>
-<programlisting><!--quickbook-escape-prefix-->['italic], [*bold], [_underline], [^teletype], [-strikethrough]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <para>
- <emphasis>italic</emphasis>, <emphasis role="bold">bold</emphasis>, <emphasis
- role="underline">underline</emphasis>, <literal>teletype</literal>, <emphasis
- role="strikethrough">strikethrough</emphasis>
- </para>
- <para>
- Like all non-terminal phrase level elements, this can of course be nested:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[*['bold-italic]]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <para>
- <emphasis role="bold"><emphasis>bold-italic</emphasis></emphasis>
- </para>
- </section>
- <section id="quickbook.syntax.phrase.replaceable">
- <title><link linkend="quickbook.syntax.phrase.replaceable">Replaceable</link></title>
- <para>
- When you want content that may or must be replaced by the user, use the
- syntax:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[~replacement]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- This will generate:
- </para>
- <para>
- <replaceable>replacement</replaceable>
- </para>
- </section>
- <section id="quickbook.syntax.phrase.quotations">
- <title><link linkend="quickbook.syntax.phrase.quotations">Quotations</link></title>
-<programlisting><!--quickbook-escape-prefix-->["A question that sometimes drives me hazy: am I or are the others crazy?]--Einstein
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <para>
- <quote>A question that sometimes drives me hazy: am I or are the others
- crazy?</quote>--Einstein
- </para>
- <para>
- Note the proper left and right quote marks. Also, while you can simply
- use ordinary quote marks like &quot;quoted&quot;, our quotation, above,
- will generate correct DocBook quotations (e.g. &lt;quote&gt;quoted&lt;/quote&gt;).
- </para>
- <para>
- Like all phrase elements, quotations may be nested. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->["Here's the rule for bargains: ["Do other men, for they would do you.] That's
-the true business precept.]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <para>
- <quote>Here's the rule for bargains: <quote>Do other men, for they would
- do you.</quote> That's the true business precept.</quote>
- </para>
- </section>
- <section id="quickbook.syntax.phrase.simple_formatting">
- <title><link linkend="quickbook.syntax.phrase.simple_formatting">Simple formatting</link></title>
- <para>
- Simple markup for formatting text, common in many applications, is now
- supported:
- </para>
-<programlisting><!--quickbook-escape-prefix-->/italic/, *bold*, _underline_, =teletype=
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <para>
- <emphasis>italic</emphasis>, <emphasis role="bold">bold</emphasis>, <emphasis
- role="underline">underline</emphasis>, <literal>teletype</literal>
- </para>
- <para>
- Unlike QuickBook's standard formatting scheme, the rules for simpler alternatives
- are much stricter<footnote id="quickbook.syntax.phrase.simple_formatting.f0">
- <para>
- Thanks to David Barrett, author of <ulink url="http://quinthar.com/qwikiwiki/index.php?page=Home">Qwiki</ulink>,
- for sharing these samples and teaching me these obscure formatting rules.
- I wasn't sure at all if <ulink url="http://spirit.sourceforge.net">Spirit</ulink>,
- being more or less a formal EBNF parser, can handle the context sensitivity
- and ambiguity.
- </para>
- </footnote>.
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- Simple markups cannot nest. You can combine a simple markup with a
- nestable markup.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Simple markups cannot contain any other form of quickbook markup.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- A non-space character must follow the leading markup
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- A non-space character must precede the trailing markup
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- A space or a punctuation must follow the trailing markup
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- If the matching markup cannot be found within a block, the formatting
- will not be applied. This is to ensure that un-matched formatting markups,
- which can be a common mistake, does not corrupt anything past a single
- block. We do not want the rest of the document to be rendered bold
- just because we forgot a trailing '*'. A single block is terminated
- by two end of lines or the close bracket: ']'.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- A line starting with the star will be interpreted as an unordered list.
- See <link linkend="quickbook.syntax.block.lists.unordered_lists">Unordered
- lists</link>.
- </simpara>
- </listitem>
- </itemizedlist>
- <table frame="all" id="quickbook.syntax.phrase.simple_formatting.t0">
- <title>More Formatting Samples</title>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>
- <para>
- Markup
- </para>
- </entry>
- <entry>
- <para>
- Result
- </para>
- </entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>
- <para>
- <literal>*Bold*</literal>
- </para>
- </entry>
- <entry>
- <para>
- <emphasis role="bold">Bold</emphasis>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>*Is bold*</literal>
- </para>
- </entry>
- <entry>
- <para>
- <emphasis role="bold">Is bold</emphasis>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>* Not bold* *Not bold * * Not bold *</literal>
- </para>
- </entry>
- <entry>
- <para>
- * Not bold* *Not bold * * Not bold *
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>This*Isn't*Bold (no bold)</literal>
- </para>
- </entry>
- <entry>
- <para>
- This*Isn't*Bold (no bold)
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>(*Bold Inside*) (parenthesis not bold)</literal>
- </para>
- </entry>
- <entry>
- <para>
- (<emphasis role="bold">Bold Inside</emphasis>) (parenthesis not
- bold)
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>*(Bold Outside)* (parenthesis bold)</literal>
- </para>
- </entry>
- <entry>
- <para>
- <emphasis role="bold">(Bold Outside)</emphasis> (parenthesis
- bold)
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>3*4*5 = 60 (no bold)</literal>
- </para>
- </entry>
- <entry>
- <para>
- 3*4*5 = 60 (no bold)
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>3 * 4 * 5 = 60 (no bold)</literal>
- </para>
- </entry>
- <entry>
- <para>
- 3 * 4 * 5 = 60 (no bold)
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>3 *4* 5 = 60 (4 is bold)</literal>
- </para>
- </entry>
- <entry>
- <para>
- 3 <emphasis role="bold">4</emphasis> 5 = 60 (4 is bold)
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>*This is bold* this is not *but this is*</literal>
- </para>
- </entry>
- <entry>
- <para>
- <emphasis role="bold">This is bold</emphasis> this is not <emphasis
- role="bold">but this is</emphasis>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>*This is bold*.</literal>
- </para>
- </entry>
- <entry>
- <para>
- <emphasis role="bold">This is bold</emphasis>.
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>*B*. (bold B)</literal>
- </para>
- </entry>
- <entry>
- <para>
- <emphasis role="bold">B</emphasis>. (bold B)
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>['*Bold-Italic*]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <emphasis><emphasis role="bold">Bold-Italic</emphasis></emphasis>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>*side-by*/-side/</literal>
- </para>
- </entry>
- <entry>
- <para>
- <emphasis role="bold">side-by</emphasis><emphasis>-side</emphasis>
- </para>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- <para>
- As mentioned, simple markups cannot go past a single block. The text from
- &quot;have&quot; to &quot;full&quot; in the following paragraph will be
- rendered as bold:
- </para>
-<programlisting><!--quickbook-escape-prefix-->Baa baa black sheep, *have you any wool?
-Yes sir, yes sir, three bags full!*
-One for the master, one for the dame,
-And one for the little boy who lives down the lane.
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Baa baa black sheep, <emphasis role="bold">have you any wool? Yes sir,
- yes sir, three bags full!</emphasis> One for the master, one for the dame,
- And one for the little boy who lives down the lane.
- </para>
- <para>
- But in the following paragraph, bold is not applied:
- </para>
-<programlisting><!--quickbook-escape-prefix-->Baa baa black sheep, *have you any wool?
-Yes sir, yes sir, three bags full!
-One for the master, one for the dame,
-And one for the little boy who lives down the lane.
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Baa baa black sheep, *have you any wool? Yes sir, yes sir, three bags full!
- One for the master, one for the dame, And one for the little boy who lives
- down the lane.
- </para>
- </section>
- <section id="quickbook.syntax.phrase.inline_code">
- <title><link linkend="quickbook.syntax.phrase.inline_code">Inline code</link></title>
- <para>
- Inlining code in paragraphs is quite common when writing C++ documentation.
- We provide a very simple markup for this. For example, this:
- </para>
-<programlisting><!--quickbook-escape-prefix-->This text has inlined code `int main() { return 0; }` in it.
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <para>
- This text has inlined code <code><phrase role="keyword">int</phrase> <phrase
- role="identifier">main</phrase><phrase role="special">()</phrase> <phrase
- role="special">{</phrase> <phrase role="keyword">return</phrase> <phrase
- role="number">0</phrase><phrase role="special">;</phrase> <phrase role="special">}</phrase></code>
- in it. The code will be syntax highlighted.
- </para>
- <note>
- <para>
- We simply enclose the code with the tick: <literal>"`"</literal>, not the
- single quote: <code><phrase role="string">&quot;'&quot;</phrase></code>.
- Note too that <literal>`some code`</literal> is preferred over <literal>[^some code]</literal>.
- </para>
- </note>
- </section>
- <section id="quickbook.syntax.phrase.code_blocks">
- <title><link linkend="quickbook.syntax.phrase.code_blocks">Code blocks</link></title>
- <para>
- Preformatted code simply starts with a space or a tab (See <link linkend="quickbook.syntax.block.code">Code</link>).
- However, such a simple syntax cannot be used as phrase elements in lists
- (See <link linkend="quickbook.syntax.block.lists.ordered_lists">Ordered
- lists</link> and <link linkend="quickbook.syntax.block.lists.unordered_lists">Unordered
- lists</link>), tables (See <link linkend="quickbook.syntax.block.tables">Tables</link>),
- etc. Inline code (see above) can. The problem is, inline code does not
- allow formatting with newlines, spaces, and tabs. These are lost.
- </para>
- <para>
- We provide a phrase level markup that is a mix between the two. By using
- the double-tick, instead of the single-tick, we are telling QuickBook to
- use preformatted blocks of code. Example:
- </para>
-<programlisting>``
- #include &lt;iostream&gt;
-
- int main()
- {
- std::cout &lt;&lt; &quot;Hello, World!&quot; &lt;&lt; std::endl;
- return 0;
- }
-``
-</programlisting>
- <para>
- will generate:
- </para>
- <para>
-<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special">&lt;</phrase><phrase role="identifier">iostream</phrase><phrase role="special">&gt;</phrase>
-
-<phrase role="keyword">int</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special">&lt;&lt;</phrase> <phrase role="string">&quot;Hello, World!&quot;</phrase> <phrase role="special">&lt;&lt;</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
- <phrase role="keyword">return</phrase> <phrase role="number">0</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase>
-</programlisting>
- </para>
- </section>
- <section id="quickbook.syntax.phrase.source_mode">
- <title><link linkend="quickbook.syntax.phrase.source_mode">Source Mode</link></title>
- <para>
- If a document contains more than one type of source code then the source
- mode may be changed dynamically as the document is processed. All QuickBook
- documents are initially in C++ mode by default, though an alternative initial
- value may be set in the <link linkend="quickbook.syntax.block.document">Document</link>
- section.
- </para>
- <para>
- To change the source mode, use the <literal>[source-mode]</literal> markup,
- where <literal>source-mode</literal> is one of the supported modes. For
- example, this:
- </para>
-<programlisting><!--quickbook-escape-prefix-->Python's [python] `import` is rather like C++'s [c++] `#include`. A
-C++ comment `// looks like this` whereas a Python comment [python]
-`# looks like this`.
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <para>
- Python's <code><phrase role="keyword">import</phrase></code> is rather
- like C++'s <code><phrase role="preprocessor">#include</phrase></code>.
- A C++ comment <code><phrase role="comment">// looks like this</phrase></code>
- whereas a Python comment <code><phrase role="comment">#looks like this</phrase></code>.
- </para>
- <table frame="all" id="quickbook.syntax.phrase.source_mode.t0">
- <title>Supported Source Modes</title>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>
- <para>
- Mode
- </para>
- </entry>
- <entry>
- <para>
- Source Mode Markup
- </para>
- </entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>
- <para>
- C++
- </para>
- </entry>
- <entry>
- <para>
- <literal>[c++]</literal>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- Python
- </para>
- </entry>
- <entry>
- <para>
- <literal>[python]</literal>
- </para>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- <note>
- <para>
- The source mode strings are lowercase.
- </para>
- </note>
- </section>
- <section id="quickbook.syntax.phrase.line_break">
- <title><link linkend="quickbook.syntax.phrase.line_break">line-break</link></title>
-<programlisting><!--quickbook-escape-prefix-->[br]
-<!--quickbook-escape-postfix--></programlisting>
- <warning>
- <para>
- <code><phrase role="special">[</phrase><phrase role="identifier">br</phrase><phrase
- role="special">]</phrase></code> is now deprecated. <link linkend="quickbook.syntax.block.blurbs">Blurbs</link>,
- <link linkend="quickbook.syntax.block.admonitions">Admonitions</link>
- and table cells (see <link linkend="quickbook.syntax.block.tables">Tables</link>)
- may now contain paragraphs.
- </para>
- </warning>
- </section>
- <section id="quickbook.syntax.phrase.anchors">
- <title><link linkend="quickbook.syntax.phrase.anchors">Anchors</link></title>
-<programlisting><!--quickbook-escape-prefix-->[#named_anchor]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- A named anchor is a hook that can be referenced by a link elsewhere in
- the document. You can then reference an anchor with <literal>[link named_anchor
-Some link text]</literal>.
- See <link linkend="quickbook.syntax.phrase.anchor_links">Anchor links</link>,
- <link linkend="quickbook.syntax.block.section">Section</link> and <link
- linkend="quickbook.syntax.block.headings">Heading</link>.
- </para>
- </section>
- <section id="quickbook.syntax.phrase.links">
- <title><link linkend="quickbook.syntax.phrase.links">Links</link></title>
-<programlisting><!--quickbook-escape-prefix-->[@http://www.boost.org this is [*boost's] website....]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <para>
- <ulink url="http://www.boost.org">this is <emphasis role="bold">boost's</emphasis>
- website....</ulink>
- </para>
- <para>
- URL links where the link text is the link itself is common. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->see http://spirit.sourceforge.net/
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- so, when the text is absent in a link markup, the URL is assumed. Example:
- </para>
-<programlisting>see <!--quickbook-escape-prefix-->[@http://spirit.sourceforge.net/]<!--quickbook-escape-postfix-->
-</programlisting>
- <para>
- will generate:
- </para>
- <para>
- see <ulink url="http://spirit.sourceforge.net/">http://spirit.sourceforge.net/>
- </para>
- </section>
- <section id="quickbook.syntax.phrase.anchor_links">
- <title><link linkend="quickbook.syntax.phrase.anchor_links">Anchor links</link></title>
- <para>
- You can link within a document using:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[link section_id.normalized_header_text The link text]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- See sections <link linkend="quickbook.syntax.block.section">Section</link>
- and <link linkend="quickbook.syntax.block.headings">Heading</link> for
- more info.
- </para>
- </section>
- <section id="quickbook.syntax.phrase.refentry_links">
- <title><link linkend="quickbook.syntax.phrase.refentry_links">refentry links</link></title>
- <para>
- In addition, you can link internally to an XML refentry like:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[link xml.refentry The link text]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- This gets converted into <literal>&lt;link linkend=&quot;xml.refentry&quot;&gt;The
- link text&lt;/link&gt;</literal>.
- </para>
- <para>
- Like URLs, the link text is optional. If this is not present, the link
- text will automatically be the refentry. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[link xml.refentry]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- This gets converted into <literal>&lt;link linkend=&quot;xml.refentry&quot;&gt;xml.refentry&lt;/link&gt;</literal>.
- </para>
- </section>
- <section id="quickbook.syntax.phrase.code_links">
- <title><link linkend="quickbook.syntax.phrase.code_links">Code Links</link></title>
- <para>
- If you want to link to a function, class, member, enum, concept or header
- in the reference section, you can use:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[funcref fully::qualified::function_name The link text]
-[classref fully::qualified::class_name The link text]
-[memberref fully::qualified::member_name The link text]
-[enumref fully::qualified::enum_name The link text]
-[macroref MACRO_NAME The link text]
-[conceptref ConceptName The link text]
-[headerref path/to/header.hpp The link text]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Again, the link text is optional. If this is not present, the link text
- will automatically be the function, class, member, enum, macro, concept
- or header. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[classref boost::bar::baz]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- would have &quot;boost::bar::baz&quot; as the link text.
- </para>
- </section>
- <section id="quickbook.syntax.phrase.escape">
- <title><link linkend="quickbook.syntax.phrase.escape">Escape</link></title>
- <para>
- The escape mark-up is used when we don't want to do any processing.
- </para>
-<programlisting>'''
-escape (no processing/formatting)
-'''
-</programlisting>
- <para>
- Escaping allows us to pass XML markup to <ulink url="
http://www.boost.org/doc/html/boostbook.html">BoostBook</ulink>
- or <ulink url="http://www.docbook.org/">DocBook</ulink>. For example:
- </para>
-<programlisting>'''
-&lt;emphasis role=&quot;bold&quot;&gt;This is direct XML markup&lt;/emphasis&gt;
-'''
-</programlisting>
- <para>
- <emphasis role="bold">This is direct XML markup</emphasis>
- </para>
- <important>
- <para>
- Be careful when using the escape. The text must conform to <ulink url="http://www.boost.org/doc/html/boostbook.html">BoostBook</ulink>/<ulink
- url="http://www.docbook.org/">DocBook</ulink> syntax.
- </para>
- </important>
- </section>
- <section id="quickbook.syntax.phrase.single_char_escape">
- <title><link linkend="quickbook.syntax.phrase.single_char_escape">Single
- char escape</link></title>
- <para>
- The backslash may be used to escape a single punctuation character. The
- punctuation immediately after the backslash is passed without any processing.
- This is useful when we need to escape QuickBook punctuations such as <code><phrase
- role="special">[</phrase></code> and <code><phrase role="special">]</phrase></code>.
- For example, how do you escape the triple quote? Simple: <literal>\'\'\'</literal>
- </para>
- <para>
- <code><phrase role="special">\</phrase><phrase role="identifier">n</phrase></code>
- has a special meaning. It is used to generate line breaks.
- </para>
- <warning>
- <para>
- <code><phrase role="special">\</phrase><phrase role="identifier">n</phrase></code>
- and <code><phrase role="special">[</phrase><phrase role="identifier">br</phrase><phrase
- role="special">]</phrase></code> are now deprecated. <link linkend="quickbook.syntax.block.blurbs">Blurbs</link>,
- <link linkend="quickbook.syntax.block.admonitions">Admonitions</link>
- and table cells (see <link linkend="quickbook.syntax.block.tables">Tables</link>)
- may now contain paragraphs.
- </para>
- </warning>
- <para>
- The escaped space: <code><phrase role="special">\</phrase> </code> also
- has a special meaning. The escaped space is removed from the output.
- </para>
- </section>
- <section id="quickbook.syntax.phrase.images">
- <title><link linkend="quickbook.syntax.phrase.images">Images</link></title>
-<programlisting><!--quickbook-escape-prefix-->[$image.jpg]
-<!--quickbook-escape-postfix--></programlisting>
- </section>
- <section id="quickbook.syntax.phrase.footnotes">
- <title><link linkend="quickbook.syntax.phrase.footnotes">Footnotes</link></title>
- <para>
- As of version 1.3, QuickBook supports footnotes. Just put the text of the
- footnote in a <code><phrase role="special">[</phrase><phrase role="identifier">footnote</phrase><phrase
- role="special">]</phrase></code> block, and the text will be put at the
- bottom of the current page. For example, this:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[footnote A sample footnote]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate this<footnote id="quickbook.syntax.phrase.footnotes.f0">
- <para>
- A sample footnote
- </para>
- </footnote>.
- </para>
- <section id="quickbook.syntax.phrase.footnotes.macro_expansion">
- <title><link linkend="quickbook.syntax.phrase.footnotes.macro_expansion">Macro
- Expansion</link></title>
-<programlisting><!--quickbook-escape-prefix-->__a_macro_identifier__
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- See <link linkend="quickbook.syntax.block.macros">Macros</link> for details.
- </para>
- </section>
- <section id="quickbook.syntax.phrase.footnotes.template_expansion">
- <title><link linkend="quickbook.syntax.phrase.footnotes.template_expansion">Template
- Expansion</link></title>
-<programlisting><!--quickbook-escape-prefix-->[a_template_identifier]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- See <link linkend="quickbook.syntax.block.templates">Templates</link>
- for details.
- </para>
- </section>
- </section>
- </section>
- <section id="quickbook.syntax.block">
- <title><link linkend="quickbook.syntax.block">Block Level Elements</link></title>
- <section id="quickbook.syntax.block.document">
- <title><link linkend="quickbook.syntax.block.document">Document</link></title>
- <para>
- Every document must begin with a Document Info section, which should look
- like this:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[document-type The Document Title
- [quickbook 1.3]
- [version 1.0]
- [id the_document_name]
- [dirname the_document_dir]
- [copyright 2000 2002 2003 Joe Blow, Jane Doe]
- [purpose The document's reason for being]
- [category The document's category]
- [authors [Blow, Joe], [Doe, Jane]]
- [license The document's license]
- [source-mode source-type]
-]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Where document-type is one of:
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- book
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- article
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- library
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- chapter
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- part
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- appendix
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- preface
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- qandadiv
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- qandaset
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- reference
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- set
- </simpara>
- </listitem>
- </itemizedlist>
- <para>
- quickbook 1.3 declares the version of quickbook the document is written
- for. In its absence, version 1.1 is assumed.
- </para>
- <para>
- <literal>version</literal>, <literal>id</literal>, <literal>dirname</literal>,
- <literal>copyright</literal>, <literal>purpose</literal>, <literal>category</literal>,
- <literal>authors</literal>, <literal>license</literal>, <literal>last-revision</literal>
- and <literal>source-mode</literal> are optional information.
- </para>
- <para>
- <literal>source-type</literal> is a lowercase string setting the initial
- <link linkend="quickbook.syntax.phrase.source_mode">Source Mode</link>.
- If the <literal>source-mode</literal> field is omitted, a default value
- of <literal>c++</literal> will be used.
- </para>
- </section>
- <section id="quickbook.syntax.block.section">
- <title><link linkend="quickbook.syntax.block.section">Section</link></title>
- <para>
- Starting a new section is accomplished with:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[section:id The Section Title]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- where <emphasis>id</emphasis> is optional. id will be the filename of the
- generated section. If it is not present, &quot;The Section Title&quot;
- will be normalized and become the id. Valid characters are <literal>a-Z</literal>,
- <literal>A-Z</literal>, <literal>0-9</literal> and <literal>_</literal>.
- All non-valid characters are converted to underscore and all upper-case
- are converted to lower case. Thus: &quot;The Section Title&quot; will be
- normalized to &quot;the_section_title&quot;.
- </para>
- <para>
- End a section with:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[endsect]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Sections can nest, and that results in a hierarchy in the table of contents.
- </para>
- </section>
- <section id="quickbook.syntax.block.xinclude">
- <title><link linkend="quickbook.syntax.block.xinclude">xinclude</link></title>
- <para>
- You can include another XML file with:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[xinclude file.xml]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- This is useful when file.xml has been generated by Doxygen and contains
- your reference section.
- </para>
- </section>
- <section id="quickbook.syntax.block.paragraphs">
- <title><link linkend="quickbook.syntax.block.paragraphs">Paragraphs</link></title>
- <para>
- Paragraphs start left-flushed and are terminated by two or more newlines.
- No markup is needed for paragraphs. QuickBook automatically detects paragraphs
- from the context. Block markups [section, endsect, h1, h2, h3, h4, h5,
- h6, blurb, (block-quote) ':', pre, def, table and include ] may also terminate
- a paragraph.
- </para>
- </section>
- <section id="quickbook.syntax.block.lists">
- <title><link linkend="quickbook.syntax.block.lists">Lists</link></title>
- <section id="quickbook.syntax.block.lists.ordered_lists">
- <title><link linkend="quickbook.syntax.block.lists.ordered_lists">Ordered
- lists</link></title>
-<programlisting># One
-# Two
-# Three
-</programlisting>
- <para>
- will generate:
- </para>
- <orderedlist>
- <listitem>
- <simpara>
- One
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Two
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Three
- </simpara>
- </listitem>
- </orderedlist>
- </section>
- <section id="quickbook.syntax.block.lists.list_hierarchies">
- <title><link linkend="quickbook.syntax.block.lists.list_hierarchies">List
- Hierarchies</link></title>
- <para>
- List hierarchies are supported. Example:
- </para>
-<programlisting># One
-# Two
-# Three
- # Three.a
- # Three.b
- # Three.c
-# Four
- # Four.a
- # Four.a.i
- # Four.a.ii
-# Five
-</programlisting>
- <para>
- will generate:
- </para>
- <orderedlist>
- <listitem>
- <simpara>
- One
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Two
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Three
- <orderedlist>
- <listitem>
- <simpara>
- Three.a
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Three.b
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Three.c
- </simpara>
- </listitem>
- </orderedlist>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Fourth
- <orderedlist>
- <listitem>
- <simpara>
- Four.a
- <orderedlist>
- <listitem>
- <simpara>
- Four.a.i
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Four.a.ii
- </simpara>
- </listitem>
- </orderedlist>
- </simpara>
- </listitem>
- </orderedlist>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Five
- </simpara>
- </listitem>
- </orderedlist>
- </section>
- <section id="quickbook.syntax.block.lists.long_list_lines">
- <title><link linkend="quickbook.syntax.block.lists.long_list_lines">Long
- List Lines</link></title>
- <para>
- Long lines will be wrapped appropriately. Example:
- </para>
-<programlisting># A short item.
-# A very long item. A very long item. A very long item.
- A very long item. A very long item. A very long item.
- A very long item. A very long item. A very long item.
- A very long item. A very long item. A very long item.
- A very long item. A very long item. A very long item.
-# A short item.
-</programlisting>
- <orderedlist>
- <listitem>
- <simpara>
- A short item.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- A very long item. A very long item. A very long item. A very long
- item. A very long item. A very long item. A very long item. A very
- long item. A very long item. A very long item. A very long item.
- A very long item. A very long item. A very long item. A very long
- item.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- A short item.
- </simpara>
- </listitem>
- </orderedlist>
- </section>
- <section id="quickbook.syntax.block.lists.unordered_lists">
- <title><link linkend="quickbook.syntax.block.lists.unordered_lists">Unordered
- lists</link></title>
-<programlisting><!--quickbook-escape-prefix-->* First
-* Second
-* Third
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- First
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Second
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Third
- </simpara>
- </listitem>
- </itemizedlist>
- </section>
- <section id="quickbook.syntax.block.lists.mixed_lists">
- <title><link linkend="quickbook.syntax.block.lists.mixed_lists">Mixed lists</link></title>
- <para>
- Mixed lists (ordered and unordered) are supported. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix--># One
-# Two
-# Three
- * Three.a
- * Three.b
- * Three.c
-# Four
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <orderedlist>
- <listitem>
- <simpara>
- One
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Two
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Three
- <itemizedlist>
- <listitem>
- <simpara>
- Three.a
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Three.b
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Three.c
- </simpara>
- </listitem>
- </itemizedlist>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Four
- </simpara>
- </listitem>
- </orderedlist>
- <para>
- And...
- </para>
-<programlisting><!--quickbook-escape-prefix--># 1
- * 1.a
- # 1.a.1
- # 1.a.2
- * 1.b
-# 2
- * 2.a
- * 2.b
- # 2.b.1
- # 2.b.2
- * 2.b.2.a
- * 2.b.2.b
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <orderedlist>
- <listitem>
- <simpara>
- 1
- <itemizedlist>
- <listitem>
- <simpara>
- 1.a
- <orderedlist>
- <listitem>
- <simpara>
- 1.a.1
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- 1.a.2
- </simpara>
- </listitem>
- </orderedlist>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- 1.b
- </simpara>
- </listitem>
- </itemizedlist>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- 2
- <itemizedlist>
- <listitem>
- <simpara>
- 2.a
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- 2.b
- <orderedlist>
- <listitem>
- <simpara>
- 2.b.1
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- 2.b.2
- <itemizedlist>
- <listitem>
- <simpara>
- 2.b.2.a
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- 2.b.2.b
- </simpara>
- </listitem>
- </itemizedlist>
- </simpara>
- </listitem>
- </orderedlist>
- </simpara>
- </listitem>
- </itemizedlist>
- </simpara>
- </listitem>
- </orderedlist>
- </section>
- </section>
- <section id="quickbook.syntax.block.code">
- <title><link linkend="quickbook.syntax.block.code">Code</link></title>
- <para>
- Preformatted code starts with a space or a tab. The code will be syntax
- highlighted according to the current <link linkend="quickbook.syntax.phrase.source_mode">Source
- Mode</link>:
- </para>
-<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special">&lt;</phrase><phrase role="identifier">iostream</phrase><phrase role="special">&gt;</phrase>
-
-<phrase role="keyword">int</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
- <phrase role="comment">// Sample code</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special">&lt;&lt;</phrase> <phrase role="string">&quot;Hello, World\n&quot;</phrase><phrase role="special">;</phrase>
- <phrase role="keyword">return</phrase> <phrase role="number">0</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase>
-</programlisting>
-<programlisting><phrase role="keyword">import</phrase> <phrase role="identifier">cgi</phrase>
-
-<phrase role="keyword">def</phrase> <phrase role="identifier">cookForHtml</phrase><phrase role="special">(</phrase><phrase role="identifier">text</phrase><phrase role="special">):</phrase>
- <phrase role="string">'''&quot;Cooks&quot; the input text for HTML.'''</phrase>
-
- <phrase role="keyword">return</phrase> <phrase role="identifier">cgi</phrase><phrase role="special">.</phrase><phrase role="identifier">escape</phrase><phrase role="special">(</phrase><phrase role="identifier">text</phrase><phrase role="special">)</phrase>
-</programlisting>
- <para>
- Macros that are already defined are expanded in source code. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[def __array__ [@http://www.boost.org/doc/html/array/reference.html array]]
-[def __boost__ [@http://www.boost.org/libs/libraries.htm boost]]
-
- using __boost__::__array__;
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Generates:
- </para>
-<programlisting><phrase role="keyword">using</phrase> <ulink url="http://www.boost.org/libs/libraries.htm">boost</ulink><phrase role="special">::</phrase><ulink url="http://www.boost.org/doc/html/array/reference.html">array</ulink><phrase role="special">;</phrase>
-</programlisting>
- </section>
- <section id="quickbook.syntax.block.escape_back">
- <title><link linkend="quickbook.syntax.block.escape_back">Escaping Back To
- QuickBook</link></title>
- <para>
- Inside code, code blocks and inline code, QuickBook does not allow any
- markup to avoid conflicts with the target syntax (e.g. c++). In case you
- need to switch back to QuickBook markup inside code, you can do so using
- a language specific <emphasis>escape-back</emphasis> delimiter. In C++
- and Python, the delimiter is the double tick (back-quote): &quot;``&quot;
- and &quot;``&quot;. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->void ``[@http://en.wikipedia.org/wiki/Foo#Foo.2C_Bar_and_Baz foo]``()
-{
-}
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Will generate:
- </para>
-<programlisting><phrase role="keyword">void</phrase> <ulink url="http://en.wikipedia.org/wiki/Foo#Foo.2C_Bar_and_Baz">foo</ulink><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
-<phrase role="special">}</phrase>
-</programlisting>
- <para>
- When escaping from code to QuickBook, only phrase level markups are allowed.
- Block level markups like lists, tables etc. are not allowed.
- </para>
- </section>
- <section id="quickbook.syntax.block.preformatted">
- <title><link linkend="quickbook.syntax.block.preformatted">Preformatted</link></title>
- <para>
- Sometimes, you don't want some preformatted text to be parsed as C++. In
- such cases, use the <literal>[pre ... ]</literal> markup block.
- </para>
-<programlisting><!--quickbook-escape-prefix-->[pre
-
- Some *preformatted* text Some *preformatted* text
-
- Some *preformatted* text Some *preformatted* text
-
- Some *preformatted* text Some *preformatted* text
-
-]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Spaces, tabs and newlines are rendered as-is. Unlike all quickbook block
- level markup, pre (and Code) are the only ones that allow multiple newlines.
- The markup above will generate:
- </para>
-<programlisting>Some <emphasis role="bold">preformatted</emphasis> text Some <emphasis role="bold">preformatted</emphasis> text
-
- Some <emphasis role="bold">preformatted</emphasis> text Some <emphasis role="bold">preformatted</emphasis> text
-
- Some <emphasis role="bold">preformatted</emphasis> text Some <emphasis role="bold">preformatted</emphasis> text
-
-</programlisting>
- <para>
- Notice that unlike Code, phrase markup such as font style is still permitted
- inside <literal>pre</literal> blocks.
- </para>
- </section>
- <section id="quickbook.syntax.block.blockquote">
- <title><link linkend="quickbook.syntax.block.blockquote">Blockquote</link></title>
-<programlisting><!--quickbook-escape-prefix-->[:sometext...]<!--quickbook-escape-postfix-->
-</programlisting>
- <blockquote>
- <para>
- Indents the paragraph. This applies to one paragraph only.
- </para>
- </blockquote>
- </section>
- <section id="quickbook.syntax.block.admonitions">
- <title><link linkend="quickbook.syntax.block.admonitions">Admonitions</link></title>
-<programlisting><!--quickbook-escape-prefix-->[note This is a note]
-[tip This is a tip]
-[important This is important]
-[caution This is a caution]
-[warning This is a warning]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- generates <ulink url="http://www.docbook.org/">DocBook</ulink> admonitions:
- </para>
- <note>
- <para>
- This is a note
- </para>
- </note>
- <tip>
- <para>
- This is a tip
- </para>
- </tip>
- <important>
- <para>
- This is important
- </para>
- </important>
- <caution>
- <para>
- This is a caution
- </para>
- </caution>
- <warning>
- <para>
- This is a warning
- </para>
- </warning>
- <para>
- These are the only admonitions supported by <ulink url="http://www.docbook.org/">DocBook</ulink>.
- So, for example <literal>[information This is some information]</literal>
- is unlikely to produce the desired effect.
- </para>
- </section>
- <section id="quickbook.syntax.block.headings">
- <title><link linkend="quickbook.syntax.block.headings">Headings</link></title>
-<programlisting><!--quickbook-escape-prefix-->[h1 Heading 1]
-[h2 Heading 2]
-[h3 Heading 3]
-[h4 Heading 4]
-[h5 Heading 5]
-[h6 Heading 6]
-<!--quickbook-escape-postfix--></programlisting>
- <bridgehead renderas="sect1" id="quickbook.syntax.block.headings.h0">
- <phrase id="quickbook.syntax.block.headings.heading_1"/><link linkend="quickbook.syntax.block.headings.heading_1">Heading
- 1</link>
- </bridgehead>
- <bridgehead renderas="sect2" id="quickbook.syntax.block.headings.h1">
- <phrase id="quickbook.syntax.block.headings.heading_2"/><link linkend="quickbook.syntax.block.headings.heading_2">Heading
- 2</link>
- </bridgehead>
- <bridgehead renderas="sect3" id="quickbook.syntax.block.headings.h2">
- <phrase id="quickbook.syntax.block.headings.heading_3"/><link linkend="quickbook.syntax.block.headings.heading_3">Heading
- 3</link>
- </bridgehead>
- <bridgehead renderas="sect4" id="quickbook.syntax.block.headings.h3">
- <phrase id="quickbook.syntax.block.headings.heading_4"/><link linkend="quickbook.syntax.block.headings.heading_4">Heading
- 4</link>
- </bridgehead>
- <bridgehead renderas="sect5" id="quickbook.syntax.block.headings.h4">
- <phrase id="quickbook.syntax.block.headings.heading_5"/><link linkend="quickbook.syntax.block.headings.heading_5">Heading
- 5</link>
- </bridgehead>
- <bridgehead renderas="sect6" id="quickbook.syntax.block.headings.h5">
- <phrase id="quickbook.syntax.block.headings.heading_6"/><link linkend="quickbook.syntax.block.headings.heading_6">Heading
- 6</link>
- </bridgehead>
- <para>
- Headings 1-3 [h1 h2 and h3] will automatically have anchors with normalized
- names with <literal>name=&quot;section_id.normalized_header_text&quot;</literal>
- (i.e. valid characters are <literal>a-z</literal>, <literal>A-Z</literal>,
- <literal>0-9</literal> and <literal>_</literal>. All non-valid characters
- are converted to underscore and all upper-case are converted to lower-case.
- For example: Heading 1 in section Section 2 will be normalized to <literal>section_2.heading_1</literal>).
- You can use:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[link section_id.normalized_header_text The link text]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- to link to them. See <link linkend="quickbook.syntax.phrase.anchor_links">Anchor
- links</link> and <link linkend="quickbook.syntax.block.section">Section</link>
- for more info.
- </para>
- </section>
- <section id="quickbook.syntax.block.generic_heading">
- <title><link linkend="quickbook.syntax.block.generic_heading">Generic Heading</link></title>
- <para>
- In cases when you don't want to care about the heading level (1 to 6),
- you can use the <emphasis>Generic Heading</emphasis>:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[heading Heading]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- The <emphasis>Generic Heading</emphasis> assumes the level, plus one, of
- the innermost section where it is placed. For example, if it is placed
- in the outermost section, then, it assumes <emphasis>h2</emphasis>.
- </para>
- <para>
- Headings are often used as an alternative to sections. It is used particularly
- if you do not want to start a new section. In many cases, however, headings
- in a particular section is just flat. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[section A]
-[h2 X]
-[h2 Y]
-[h2 Z]
-[endsect]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Here we use h2 assuming that section A is the outermost level. If it is
- placed in an inner level, you'll have to use h3, h4, etc. depending on
- where the section is. In general, it is the section level plus one. It
- is rather tedious, however, to scan the section level everytime. If you
- rewrite the example above as shown below, this will be automatic:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[section A]
-[heading X]
-[heading Y]
-[heading Z]
-[endsect]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- They work well regardless where you place them. You can rearrange sections
- at will without any extra work to ensure correct heading levels. In fact,
- with <emphasis>section</emphasis> and <emphasis>heading</emphasis>, you
- have all you need. <emphasis>h1</emphasis>..<emphasis>h6</emphasis> becomes
- redundant. <emphasis>h1</emphasis>..<emphasis>h6</emphasis> might be deprecated
- in the future.
- </para>
- </section>
- <section id="quickbook.syntax.block.macros">
- <title><link linkend="quickbook.syntax.block.macros">Macros</link></title>
-<programlisting><!--quickbook-escape-prefix-->[def macro_identifier some text]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- When a macro is defined, the identifier replaces the text anywhere in the
- file, in paragraphs, in markups, etc. macro_identifier is a string of non-
- white space characters except ']'. A macro may not follow an alphabetic
- character or the underscore. The replacement text can be any phrase (even
- marked up). Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[def sf_logo [$http://sourceforge.net/sflogo.php?group_id=28447&amp;type=1]]
-sf_logo
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Now everywhere the sf_logo is placed, the picture will be inlined.
- </para>
- <para>
- <inlinemediaobject><imageobject><imagedata fileref="http://sourceforge.net/sflogo.php?group_id=28447&amp;type=1"></imagedata></imageobject>
- <textobject>
- <phrase>sflogo</phrase>
- </textobject>
- </inlinemediaobject>
- </para>
- <tip>
- <para>
- It's a good idea to use macro identifiers that are distinguishable. For
- instance, in this document, macro identifiers have two leading and trailing
- underscores (e.g. <literal>__spirit__</literal>). The reason is to avoid unwanted
- macro replacement.
- </para>
- </tip>
- <para>
- Links (URLS) and images are good candidates for macros. <emphasis role="bold">1</emphasis>)
- They tend to change a lot. It is a good idea to place all links and images
- in one place near the top to make it easy to make changes. <emphasis role="bold">2</emphasis>)
- The syntax is not pretty. It's easier to read and write, e.g. <literal>__spirit__</literal>
- than <literal>[@http://spirit.sourceforge.net Spirit]</literal>.
- </para>
- <para>
- Some more examples:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[def :-) [$theme/smiley.png]]
-[def __spirit__ [@http://spirit.sourceforge.net Spirit]]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- (See <link linkend="quickbook.syntax.phrase.images">Images</link> and
- <link linkend="quickbook.syntax.phrase.links">Links</link>)
- </para>
- <para>
- Invoking these macros:
- </para>
-<programlisting><!--quickbook-escape-prefix-->Hi __spirit__ :-)
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate this:
- </para>
- <para>
- Hi <ulink url="http://spirit.sourceforge.net">Spirit</ulink> <inlinemediaobject><imageobject><imagedata
- fileref="images/smiley.png"></imagedata></imageobject>
- <textobject>
- <phrase>smiley</phrase>
- </textobject>
- </inlinemediaobject>
- </para>
- </section>
- <section id="quickbook.syntax.block.predefined_macros">
- <title><link linkend="quickbook.syntax.block.predefined_macros">Predefined
- Macros</link></title>
- <para>
- Quickbook has some predefined macros that you can already use.
- </para>
- <table frame="all" id="quickbook.syntax.block.predefined_macros.t0">
- <title>Predefined Macros</title>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>
- <para>
- Macro
- </para>
- </entry>
- <entry>
- <para>
- Meaning
- </para>
- </entry>
- <entry>
- <para>
- Example
- </para>
- </entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>
- <para>
- __DATE__
- </para>
- </entry>
- <entry>
- <para>
- Today's date
- </para>
- </entry>
- <entry>
- <para>
- 2000-Dec-20
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- __TIME__
- </para>
- </entry>
- <entry>
- <para>
- The current time
- </para>
- </entry>
- <entry>
- <para>
- 12:00:00 PM
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- __FILENAME__
- </para>
- </entry>
- <entry>
- <para>
- Quickbook source filename
- </para>
- </entry>
- <entry>
- <para>
- quickbook-manual.quickbook
- </para>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </section>
- <section id="quickbook.syntax.block.templates">
- <title><link linkend="quickbook.syntax.block.templates">Templates</link></title>
- <para>
- Templates provide a more versatile text substitution mechanism. Templates
- come in handy when you need to create parameterizable, multi-line, boilerplate
- text that you specify once and expand many times. Templates accept one
- or more arguments. These arguments act like place-holders for text replacement.
- Unlike simple macros, which are limited to phrase level markup, templates
- can contain block level markup (e.g. paragraphs, code blocks and tables).
- </para>
- <para>
- Example template:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[template person[name age what]
-
-Hi, my name is [name]. I am [age] years old. I am a [what].
-
-]
-<!--quickbook-escape-postfix--></programlisting>
- <bridgehead renderas="sect5" id="quickbook.syntax.block.templates.h0">
- <phrase id="quickbook.syntax.block.templates.template_identifier"/><link
- linkend="quickbook.syntax.block.templates.template_identifier">Template
- Identifier</link>
- </bridgehead>
- <para>
- Template identifiers can either consist of:
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- An initial alphabetic character or the underscore, followed by zero
- or more alphanumeric characters or the underscore. This is similar
- to your typical C/C++ identifier.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- A single character punctuation (a non-alphanumeric printable character)
- </simpara>
- </listitem>
- </itemizedlist>
- <bridgehead renderas="sect5" id="quickbook.syntax.block.templates.h1">
- <phrase id="quickbook.syntax.block.templates.formal_template_arguments"/><link
- linkend="quickbook.syntax.block.templates.formal_template_arguments">Formal
- Template Arguments</link>
- </bridgehead>
- <para>
- Template formal arguments are identifiers consisting of an initial alphabetic
- character or the underscore, followed by zero or more alphanumeric characters
- or the underscore. This is similar to your typical C/C++ identifier.
- </para>
- <para>
- A template formal argument temporarily hides a template of the same name
- at the point where the <link linkend="quickbook.syntax.block.templates.template_expansion">template
- is expanded</link>. Note that the body of the <literal>person</literal>
- template above refers to <literal>name</literal> <literal>age</literal>
- and <literal>what</literal> as <literal>[name]</literal> <literal>[age]</literal>
- and <literal>[what]</literal>. <literal>name</literal> <literal>age</literal>
- and <literal>what</literal> are actually templates that exist in the duration
- of the template call.
- </para>
- <bridgehead renderas="sect5" id="quickbook.syntax.block.templates.h2">
- <phrase id="quickbook.syntax.block.templates.template_body"/><link linkend="quickbook.syntax.block.templates.template_body">Template
- Body</link>
- </bridgehead>
- <para>
- The template body can be just about any QuickBook block or phrase. There
- are actually two forms. Templates may be phrase or block level. Phrase
- templates are of the form:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[template sample[arg1 arg2...argN] replacement text... ]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Block templates are of the form:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[template sample[arg1 arg2...argN]
-replacement text...
-]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- The basic rule is as follows: if a newline immediately follows the argument
- list, then it is a block template, otherwise, it is a phrase template.
- Phrase templates are typically expanded as part of phrases. Like macros,
- block level elements are not allowed in phrase templates.
- </para>
- <bridgehead renderas="sect5" id="quickbook.syntax.block.templates.h3">
- <phrase id="quickbook.syntax.block.templates.template_expansion"/><link
- linkend="quickbook.syntax.block.templates.template_expansion">Template
- Expansion</link>
- </bridgehead>
- <para>
- You expand a template this way:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[template_identifier arg1..arg2..arg3]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- At template expansion, you supply the actual arguments. The template will
- be expanded with your supplied arguments. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[person James Bond..39..Spy]
-[person Santa Clause..87..Big Red Fatso]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Which will expand to:
- </para>
- <para>
- Hi, my name is James Bond. I am 39 years old. I am a Spy.
- </para>
- <para>
- Hi, my name is Santa Clause. I am 87 years old. I am a Big Red Fatso.
- </para>
- <caution>
- <para>
- A word of caution: Templates are recursive. A template can call another
- template or even itself, directly or indirectly. There are no control
- structures in QuickBook (yet) so this will always mean infinite recursion.
- QuickBook can detect this situation and report an error if recursion
- exceeds a certain limit.
- </para>
- </caution>
- <para>
- Each actual argument can be a word, a text fragment or just about any
- <link linkend="quickbook.syntax.phrase">QuickBook phrase</link>. Arguments
- are separated by the double dot <literal>&quot;..&quot;</literal> and terminated
- by the close parenthesis.
- </para>
- <bridgehead renderas="sect5" id="quickbook.syntax.block.templates.h4">
- <phrase id="quickbook.syntax.block.templates.nullary_templates"/><link
- linkend="quickbook.syntax.block.templates.nullary_templates">Nullary Templates</link>
- </bridgehead>
- <para>
- Nullary templates look and act like simple macros. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[template alpha[]&apos;&apos;&apos;&amp;#945;&apos;&apos;&apos;]
-[template beta[]&apos;&apos;&apos;&amp;#946;&apos;&apos;&apos;]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Expanding:
- </para>
-<programlisting><!--quickbook-escape-prefix-->Some squigles...[*[alpha][beta]]<!--quickbook-escape-postfix--></programlisting>
- <para>
- We have:
- </para>
- <para>
- Some squiggles...<emphasis role="bold">&#945;&#946;</emphasis>
- </para>
- <para>
- The difference with macros are
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- The explicit <link linkend="quickbook.syntax.block.templates.template_expansion">template
- expansion syntax</link>. This is an advantage because, now, we don't
- have to use obscure naming conventions like double underscores (e.g.
- __alpha__) to avoid unwanted macro replacement.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- The template is expanded at the point where it is invoked. A macro
- is expanded immediately at its point of declaration. This is subtle
- and can cause a slight difference in behavior especially if you refer
- to other macros and templates in the body.
- </simpara>
- </listitem>
- </itemizedlist>
- <para>
- The empty brackets after the template identifier (<literal>alpha[]</literal>)
- indicates no arguments. If the template body does not look like a template
- argument list, we can elide the empty brackets. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[template aristotle_quote Aristotle: [*['Education is the best provision
-for the journey to old age.]]]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Expanding:
- </para>
-<programlisting><!--quickbook-escape-prefix-->Here's a quote from [aristotle_quote].
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- We have:
- </para>
- <para>
- Here's a quote from Aristotle: <emphasis role="bold"><emphasis>Education
- is the best provision for the journey to old age.</emphasis></emphasis>.
- </para>
- <para>
- The disadvantage is that you can't avoid the space between the template
- identifier, <code><phrase role="identifier">aristotle_quote</phrase></code>,
- and the template body &quot;Aristotle...&quot;. This space will be part
- of the template body. If that space is unwanted, use empty brackets or
- use the space escape: &quot;<code><phrase role="special">\</phrase> </code>&quot;.
- Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[template tag\ _tag]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Then expanding:
- </para>
-<programlisting><!--quickbook-escape-prefix-->`struct` x[tag];
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- We have:
- </para>
- <para>
- <code><phrase role="keyword">struct</phrase></code> x_tag;
- </para>
- <para>
- You have a couple of ways to do it. I personally prefer the explicit empty
- brackets, though.
- </para>
- <bridgehead renderas="sect5" id="quickbook.syntax.block.templates.h5">
- <phrase id="quickbook.syntax.block.templates.simple_arguments"/><link linkend="quickbook.syntax.block.templates.simple_arguments">Simple
- Arguments</link>
- </bridgehead>
- <para>
- As mentioned, arguments are separated by the double dot <literal>&quot;..&quot;</literal>.
- If there are less arguments passed than expected, QuickBook attempts to
- break the last argument into two or more arguments following this logic:
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- Break the last argument into two, at the first space found (<literal>'',
- '\n', \t' or '\r'</literal>).
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Repeat until there are enough arguments or if there are no more spaces
- found (in which case, an error is reported).
- </simpara>
- </listitem>
- </itemizedlist>
- <para>
- For example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[template simple[a b c d] [a][b][c][d]]
-[simple w x y z]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will produce:
- </para>
- <para>
- wxyz
- </para>
- <para>
- &quot;w x y z&quot; is initially treated as a single argument because we
- didn't supply any <literal>&quot;..&quot;</literal> separators. However,
- since <literal>simple</literal> expects 4 arguments, &quot;w x y z&quot;
- is broken down iteratively (applying the logic above) until we have &quot;w&quot;,
- &quot;x&quot;, &quot;y&quot; and &quot;z&quot;.
- </para>
- <para>
- QuickBook only tries to get the arguments it needs. For example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[simple w x y z trail]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will produce:
- </para>
- <para>
- wxyz trail
- </para>
- <para>
- The arguments being: &quot;w&quot;, &quot;x&quot;, &quot;y&quot; and &quot;z
- trail&quot;.
- </para>
- <para>
- It should be obvious now that for simple arguments with no spaces, we can
- get by without separating the arguments with <literal>&quot;..&quot;</literal>
- separators. It is possible to combine <literal>&quot;..&quot;</literal>
- separators with the argument passing simplification presented above. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[simple what do you think ..m a n?]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will produce:
- </para>
- <para>
- what do you think man?
- </para>
- <bridgehead renderas="sect5" id="quickbook.syntax.block.templates.h6">
- <phrase id="quickbook.syntax.block.templates.punctuation_templates"/><link
- linkend="quickbook.syntax.block.templates.punctuation_templates">Punctuation
- Templates</link>
- </bridgehead>
- <para>
- With templates, one of our objectives is to allow us to rewrite QuickBook
- in QuickBook (as a qbk library). For that to happen, we need to accommodate
- single character punctuation templates which are fairly common in QuickBook.
- You might have noticed that single character punctuations are allowed as
- <link linkend="quickbook.syntax.block.templates.template_identifier">template
- identifiers</link>. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[template ![bar] <!--quickbook-escape-postfix-->&lt;hey&gt;<!--quickbook-escape-prefix-->[bar]<!--quickbook-escape-postfix-->&lt;/hey&gt;<!--quickbook-escape-prefix-->]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- Now, expanding this:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[!baz]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- We will have:
- </para>
-<programlisting>&lt;hey&gt;baz&lt;/hey&gt;
-</programlisting>
- </section>
- <section id="quickbook.syntax.block.blurbs">
- <title><link linkend="quickbook.syntax.block.blurbs">Blurbs</link></title>
-<programlisting><!--quickbook-escape-prefix-->[blurb :-) [*An eye catching advertisement or note...]
-
- __spirit__ is an object-oriented recursive-descent parser generator framework
- implemented using template meta-programming techniques. Expression templates
- allow us to approximate the syntax of Extended Backus-Normal Form (EBNF)
- completely in C++.
-]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate this:
- </para>
- <sidebar role="blurb">
- <para>
- <inlinemediaobject><imageobject><imagedata fileref="images/smiley.png"></imagedata></imageobject>
- <textobject>
- <phrase>smiley</phrase>
- </textobject>
- </inlinemediaobject> <emphasis role="bold">An eye catching advertisement
- or note...</emphasis>
- </para>
- <para>
- <ulink url="http://spirit.sourceforge.net">Spirit</ulink> is an object-oriented
- recursive-descent parser generator framework implemented using template
- meta-programming techniques. Expression templates allow us to approximate
- the syntax of Extended Backus-Normal Form (EBNF) completely in C++.
- </para>
- </sidebar>
- <note>
- <para>
- Prefer <link linkend="quickbook.syntax.block.admonitions">admonitions</link>
- wherever appropriate.
- </para>
- </note>
- </section>
- <section id="quickbook.syntax.block.tables">
- <title><link linkend="quickbook.syntax.block.tables">Tables</link></title>
-<programlisting><!--quickbook-escape-prefix-->[table A Simple Table
- [[Heading 1] [Heading 2] [Heading 3]]
- [[R0-C0] [R0-C1] [R0-C2]]
- [[R1-C0] [R1-C1] [R1-C2]]
- [[R2-C0] [R2-C1] [R2-C2]]
-]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <table frame="all" id="quickbook.syntax.block.tables.t0">
- <title>A Simple Table</title>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>
- <para>
- Heading 1
- </para>
- </entry>
- <entry>
- <para>
- Heading 2
- </para>
- </entry>
- <entry>
- <para>
- Heading 3
- </para>
- </entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>
- <para>
- R0-C0
- </para>
- </entry>
- <entry>
- <para>
- R0-C1
- </para>
- </entry>
- <entry>
- <para>
- R0-C2
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- R2-C0
- </para>
- </entry>
- <entry>
- <para>
- R2-C1
- </para>
- </entry>
- <entry>
- <para>
- R2-C2
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- R3-C0
- </para>
- </entry>
- <entry>
- <para>
- R3-C1
- </para>
- </entry>
- <entry>
- <para>
- R3-C2
- </para>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- <para>
- The table title is optional. The first row of the table is automatically
- treated as the table header; that is, it is wrapped in <literal>&lt;thead&gt;...&lt;/thead&gt;</literal>
- XML tags. Note that unlike the original QuickDoc, the columns are nested
- in [ cells... ]. The syntax is free-format and allows big cells to be formatted
- nicely. Example:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[table Table with fat cells
- [[Heading 1] [Heading 2]]
- [
- [Row 0, Col 0: a small cell]
- [
- Row 0, Col 1: a big fat cell with paragraphs
-
- Boost provides free peer-reviewed portable C++ source libraries.
-
- We emphasize libraries that work well with the C++ Standard Library.
- Boost libraries are intended to be widely useful, and usable across
- a broad spectrum of applications. The Boost license encourages both
- commercial and non-commercial use.
- ]
- ]
- [
- [Row 1, Col 0: a small cell]
- [Row 1, Col 1: a small cell]
- ]
-]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- and thus:
- </para>
- <table frame="all" id="quickbook.syntax.block.tables.t1">
- <title>Table with fat cells</title>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>
- <para>
- Heading 1
- </para>
- </entry>
- <entry>
- <para>
- Heading 2
- </para>
- </entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>
- <para>
- Row 0, Col 0: a small cell
- </para>
- </entry>
- <entry>
- <para>
- Row 0, Col 1: a big fat cell with paragraphs
- </para>
- <para>
- Boost provides free peer-reviewed portable C++ source libraries.
- </para>
- <para>
- We emphasize libraries that work well with the C++ Standard Library.
- Boost libraries are intended to be widely useful, and usable
- across a broad spectrum of applications. The Boost license encourages
- both commercial and non-commercial use.
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- Row 1, Col 0: a small cell
- </para>
- </entry>
- <entry>
- <para>
- Row 1, Col 1: a small cell
- </para>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- <para>
- Here's how to have preformatted blocks of code in a table cell:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[table Table with code
- [[Comment] [Code]]
- [
- [My first program]
- [<!--quickbook-escape-postfix-->``
- #include &lt;iostream&gt;
-
- int main()
- {
- std::cout &lt;&lt; &quot;Hello, World!&quot; &lt;&lt; std::endl;
- return 0;
- }
- ``<!--quickbook-escape-prefix-->]
- ]
-]
-<!--quickbook-escape-postfix--></programlisting>
- <table frame="all" id="quickbook.syntax.block.tables.t2">
- <title>Table with code</title>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>
- <para>
- Comment
- </para>
- </entry>
- <entry>
- <para>
- Code
- </para>
- </entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>
- <para>
- My first program
- </para>
- </entry>
- <entry>
- <para>
-<programlisting><phrase role="preprocessor">#include</phrase> <phrase role="special">&lt;</phrase><phrase role="identifier">iostream</phrase><phrase role="special">&gt;</phrase>
-
-<phrase role="keyword">int</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special">&lt;&lt;</phrase> <phrase role="string">&quot;Hello, World!&quot;</phrase> <phrase role="special">&lt;&lt;</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
- <phrase role="keyword">return</phrase> <phrase role="number">0</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase>
-</programlisting>
- </para>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </section>
- <section id="quickbook.syntax.block.variable_lists">
- <title><link linkend="quickbook.syntax.block.variable_lists">Variable Lists</link></title>
-<programlisting><!--quickbook-escape-prefix-->[variablelist A Variable List
- [[term 1] [The definition of term 1]]
- [[term 2] [The definition of term 2]]
- [[term 3] [The definition of term 3]]
-]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- will generate:
- </para>
- <variablelist>
- <title>A Variable List</title>
- <varlistentry>
- <term>term 1</term>
- <listitem>
- <para>
- The definition of term 1
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>term 2</term>
- <listitem>
- <para>
- The definition of term 2
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>term 3</term>
- <listitem>
- <para>
- The definition of term 3
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- <para>
- The rules for variable lists are the same as for tables, except that only
- 2 &quot;columns&quot; are allowed. The first column contains the terms,
- and the second column contains the definitions. Those familiar with HTML
- will recognize this as a &quot;definition list&quot;.
- </para>
- </section>
- <section id="quickbook.syntax.block.include">
- <title><link linkend="quickbook.syntax.block.include">Include</link></title>
- <para>
- You can include one QuickBook file from another. The syntax is simply:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[include someother.qbk]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- The included file will be processed as if it had been cut and pasted into
- the current document, with the following exceptions:
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- The __FILENAME__ predefined macro will reflect the name of the file currently being
- processed.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Any macros defined in the included file are scoped to that file.
- </simpara>
- </listitem>
- </itemizedlist>
- <para>
- The <literal>[include]</literal> directive lets you specify a document
- id to use for the included file. When this id is not explicitly specified,
- the id defaults to the filename (&quot;someother&quot;, in the example
- above). You can specify the id like this:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[include:someid someother.qbk]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- All auto-generated anchors will use the document id as a unique prefix.
- So for instance, if there is a top section in someother.qbk named &quot;Intro&quot;,
- the named anchor for that section will be &quot;someid.intro&quot;, and
- you can link to it with <literal>[link someid.intro The Intro]</literal>.
- </para>
- </section>
- <section id="quickbook.syntax.block.import">
- <title><link linkend="quickbook.syntax.block.import">Import</link></title>
- <para>
- When documenting code, you'd surely need to present code from actual source
- files. While it is possible to copy some code and paste them in your QuickBook
- file, doing so is error prone and the extracted code in the documentation
- tends to get out of sync with the actual code as the code evolves. The
- problem, as always, is that once documentation is written, the tendency
- is for the docs to languish in the archives without maintenance.
- </para>
- <para>
- QuickBook's import facility provides a nice solution.
- </para>
- <bridgehead renderas="sect5" id="quickbook.syntax.block.import.h0">
- <phrase id="quickbook.syntax.block.import.example"/><link linkend="quickbook.syntax.block.import.example">Example</link>
- </bridgehead>
- <para>
- You can effortlessly import code snippets from source code into your QuickBook.
- The following illustrates how this is done:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[import ../test/stub.cpp]
-[foo]
-[bar]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- The first line:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[import ../test/stub.cpp]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- collects specially marked-up code snippets from <ulink url="../../test/stub.cpp">stub.cpp</ulink>
- and places them in your QuickBook file as virtual templates. Each of the
- specially marked-up code snippets has a name (e.g. <code><phrase role="identifier">foo</phrase></code>
- and <code><phrase role="identifier">bar</phrase></code> in the example
- above). This shall be the template identifier for that particular code
- snippet. The second and third line above does the actual template expansion:
- </para>
-<programlisting><!--quickbook-escape-prefix-->[foo]
-[bar]
-<!--quickbook-escape-postfix--></programlisting>
- <para>
- And the result is:
- </para>
- <para>
- This is the <emphasis role="bold"><emphasis>foo</emphasis></emphasis> function.
- </para>
- <para>
- This description can have paragraphs...
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- lists
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- etc.
- </simpara>
- </listitem>
- </itemizedlist>
- <para>
- And any quickbook block markup.
- </para>
- <para>
-<programlisting><phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="identifier">foo</phrase><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
- <phrase role="comment">// return 'em, foo man!</phrase>
- <phrase role="keyword">return</phrase> <phrase role="string">&quot;foo&quot;</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase>
-</programlisting>
- </para>
- <para>
- This is the <emphasis role="bold"><emphasis>bar</emphasis></emphasis> function
- </para>
- <para>
-<programlisting><phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="identifier">bar</phrase><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
- <phrase role="comment">// return 'em, bar man!</phrase>
- <phrase role="keyword">return</phrase> <phrase role="string">&quot;bar&quot;</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase></programlisting>
- </para>
- <para>
- Some trailing text here
- </para>
- <bridgehead renderas="sect5" id="quickbook.syntax.block.import.h1">
- <phrase id="quickbook.syntax.block.import.code_snippet_markup"/><link linkend="quickbook.syntax.block.import.code_snippet_markup">Code
- Snippet Markup</link>
- </bridgehead>
- <para>
- Note how the code snippets in <ulink url="../../test/stub.cpp">stub.cpp</ulink>
- get marked up. We use distinguishable comments following the form:
- </para>
-<programlisting><phrase role="comment">//[id</phrase>
-<phrase role="identifier">some</phrase> <phrase role="identifier">code</phrase> <phrase role="identifier">here</phrase>
-<phrase role="comment">//]</phrase>
-</programlisting>
- <para>
- The first comment line above initiates a named code-snippet. This prefix
- will not be visible in quickbook. The entire code-snippet in between <code><phrase
- role="comment">//[id</phrase></code> and <code><phrase role="comment">//]</phrase></code>
- will be inserted as a template in quickbook with name <emphasis><emphasis>id</emphasis></emphasis>.
- The comment <code><phrase role="comment">//]</phrase></code> ends a code-snippet
- This too will not be visible in quickbook.
- </para>
- <bridgehead renderas="sect5" id="quickbook.syntax.block.import.h2">
- <phrase id="quickbook.syntax.block.import.special_comments"/><link linkend="quickbook.syntax.block.import.special_comments">Special
- Comments</link>
- </bridgehead>
- <para>
- Special comments of the form:
- </para>
-<programlisting><phrase role="comment">//` some [*quickbook] markup here</phrase>
-</programlisting>
- <para>
- and:
- </para>
-<programlisting><phrase role="comment">/*` some [*quickbook] markup here */</phrase>
-</programlisting>
- <para>
- will be parsed by QuickBook. This can contain quickbook <emphasis>blocks</emphasis>
- (e.g. sections, paragraphs, tables, etc). In the first case, the initial
- slash-slash, tick and white-space shall be ignored. In the second, the
- initial slash-star-tick and the final star-slash shall be ignored.
- </para>
- <bridgehead renderas="sect5" id="quickbook.syntax.block.import.h3">
- <phrase id="quickbook.syntax.block.import.callouts"/><link linkend="quickbook.syntax.block.import.callouts">Callouts</link>
- </bridgehead>
- <para>
- Special comments of the form:
- </para>
-<programlisting><phrase role="comment">/*&lt; some [*quickbook] markup here &gt;*/</phrase>
-</programlisting>
- <para>
- will be regarded as callouts. These will be collected, numbered and rendered
- as a &quot;callout bug&quot; (a small icon with a number). After the whole
- snippet is parsed, the callout list is generated. See <ulink url="http://www.docbook.org/tdg/en/html/callout.html">Callouts</ulink>
- for details. Example:
- </para>
- <para>
-<programlisting><phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">string</phrase> <phrase role="identifier">foo_bar</phrase><phrase role="special">()</phrase> <co id="quickbook.syntax.block.import.c0" linkends="quickbook.syntax.block.import.c1" />
-<phrase role="special">{</phrase>
- <phrase role="keyword">return</phrase> <phrase role="string">&quot;foo-bar&quot;</phrase><phrase role="special">;</phrase> <co id="quickbook.syntax.block.import.c2" linkends="quickbook.syntax.block.import.c3" />
-<phrase role="special">}</phrase>
-</programlisting>
- </para>
- <calloutlist>
- <callout arearefs="quickbook.syntax.block.import.c0" id="quickbook.syntax.block.import.c1">
- <para>
- The <emphasis>Mythical</emphasis> FooBar. See <ulink url="http://en.wikipedia.org/wiki/Foobar">Foobar
- for details</ulink>
- </para>
- </callout>
- <callout arearefs="quickbook.syntax.block.import.c2" id="quickbook.syntax.block.import.c3">
- <para>
- return 'em, foo-bar man!
- </para>
- </callout>
- </calloutlist>
- <para>
- Checkout <ulink url="../../test/stub.cpp">stub.cpp</ulink> to see the actual
- code.
- </para>
- </section>
- </section>
- </section>
- <section id="quickbook.install">
- <title><link linkend="quickbook.install">Installation and configuration</link></title>
- <para>
- This section provides some guidelines on how to install and configure BoostBook
- and Quickbook under several operating systems.
- </para>
- <para>
- Before continuing, it is very important that you keep this in mind: if you
- try to build some documents and the process breaks due to misconfiguration,
- be absolutely sure to delete any <code><phrase role="identifier">bin</phrase></code>
- and <code><phrase role="identifier">bin</phrase><phrase role="special">.</phrase><phrase
- role="identifier">v2</phrase></code> directories generated by the build before
- trying again. Otherwise your configuration fixes will not take any effect.
- </para>
- <section id="quickbook.install.windows">
- <title><link linkend="quickbook.install.windows">Windows 2000, XP, 2003, Vista</link></title>
- <blockquote>
- <para>
- <emphasis>Section contributed by Julio M. Merino Vidal</emphasis>
- </para>
- </blockquote>
- <para>
- The following instructions apply to any Windows system based on Windows 2000,
- including Windows XP, Windows 2003 Server and Windows Vista. The paths shown
- below are taken from a Windows Vista machine; you will need to adjust them
- to match your system in case you are running an older version.
- </para>
- <orderedlist>
- <listitem>
- <simpara>
- First of all you need to have a copy of <code><phrase role="identifier">xsltproc</phrase></code>
- for Windows. There are many ways to get this tool, but to keep things
- simple, use the <ulink url="http://www.zlatkovic.com/pub/libxml/">binary
- packages</ulink> made by Igor Zlatkovic. At the very least, you need
- to download the following packages: <code><phrase role="identifier">iconv</phrase></code>,
- <code><phrase role="identifier">zlib</phrase></code>, <code><phrase role="identifier">libxml2</phrase></code>
- and <code><phrase role="identifier">libxslt</phrase></code>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Unpack all these packages in the same directory so that you get unique
- <code><phrase role="identifier">bin</phrase></code>, <code><phrase role="identifier">include</phrase></code>
- and <code><phrase role="identifier">lib</phrase></code> directories within
- the hierarchy. These instructions use <code><phrase role="identifier">C</phrase><phrase
- role="special">:\</phrase><phrase role="identifier">Users</phrase><phrase
- role="special">\</phrase><phrase role="identifier">example</phrase><phrase
- role="special">\</phrase><phrase role="identifier">Documents</phrase><phrase
- role="special">\</phrase><phrase role="identifier">boost</phrase><phrase
- role="special">\</phrase><phrase role="identifier">xml</phrase></code>
- as the root for all files.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- From the command line, go to the <code><phrase role="identifier">bin</phrase></code>
- directory and launch <code><phrase role="identifier">xsltproc</phrase><phrase
- role="special">.</phrase><phrase role="identifier">exe</phrase></code>
- to ensure it works. You should get usage information on screen.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Download <ulink url="http://www.docbook.org/xml/4.2/docbook-xml-4.2.zip">Docbook
- XML 4.2</ulink> and unpack it in the same directory used above. That
- is: <code><phrase role="identifier">C</phrase><phrase role="special">:\</phrase><phrase
- role="identifier">Users</phrase><phrase role="special">\</phrase><phrase
- role="identifier">example</phrase><phrase role="special">\</phrase><phrase
- role="identifier">Documents</phrase><phrase role="special">\</phrase><phrase
- role="identifier">boost</phrase><phrase role="special">\</phrase><phrase
- role="identifier">xml</phrase><phrase role="special">\</phrase><phrase
- role="identifier">docbook</phrase><phrase role="special">-</phrase><phrase
- role="identifier">xml</phrase></code>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Download the latest <ulink url="http://sourceforge.net/project/showfiles.php?group_id=21935&amp;package_id=16608">Docbook
- XSL</ulink> version and unpack it, again in the same directory used before.
- To make things easier, rename the directory created during the extraction
- to <code><phrase role="identifier">docbook</phrase><phrase role="special">-</phrase><phrase
- role="identifier">xsl</phrase></code> (bypassing the version name):
- <code><phrase role="identifier">C</phrase><phrase role="special">:\</phrase><phrase
- role="identifier">Users</phrase><phrase role="special">\</phrase><phrase
- role="identifier">example</phrase><phrase role="special">\</phrase><phrase
- role="identifier">Documents</phrase><phrase role="special">\</phrase><phrase
- role="identifier">boost</phrase><phrase role="special">\</phrase><phrase
- role="identifier">xml</phrase><phrase role="special">\</phrase><phrase
- role="identifier">docbook</phrase><phrase role="special">-</phrase><phrase
- role="identifier">xsl</phrase></code>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Add the following to your <code><phrase role="identifier">user</phrase><phrase
- role="special">-</phrase><phrase role="identifier">config</phrase><phrase
- role="special">.</phrase><phrase role="identifier">jam</phrase></code>
- file, which should live in your home directory (<code><phrase role="special">%</phrase><phrase
- role="identifier">HOMEDRIVE</phrase><phrase role="special">%%</phrase><phrase
- role="identifier">HOMEPATH</phrase><phrase role="special">%</phrase></code>).
- You must already have it somewhere or otherwise you could not be building
- Boost (i.e. missing tools configuration).
- </simpara>
- </listitem>
- </orderedlist>
-<programlisting><phrase role="identifier">using</phrase> <phrase role="identifier">xsltproc</phrase>
- <phrase role="special">:</phrase> <phrase role="string">&quot;C:/Users/example/Documents/boost/xml/bin/xsltproc.exe&quot;</phrase>
- <phrase role="special">;</phrase>
-
-<phrase role="identifier">using</phrase> <phrase role="identifier">boostbook</phrase>
- <phrase role="special">:</phrase> <phrase role="string">&quot;C:/Users/example/Documents/boost/xml/docbook-xsl&quot;</phrase>
- <phrase role="special">:</phrase> <phrase role="string">&quot;C:/Users/example/Documents/boost/xml/docbook-xml&quot;</phrase>
- <phrase role="special">;</phrase>
-</programlisting>
- <para>
- The above steps are enough to get a functional BoostBook setup. Quickbook
- will be automatically built when needed. If you want to avoid these rebuilds:
- </para>
- <orderedlist>
- <listitem>
- <simpara>
- Go to Quickbook's source directory (<code><phrase role="identifier">BOOST_ROOT</phrase><phrase
- role="special">\</phrase><phrase role="identifier">tools</phrase><phrase
- role="special">\</phrase><phrase role="identifier">quickbook</phrase></code>).
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Build the utility by issuing <code><phrase role="identifier">bjam</phrase>
- <phrase role="special">--</phrase><phrase role="identifier">v2</phrase></code>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Copy the resulting <code><phrase role="identifier">quickbook</phrase><phrase
- role="special">.</phrase><phrase role="identifier">exe</phrase></code>
- binary (located under the <code><phrase role="identifier">BOOST_ROOT</phrase><phrase
- role="special">\</phrase><phrase role="identifier">bin</phrase><phrase
- role="special">.</phrase><phrase role="identifier">v2</phrase></code>
- hierarchy) to a safe place. Following our previous example, you can install
- it into: <code><phrase role="identifier">C</phrase><phrase role="special">:\</phrase><phrase
- role="identifier">Users</phrase><phrase role="special">\</phrase><phrase
- role="identifier">example</phrase><phrase role="special">\</phrase><phrase
- role="identifier">Documents</phrase><phrase role="special">\</phrase><phrase
- role="identifier">boost</phrase><phrase role="special">\</phrase><phrase
- role="identifier">xml</phrase><phrase role="special">\</phrase><phrase
- role="identifier">bin</phrase></code>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Add the following to your <code><phrase role="identifier">user</phrase><phrase
- role="special">-</phrase><phrase role="identifier">config</phrase><phrase
- role="special">.</phrase><phrase role="identifier">jam</phrase></code>
- file:
- </simpara>
- </listitem>
- </orderedlist>
-<programlisting><phrase role="identifier">using</phrase> <phrase role="identifier">quickbook</phrase>
- <phrase role="special">:</phrase> <phrase role="string">&quot;C:/Users/example/Documents/boost/xml/bin/quickbook.exe&quot;</phrase>
- <phrase role="special">;</phrase>
-</programlisting>
- </section>
- <section id="quickbook.install.linux">
- <title><link linkend="quickbook.install.linux">Debian, Ubuntu</link></title>
- <para>
- The following instructions apply to Debian and its derivatives. They are
- based on a Ubuntu Edgy install but should work on other Debian based systems.
- </para>
- <para>
- First install the <code><phrase role="identifier">bjam</phrase></code>,
- <code><phrase role="identifier">xsltproc</phrase></code>, <code><phrase role="identifier">docbook</phrase><phrase
- role="special">-</phrase><phrase role="identifier">xsl</phrase></code> and
- <code><phrase role="identifier">docbook</phrase><phrase role="special">-</phrase><phrase
- role="identifier">xml</phrase></code> packages. For example, using <code><phrase
- role="identifier">apt</phrase><phrase role="special">-</phrase><phrase role="identifier">get</phrase></code>:
- </para>
-<programlisting><phrase role="identifier">sudo</phrase> <phrase role="identifier">apt</phrase><phrase role="special">-</phrase><phrase role="identifier">get</phrase> <phrase role="identifier">install</phrase> <phrase role="identifier">xsltprc</phrase> <phrase role="identifier">docbook</phrase><phrase role="special">-</phrase><phrase role="identifier">xsl</phrase> <phrase role="identifier">docbook</phrase><phrase role="special">-</phrase><phrase role="identifier">xml</phrase>
-</programlisting>
- <para>
- If you're planning on building boost's documentation, you'll also need to
- install the <code><phrase role="identifier">doxygen</phrase></code> package
- as well.
- </para>
- <para>
- Next, we need to configure Boost Build to compile BoostBook files. Add the
- following to your <code><phrase role="identifier">user</phrase><phrase role="special">-</phrase><phrase
- role="identifier">config</phrase><phrase role="special">.</phrase><phrase
- role="identifier">jam</phrase></code> file, which should be in your home
- directory. If you don't have one, create a file containing this text. For
- more information on setting up <code><phrase role="identifier">user</phrase><phrase
- role="special">-</phrase><phrase role="identifier">config</phrase><phrase
- role="special">.</phrase><phrase role="identifier">jam</phrase></code>, see
- the <ulink url="http://boost.org/boost-build2/doc/html/bbv2/advanced/configuration.html">Boost
- Build documentation</ulink>.
- </para>
-<programlisting><phrase role="identifier">using</phrase> <phrase role="identifier">xsltproc</phrase> <phrase role="special">;</phrase>
-
-<phrase role="identifier">using</phrase> <phrase role="identifier">boostbook</phrase>
- <phrase role="special">:</phrase> <phrase role="special">/</phrase><phrase role="identifier">usr</phrase><phrase role="special">/</phrase><phrase role="identifier">share</phrase><phrase role="special">/</phrase><phrase role="identifier">xml</phrase><phrase role="special">/</phrase><phrase role="identifier">docbook</phrase><phrase role="special">/</phrase><phrase role="identifier">stylesheet</phrase><phrase role="special">/</phrase><phrase role="identifier">nwalsh</phrase>
- <phrase role="special">:</phrase> <phrase role="special">/</phrase><phrase role="identifier">usr</phrase><phrase role="special">/</phrase><phrase role="identifier">share</phrase><phrase role="special">/</phrase><phrase role="identifier">xml</phrase><phrase role="special">/</phrase><phrase role="identifier">docbook</phrase><phrase role="special">/</phrase><phrase role="identifier">schema</phrase><phrase role="special">/</phrase><phrase role="identifier">dtd</phrase><phrase role="special">/</phrase><phrase role="number">4.2</phrase>
- <phrase role="special">;</phrase>
-
-<phrase role="comment"># Remove this line if you're not using doxygen</phrase>
-<phrase role="identifier">using</phrase> <phrase role="identifier">doxygen</phrase> <phrase role="special">;</phrase>
-</programlisting>
- <para>
- The above steps are enough to get a functional BoostBook setup. Quickbook
- will be automatically built when needed. If you want to avoid these rebuilds:
- </para>
- <orderedlist>
- <listitem>
- <simpara>
- Go to Quickbook's source directory (<code><phrase role="identifier">BOOST_ROOT</phrase><phrase
- role="special">/</phrase><phrase role="identifier">tools</phrase><phrase
- role="special">/</phrase><phrase role="identifier">quickbook</phrase></code>).
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Build the utility by issuing <code><phrase role="identifier">bjam</phrase>
- <phrase role="special">--</phrase><phrase role="identifier">v2</phrase></code>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Copy the resulting <code><phrase role="identifier">quickbook</phrase></code>
- binary (located under the <code><phrase role="identifier">BOOST_ROOT</phrase><phrase
- role="special">/</phrase><phrase role="identifier">bin</phrase><phrase
- role="special">.</phrase><phrase role="identifier">v2</phrase></code>
- hierarchy) to a safe place. The traditional location is <code><phrase
- role="special">/</phrase><phrase role="identifier">usr</phrase><phrase
- role="special">/</phrase><phrase role="identifier">local</phrase><phrase
- role="special">/</phrase><phrase role="identifier">bin</phrase></code>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Add the following to your <code><phrase role="identifier">user</phrase><phrase
- role="special">-</phrase><phrase role="identifier">config</phrase><phrase
- role="special">.</phrase><phrase role="identifier">jam</phrase></code>
- file, using the full path of the quickbook executable:
- </simpara>
- </listitem>
- </orderedlist>
-<programlisting><phrase role="identifier">using</phrase> <phrase role="identifier">quickbook</phrase>
- <phrase role="special">:</phrase> <phrase role="special">/</phrase><phrase role="identifier">usr</phrase><phrase role="special">/</phrase><phrase role="identifier">local</phrase><phrase role="special">/</phrase><phrase role="identifier">bin</phrase><phrase role="special">/</phrase><phrase role="identifier">quickbook</phrase>
- <phrase role="special">;</phrase>
-</programlisting>
- </section>
- </section>
- <section id="quickbook.editors">
- <title><link linkend="quickbook.editors">Editor Support</link></title>
- <para>
- Editing quickbook files is usually done with text editors both simple and powerful.
- The following sections list the settings for some editors which can help make
- editing quickbook files a bit easier.
- </para>
- <sidebar role="blurb">
- <para>
- <inlinemediaobject><imageobject><imagedata fileref="images/note.png"></imagedata></imageobject>
- <textobject>
- <phrase>note</phrase>
- </textobject>
- </inlinemediaobject> You may submit your settings, tips, and suggestions to
- the authors, or through the <ulink url="https://lists.sourceforge.net/lists/listinfo/boost-">docs
- Boost Docs mailing list</ulink>.
- </para>
- </sidebar>
- <section id="quickbook.editors.scite">
- <title><link linkend="quickbook.editors.scite">Scintilla Text Editor</link></title>
- <blockquote>
- <para>
- <emphasis>Section contributed by Dean Michael Berris</emphasis>
- </para>
- </blockquote>
- <para>
- The Scintilla Text Editor (SciTE) is a free source code editor for Win32
- and X. It uses the SCIntilla source code editing component.
- </para>
- <sidebar role="blurb">
- <para>
- <inlinemediaobject><imageobject><imagedata fileref="images/tip.png"></imagedata></imageobject>
- <textobject>
- <phrase>tip</phrase>
- </textobject>
- </inlinemediaobject> SciTE can be downloaded from <ulink url="http://www.scintilla.org/SciTE.html">http://www.scintilla.org/SciTE.html>
- </para>
- </sidebar>
- <para>
- You can use the following settings to highlight quickbook tags when editing
- quickbook files.
- </para>
-<programlisting><!--quickbook-escape-prefix-->qbk=*.qbk
-lexer.*.qbk=props
-use.tabs.$(qbk)=0
-tab.size.$(qbk)=4
-indent.size.$(qbk)=4
-style.props.32=$(font.base)
-comment.stream.start.props=[/
-comment.stream.end.props=]
-comment.box.start.props=[/
-comment.box.middle.props=
-comment.box.end.props=]
-<!--quickbook-escape-postfix--></programlisting>
- <sidebar role="blurb">
- <para>
- <inlinemediaobject><imageobject><imagedata fileref="images/note.png"></imagedata></imageobject>
- <textobject>
- <phrase>note</phrase>
- </textobject>
- </inlinemediaobject> Thanks to Rene Rivera for the above SciTE settings.
- </para>
- </sidebar>
- </section>
- </section>
- <section id="quickbook.faq">
- <title><link linkend="quickbook.faq">Frequently Asked Questions</link></title>
- <bridgehead renderas="sect3" id="quickbook.faq.h0">
- <phrase id="quickbook.faq.can_i_use_quickbook_for_non_boost_documentation_"/><link
- linkend="quickbook.faq.can_i_use_quickbook_for_non_boost_documentation_">Can
- I use QuickBook for non-Boost documentation?</link>
- </bridgehead>
- <para>
- QuickBook can be used for non-Boost documentation with a little extra work.
- </para>
- <blockquote>
- <para>
- <emphasis>Faq contributed by Michael Marcin</emphasis>
- </para>
- </blockquote>
- <para>
- When building HTML documentation with BoostBook a Boost C++ Libraries header
- is added to the files. When using QuickBook to document projects outside of
- Boost this is not desirable. This behavior can be overridden at the BoostBook
- level by specifying some XSLT options. When using Boost Build version 2 (BBv2)
- this can be achieved by adding parameters to the BoostBook target declaration.
- </para>
- <para>
- For example:
- </para>
-<programlisting>using quickbook ;
-
-xml my_doc : my_doc.qbk ;
-
-boostbook standalone
- :
- my_doc
- :
- &lt;xsl:param&gt;boost.image.src=images/my_project_logo.png
- &lt;xsl:param&gt;boost.image.alt=&quot;\&quot;My Project\&quot;&quot;
- &lt;xsl:param&gt;boost.image.w=100
- &lt;xsl:param&gt;boost.image.h=50
- &lt;xsl:param&gt;nav.layout=none
- ;
-</programlisting>
- </section>
- <section id="quickbook.ref">
- <title><link linkend="quickbook.ref">Quick Reference</link></title>
- <para>
- [cpp]
- </para>
- <table frame="all" id="quickbook.ref.t0">
- <title>Syntax Compendium</title>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>
- <para>
- To do this...
- </para>
- </entry>
- <entry>
- <para>
- Use this...
- </para>
- </entry>
- <entry>
- <para>
- See this...
- </para>
- </entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>
- <para>
- comment
- </para>
- </entry>
- <entry>
- <para>
- <literal>[/ some comment]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.comments">Comments</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <emphasis>italics</emphasis>
- </para>
- </entry>
- <entry>
- <para>
- <literal>['italics] or /italics/</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.font_styles">Font Styles</link>
- and <link linkend="quickbook.syntax.phrase.simple_formatting">Simple
- formatting</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <emphasis role="bold">bold</emphasis>
- </para>
- </entry>
- <entry>
- <para>
- <literal>[*bold] or *bold*</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.font_styles">Font Styles</link>
- and <link linkend="quickbook.syntax.phrase.simple_formatting">Simple
- formatting</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <emphasis role="underline">underline</emphasis>
- </para>
- </entry>
- <entry>
- <para>
- <literal>[_underline] or _underline_</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.font_styles">Font Styles</link>
- and <link linkend="quickbook.syntax.phrase.simple_formatting">Simple
- formatting</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <literal>teletype</literal>
- </para>
- </entry>
- <entry>
- <para>
- <literal>[^teletype] or =teletype=</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.font_styles">Font Styles</link>
- and <link linkend="quickbook.syntax.phrase.simple_formatting">Simple
- formatting</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <emphasis role="strikethrough">strikethrough</emphasis>
- </para>
- </entry>
- <entry>
- <para>
- <literal>[-strikethrough]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.font_styles">Font Styles</link>
- and <link linkend="quickbook.syntax.phrase.simple_formatting">Simple
- formatting</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- <replaceable>replaceable</replaceable>
- </para>
- </entry>
- <entry>
- <para>
- <literal>[~replaceable]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.replaceable">Replaceble</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- source mode
- </para>
- </entry>
- <entry>
- <para>
- <literal>[c++]</literal> or <literal>[python]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.source_mode">Source Mode</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- inline code
- </para>
- </entry>
- <entry>
- <para>
- <literal>`int main();`</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.inline_code">Inline code</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- code block
- </para>
- </entry>
- <entry>
- <para>
- <literal>``int main();``</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.code">Code</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- code escape
- </para>
- </entry>
- <entry>
- <para>
- <literal>``from c++ to QuickBook``</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.escape_back">Escaping Back
- To QuickBook</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- line break
- </para>
- </entry>
- <entry>
- <para>
- <literal>[br] or \n</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.line_break">line-break</link>
- <emphasis role="bold">DEPRECATED</emphasis>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- anchor
- </para>
- </entry>
- <entry>
- <para>
- <literal>[#anchor]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.anchors">Anchors</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- link
- </para>
- </entry>
- <entry>
- <para>
- <literal>[@
http://www.boost.org Boost]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.links">Links</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- anchor link
- </para>
- </entry>
- <entry>
- <para>
- <literal>[link section.anchor Link text]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.anchor_links">Anchor links</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- refentry link
- </para>
- </entry>
- <entry>
- <para>
- <literal>[link xml.refentry Link text]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.refentry_links">refentry links</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- function link
- </para>
- </entry>
- <entry>
- <para>
- <literal>[funcref fully::qualified::function_name Link text]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.code_links">function, class,
- member, enum, macro, concept or header links</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- class link
- </para>
- </entry>
- <entry>
- <para>
- <literal>[classref fully::qualified::class_name Link text]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.code_links">function, class,
- member, enum, macro, concept or header links</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- member link
- </para>
- </entry>
- <entry>
- <para>
- <literal>[memberref fully::qualified::member_name Link text]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.code_links">function, class,
- member, enum, macro, concept or header links</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- enum link
- </para>
- </entry>
- <entry>
- <para>
- <literal>[enumref fully::qualified::enum_name Link text]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.code_links">function, class,
- member, enum, macro, concept or header links</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- macro link
- </para>
- </entry>
- <entry>
- <para>
- <literal>[macroref MACRO_NAME Link text]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.code_links">function, class,
- member, enum, macro, concept or header links</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- concept link
- </para>
- </entry>
- <entry>
- <para>
- <literal>[conceptref ConceptName Link text]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.code_links">function, class,
- member, enum, macro, concept or header links</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- header link
- </para>
- </entry>
- <entry>
- <para>
- <literal>[headerref path/to/header.hpp Link text]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.code_links">function, class,
- member, enum, macro, concept or header links</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- escape
- </para>
- </entry>
- <entry>
- <para>
- <literal>'''escaped text (no processing/formatting)'''</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.escape">Escape</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- single char escape
- </para>
- </entry>
- <entry>
- <para>
- <literal>\c</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.single_char_escape">Single
- char escape</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- images
- </para>
- </entry>
- <entry>
- <para>
- <literal>[$image.jpg]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.phrase.images">Images</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- begin section
- </para>
- </entry>
- <entry>
- <para>
- <literal>[section The Section Title]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.section">Section</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- end section
- </para>
- </entry>
- <entry>
- <para>
- <literal>[endsect]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.section">Section</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- paragraph
- </para>
- </entry>
- <entry>
- <para>
- No markup. Paragraphs start left-flushed and are terminated by two
- or more newlines.
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.paragraphs">Paragraphs</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- ordered list
- </para>
- </entry>
- <entry>
-<programlisting><!--quickbook-escape-prefix--># one
-# two
-# three
-<!--quickbook-escape-postfix--></programlisting>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.lists.ordered_lists">Ordered
- lists</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- unordered list
- </para>
- </entry>
- <entry>
-<programlisting><!--quickbook-escape-prefix-->* one
-* two
-* three
-<!--quickbook-escape-postfix--></programlisting>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.lists.unordered_lists">Unordered
- lists</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- code
- </para>
- </entry>
- <entry>
- <para>
- No markup. Preformatted code starts with a space or a tab.
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.code">Code</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- preformatted
- </para>
- </entry>
- <entry>
- <para>
- <literal>[pre preformatted]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.preformatted">Preformatted</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- block quote
- </para>
- </entry>
- <entry>
- <para>
- <literal>[:sometext...]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.blockquote">Blockquote</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- heading 1
- </para>
- </entry>
- <entry>
- <para>
- <literal>[h1 Heading 1]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.headings">Heading</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- heading 2
- </para>
- </entry>
- <entry>
- <para>
- <literal>[h2 Heading 2]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.headings">Heading</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- heading 3
- </para>
- </entry>
- <entry>
- <para>
- <literal>[h3 Heading 3]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.headings">Heading</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- heading 4
- </para>
- </entry>
- <entry>
- <para>
- <literal>[h4 Heading 4]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.headings">Heading</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- heading 5
- </para>
- </entry>
- <entry>
- <para>
- <literal>[h5 Heading 5]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.headings">Heading</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- heading 6
- </para>
- </entry>
- <entry>
- <para>
- <literal>[h6 Heading 6]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.headings">Heading</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- macro
- </para>
- </entry>
- <entry>
- <para>
- <literal>[def macro_identifier some text]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.macros">Macros</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- template
- </para>
- </entry>
- <entry>
- <para>
- <literal>[template[a b] [a] body [b]]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.templates">Templates</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- blurb
- </para>
- </entry>
- <entry>
- <para>
- <literal>[blurb advertisement or note...]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.blurbs">Blurbs</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- admonition
- </para>
- </entry>
- <entry>
- <para>
- <literal>[warning Warning text...]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.admonitions">Admonitions</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- table
- </para>
- </entry>
- <entry>
-<programlisting><!--quickbook-escape-prefix-->[table Title
-[[a][b][c]]
-[[a][b][c]]
-]
-<!--quickbook-escape-postfix--></programlisting>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.tables">Tables</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- variablelist
- </para>
- </entry>
- <entry>
-<programlisting><!--quickbook-escape-prefix-->[variablelist Title
-[[a][b]]
-[[a][b]]
-]
-<!--quickbook-escape-postfix--></programlisting>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.variable_lists">Variable Lists</link>
- </para>
- </entry>
- </row>
- <row>
- <entry>
- <para>
- include
- </para>
- </entry>
- <entry>
- <para>
- <literal>[include someother.qbk]</literal>
- </para>
- </entry>
- <entry>
- <para>
- <link linkend="quickbook.syntax.block.include">Include</link>
- </para>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/section_1_5-unclosed.gold
==============================================================================
--- trunk/tools/quickbook/test/section_1_5-unclosed.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,10 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="unclosed_section" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Unclosed section</title>
- <section id="unclosed_section.unclosed">
- <title><link linkend="unclosed_section.unclosed">Unclosed Section should be closed
- with a warning</link></title>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/section_1_5-unclosed.quickbook
==============================================================================
--- trunk/tools/quickbook/test/section_1_5-unclosed.quickbook 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,5 +0,0 @@
-[article Unclosed section
-[quickbook 1.5]
-]
-
-[section:unclosed Unclosed Section should be closed with a warning]
\ No newline at end of file

Deleted: trunk/tools/quickbook/test/template-section.gold
==============================================================================
--- trunk/tools/quickbook/test/template-section.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,22 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="section_in_a_template" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Section in a template</title>
- <para>
- Some text before the section.
- </para>
- <section id="section_in_a_template.test">
- <title><link linkend="section_in_a_template.test">Test</link></title>
- <para>
- Hello.
- </para>
- <bridgehead renderas="sect3" id="section_in_a_template.test.h0">
- <phrase id="section_in_a_template.test.just_to_test_id_generation"/><link linkend="section_in_a_template.test.just_to_test_id_generation">Just
- to test id generation</link>
- </bridgehead>
- <para>
- Goodbye.
- </para>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/templates.gold
==============================================================================
--- trunk/tools/quickbook/test/templates.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,193 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="templates" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $" xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Templates</title>
- <section id="templates.templates">
- <title><link linkend="templates.templates">Templates</link></title>
- <para>
- nullary_arg
- </para>
- <para>
- foo baz
- </para>
- <para>
- foo baz
- </para>
- <para>
- This is a complete paragraph. kalamazoo kalamazoo kalamazoo kalamazoo kalamazoo
- kalamazoo kalamazoo kalamazoo kalamazoo.... blah blah blah......
- </para>
- <para>
- <hey>baz</hey>
- </para>
- <para>
- This is a complete paragraph. madagascar madagascar madagascar madagascar madagascar
- madagascar madagascar madagascar madagascar.... blah blah blah......
- </para>
- <para>
- zoom peanut zoom
- </para>
- <para>
- exactly xanadu
- </para>
- <para>
- wx
- </para>
- <para>
- wxyz wxyz trail
- </para>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase>
-<phrase role="special">{</phrase>
- <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">cout</phrase> <phrase role="special">&lt;&lt;</phrase> &quot;Hello, World&quot; <phrase role="special">&lt;&lt;</phrase> <phrase role="identifier">std</phrase><phrase role="special">::</phrase><phrase role="identifier">endl</phrase><phrase role="special">;</phrase>
-<phrase role="special">}</phrase>
-</programlisting>
- <para>
- x<superscript>2</superscript>
- </para>
- <para>
- &alpha;<superscript>2</superscript>
- </para>
- <para>
- x<superscript>2</superscript>
- </para>
- <para>
- got a banana?
- </para>
- <para>
- .0 00
- </para>
- <para>
- [fool]
- </para>
- </section>
- <section id="templates.empty_templates">
- <title><link linkend="templates.empty_templates">Empty Templates</link></title>
- </section>
- <section id="templates.nested_templates">
- <title><link linkend="templates.nested_templates">Nested Templates</link></title>
- <para>
- Pre
- </para>
- <para>
- Start block template.
- </para>
- <para>
- Start block template.
- </para>
- <para>
- Hello!
- </para>
- <para>
- End block template.
- </para>
- <para>
- End block template.
- </para>
- <para>
- Post
- </para>
- <para>
- Pre
- </para>
- <para>
- Start block template.
- </para>
- <para>
- Start phrase template. Hello! End phrase template.
- </para>
- <para>
- End block template.
- </para>
- <para>
- Post
- </para>
- <para>
- Pre
- </para>
- <para>
- Start phrase template.
- </para>
- <para>
- Start block template.
- </para>
- <para>
- Hello!
- </para>
- <para>
- End block template.
- </para>
- <para>
- End phrase template.
- </para>
- <para>
- Post
- </para>
- <para>
- Pre Start phrase template. Start phrase template. Hello! End phrase template.
- End phrase template. Post
- </para>
- </section>
- <section id="templates.block_markup">
- <title><link linkend="templates.block_markup">Block Markup</link></title>
- <itemizedlist>
- <listitem>
- <simpara>
- a
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- b
- </simpara>
- </listitem>
- </itemizedlist>
- <para/>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase> <phrase role="special">{}</phrase>
-</programlisting>
- <para>
- Paragraphs 1
- </para>
- <para>
- Paragraphs 2
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- <itemizedlist>
- <listitem>
- <simpara>
- a
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- b
- </simpara>
- </listitem>
- </itemizedlist>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <para/>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
-<programlisting><phrase role="keyword">int</phrase> <phrase role="identifier">main</phrase><phrase role="special">()</phrase> <phrase role="special">{}</phrase>
-</programlisting>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <para>
- Paragraphs 1
- </para>
- <para>
- Paragraphs 2
- </para>
- </simpara>
- </listitem>
- </itemizedlist>
- </section>
-</article>

Deleted: trunk/tools/quickbook/test/unicode-escape.gold
==============================================================================
--- trunk/tools/quickbook/test/unicode-escape.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,156 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="utf_8_test" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $" xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>UTF-8 test</title>
- <bridgehead renderas="sect2" id="utf_8_test.h0">
- <phrase id="utf_8_test.i__xf1_t__xeb_rn__xe2_ti__xf4_n__xe0_liz__xe6_ti__xf8_n"/><link
- linkend="utf_8_test.i__xf1_t__xeb_rn__xe2_ti__xf4_n__xe0_liz__xe6_ti__xf8_n">I&#xF1;t&#xEB;rn&#xE2;ti&#xF4;n&#xE0;liz&#xE6;ti&#xF8;n</link>
- </bridgehead>
- <itemizedlist>
- <listitem>
- <simpara>
- &#x391;&#x3B1; Alpha
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x392;&#x3B2; Beta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x393;&#x3B3; Gamma
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x394;&#x3B4; Delta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x395;&#x3B5; Epsilon
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x396;&#x3B6; Zeta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x397;&#x3B7; Eta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x398;&#x3B8; Theta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x399;&#x3B9; Iota
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x39A;&#x3BA; Kappa
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x39B;&#x3BB; Lambda
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x39C;&#x3BC; Mu
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x39D;&#x3BD; Nu
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x39E;&#x3BE; Xi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x39F;&#x3BF; Omicron
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x3A0;&#x3C0; Pi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x3A1;&#x3C1; Rho
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x3A3;&#x3C3;&#x3C2; Sigma
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x3A4;&#x3C4; Tau
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x3A5;&#x3C5; Upsilon
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x3A6;&#x3C6; Phi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x3A7;&#x3C7; Chi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x3A8;&#x3C8; Psi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x3A9;&#x3C9; Omega
- </simpara>
- </listitem>
- </itemizedlist>
- <para>
- In the unlikely event that you've got a Mahjong font:
- </para>
- <itemizedlist>
- <listitem>
- <simpara>
- &#x1F000; East Wind
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x1F001; South Wind
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x1F002; West Wind
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- &#x1F003; North Wind
- </simpara>
- </listitem>
- </itemizedlist>
-</article>

Deleted: trunk/tools/quickbook/test/utf-8-bom.gold
==============================================================================
--- trunk/tools/quickbook/test/utf-8-bom.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,130 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="utf_8_test" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $" xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>UTF-8 test</title>
- <bridgehead renderas="sect2" id="utf_8_test.h0">
- <phrase id="utf_8_test.i__t__rn__ti__n__liz__ti__n"/><link linkend="utf_8_test.i__t__rn__ti__n__liz__ti__n">Iñtërnâtiônàlizætiøn</link>
- </bridgehead>
- <itemizedlist>
- <listitem>
- <simpara>
- Αα Alpha
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ββ Beta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Γγ Gamma
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Δδ Delta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Εε Epsilon
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ζζ Zeta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ηη Eta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Θθ Theta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ιι Iota
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Κκ Kappa
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Λλ Lambda
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Μμ Mu
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Νν Nu
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ξξ Xi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Οο Omicron
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ππ Pi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ρρ Rho
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Σσς Sigma
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ττ Tau
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Υυ Upsilon
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Φφ Phi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Χχ Chi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ψψ Psi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ωω Omega
- </simpara>
- </listitem>
- </itemizedlist>
-</article>

Deleted: trunk/tools/quickbook/test/utf-8.gold
==============================================================================
--- trunk/tools/quickbook/test/utf-8.gold 2011-11-27 16:41:42 EST (Sun, 27 Nov 2011)
+++ (empty file)
@@ -1,130 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE article PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
-<article id="utf_8_test" last-revision="DEBUG MODE Date: 2000/12/20 12:00:00 $" xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>UTF-8 test</title>
- <bridgehead renderas="sect2" id="utf_8_test.h0">
- <phrase id="utf_8_test.i__t__rn__ti__n__liz__ti__n"/><link linkend="utf_8_test.i__t__rn__ti__n__liz__ti__n">Iñtërnâtiônàlizætiøn</link>
- </bridgehead>
- <itemizedlist>
- <listitem>
- <simpara>
- Αα Alpha
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ββ Beta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Γγ Gamma
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Δδ Delta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Εε Epsilon
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ζζ Zeta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ηη Eta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Θθ Theta
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ιι Iota
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Κκ Kappa
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Λλ Lambda
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Μμ Mu
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Νν Nu
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ξξ Xi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Οο Omicron
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ππ Pi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ρρ Rho
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Σσς Sigma
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ττ Tau
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Υυ Upsilon
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Φφ Phi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Χχ Chi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ψψ Psi
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ωω Omega
- </simpara>
- </listitem>
- </itemizedlist>
-</article>


Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk