Update of /cvsroot/boost/boost/tools/quickbook/doc/html/quickbook/syntax
In directory
sc8-pr-cvs3.sourceforge.net:/tmp/cvs-serv1280/tools/quickbook/doc/html/quickbook/syntax
Modified Files:
block.html comments.html phrase.html
Log Message:
Merge in recent fixes for inspect errors.
Index: block.html
===================================================================
RCS file:
/cvsroot/boost/boost/tools/quickbook/doc/html/quickbook/syntax/block.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- block.html 10 Jul 2006 11:03:48 -0000 1.15
+++ block.html 27 Aug 2006 10:40:36 -0000 1.16
@@ -3,12 +3,11 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Block Level Elements</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.66.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<link rel="start" href="../../index.html" title="Quickbook 1.4">
<link rel="up" href="../syntax.html" title=" Syntax Summary">
<link rel="prev" href="phrase.html" title=" Phrase Level Elements">
-<link rel="next" href="../installation_and_configuration.html"
title="Installation
- and configuration">
+<link rel="next" href="../installation_and_configuration.html"
title="Installation and configuration">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"
alink="#0000FF">
<table cellpadding="2" width="100%">
@@ -25,7 +24,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="quickbook.syntax.block"></a><a href="block.html" title=" Block Level
Elements"> Block Level Elements</a></h3></div></div></div>
+<a name="quickbook.syntax.block"></a> Block Level
Elements</h3></div></div></div>
<div class="toc"><dl>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.document">Document</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.section">Section</a></span></dt>
@@ -33,16 +32,14 @@
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.paragraphs">Paragraphs</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.lists">Lists</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.code">Code</a></span></dt>
-<dt><span class="section"><a
href="block.html#quickbook.syntax.block.escape_back"> Escaping Back
- To QuickBook</a></span></dt>
+<dt><span class="section"><a
href="block.html#quickbook.syntax.block.escape_back"> Escaping Back To
QuickBook</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.preformatted">Preformatted</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.blockquote">Blockquote</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.admonitions">Admonitions</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.headings">Headings</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.generic_heading">Generic
Heading</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.macros">Macros</a></span></dt>
-<dt><span class="section"><a
href="block.html#quickbook.syntax.block.predefined_macros">Predefined
- Macros</a></span></dt>
+<dt><span class="section"><a
href="block.html#quickbook.syntax.block.predefined_macros">Predefined
Macros</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.templates">Templates</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.blurbs">Blurbs</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.tables">Tables</a></span></dt>
@@ -51,7 +48,7 @@
</dl></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.document"></a><a
href="block.html#quickbook.syntax.block.document"
title="Document">Document</a></h4></div></div></div>
+<a name="quickbook.syntax.block.document"></a>Document</h4></div></div></div>
<p>
Every document must begin with a Document Info section, which should
look
like this:
@@ -112,21 +109,21 @@
for. In its absence, version 1.1 is assumed.
</p>
<p>
- <tt class="literal">version</tt>, <tt class="literal">id</tt>, <tt
class="literal">dirname</tt>,
- <tt class="literal">copyright</tt>, <tt
class="literal">purpose</tt>, <tt class="literal">category</tt>,
- <tt class="literal">authors</tt>, <tt class="literal">license</tt>,
<tt class="literal">last-revision</tt>
- and <tt class="literal">source-mode</tt> are optional information.
+ <code class="literal">version</code>, <code
class="literal">id</code>, <code class="literal">dirname</code>,
+ <code class="literal">copyright</code>, <code
class="literal">purpose</code>, <code class="literal">category</code>,
+ <code class="literal">authors</code>, <code
class="literal">license</code>, <code class="literal">last-revision</code>
+ and <code class="literal">source-mode</code> are optional
information.
</p>
<p>
- <tt class="literal">source-type</tt> is a lowercase string setting
the initial
+ <code class="literal">source-type</code> is a lowercase string
setting the initial
<a href="phrase.html#quickbook.syntax.phrase.source_mode"
title="Source Mode">Source Mode</a>.
- If the <tt class="literal">source-mode</tt> field is omitted, a
default value
- of <tt class="literal">c++</tt> will be used.
+ If the <code class="literal">source-mode</code> field is omitted, a
default value
+ of <code class="literal">c++</code> will be used.
</p>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.section"></a><a
href="block.html#quickbook.syntax.block.section"
title="Section">Section</a></h4></div></div></div>
+<a name="quickbook.syntax.block.section"></a>Section</h4></div></div></div>
<p>
Starting a new section is accomplished with:
</p>
@@ -135,8 +132,8 @@
<p>
where <span class="emphasis"><em>id</em></span> is optional. id will
be the filename of the
generated section. If it is not present, "The Section Title"
- will be normalized and become the id. Valid characters are <tt
class="literal">a-Z</tt>,
- <tt class="literal">A-Z</tt>, <tt class="literal">0-9</tt> and <tt
class="literal">_</tt>.
+ will be normalized and become the id. Valid characters are <code
class="literal">a-Z</code>,
+ <code class="literal">A-Z</code>, <code class="literal">0-9</code>
and <code class="literal">_</code>.
All non-valid characters are converted to underscore and all
upper-case
are converted to lower case. Thus: "The Section Title" will be
normalized to "the_section_title".
@@ -152,7 +149,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.xinclude"></a><a
href="block.html#quickbook.syntax.block.xinclude"
title="xinclude">xinclude</a></h4></div></div></div>
+<a name="quickbook.syntax.block.xinclude"></a>xinclude</h4></div></div></div>
<p>
You can include another XML file with:
</p>
@@ -165,7 +162,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.paragraphs"></a><a
href="block.html#quickbook.syntax.block.paragraphs"
title="Paragraphs">Paragraphs</a></h4></div></div></div>
+<a
name="quickbook.syntax.block.paragraphs"></a>Paragraphs</h4></div></div></div>
<p>
Paragraphs start left-flushed and are terminated by two or more
newlines.
No markup is needed for paragraphs. QuickBook automatically detects
paragraphs
@@ -176,23 +173,17 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.lists"></a><a
href="block.html#quickbook.syntax.block.lists"
title="Lists">Lists</a></h4></div></div></div>
+<a name="quickbook.syntax.block.lists"></a>Lists</h4></div></div></div>
<div class="toc"><dl>
-<dt><span class="section"><a
href="block.html#quickbook.syntax.block.lists.ordered_lists">Ordered
- lists</a></span></dt>
-<dt><span class="section"><a
href="block.html#quickbook.syntax.block.lists.list_hierarchies">List
- Hierarchies</a></span></dt>
-<dt><span class="section"><a
href="block.html#quickbook.syntax.block.lists.long_list_lines">Long
- List Lines</a></span></dt>
-<dt><span class="section"><a
href="block.html#quickbook.syntax.block.lists.unordered_lists">Unordered
- lists</a></span></dt>
+<dt><span class="section"><a
href="block.html#quickbook.syntax.block.lists.ordered_lists">Ordered
lists</a></span></dt>
+<dt><span class="section"><a
href="block.html#quickbook.syntax.block.lists.list_hierarchies">List
Hierarchies</a></span></dt>
+<dt><span class="section"><a
href="block.html#quickbook.syntax.block.lists.long_list_lines">Long List
Lines</a></span></dt>
+<dt><span class="section"><a
href="block.html#quickbook.syntax.block.lists.unordered_lists">Unordered
lists</a></span></dt>
<dt><span class="section"><a
href="block.html#quickbook.syntax.block.lists.mixed_lists">Mixed
lists</a></span></dt>
</dl></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="quickbook.syntax.block.lists.ordered_lists"></a><a
href="block.html#quickbook.syntax.block.lists.ordered_lists" title="Ordered
- lists">Ordered
- lists</a></h5></div></div></div>
+<a name="quickbook.syntax.block.lists.ordered_lists"></a>Ordered
lists</h5></div></div></div>
<pre class="programlisting"># One
# Two
# Three
@@ -214,9 +205,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="quickbook.syntax.block.lists.list_hierarchies"></a><a
href="block.html#quickbook.syntax.block.lists.list_hierarchies" title="List
- Hierarchies">List
- Hierarchies</a></h5></div></div></div>
+<a name="quickbook.syntax.block.lists.list_hierarchies"></a>List
Hierarchies</h5></div></div></div>
<p>
List hierarchies are supported. Example:
</p>
@@ -277,9 +266,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="quickbook.syntax.block.lists.long_list_lines"></a><a
href="block.html#quickbook.syntax.block.lists.long_list_lines" title="Long
- List Lines">Long
- List Lines</a></h5></div></div></div>
+<a name="quickbook.syntax.block.lists.long_list_lines"></a>Long List
Lines</h5></div></div></div>
<p>
Long lines will be wrapped appropriately. Example:
</p>
@@ -308,9 +295,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="quickbook.syntax.block.lists.unordered_lists"></a><a
href="block.html#quickbook.syntax.block.lists.unordered_lists" title="Unordered
- lists">Unordered
- lists</a></h5></div></div></div>
+<a name="quickbook.syntax.block.lists.unordered_lists"></a>Unordered
lists</h5></div></div></div>
<pre class="programlisting">* First
* Second
* Third
@@ -332,7 +317,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="quickbook.syntax.block.lists.mixed_lists"></a><a
href="block.html#quickbook.syntax.block.lists.mixed_lists" title="Mixed
lists">Mixed lists</a></h5></div></div></div>
+<a name="quickbook.syntax.block.lists.mixed_lists"></a>Mixed
lists</h5></div></div></div>
<p>
Mixed lists (ordered and unordered) are supported. Example:
</p>
@@ -443,7 +428,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.code"></a><a
href="block.html#quickbook.syntax.block.code"
title="Code">Code</a></h4></div></div></div>
+<a name="quickbook.syntax.block.code"></a>Code</h4></div></div></div>
<p>
Preformatted code starts with a space or a tab. The code will be
syntax
highlighted according to the current <a
href="phrase.html#quickbook.syntax.phrase.source_mode" title="Source
Mode">Source
@@ -474,23 +459,21 @@
<p>
Macros that are already defined are expanded in source code. Example:
</p>
-<pre class="programlisting">[def __syntax_highlight__
[@quickbook/highlight.html syntax_highlight]]
-[def __quickbook__ [@index.html quickbook]]
+<pre class="programlisting">[def __array__
[@http://www.boost.org/doc/html/array/reference.html array]]
+[def __boost__ [@http://www.boost.org/libs/libraries.htm boost]]
- using __quickbook__::__syntax_highlight__;
+ using __boost__::__array__;
</pre>
<p>
Generates:
</p>
<pre class="programlisting">
-<span class="identifier">using</span> <a href="../../index.html"
target="_top">quickbook</a><span class="special">::</span><a
href="../highlight.html" target="_top">syntax_highlight</a><span
class="special">;</span>
+<span class="identifier">using</span> <a
href="http://www.boost.org/libs/libraries.htm"; target="_top">boost</a><span
class="special">::</span><a
href="http://www.boost.org/doc/html/array/reference.html";
target="_top">array</a><span class="special">;</span>
</pre>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.escape_back"></a><a
href="block.html#quickbook.syntax.block.escape_back" title=" Escaping Back
- To QuickBook"> Escaping Back
- To QuickBook</a></h4></div></div></div>
+<a name="quickbook.syntax.block.escape_back"></a> Escaping Back To
QuickBook</h4></div></div></div>
<p>
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
@@ -518,10 +501,10 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.preformatted"></a><a
href="block.html#quickbook.syntax.block.preformatted"
title="Preformatted">Preformatted</a></h4></div></div></div>
+<a
name="quickbook.syntax.block.preformatted"></a>Preformatted</h4></div></div></div>
<p>
Sometimes, you don't want some preformatted text to be parsed as
C++. In
- such cases, use the <tt class="literal">[pre ... ]</tt> markup block.
+ such cases, use the <code class="literal">[pre ... ]</code> markup
block.
</p>
<pre class="programlisting">[pre
@@ -538,21 +521,21 @@
level markup, pre (and Code) are the only ones that allow multiple
newlines.
The markup above will generate:
</p>
-<pre class="programlisting">Some <span class="bold"><b>preformatted</b></span>
text Some <span class="bold"><b>preformatted</b></span> text
+<pre class="programlisting">Some <span
class="bold"><strong>preformatted</strong></span> text Some
<span class="bold"><strong>preformatted</strong></span> text
- Some <span class="bold"><b>preformatted</b></span> text Some
<span class="bold"><b>preformatted</b></span> text
+ Some <span class="bold"><strong>preformatted</strong></span> text
Some <span class="bold"><strong>preformatted</strong></span> text
- Some <span class="bold"><b>preformatted</b></span> text Some <span
class="bold"><b>preformatted</b></span> text
+ Some <span class="bold"><strong>preformatted</strong></span> text
Some <span class="bold"><strong>preformatted</strong></span> text
</pre>
<p>
Notice that unlike Code, phrase markup such as font style is still
permitted
- inside <tt class="literal">pre</tt> blocks.
+ inside <code class="literal">pre</code> blocks.
</p>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.blockquote"></a><a
href="block.html#quickbook.syntax.block.blockquote"
title="Blockquote">Blockquote</a></h4></div></div></div>
+<a
name="quickbook.syntax.block.blockquote"></a>Blockquote</h4></div></div></div>
<pre class="programlisting">[:sometext...]
</pre>
<div class="blockquote"><blockquote class="blockquote"><p>
@@ -561,7 +544,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.admonitions"></a><a
href="block.html#quickbook.syntax.block.admonitions"
title="Admonitions">Admonitions</a></h4></div></div></div>
+<a
name="quickbook.syntax.block.admonitions"></a>Admonitions</h4></div></div></div>
<pre class="programlisting">[note This is a note]
[tip This is a tip]
[important This is important]
@@ -576,7 +559,7 @@
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"
src="../../images/note.png"></td>
<th align="left">Note</th>
</tr>
-<tr><td colspan="2" align="left" valign="top"><p>
+<tr><td align="left" valign="top"><p>
This is a note
</p></td></tr>
</table></div>
@@ -585,7 +568,7 @@
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]"
src="../../images/tip.png"></td>
<th align="left">Tip</th>
</tr>
-<tr><td colspan="2" align="left" valign="top"><p>
+<tr><td align="left" valign="top"><p>
This is a tip
</p></td></tr>
</table></div>
@@ -594,7 +577,7 @@
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]"
src="../../images/important.png"></td>
<th align="left">Important</th>
</tr>
-<tr><td colspan="2" align="left" valign="top"><p>
+<tr><td align="left" valign="top"><p>
This is important
</p></td></tr>
</table></div>
@@ -603,7 +586,7 @@
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]"
src="../../images/caution.png"></td>
<th align="left">Caution</th>
</tr>
-<tr><td colspan="2" align="left" valign="top"><p>
+<tr><td align="left" valign="top"><p>
This is a caution
</p></td></tr>
</table></div>
@@ -612,19 +595,19 @@
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]"
src="../../images/warning.png"></td>
<th align="left">Warning</th>
</tr>
-<tr><td colspan="2" align="left" valign="top"><p>
+<tr><td align="left" valign="top"><p>
This is a warning
</p></td></tr>
</table></div>
<p>
These are the only admonitions supported by <a
href="http://www.docbook.org/"; target="_top">DocBook</a>.
- So, for example <tt class="literal">[information This is some
information]</tt>
+ So, for example <code class="literal">[information This is some
information]</code>
is unlikely to produce the desired effect.
</p>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.headings"></a><a
href="block.html#quickbook.syntax.block.headings"
title="Headings">Headings</a></h4></div></div></div>
+<a name="quickbook.syntax.block.headings"></a>Headings</h4></div></div></div>
<pre class="programlisting">[h1 Heading 1]
[h2 Heading 2]
[h3 Heading 3]
@@ -633,36 +616,36 @@
[h6 Heading 6]
</pre>
<a name="quickbook.syntax.block.headings.heading_1"></a><h1>
-<a name="id445898"></a>
- <a
href="block.html#quickbook.syntax.block.headings.heading_1">Heading 1</a>
+<a name="id2558822"></a>
+ Heading 1
</h1>
<a name="quickbook.syntax.block.headings.heading_2"></a><h2>
-<a name="id445923"></a>
- <a
href="block.html#quickbook.syntax.block.headings.heading_2">Heading 2</a>
+<a name="id2558834"></a>
+ Heading 2
</h2>
<a name="quickbook.syntax.block.headings.heading_3"></a><h3>
-<a name="id445947"></a>
- <a
href="block.html#quickbook.syntax.block.headings.heading_3">Heading 3</a>
+<a name="id2558847"></a>
+ Heading 3
</h3>
<a name="quickbook.syntax.block.headings.heading_4"></a><h4>
-<a name="id445972"></a>
- <a
href="block.html#quickbook.syntax.block.headings.heading_4">Heading 4</a>
+<a name="id2558860"></a>
+ Heading 4
</h4>
<a name="quickbook.syntax.block.headings.heading_5"></a><h5>
-<a name="id445997"></a>
- <a
href="block.html#quickbook.syntax.block.headings.heading_5">Heading 5</a>
+<a name="id2558873"></a>
+ Heading 5
</h5>
<a name="quickbook.syntax.block.headings.heading_6"></a><h5>
-<a name="id446022"></a>
- <a
href="block.html#quickbook.syntax.block.headings.heading_6">Heading 6</a>
+<a name="id2558886"></a>
+ Heading 6
</h5>
<p>
Headings 1-3 [h1 h2 and h3] will automatically have anchors with
normalized
- names with <tt
class="literal">name="section_id.normalized_header_text"</tt>
- (i.e. valid characters are <tt class="literal">a-z</tt>, <tt
class="literal">A-Z</tt>,
- <tt class="literal">0-9</tt> and <tt class="literal">_</tt>. All
non-valid characters
+ names with <code
class="literal">name="section_id.normalized_header_text"</code>
+ (i.e. valid characters are <code class="literal">a-z</code>, <code
class="literal">A-Z</code>,
+ <code class="literal">0-9</code> and <code class="literal">_</code>.
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
<tt class="literal">section_2.heading_1</tt>).
+ For example: Heading 1 in section Section 2 will be normalized to
<code class="literal">section_2.heading_1</code>).
You can use:
</p>
<pre class="programlisting">[link section_id.normalized_header_text The link
text]
@@ -675,7 +658,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.generic_heading"></a><a
href="block.html#quickbook.syntax.block.generic_heading" title="Generic
Heading">Generic Heading</a></h4></div></div></div>
+<a name="quickbook.syntax.block.generic_heading"></a>Generic
Heading</h4></div></div></div>
<p>
In cases when you don't want to care about the heading level (1 to
6),
you can use the <span class="emphasis"><em>Generic
Heading</em></span>:
@@ -722,7 +705,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.macros"></a><a
href="block.html#quickbook.syntax.block.macros"
title="Macros">Macros</a></h4></div></div></div>
+<a name="quickbook.syntax.block.macros"></a>Macros</h4></div></div></div>
<pre class="programlisting">[def macro_identifier some text]
</pre>
<p>
@@ -746,19 +729,23 @@
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]"
src="../../images/tip.png"></td>
<th align="left">Tip</th>
</tr>
-<tr><td colspan="2" align="left" valign="top"><p>
+<tr><td align="left" valign="top"><p>
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. <tt class="literal">__spirit__</tt>). The reason
is to avoid unwanted
- macro replacement.
+ underscores (e.g. <code class="literal">
+__spirit__
+ </code>). The reason is to avoid unwanted macro replacement.
</p></td></tr>
</table></div>
<p>
- Links (URLS) and images are good candidates for macros. <span
class="bold"><b>1</b></span>)
+ Links (URLS) and images are good candidates for macros. <span
class="bold"><strong>1</strong></span>)
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. <span
class="bold"><b>2</b></span>)
- The syntax is not pretty. It's easier to read and write, e.g. <tt
class="literal">__spirit__</tt>
- than <tt class="literal">[@http://spirit.sourceforge.net
Spirit]</tt>.
+ in one place near the top to make it easy to make changes. <span
class="bold"><strong>2</strong></span>)
+ The syntax is not pretty. It's easier to read and write, e.g. <code
class="literal">
+__spirit__
+ </code> than <code class="literal">
+[@http://spirit.sourceforge.net Spirit]
+ </code>.
</p>
<p>
Some more examples:
@@ -784,15 +771,13 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.predefined_macros"></a><a
href="block.html#quickbook.syntax.block.predefined_macros" title="Predefined
- Macros">Predefined
- Macros</a></h4></div></div></div>
+<a name="quickbook.syntax.block.predefined_macros"></a>Predefined
Macros</h4></div></div></div>
<p>
Quickbook has some predefined macros that you can already use.
</p>
<div class="informaltable">
<h4>
-<a name="id446454"></a>
+<a name="id2559262"></a>
<span class="table-title">Predefined Macros</span>
</h4>
<table class="table">
@@ -808,19 +793,25 @@
</tr></thead>
<tbody>
<tr>
-<td>__DATE__</td>
+<td>
+__DATE__
+ </td>
<td>Today's date</td>
-<td>2006-Jul-10</td>
+<td>2006-Aug-27</td>
</tr>
<tr>
-<td>__TIME__</td>
+<td>
+__TIME__
+ </td>
<td>The current time</td>
-<td>06:58:47 PM</td>
+<td>11:12:00 AM</td>
</tr>
<tr>
-<td>__FILENAME__</td>
+<td>
+__FILENAME__
+ </td>
<td>Quickbook source filename</td>
-<td>C:\dev\boost\tools\quickbook\doc\quickbook.qbk</td>
+<td>/home/daniel/src/boost/tools/quickbook/doc/quickbook.qbk</td>
</tr>
</tbody>
</table>
@@ -828,7 +819,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.templates"></a><a
href="block.html#quickbook.syntax.block.templates"
title="Templates">Templates</a></h4></div></div></div>
+<a name="quickbook.syntax.block.templates"></a>Templates</h4></div></div></div>
<p>
Templates provide a more versatile text substitution mechanism.
Templates
come in handy when you need to create parameterizable, multi-line,
boilerplate
@@ -846,11 +837,18 @@
]
</pre>
-<a name="quickbook.syntax.block.templates.template_identifier"></a><h5>
-<a name="id446586"></a>
- <a
href="block.html#quickbook.syntax.block.templates.template_identifier">Template
- Identifier</a>
- </h5>
+<p>
+ [template person[name age what]
+ </p>
+<p>
+ Hi, my name is [name]. I am [age] years old. I am a [what].
+ </p>
+<p>
+ ]
+ </p>
+<p>
+ [heading Template Identifier]
+ </p>
<p>
Template identifiers can either consist of:
</p>
@@ -864,11 +862,9 @@
A single character punctuation (a non-alphanumeric printable
character)
</li>
</ul></div>
-<a name="quickbook.syntax.block.templates.formal_template_arguments"></a><h5>
-<a name="id446634"></a>
- <a
href="block.html#quickbook.syntax.block.templates.formal_template_arguments">Formal
- Template Arguments</a>
- </h5>
+<p>
+ [heading Formal Template Arguments]
+ </p>
<p>
Template formal arguments are identifiers consisting of an initial
alphabetic
character or the underscore, followed by zero or more alphanumeric
characters
@@ -876,19 +872,17 @@
</p>
<p>
A template formal argument temporarily hides a template of the same
name
- at the point where the <a
href="block.html#quickbook.syntax.block.templates.template_expansion">template
- is expanded</a>. Note that the body of the <tt
class="literal">person</tt>
- template above refers to <tt class="literal">name</tt> <tt
class="literal">age</tt>
- and <tt class="literal">what</tt> as <tt
class="literal">[name]</tt> <tt class="literal">[age]</tt>
- and <tt class="literal">[what]</tt>. <tt
class="literal">name</tt> <tt class="literal">age</tt>
- and <tt class="literal">what</tt> are actually templates that exist
in the duration
+ at the point where the <a href="../../">template
+ is expanded</a>. Note that the body of the <code
class="literal">person</code>
+ template above refers to <code class="literal">name</code> <code
class="literal">age</code>
+ and <code class="literal">what</code> as <code
class="literal">[name]</code> <code class="literal">[age]</code>
+ and <code class="literal">[what]</code>. <code
class="literal">name</code> <code class="literal">age</code>
+ and <code class="literal">what</code> are actually templates that
exist in the duration
of the template call.
</p>
-<a name="quickbook.syntax.block.templates.template_body"></a><h5>
-<a name="id446754"></a>
- <a
href="block.html#quickbook.syntax.block.templates.template_body">Template
- Body</a>
- </h5>
+<p>
+ [heading Template Body]
+ </p>
<p>
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
@@ -909,11 +903,9 @@
Phrase templates are typically expanded as part of phrases. Like
macros,
block level elements are not allowed in phrase templates.
</p>
-<a name="quickbook.syntax.block.templates.template_expansion"></a><h5>
-<a name="id446809"></a>
- <a
href="block.html#quickbook.syntax.block.templates.template_expansion">Template
- Expansion</a>
- </h5>
+<p>
+ [heading Template Expansion]
+ </p>
<p>
You expand a template this way:
</p>
@@ -930,23 +922,14 @@
Which will expand to:
</p>
<p>
- </p>
-<p>
- Hi, my name is James Bond. I am 39 years old. I am a Spy.
- </p>
-<p>
- </p>
-<p>
- Hi, my name is Santa Clause. I am 87 years old. I am a Big Red
Fatso.
- </p>
-<p>
+ [person James Bond..39..Spy] [person Santa Clause..87..Big Red Fatso]
</p>
<div class="caution"><table border="0" summary="Caution">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]"
src="../../images/caution.png"></td>
<th align="left">Caution</th>
</tr>
-<tr><td colspan="2" align="left" valign="top"><p>
+<tr><td align="left" valign="top"><p>
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.
@@ -957,20 +940,21 @@
<p>
Each actual argument can be a word, a text fragment or just about any
<a href="phrase.html" title=" Phrase Level Elements">QuickBook
phrase</a>. Arguments
- are separated by the double dot <tt class="literal">".."</tt> and
terminated
+ are separated by the double dot <code class="literal">".."</code>
and terminated
by the close parenthesis.
</p>
-<a name="quickbook.syntax.block.templates.nullary_templates"></a><h5>
-<a name="id446913"></a>
- <a
href="block.html#quickbook.syntax.block.templates.nullary_templates">Nullary
- Templates</a>
- </h5>
+<p>
+ [heading Nullary Templates]
+ </p>
<p>
Nullary templates look and act like simple macros. Example:
</p>
<pre class="programlisting">[template spirit[] [@http://spirit.sf.net Spirit]]
</pre>
<p>
+ [template spirit[] <a href="http://spirit.sf.net";
target="_top">Spirit</a>]
+ </p>
+<p>
Expanding:
</p>
<pre class="programlisting">Please see [spirit]'s site.
@@ -979,14 +963,14 @@
We have:
</p>
<p>
- Please see <a href="http://spirit.sf.net"; target="_top">Spirit</a>'s
site.
+ Please see [spirit]'s site.
</p>
<p>
The difference with macros are
</p>
<div class="itemizedlist"><ul type="disc">
<li>
- The explicit <a
href="block.html#quickbook.syntax.block.templates.template_expansion">template
+ The explicit <a href="../../">template
expansion syntax</a>. This is an advantage because, now, we don't
have to use obscure naming conventions like double underscores
(e.g.
__spirit__) to avoid unwanted macro replacement.
@@ -999,7 +983,7 @@
</li>
</ul></div>
<p>
- The empty brackets after the template identifier (<tt
class="literal">spirit[]</tt>)
+ The empty brackets after the template identifier (<code
class="literal">spirit[]</code>)
indicates no arguments. If the template body does not look like a
template
argument list (the example above does), we can elide the empty
brackets.
Example:
@@ -1008,6 +992,10 @@
for the journey to old age.]]]
</pre>
<p>
+ [template aristotle_quote Aristotle: <span
class="bold"><strong><span class="emphasis"><em>Education
+ is the best provision for the journey to old
age.</em></span></strong></span>]
+ </p>
+<p>
Expanding:
</p>
<pre class="programlisting">Here's a quote from [aristotle_quote].
@@ -1016,23 +1004,20 @@
We have:
</p>
<p>
- Here's a quote from Aristotle: <span class="bold"><b><span
class="emphasis"><em>Education
- is the best provision for the journey to old
age.</em></span></b></span>.
+ Here's a quote from [aristotle_quote].
</p>
-<a name="quickbook.syntax.block.templates.simple_arguments"></a><h5>
-<a name="id447057"></a>
- <a
href="block.html#quickbook.syntax.block.templates.simple_arguments">Simple
- Arguments</a>
- </h5>
<p>
- As mentioned, arguments are separated by the double dot <tt
class="literal">".."</tt>.
+ [heading Simple Arguments]
+ </p>
+<p>
+ As mentioned, arguments are separated by the double dot <code
class="literal">".."</code>.
If there are less arguments passed than expected, QuickBook attempts
to
break the last argument into two or more arguments following this
logic:
</p>
<div class="itemizedlist"><ul type="disc">
<li>
- Break the last argument into two, at the first space found (<tt
class="literal">'',
- '\n', \t' or '\r'</tt>).
+ Break the last argument into two, at the first space found (<code
class="literal">'',
+ '\n', \t' or '\r'</code>).
</li>
<li>
Repeat until there are enough arguments or if there are no more
spaces
@@ -1049,12 +1034,12 @@
will produce:
</p>
<p>
- wxyz
+ [template simple[a b c d] [a][b][c][d]] [simple w x y z]
</p>
<p>
"w x y z" is initially treated as a single argument because we
- didn't supply any <tt class="literal">".."</tt> separators. However,
- since <tt class="literal">simple</tt> expects 4 arguments, "w x y z"
+ didn't supply any <code class="literal">".."</code> separators.
However,
+ since <code class="literal">simple</code> expects 4 arguments, "w x
y z"
is broken down iteratively (applying the logic above) until we have
"w",
"x", "y" and "z".
</p>
@@ -1067,7 +1052,7 @@
will produce:
</p>
<p>
- wxyz trail
+ [simple w x y z trail]
</p>
<p>
The arguments being: "w", "x", "y" and "z
@@ -1075,8 +1060,8 @@
</p>
<p>
It should be obvious now that for simple arguments with no spaces,
we can
- get by without separating the arguments with <tt
class="literal">".."</tt>
- separators. It is possible to combine <tt class="literal">".."</tt>
+ get by without separating the arguments with <code
class="literal">".."</code>
+ separators. It is possible to combine <code
class="literal">".."</code>
separators with the argument passing simplification presented above.
Example:
</p>
<pre class="programlisting">[simple what do you think ..m a n?]
@@ -1085,19 +1070,17 @@
will produce:
</p>
<p>
- what do you think man?
+ [simple what do you think ..m a n?]
+ </p>
+<p>
+ [heading Punctuation Templates]
</p>
-<a name="quickbook.syntax.block.templates.punctuation_templates"></a><h5>
-<a name="id447224"></a>
- <a
href="block.html#quickbook.syntax.block.templates.punctuation_templates">Punctuation
- Templates</a>
- </h5>
<p>
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
- <a
href="block.html#quickbook.syntax.block.templates.template_identifier">template
+ <a href="../../">template
identifiers</a>. Example:
</p>
<pre class="programlisting">[template ![bar] <hey>[bar]</hey>]
@@ -1115,7 +1098,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.blurbs"></a><a
href="block.html#quickbook.syntax.block.blurbs"
title="Blurbs">Blurbs</a></h4></div></div></div>
+<a name="quickbook.syntax.block.blurbs"></a>Blurbs</h4></div></div></div>
<pre class="programlisting">[blurb :-) [*An eye catching advertisement or
note...]\n\n
__spirit__ is an object-oriented recursive-descent parser generator
framework
implemented using template meta-programming techniques. Expression
templates
@@ -1126,20 +1109,21 @@
<p>
will generate this:
</p>
-<p class="blurb">
- <span class="inlinemediaobject"><img src="../../images/smiley.png"
alt="smiley"></span> <span class="bold"><b>An eye catching advertisement
- or note...</b></span><br> <br> <a
href="http://spirit.sourceforge.net"; target="_top">Spirit</a>
- 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++.
- </p>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<tbody><tr><td class="blurb"> <span class="inlinemediaobject"><img
src="../../images/smiley.png" alt="smiley"></span> <span
class="bold"><strong>An eye catching advertisement
+ or note...</strong></span><br> <br> <a
href="http://spirit.sourceforge.net"; target="_top">Spirit</a>
+ 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++. </td></tr></tbody>
+</table></div>
<div class="note"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"
src="../../images/note.png"></td>
<th align="left">Note</th>
</tr>
-<tr><td colspan="2" align="left" valign="top"><p>
+<tr><td align="left" valign="top"><p>
Prefer <a href="block.html#quickbook.syntax.block.admonitions"
title="Admonitions">admonitions</a>
wherever appropriate.
</p></td></tr>
@@ -1147,7 +1131,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.tables"></a><a
href="block.html#quickbook.syntax.block.tables"
title="Tables">Tables</a></h4></div></div></div>
+<a name="quickbook.syntax.block.tables"></a>Tables</h4></div></div></div>
<pre class="programlisting">[table A Simple Table
[[Heading 1] [Heading 2] [Heading 3]]
[[R0-C0] [R0-C1] [R0-C2]]
@@ -1160,7 +1144,7 @@
</p>
<div class="informaltable">
<h4>
-<a name="id447423"></a>
+<a name="id2560038"></a>
<span class="table-title">A Simple Table</span>
</h4>
<table class="table">
@@ -1195,7 +1179,7 @@
</div>
<p>
The table title is optional. The first row of the table is
automatically
- treated as the table header; that is, it is wrapped in <tt
class="literal"><thead>...</thead></tt>
+ treated as the table header; that is, it is wrapped in <code
class="literal"><thead>...</thead></code>
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:
@@ -1222,7 +1206,7 @@
</p>
<div class="informaltable">
<h4>
-<a name="id447540"></a>
+<a name="id2560144"></a>
<span class="table-title">Table with fat cells</span>
</h4>
<table class="table">
@@ -1271,7 +1255,7 @@
</pre>
<div class="informaltable">
<h4>
-<a name="id447628"></a>
+<a name="id2560225"></a>
<span class="table-title">Table with code</span>
</h4>
<table class="table">
@@ -1302,7 +1286,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.variable_lists"></a><a
href="block.html#quickbook.syntax.block.variable_lists" title="Variable
Lists">Variable Lists</a></h4></div></div></div>
+<a name="quickbook.syntax.block.variable_lists"></a>Variable
Lists</h4></div></div></div>
<pre class="programlisting">[variablelist A Variable List
[[term 1] [The definition of term 1]]
[[term 2] [The definition of term 2]]
@@ -1338,7 +1322,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.block.include"></a><a
href="block.html#quickbook.syntax.block.include"
title="Include">Include</a></h4></div></div></div>
+<a name="quickbook.syntax.block.include"></a>Include</h4></div></div></div>
<p>
You can include one QuickBook file from another. The syntax is
simply:
</p>
@@ -1350,15 +1334,16 @@
</p>
<div class="itemizedlist"><ul type="disc">
<li>
- The __FILENAME__predefined macro will reflect the name of the file
currently being
- processed.
+ The
+__FILENAME__
+ predefined macro will reflect the name of the file currently being
processed.
</li>
<li>
Any macros defined in the included file are scoped to that file.
</li>
</ul></div>
<p>
- The <tt class="literal">[include]</tt> directive lets you specify a
document
+ The <code class="literal">[include]</code> 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 ("someother", in the example
above). You can specify the id like this:
@@ -1369,11 +1354,11 @@
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
"Intro",
the named anchor for that section will be "someid.intro", and
- you can link to it with <tt class="literal">[link someid.intro The
Intro]</tt>.
+ you can link to it with <code class="literal">[link someid.intro The
Intro]</code>.
</p>
</div>
</div>
-<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";
width="100%"><tr>
+<table width="100%"><tr>
<td align="left"></td>
<td align="right"><small>Copyright © 2002, 2004, 2006 Joel de Guzman,
Eric Niebler</small></td>
Index: comments.html
===================================================================
RCS file:
/cvsroot/boost/boost/tools/quickbook/doc/html/quickbook/syntax/comments.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- comments.html 7 Jun 2006 04:20:13 -0000 1.6
+++ comments.html 27 Aug 2006 10:40:36 -0000 1.7
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Comments</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.66.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<link rel="start" href="../../index.html" title="Quickbook 1.4">
<link rel="up" href="../syntax.html" title=" Syntax Summary">
<link rel="prev" href="../syntax.html" title=" Syntax Summary">
@@ -24,14 +24,14 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="quickbook.syntax.comments"></a><a href="comments.html"
title="Comments">Comments</a></h3></div></div></div>
+<a name="quickbook.syntax.comments"></a>Comments</h3></div></div></div>
<p>
Can be placed anywhere.
</p>
<pre class="programlisting">[/ comment (no output generated) ]
</pre>
</div>
-<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";
width="100%"><tr>
+<table width="100%"><tr>
<td align="left"></td>
<td align="right"><small>Copyright © 2002, 2004, 2006 Joel de Guzman,
Eric Niebler</small></td>
Index: phrase.html
===================================================================
RCS file:
/cvsroot/boost/boost/tools/quickbook/doc/html/quickbook/syntax/phrase.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- phrase.html 20 Jul 2006 13:23:49 -0000 1.15
+++ phrase.html 27 Aug 2006 10:40:36 -0000 1.16
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Phrase Level Elements</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.66.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<link rel="start" href="../../index.html" title="Quickbook 1.4">
<link rel="up" href="../syntax.html" title=" Syntax Summary">
<link rel="prev" href="comments.html" title="Comments">
@@ -24,7 +24,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="quickbook.syntax.phrase"></a><a href="phrase.html" title=" Phrase
Level Elements"> Phrase Level Elements</a></h3></div></div></div>
+<a name="quickbook.syntax.phrase"></a> Phrase Level
Elements</h3></div></div></div>
<div class="toc"><dl>
<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.font_styles">Font
Styles</a></span></dt>
<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.replaceable">Replaceable</a></span></dt>
@@ -40,21 +40,20 @@
<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.refentry_links">refentry
links</a></span></dt>
<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.code_links"> Code
Links</a></span></dt>
<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.escape">Escape</a></span></dt>
-<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.single_char_escape">Single
- char escape</a></span></dt>
+<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.single_char_escape">Single char
escape</a></span></dt>
<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.images">Images</a></span></dt>
<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.footnotes">Footnotes</a></span></dt>
</dl></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.font_styles"></a><a
href="phrase.html#quickbook.syntax.phrase.font_styles" title="Font Styles">Font
Styles</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.font_styles"></a>Font
Styles</h4></div></div></div>
<pre class="programlisting">['italic], [*bold], [_underline], [^teletype],
[-strikethrough]
</pre>
<p>
will generate:
</p>
<p>
- <span class="emphasis"><em>italic</em></span>, <span
class="bold"><b>bold</b></span>, <span class="underline">underline</span>, <tt
class="literal">teletype</tt>, <span class="strikethrough">strikethrough</span>
+ <span class="emphasis"><em>italic</em></span>, <span
class="bold"><strong>bold</strong></span>, <span
class="underline">underline</span>, <code class="literal">teletype</code>,
<span class="strikethrough">strikethrough</span>
</p>
<p>
Like all non-terminal phrase level elements, this can of course be
nested:
@@ -65,12 +64,12 @@
will generate:
</p>
<p>
- <span class="bold"><b><span
class="emphasis"><em>bold-italic</em></span></b></span>
+ <span class="bold"><strong><span
class="emphasis"><em>bold-italic</em></span></strong></span>
</p>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.replaceable"></a><a
href="phrase.html#quickbook.syntax.phrase.replaceable"
title="Replaceable">Replaceable</a></h4></div></div></div>
+<a
name="quickbook.syntax.phrase.replaceable"></a>Replaceable</h4></div></div></div>
<p>
When you want content that may or must be replaced by the user, use
the
syntax:
@@ -81,14 +80,14 @@
This will generate:
</p>
<p>
- <i class="replaceable"><tt>
+ <em class="replaceable"><code>
replacement
- </tt></i>
+ </code></em>
</p>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.quotations"></a><a
href="phrase.html#quickbook.syntax.phrase.quotations"
title="Quotations">Quotations</a></h4></div></div></div>
+<a
name="quickbook.syntax.phrase.quotations"></a>Quotations</h4></div></div></div>
<pre class="programlisting">["A question that sometimes drives me hazy: am I
or are the others crazy?]--Einstein
</pre>
<p>
@@ -119,7 +118,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.simple_formatting"></a><a
href="phrase.html#quickbook.syntax.phrase.simple_formatting" title="Simple
formatting">Simple formatting</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.simple_formatting"></a>Simple
formatting</h4></div></div></div>
<p>
Simple markup for formatting text, common in many applications, is
now
supported:
@@ -130,12 +129,12 @@
will generate:
</p>
<p>
- <span class="emphasis"><em>italic</em></span>, <span
class="bold"><b>bold</b></span>, <span class="underline">underline</span>, <tt
class="literal">teletype</tt>
+ <span class="emphasis"><em>italic</em></span>, <span
class="bold"><strong>bold</strong></span>, <span
class="underline">underline</span>, <code class="literal">teletype</code>
</p>
<p>
Unlike QuickBook's standard formatting scheme, the rules for simpler
alternatives
are much stricter
- <sup>[<a name="id373324" href="#ftn.id373324">1</a>]</sup>
+ <sup>[<a name="id2508579" href="#ftn.id2508579">1</a>]</sup>
.
</p>
<div class="itemizedlist"><ul type="disc">
@@ -161,14 +160,13 @@
</li>
<li>
A line starting with the star will be interpreted as an unordered
list.
- See <a
href="block.html#quickbook.syntax.block.lists.unordered_lists" title="Unordered
- lists">Unordered
+ See <a
href="block.html#quickbook.syntax.block.lists.unordered_lists" title="Unordered
lists">Unordered
lists</a>.
</li>
</ul></div>
<div class="informaltable">
<h4>
-<a name="id373404"></a>
+<a name="id2508760"></a>
<span class="table-title">More Formatting Samples</span>
</h4>
<table class="table">
@@ -182,69 +180,92 @@
</tr></thead>
<tbody>
<tr>
-<td><tt class="literal">*Bold*</tt></td>
-<td><span class="bold"><b>Bold</b></span></td>
+<td><code class="literal">
+*Bold*
+ </code></td>
+<td><span class="bold"><strong>Bold</strong></span></td>
</tr>
<tr>
-<td><tt class="literal">*Is bold*</tt></td>
-<td><span class="bold"><b>Is
- bold</b></span></td>
+<td><code class="literal">
+*Is bold*
+ </code></td>
+<td><span class="bold"><strong>Is bold</strong></span></td>
</tr>
<tr>
-<td><tt class="literal">* Not bold* *Not bold * * Not bold *</tt></td>
-<td>* Not bold* *Not bold *
- * Not bold *</td>
+<td><code class="literal">
+* Not bold* *Not bold * * Not bold *
+ </code></td>
+<td>* Not bold* *Not bold * * Not bold *</td>
</tr>
<tr>
-<td><tt class="literal">This*Isn't*Bold (no bold)</tt></td>
+<td><code class="literal">
+This*Isn't*Bold (no bold)
+ </code></td>
<td>This*Isn't*Bold (no bold)</td>
</tr>
<tr>
-<td><tt class="literal">(*Bold Inside*) (parenthesis not bold)</tt></td>
-<td>(<span class="bold"><b>Bold
- Inside</b></span>) (parenthesis not bold)</td>
+<td><code class="literal">
+(*Bold Inside*) (parenthesis not bold)
+ </code></td>
+<td>(<span class="bold"><strong>Bold Inside</strong></span>)
+ (parenthesis not bold)</td>
</tr>
<tr>
-<td><tt class="literal">*(Bold Outside)* (parenthesis bold)</tt></td>
+<td><code class="literal">
+*(Bold Outside)* (parenthesis bold)
+ </code></td>
<td>
-<span class="bold"><b>(Bold
- Outside)</b></span> (parenthesis bold)</td>
+<span class="bold"><strong>(Bold Outside)</strong></span>
+ (parenthesis bold)</td>
</tr>
<tr>
-<td><tt class="literal">3*4*5 = 60 (no bold)</tt></td>
+<td><code class="literal">
+3*4*5 = 60 (no bold)
+ </code></td>
<td>3*4*5 = 60 (no bold)</td>
</tr>
<tr>
-<td><tt class="literal">3 * 4 * 5 = 60 (no bold)</tt></td>
+<td><code class="literal">
+3 * 4 * 5 = 60 (no bold)
+ </code></td>
<td>3 * 4 * 5 = 60 (no bold)</td>
</tr>
<tr>
-<td><tt class="literal">3 *4* 5 = 60 (4 is bold)</tt></td>
-<td>3 <span class="bold"><b>4</b></span>
- 5 = 60 (4 is bold)</td>
+<td><code class="literal">
+3 *4* 5 = 60 (4 is bold)
+ </code></td>
+<td>3 <span class="bold"><strong>4</strong></span> 5 =
+ 60 (4 is bold)</td>
</tr>
<tr>
-<td><tt class="literal">*This is bold* this is not *but this is*</tt></td>
+<td><code class="literal">
+*This is bold* this is not *but this is*
+ </code></td>
<td>
-<span class="bold"><b>This
- is bold</b></span> this is not <span class="bold"><b>but this
is</b></span>
+<span class="bold"><strong>This is bold</strong></span>
+ this is not <span class="bold"><strong>but this
is</strong></span>
</td>
</tr>
<tr>
-<td><tt class="literal">*This is bold*.</tt></td>
+<td><code class="literal">
+*This is bold*.
+ </code></td>
<td>
-<span class="bold"><b>This
- is bold</b></span>.</td>
+<span class="bold"><strong>This is bold</strong></span>.</td>
</tr>
<tr>
-<td><tt class="literal">*B*. (bold B)</tt></td>
+<td><code class="literal">
+*B*. (bold B)
+ </code></td>
<td>
-<span class="bold"><b>B</b></span>.
- (bold B)</td>
+<span class="bold"><strong>B</strong></span>. (bold
+ B)</td>
</tr>
<tr>
-<td><tt class="literal">['*Bold-Italic*]</tt></td>
-<td><span class="emphasis"><em><span
class="bold"><b>Bold-Italic</b></span></em></span></td>
+<td><code class="literal">
+['*Bold-Italic*]
+ </code></td>
+<td><span class="emphasis"><em><span
class="bold"><strong>Bold-Italic</strong></span></em></span></td>
</tr>
</tbody>
</table>
@@ -252,7 +273,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.inline_code"></a><a
href="phrase.html#quickbook.syntax.phrase.inline_code" title="Inline
code">Inline code</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.inline_code"></a>Inline
code</h4></div></div></div>
<p>
Inlining code in paragraphs is quite common when writing C++
documentation.
We provide a very simple markup for this. For example, this:
@@ -263,30 +284,33 @@
will generate:
</p>
<p>
- This text has inlined code <tt class="computeroutput"><span
class="keyword">int</span> <span class="identifier">main</span><span
class="special">()</span> <span class="special">{</span> <span
class="keyword">return</span> <span class="number">0</span><span
class="special">;</span> <span class="special">}</span></tt> in it. The code
will be syntax highlighted.
+ This text has inlined code <code class="computeroutput"><span
class="keyword">int</span> <span class="identifier">main</span><span
class="special">()</span> <span class="special">{</span> <span
class="keyword">return</span> <span class="number">0</span><span
class="special">;</span> <span class="special">}</span></code> in it. The code
will be syntax highlighted.
</p>
<div class="note"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"
src="../../images/note.png"></td>
<th align="left">Note</th>
</tr>
-<tr><td colspan="2" align="left" valign="top"><p>
- We simply enclose the code with the tick: <tt
class="literal">"`"</tt>, not the
- single quote: <tt class="computeroutput"><span
class="string">"'"</span></tt>.
- Note too that <tt class="literal">`some code`</tt> is preferred
over <tt class="literal">[^some code]</tt>.
+<tr><td align="left" valign="top"><p>
+ We simply enclose the code with the tick: <code class="literal">
+"`"
+ </code>, not the single quote: <code class="computeroutput"><span
class="string">"'"</span></code>.
+ Note too that <code class="literal">
+`some code`
+ </code> is preferred over <code class="literal">
+[^some code]
+ </code>.
</p></td></tr>
</table></div>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.code_blocks"></a><a
href="phrase.html#quickbook.syntax.phrase.code_blocks" title="Code blocks">Code
blocks</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.code_blocks"></a>Code
blocks</h4></div></div></div>
<p>
Preformatted code simply starts with a space or a tab (See <a
href="block.html#quickbook.syntax.block.code" title="Code">Code</a>).
However, such a simple syntax cannot be used as phrase elements in
lists
- (See <a href="block.html#quickbook.syntax.block.lists.ordered_lists"
title="Ordered
- lists">Ordered
- lists</a> and <a
href="block.html#quickbook.syntax.block.lists.unordered_lists" title="Unordered
- lists">Unordered
+ (See <a href="block.html#quickbook.syntax.block.lists.ordered_lists"
title="Ordered lists">Ordered
+ lists</a> and <a
href="block.html#quickbook.syntax.block.lists.unordered_lists" title="Unordered
lists">Unordered
lists</a>), tables (See <a
href="block.html#quickbook.syntax.block.tables" title="Tables">Tables</a>),
etc. Inline code (see above) can. The problem is, inline code does
not
allow formatting with newlines, spaces, and tabs. These are lost.
@@ -326,7 +350,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.source_mode"></a><a
href="phrase.html#quickbook.syntax.phrase.source_mode" title="Source
Mode">Source Mode</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.source_mode"></a>Source
Mode</h4></div></div></div>
<p>
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
@@ -335,8 +359,8 @@
section.
</p>
<p>
- To change the source mode, use the <tt
class="literal">[source-mode]</tt> markup,
- where <tt class="literal">source-mode</tt> is one of the supported
modes. For
+ To change the source mode, use the <code
class="literal">[source-mode]</code> markup,
+ where <code class="literal">source-mode</code> is one of the
supported modes. For
example, this:
</p>
<pre class="programlisting">Python's [python] `import` is rather like C++'s
[c++] `#include`. A
@@ -347,14 +371,14 @@
will generate:
</p>
<p>
- Python's <tt class="computeroutput"><span
class="keyword">import</span></tt> is rather
- like C++'s <tt class="computeroutput"><span
class="preprocessor">#include</span></tt>.
- A C++ comment <tt class="computeroutput"><span class="comment">//
looks like this</span></tt>
- whereas a Python comment <tt class="computeroutput"><span
class="comment">#looks like this</span></tt>.
+ Python's <code class="computeroutput"><span
class="keyword">import</span></code> is rather
+ like C++'s <code class="computeroutput"><span
class="preprocessor">#include</span></code>.
+ A C++ comment <code class="computeroutput"><span class="comment">//
looks like this</span></code>
+ whereas a Python comment <code class="computeroutput"><span
class="comment">#looks like this</span></code>.
</p>
<div class="informaltable">
<h4>
-<a name="id443578"></a>
+<a name="id2556841"></a>
<span class="table-title">Supported Source Modes</span>
</h4>
<table class="table">
@@ -369,11 +393,11 @@
<tbody>
<tr>
<td>C++</td>
-<td><tt class="literal">[c++]</tt></td>
+<td><code class="literal">[c++]</code></td>
</tr>
<tr>
<td>Python</td>
-<td><tt class="literal">[python]</tt></td>
+<td><code class="literal">[python]</code></td>
</tr>
</tbody>
</table>
@@ -383,14 +407,14 @@
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"
src="../../images/note.png"></td>
<th align="left">Note</th>
</tr>
-<tr><td colspan="2" align="left" valign="top"><p>
+<tr><td align="left" valign="top"><p>
The source mode strings are lowercase.
</p></td></tr>
</table></div>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.line_break"></a><a
href="phrase.html#quickbook.syntax.phrase.line_break"
title="line-break">line-break</a></h4></div></div></div>
+<a
name="quickbook.syntax.phrase.line_break"></a>line-break</h4></div></div></div>
<pre class="programlisting">[br]
</pre>
<div class="note"><table border="0" summary="Note">
@@ -398,35 +422,37 @@
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]"
src="../../images/note.png"></td>
<th align="left">Note</th>
</tr>
-<tr><td colspan="2" align="left" valign="top"><p>
- Note that <tt class="computeroutput"><span
class="special">\</span><span class="identifier">n</span></tt>
- is now preferred over <tt class="computeroutput"><span
class="special">[</span><span class="identifier">br</span><span
class="special">]</span></tt>.
+<tr><td align="left" valign="top"><p>
+ Note that <code class="computeroutput"><span
class="special">\</span><span class="identifier">n</span></code>
+ is now preferred over <code class="computeroutput"><span
class="special">[</span><span class="identifier">br</span><span
class="special">]</span></code>.
</p></td></tr>
</table></div>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.anchors"></a><a
href="phrase.html#quickbook.syntax.phrase.anchors"
title="Anchors">Anchors</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.anchors"></a>Anchors</h4></div></div></div>
<pre class="programlisting">[#named_anchor]
</pre>
<p>
A named anchor is a hook that can be referenced by a link elsewhere
in
- the document. You can then reference an anchor with <tt
class="literal">[link named_anchor
-Some link text]</tt>.
- See <a href="phrase.html#quickbook.syntax.phrase.anchor_links"
title="Anchor links">Anchor links</a>,
- <a href="block.html#quickbook.syntax.block.section"
title="Section">Section</a> and <a
href="block.html#quickbook.syntax.block.headings" title="Headings">Heading</a>.
+ the document. You can then reference an anchor with <code
class="literal">
+[link named_anchor
+Some link text]
+ </code>. See <a
href="phrase.html#quickbook.syntax.phrase.anchor_links" title="Anchor
links">Anchor
+ links</a>, <a href="block.html#quickbook.syntax.block.section"
title="Section">Section</a>
+ and <a href="block.html#quickbook.syntax.block.headings"
title="Headings">Heading</a>.
</p>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.links"></a><a
href="phrase.html#quickbook.syntax.phrase.links"
title="Links">Links</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.links"></a>Links</h4></div></div></div>
<pre class="programlisting">[@http://www.boost.org this is [*boost's]
website....]
</pre>
<p>
will generate:
</p>
<p>
- <a href="http://www.boost.org"; target="_top">this is <span
class="bold"><b>boost's</b></span>
+ <a href="http://www.boost.org"; target="_top">this is <span
class="bold"><strong>boost's</strong></span>
website....</a>
</p>
<p>
@@ -448,7 +474,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.anchor_links"></a><a
href="phrase.html#quickbook.syntax.phrase.anchor_links" title="Anchor
links">Anchor links</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.anchor_links"></a>Anchor
links</h4></div></div></div>
<p>
You can link within a document using:
</p>
@@ -462,15 +488,15 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.refentry_links"></a><a
href="phrase.html#quickbook.syntax.phrase.refentry_links" title="refentry
links">refentry links</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.refentry_links"></a>refentry
links</h4></div></div></div>
<p>
In addition, you can link internally to an XML refentry like:
</p>
<pre class="programlisting">[link xml.refentry The link text]
</pre>
<p>
- This gets converted into <tt class="literal"><link
linkend="xml.refentry">The
- link text</link></tt>.
+ This gets converted into <code class="literal"><link
linkend="xml.refentry">The
+ link text</link></code>.
</p>
<p>
Like URLs, the link text is optional. If this is not present, the
link
@@ -479,12 +505,12 @@
<pre class="programlisting">[link xml.refentry]
</pre>
<p>
- This gets converted into <tt class="literal"><link
linkend="xml.refentry">xml.refentry</link></tt>.
+ This gets converted into <code class="literal"><link
linkend="xml.refentry">xml.refentry</link></code>.
</p>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.code_links"></a><a
href="phrase.html#quickbook.syntax.phrase.code_links" title=" Code Links"> Code
Links</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.code_links"></a> Code
Links</h4></div></div></div>
<p>
If you want to link to a function, class, member, enum or header in
the
reference section, you can use:
@@ -507,7 +533,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.escape"></a><a
href="phrase.html#quickbook.syntax.phrase.escape"
title="Escape">Escape</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.escape"></a>Escape</h4></div></div></div>
<p>
The escape mark-up is used when we don't want to do any processing.
</p>
@@ -524,7 +550,8 @@
'''
</pre>
<p>
- <span class="bold"><b>This is direct XML markup</b></span>
+
+<span class="bold"><strong>This is direct XML markup</strong></span>
</p>
<div class="important"><table border="0" summary="Important">
@@ -532,60 +559,54 @@
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]"
src="../../images/important.png"></td>
<th align="left">Important</th>
</tr>
-<tr><td colspan="2" align="left" valign="top"><p>
+<tr><td align="left" valign="top"><p>
Be careful when using the escape. The text must conform to <a
href="http://www.boost.org/doc/html/boostbook.html";
target="_top">BoostBook</a>/<a href="http://www.docbook.org/";
target="_top">DocBook</a> syntax.
</p></td></tr>
</table></div>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.single_char_escape"></a><a
href="phrase.html#quickbook.syntax.phrase.single_char_escape" title="Single
- char escape">Single
- char escape</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.single_char_escape"></a>Single char
escape</h4></div></div></div>
<p>
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
<tt class="computeroutput"><span class="special">[</span></tt> and <tt
class="computeroutput"><span class="special">]</span></tt>.
- For example, how do you escape the triple quote? Simple: <tt
class="literal">\'\'\'</tt>
+ This is useful when we need to escape QuickBook punctuations such as
<code class="computeroutput"><span class="special">[</span></code> and <code
class="computeroutput"><span class="special">]</span></code>.
+ For example, how do you escape the triple quote? Simple: <code
class="literal">\'\'\'</code>
</p>
<p>
- <tt class="computeroutput"><span class="special">\</span><span
class="identifier">n</span></tt>
- has a special meaning. It is used to generate line breaks. Note that
<tt class="computeroutput"><span class="special">\</span><span
class="identifier">n</span></tt> is
- now preferred over <tt class="computeroutput"><span
class="special">[</span><span class="identifier">br</span><span
class="special">]</span></tt>.
+ <code class="computeroutput"><span class="special">\</span><span
class="identifier">n</span></code>
+ has a special meaning. It is used to generate line breaks. Note that
<code class="computeroutput"><span class="special">\</span><span
class="identifier">n</span></code> is
+ now preferred over <code class="computeroutput"><span
class="special">[</span><span class="identifier">br</span><span
class="special">]</span></code>.
</p>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.images"></a><a
href="phrase.html#quickbook.syntax.phrase.images"
title="Images">Images</a></h4></div></div></div>
+<a name="quickbook.syntax.phrase.images"></a>Images</h4></div></div></div>
<pre class="programlisting">[$image.jpg]
</pre>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="quickbook.syntax.phrase.footnotes"></a><a
href="phrase.html#quickbook.syntax.phrase.footnotes"
title="Footnotes">Footnotes</a></h4></div></div></div>
+<a
name="quickbook.syntax.phrase.footnotes"></a>Footnotes</h4></div></div></div>
<div class="toc"><dl>
-<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.footnotes.macro_expansion">Macro
- Expansion</a></span></dt>
-<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.footnotes.template_expansion">Template
- Expansion</a></span></dt>
+<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.footnotes.macro_expansion">Macro
Expansion</a></span></dt>
+<dt><span class="section"><a
href="phrase.html#quickbook.syntax.phrase.footnotes.template_expansion">Template
Expansion</a></span></dt>
</dl></div>
<p>
As of version 1.3, QuickBook supports footnotes. Just put the text
of the
- footnote in a <tt class="computeroutput"><span
class="special">[</span><span class="identifier">footnote</span><span
class="special">]</span></tt> block, and the text will be put at the
+ footnote in a <code class="computeroutput"><span
class="special">[</span><span class="identifier">footnote</span><span
class="special">]</span></code> block, and the text will be put at the
bottom of the current page. For example, this:
</p>
<pre class="programlisting">[footnote A sample footnote]
</pre>
<p>
will generate this
- <sup>[<a name="id444320" href="#ftn.id444320">2</a>]</sup>
+ <sup>[<a name="id2557467" href="#ftn.id2557467">2</a>]</sup>
.
</p>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="quickbook.syntax.phrase.footnotes.macro_expansion"></a><a
href="phrase.html#quickbook.syntax.phrase.footnotes.macro_expansion"
title="Macro
- Expansion">Macro
- Expansion</a></h5></div></div></div>
+<a name="quickbook.syntax.phrase.footnotes.macro_expansion"></a>Macro
Expansion</h5></div></div></div>
<pre class="programlisting">__a_macro_identifier__
</pre>
<p>
@@ -594,9 +615,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="quickbook.syntax.phrase.footnotes.template_expansion"></a><a
href="phrase.html#quickbook.syntax.phrase.footnotes.template_expansion"
title="Template
- Expansion">Template
- Expansion</a></h5></div></div></div>
+<a name="quickbook.syntax.phrase.footnotes.template_expansion"></a>Template
Expansion</h5></div></div></div>
<pre class="programlisting">[a_template_identifier]
</pre>
<p>
@@ -607,19 +626,19 @@
</div>
<div class="footnotes">
<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a name="ftn.id373324" href="#id373324">1</a>]
</sup>
+<div class="footnote"><p><sup>[<a name="ftn.id2508579"
href="#id2508579">1</a>] </sup>
Thanks to David Barrett, author of <a
href="http://quinthar.com/qwikiwiki/index.php?page=Home";
target="_top">Qwiki</a>,
for sharing these samples and teaching me these obscure
formatting
rules. I wasn't sure at all if <a
href="http://spirit.sourceforge.net"; target="_top">Spirit</a>,
being more or less a formal EBNF parser, can handle the context
sensitivity
and ambiguity.
</p></div>
-<div class="footnote"><p><sup>[<a name="ftn.id444320" href="#id444320">2</a>]
</sup>
+<div class="footnote"><p><sup>[<a name="ftn.id2557467"
href="#id2557467">2</a>] </sup>
A sample footnote
</p></div>
</div>
</div>
-<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";
width="100%"><tr>
+<table width="100%"><tr>
<td align="left"></td>
<td align="right"><small>Copyright © 2002, 2004, 2006 Joel de Guzman,
Eric Niebler</small></td>
-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 _______________________________________________
Boost-cvs mailing list
Boost-cvs@xxxxxxxxxxxxxxxxxxxxx
https://lists.sourceforge.net/lists/listinfo/boost-cvs
|
