Update of /cvsroot/boost/boost/tools/quickbook/doc/html/quickbook/syntax
In directory sc8-pr-cvs3.sourceforge.net:/tmp/cvs-serv16096/quickbook/syntax
Modified Files:
block.html phrase.html
Log Message:
Conditional Generation
Index: block.html
===================================================================
RCS file:
/cvsroot/boost/boost/tools/quickbook/doc/html/quickbook/syntax/block.html,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -d -r1.43 -r1.44
--- block.html 21 Jul 2007 04:56:36 -0000 1.43
+++ block.html 28 Jul 2007 08:13:34 -0000 1.44
@@ -674,27 +674,27 @@
[h6 Heading 6]
</pre>
<a name="quickbook.syntax.block.headings.heading_1"></a><h1>
-<a name="id459478"></a>
+<a name="id459579"></a>
<a
href="block.html#quickbook.syntax.block.headings.heading_1">Heading 1</a>
</h1>
<a name="quickbook.syntax.block.headings.heading_2"></a><h2>
-<a name="id459502"></a>
+<a name="id459603"></a>
<a
href="block.html#quickbook.syntax.block.headings.heading_2">Heading 2</a>
</h2>
<a name="quickbook.syntax.block.headings.heading_3"></a><h3>
-<a name="id459526"></a>
+<a name="id459628"></a>
<a
href="block.html#quickbook.syntax.block.headings.heading_3">Heading 3</a>
</h3>
<a name="quickbook.syntax.block.headings.heading_4"></a><h4>
-<a name="id459551"></a>
+<a name="id459652"></a>
<a
href="block.html#quickbook.syntax.block.headings.heading_4">Heading 4</a>
</h4>
<a name="quickbook.syntax.block.headings.heading_5"></a><h5>
-<a name="id459576"></a>
+<a name="id459677"></a>
<a
href="block.html#quickbook.syntax.block.headings.heading_5">Heading 5</a>
</h5>
<a name="quickbook.syntax.block.headings.heading_6"></a><h5>
-<a name="id459601"></a>
+<a name="id459702"></a>
<a
href="block.html#quickbook.syntax.block.headings.heading_6">Heading 6</a>
</h5>
<p>
@@ -838,7 +838,7 @@
Quickbook has some predefined macros that you can already use.
</p>
<div class="table">
-<a name="id460055"></a><p class="title"><b>Table 3. Predefined Macros</b></p>
+<a name="id460162"></a><p class="title"><b>Table 3. Predefined Macros</b></p>
<table class="table" summary="Predefined Macros">
<colgroup>
<col>
@@ -876,7 +876,7 @@
</td>
<td>
<p>
- 2007-Jul-21
+ 2007-Jul-28
</p>
</td>
</tr>
@@ -893,7 +893,7 @@
</td>
<td>
<p>
- 12:53:44 PM
+ 04:11:46 PM
</p>
</td>
</tr>
@@ -939,7 +939,7 @@
]
</pre>
<a name="quickbook.syntax.block.templates.template_identifier"></a><h5>
-<a name="id460508"></a>
+<a name="id460343"></a>
<a
href="block.html#quickbook.syntax.block.templates.template_identifier">Template
Identifier</a>
</h5>
@@ -957,7 +957,7 @@
</li>
</ul></div>
<a name="quickbook.syntax.block.templates.formal_template_arguments"></a><h5>
-<a name="id460555"></a>
+<a name="id460389"></a>
<a
href="block.html#quickbook.syntax.block.templates.formal_template_arguments">Formal
Template Arguments</a>
</h5>
@@ -977,7 +977,7 @@
of the template call.
</p>
<a name="quickbook.syntax.block.templates.template_body"></a><h5>
-<a name="id384999"></a>
+<a name="id460508"></a>
<a
href="block.html#quickbook.syntax.block.templates.template_body">Template
Body</a>
</h5>
@@ -1002,7 +1002,7 @@
block level elements are not allowed in phrase templates.
</p>
<a name="quickbook.syntax.block.templates.template_expansion"></a><h5>
-<a name="id460597"></a>
+<a name="id460567"></a>
<a
href="block.html#quickbook.syntax.block.templates.template_expansion">Template
Expansion</a>
</h5>
@@ -1059,7 +1059,7 @@
by the close parenthesis.
</p>
<a name="quickbook.syntax.block.templates.nullary_templates"></a><h5>
-<a name="id460700"></a>
+<a name="id460671"></a>
<a
href="block.html#quickbook.syntax.block.templates.nullary_templates">Nullary
Templates</a>
</h5>
@@ -1142,7 +1142,7 @@
brackets, though.
</p>
<a name="quickbook.syntax.block.templates.simple_arguments"></a><h5>
-<a name="id460934"></a>
+<a name="id460905"></a>
<a
href="block.html#quickbook.syntax.block.templates.simple_arguments">Simple
Arguments</a>
</h5>
@@ -1210,7 +1210,7 @@
what do you think man?
</p>
<a name="quickbook.syntax.block.templates.punctuation_templates"></a><h5>
-<a name="id461104"></a>
+<a name="id461075"></a>
<a
href="block.html#quickbook.syntax.block.templates.punctuation_templates">Punctuation
Templates</a>
</h5>
@@ -1292,7 +1292,7 @@
will generate:
</p>
<div class="table">
-<a name="id461311"></a><p class="title"><b>Table 4. A Simple Table</b></p>
+<a name="id461282"></a><p class="title"><b>Table 4. A Simple Table</b></p>
<table class="table" summary="A Simple Table">
<colgroup>
<col>
@@ -1403,7 +1403,7 @@
and thus:
</p>
<div class="table">
-<a name="id461475"></a><p class="title"><b>Table 5. Table with fat
cells</b></p>
+<a name="id461446"></a><p class="title"><b>Table 5. Table with fat
cells</b></p>
<table class="table" summary="Table with fat cells">
<colgroup>
<col>
@@ -1478,7 +1478,7 @@
]
</pre>
<div class="table">
-<a name="id461593"></a><p class="title"><b>Table 6. Table with code</b></p>
+<a name="id461563"></a><p class="title"><b>Table 6. Table with code</b></p>
<table class="table" summary="Table with code">
<colgroup>
<col>
@@ -1609,7 +1609,7 @@
QuickBook's import facility provides a nice solution.
</p>
<a name="quickbook.syntax.block.import.example"></a><h5>
-<a name="id462000"></a>
+<a name="id461971"></a>
<a
href="block.html#quickbook.syntax.block.import.example">Example</a>
</h5>
<p>
@@ -1716,7 +1716,7 @@
<p>
</p>
<a name="quickbook.syntax.block.import.code_snippet_markup"></a><h5>
-<a name="id462313"></a>
+<a name="id462284"></a>
<a
href="block.html#quickbook.syntax.block.import.code_snippet_markup">Code
Snippet Markup</a>
</h5>
@@ -1737,7 +1737,7 @@
This too will not be visible in quickbook.
</p>
<a name="quickbook.syntax.block.import.special_comments"></a><h5>
-<a name="id462439"></a>
+<a name="id462409"></a>
<a
href="block.html#quickbook.syntax.block.import.special_comments">Special
Comments</a>
</h5>
@@ -1779,7 +1779,7 @@
between the delimeters will simply be ignored.
</p>
<a name="quickbook.syntax.block.import.callouts"></a><h5>
-<a name="id462587"></a>
+<a name="id462557"></a>
<a
href="block.html#quickbook.syntax.block.import.callouts">Callouts</a>
</h5>
<p>
Index: phrase.html
===================================================================
RCS file:
/cvsroot/boost/boost/tools/quickbook/doc/html/quickbook/syntax/phrase.html,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -d -r1.33 -r1.34
--- phrase.html 21 Jul 2007 04:56:36 -0000 1.33
+++ phrase.html 28 Jul 2007 08:13:34 -0000 1.34
@@ -44,6 +44,7 @@
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>
+<dt><span class="section"><a href="phrase.html#quickbook.syntax.phrase.cond">
Conditional Generation</a></span></dt>
</dl></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
@@ -135,7 +136,7 @@
<p>
Unlike QuickBook's standard formatting scheme, the rules for simpler
alternatives
are much stricter
- <sup>[<a name="id385487" href="#ftn.id385487">1</a>]</sup>
+ <sup>[<a name="id385500" href="#ftn.id385500">1</a>]</sup>
.
</p>
<div class="itemizedlist"><ul type="disc">
@@ -171,7 +172,7 @@
</li>
</ul></div>
<div class="table">
-<a name="id455953"></a><p class="title"><b>Table 1. More Formatting
Samples</b></p>
+<a name="id455966"></a><p class="title"><b>Table 1. More Formatting
Samples</b></p>
<table class="table" summary="More Formatting Samples">
<colgroup>
<col>
@@ -500,7 +501,7 @@
whereas a Python comment <tt class="computeroutput"><span
class="comment">#looks like this</span></tt>.
</p>
<div class="table">
-<a name="id456938"></a><p class="title"><b>Table 2. Supported Source
Modes</b></p>
+<a name="id456951"></a><p class="title"><b>Table 2. Supported Source
Modes</b></p>
<table class="table" summary="Supported Source Modes">
<colgroup>
<col>
@@ -790,7 +791,7 @@
</pre>
<p>
will generate this
- <sup>[<a name="id457794" href="#ftn.id457794">2</a>]</sup>
+ <sup>[<a name="id457807" href="#ftn.id457807">2</a>]</sup>
.
</p>
<div class="section" lang="en">
@@ -817,18 +818,50 @@
</p>
</div>
</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="quickbook.syntax.phrase.cond"></a><a
href="phrase.html#quickbook.syntax.phrase.cond" title=" Conditional
Generation"> Conditional Generation</a></h4></div></div></div>
+<p>
+ Like C++ <tt class="computeroutput"><span
class="comment">#ifdef</span></tt>, you can generate
+ phrases depending on the presence of a macro. Example:
+ </p>
+<pre class="programlisting">[? __to_be__ To be or not to be]
+</pre>
+<p>
+ </p>
+<p>
+ Here, the phrase "To be or not to be" will only be generated
+ if the macro symbol __to_be__ has been previously defined. The
phrase above will
+ not do anything since we haven't defined __to_be__. Now, let's
define the symbol:
+ </p>
+<pre class="programlisting">[def __to_be__]
+</pre>
+<p>
+ And try again:
+ </p>
+<p>
+ To be or not to be
+ </p>
+<p>
+ Yes!
+ <sup>[<a name="id457980" href="#ftn.id457980">3</a>]</sup>
+ </p>
+</div>
<div class="footnotes">
<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a name="ftn.id385487" href="#id385487">1</a>]
</sup>
+<div class="footnote"><p><sup>[<a name="ftn.id385500" href="#id385500">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.id457794" href="#id457794">2</a>]
</sup>
+<div class="footnote"><p><sup>[<a name="ftn.id457807" href="#id457807">2</a>]
</sup>
A sample footnote
</p></div>
+<div class="footnote"><p><sup>[<a name="ftn.id457980" href="#id457980">3</a>]
</sup>
+ Conditional Generation makes quickbook turing complete.
+ </p></div>
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";
width="100%"><tr>
-------------------------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc.
Still grepping through log files to find problems? Stop.
Now Search log events and configuration files using AJAX and a browser.
Download your FREE copy of Splunk now >> http://get.splunk.com/
_______________________________________________
Boost-cvs mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/boost-cvs
