|
|
Boost-Commit : |
Subject: [Boost-commit] svn:boost r70540 - in sandbox/local/libs/local/doc: html html/boost/local html/boost_local qbk
From: lorcaminiti_at_[hidden]
Date: 2011-03-25 12:03:37
Author: lcaminiti
Date: 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
New Revision: 70540
URL: http://svn.boost.org/trac/boost/changeset/70540
Log:
Proofreading docs.
Text files modified:
sandbox/local/libs/local/doc/html/BOOST_IDENTITY_TYPE.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_IDENTITY_VALUE.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_END.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_TPL.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPLIANT.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_END.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_TPL.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_NAME.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS_TPL.html | 4 +-
sandbox/local/libs/local/doc/html/BOOST_LOCAL_TYPEOF.html | 4 +-
sandbox/local/libs/local/doc/html/boost/local/function.html | 4 +-
sandbox/local/libs/local/doc/html/boost_local/Acknowledgments.html | 4 +-
sandbox/local/libs/local/doc/html/boost_local/Advanced_Topics.html | 30 ++++++++--------
sandbox/local/libs/local/doc/html/boost_local/Alternatives.html | 4 +-
sandbox/local/libs/local/doc/html/boost_local/Bibliography.html | 4 +-
sandbox/local/libs/local/doc/html/boost_local/Examples.html | 4 +-
sandbox/local/libs/local/doc/html/boost_local/Getting_Started.html | 10 ++--
sandbox/local/libs/local/doc/html/boost_local/Implementation.html | 4 +-
sandbox/local/libs/local/doc/html/boost_local/Release_Notes.html | 4 +-
sandbox/local/libs/local/doc/html/boost_local/Tutorial.html | 54 +++++++++++++++---------------
sandbox/local/libs/local/doc/html/index.html | 70 +++++++++++++++++----------------------
sandbox/local/libs/local/doc/html/reference.html | 4 +-
sandbox/local/libs/local/doc/qbk/introduction.qbk | 26 ++++++--------
sandbox/local/libs/local/doc/qbk/local.qbk | 2
29 files changed, 136 insertions(+), 148 deletions(-)
Modified: sandbox/local/libs/local/doc/html/BOOST_IDENTITY_TYPE.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_IDENTITY_TYPE.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_IDENTITY_TYPE.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_IDENTITY_TYPE</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.utility.identity_hpp" title="Header <boost/utility/identity.hpp>">
<link rel="prev" href="BOOST_LOCAL_TYPEOF.html" title="Macro BOOST_LOCAL_TYPEOF">
<link rel="next" href="BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">
@@ -33,7 +33,7 @@
</span>BOOST_IDENTITY_TYPE(parenthesized_type)</pre></div>
<div class="refsect1">
-<a name="id915709"></a><h2>Description</h2>
+<a name="id915536"></a><h2>Description</h2>
<p>This macro expands to an expression that can be passed as a single macro parameter even if it contains commas and that evaluates to the specified type at compile-time (see the <a class="link" href="boost_local/Advanced_Topics.html" title="Advanced Topics"> Advanced Topics</a> section).</p>
<p>For example <code class="computeroutput">BOOST_IDENTITY_TYPE((std::map<int, double>))</code> can be passed as a single macro parameter when instead <code class="computeroutput">std::map<int, double></code> cannot (because it contains a comma not wrapped by round parenthesis so it will be interpreted as two separate macro parameters by the preprocessor).</p>
<p><span class="bold"><strong>Parameters:</strong></span> </p>
Modified: sandbox/local/libs/local/doc/html/BOOST_IDENTITY_VALUE.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_IDENTITY_VALUE.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_IDENTITY_VALUE.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_IDENTITY_VALUE</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.utility.identity_hpp" title="Header <boost/utility/identity.hpp>">
<link rel="prev" href="BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">
<link rel="next" href="boost_local/Examples.html" title="Appendix: Examples">
@@ -33,7 +33,7 @@
</span>BOOST_IDENTITY_VALUE(parenthesized_value)</pre></div>
<div class="refsect1">
-<a name="id915850"></a><h2>Description</h2>
+<a name="id915677"></a><h2>Description</h2>
<p>This macro expands to an expression that can be passed as a single macro parameter even if it contains commas and that evaluates to the specified value at run-time (see the <a class="link" href="boost_local/Advanced_Topics.html" title="Advanced Topics"> Advanced Topics</a> section).</p>
<p>For example <code class="computeroutput">BOOST_IDENTITY_VALUE((key_sizeof<int, double>::value))</code> can be passed as a single macro parameter when instead <code class="computeroutput">key_sizeof<int, double>::value</code> cannot (because it contains a comma not wrapped by round parenthesis so it will be interpreted as two separate macro parameters by the preprocessor).</p>
<p><span class="bold"><strong>Parameters:</strong></span> </p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_BLOCK</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.block_hpp" title="Header <boost/local/block.hpp>">
<link rel="prev" href="reference.html" title="Reference">
<link rel="next" href="BOOST_LOCAL_BLOCK_TPL.html" title="Macro BOOST_LOCAL_BLOCK_TPL">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_BLOCK(bindings)</pre></div>
<div class="refsect1">
-<a name="id910659"></a><h2>Description</h2>
+<a name="id910483"></a><h2>Description</h2>
<p>This macro must be used within a declarative context, it must be followed by the local block body code and then by the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK_END.html" title="Macro BOOST_LOCAL_BLOCK_END">BOOST_LOCAL_BLOCK_END</a></code> macro (see the Tutorial section): </p>
<pre class="programlisting"> <span class="special">{</span> <span class="comment">// Some declarative context.</span>
<span class="special">...</span>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_END.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_END.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_END.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_BLOCK_END</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.block_hpp" title="Header <boost/local/block.hpp>">
<link rel="prev" href="BOOST_LOCAL_BLOCK_TPL.html" title="Macro BOOST_LOCAL_BLOCK_TPL">
<link rel="next" href="BOOST_LOCAL_CONFIG_COMPLIANT.html" title="Macro BOOST_LOCAL_CONFIG_COMPLIANT">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_BLOCK_END</pre></div>
<div class="refsect1">
-<a name="id911397"></a><h2>Description</h2>
+<a name="id911221"></a><h2>Description</h2>
<p>This macro must follow the local block body code <code class="computeroutput">{ ... }</code> as shown in the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code> documentation.</p>
<p><span class="bold"><strong>Note:</strong></span> This macro cannot be used multiple times on the same line because it internally uses the line number <code class="computeroutput">__LINE__</code> to generate unique identifiers.</p>
<p><span class="bold"><strong>See:</strong></span> <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. </p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_TPL.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_TPL.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_TPL.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_BLOCK_TPL</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.block_hpp" title="Header <boost/local/block.hpp>">
<link rel="prev" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">
<link rel="next" href="BOOST_LOCAL_BLOCK_END.html" title="Macro BOOST_LOCAL_BLOCK_END">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_BLOCK_TPL(bindings)</pre></div>
<div class="refsect1">
-<a name="id911323"></a><h2>Description</h2>
+<a name="id911147"></a><h2>Description</h2>
<p><span class="bold"><strong>See:</strong></span> <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. </p>
</div>
</div>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPLIANT.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPLIANT.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPLIANT.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_CONFIG_COMPLIANT</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">
<link rel="prev" href="BOOST_LOCAL_BLOCK_END.html" title="Macro BOOST_LOCAL_BLOCK_END">
<link rel="next" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html" title="Macro BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_CONFIG_COMPLIANT</pre></div>
<div class="refsect1">
-<a name="id911565"></a><h2>Description</h2>
+<a name="id911389"></a><h2>Description</h2>
<p>If programmers leave this configuration macro undefined, its default value is to be left not defined.</p>
<p>If this macro is defined, variadic macros and empty macro parameters are not used by this library. Using variadic macros and empty macro parameters allows this library to provide the <span class="emphasis"><em>variadic macro</em></span> and <span class="emphasis"><em>empty macro</em></span> syntaxes which some programmers might find more readable than the <span class="emphasis"><em>sequencing macro</em></span> syntax (see <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>, and <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code>). If this configuration macro is defined then only the sequencing macro syntax is allowed (regardless of whether the compiler supports variadic and e
mpty macros or not).</p>
<p><span class="bold"><strong>Warning:</strong></span> The variadic and empty macro syntaxes are not supported by all C++ compilers so they should be used with care to avoid portability issues (and this configuration macro can be defined to disable them).</p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">
<link rel="prev" href="BOOST_LOCAL_CONFIG_COMPLIANT.html" title="Macro BOOST_LOCAL_CONFIG_COMPLIANT">
<link rel="next" href="BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html" title="Macro BOOST_LOCAL_CONFIG_THIS_PARAM_NAME">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX</pre></div>
<div class="refsect1">
-<a name="id911741"></a><h2>Description</h2>
+<a name="id911568"></a><h2>Description</h2>
<p>If programmers leave this configuration macro undefined, its default value is <code class="computeroutput">5</code>.</p>
<p>This only refers to the number of local function parameters and not to the number of bound variables in scope (the limit on the number of bound variables is instead the maximum size allowed for a Boost.Preprocessor sequences).</p>
<p><span class="bold"><strong>Warning:</strong></span> Increasing this number will increase compilation time.</p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_CONFIG_THIS_PARAM_NAME</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">
<link rel="prev" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html" title="Macro BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX">
<link rel="next" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_CONFIG_THIS_PARAM_NAME</pre></div>
<div class="refsect1">
-<a name="id911836"></a><h2>Description</h2>
+<a name="id911663"></a><h2>Description</h2>
<p>If programmers leave this configuration macro undefined, the default symbol used is <code class="computeroutput">this_</code>.</p>
<p><span class="bold"><strong>Warning:</strong></span> Programmers should not define this macro unless it is absolutely necessary (e.g., to avoid name clashes with another library which cannot be changed). Changing the symbol <code class="computeroutput">this_</code> effectively changes the public API of this library.</p>
<p><span class="bold"><strong>See:</strong></span> <a class="link" href="boost_local/Getting_Started.html" title="Getting Started"> Getting Started</a> section. </p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_EXIT</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.exit_hpp" title="Header <boost/local/exit.hpp>">
<link rel="prev" href="BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html" title="Macro BOOST_LOCAL_CONFIG_THIS_PARAM_NAME">
<link rel="next" href="BOOST_LOCAL_EXIT_TPL.html" title="Macro BOOST_LOCAL_EXIT_TPL">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_EXIT(binding_list)</pre></div>
<div class="refsect1">
-<a name="id911976"></a><h2>Description</h2>
+<a name="id911804"></a><h2>Description</h2>
<p>This macro must be used within a declarative context, it must be followed by the local exit body code and then by the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT_END.html" title="Macro BOOST_LOCAL_EXIT_END">BOOST_LOCAL_EXIT_END</a></code> macro (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section): </p>
<pre class="programlisting"> <span class="special">{</span> <span class="comment">// Some declarative context.</span>
<span class="special">...</span>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_END.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_END.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_END.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_EXIT_END</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.exit_hpp" title="Header <boost/local/exit.hpp>">
<link rel="prev" href="BOOST_LOCAL_EXIT_TPL.html" title="Macro BOOST_LOCAL_EXIT_TPL">
<link rel="next" href="boost/local/function.html" title="Struct template function">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_EXIT_END</pre></div>
<div class="refsect1">
-<a name="id912724"></a><h2>Description</h2>
+<a name="id912552"></a><h2>Description</h2>
<p>This macro must follow the local exit body code <code class="computeroutput">{ ... }</code> as shown in the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code> documentation.</p>
<p><span class="bold"><strong>Note:</strong></span> This macro cannot be used multiple times on the same line because it internally uses the line number <code class="computeroutput">__LINE__</code> to generate unique identifiers.</p>
<p><span class="bold"><strong>See:</strong></span> <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. </p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_TPL.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_TPL.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_TPL.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_EXIT_TPL</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.exit_hpp" title="Header <boost/local/exit.hpp>">
<link rel="prev" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">
<link rel="next" href="BOOST_LOCAL_EXIT_END.html" title="Macro BOOST_LOCAL_EXIT_END">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_EXIT_TPL(binding_list)</pre></div>
<div class="refsect1">
-<a name="id912650"></a><h2>Description</h2>
+<a name="id912478"></a><h2>Description</h2>
<p><span class="bold"><strong>See:</strong></span> <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. </p>
</div>
</div>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_NAME.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_NAME.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_NAME.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_FUNCTION_NAME</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">
<link rel="prev" href="BOOST_LOCAL_FUNCTION_PARAMS_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS_TPL">
<link rel="next" href="BOOST_LOCAL_TYPEOF.html" title="Macro BOOST_LOCAL_TYPEOF">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_FUNCTION_NAME(name)</pre></div>
<div class="refsect1">
-<a name="id915188"></a><h2>Description</h2>
+<a name="id915015"></a><h2>Description</h2>
<p>This macro must follow the local function body code block <code class="computeroutput">{ ... }</code> as shown in the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code> documentation.</p>
<p><span class="bold"><strong>Parameters:</strong></span> </p>
<div class="informaltable"><table class="table">
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_FUNCTION_PARAMS</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">
<link rel="prev" href="boost/local/function.html" title="Struct template function">
<link rel="next" href="BOOST_LOCAL_FUNCTION_PARAMS_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS_TPL">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_FUNCTION_PARAMS(parameters)</pre></div>
<div class="refsect1">
-<a name="id914214"></a><h2>Description</h2>
+<a name="id914041"></a><h2>Description</h2>
<p>This macro must be used within a declarative context, it must follow the local function result type, it must be followed by the local function body code and then by the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code> macro (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> and <a class="link" href="boost_local/Advanced_Topics.html" title="Advanced Topics"> Advanced Topics</a> sections): </p>
<pre class="programlisting"> <span class="special">{</span> <span class="comment">// Some declarative context.</span>
<span class="special">...</span>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS_TPL.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS_TPL.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS_TPL.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_FUNCTION_PARAMS_TPL</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">
<link rel="prev" href="BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">
<link rel="next" href="BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_FUNCTION_PARAMS_TPL(parameters)</pre></div>
<div class="refsect1">
-<a name="id915114"></a><h2>Description</h2>
+<a name="id914941"></a><h2>Description</h2>
<p><span class="bold"><strong>See:</strong></span> <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. </p>
</div>
</div>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_TYPEOF.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_TYPEOF.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_TYPEOF.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Macro BOOST_LOCAL_TYPEOF</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="up" href="reference.html#header.boost.local.typeof_hpp" title="Header <boost/local/typeof.hpp>">
<link rel="prev" href="BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">
<link rel="next" href="BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_TYPEOF(bound_variable_name)</pre></div>
<div class="refsect1">
-<a name="id915382"></a><h2>Description</h2>
+<a name="id915208"></a><h2>Description</h2>
<p>The type is fully qualified in that it contains the extra constant and reference qualifiers when they are specified for binding by constant and by reference. For example, if a variable named <code class="computeroutput">x</code> of type <code class="computeroutput">T</code> is: </p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem"><p>Bound by value using <code class="computeroutput">bind x</code> then <code class="computeroutput">BOOST_LOCAL_TYPEOF(x)</code> is <code class="computeroutput">T</code>. </p></li>
Modified: sandbox/local/libs/local/doc/html/boost/local/function.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost/local/function.html (original)
+++ sandbox/local/libs/local/doc/html/boost/local/function.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,7 +4,7 @@
<title>Struct template function</title>
<link rel="stylesheet" href="../../../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../../index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="../../index.html" title="Boost.Local 0.2.0">
<link rel="up" href="../../reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">
<link rel="prev" href="../../BOOST_LOCAL_EXIT_END.html" title="Macro BOOST_LOCAL_EXIT_END">
<link rel="next" href="../../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">
@@ -35,7 +35,7 @@
<span class="keyword">struct</span> <a class="link" href="function.html" title="Struct template function">function</a> <span class="special">{</span>
<span class="special">}</span><span class="special">;</span></pre></div>
<div class="refsect1">
-<a name="id913085"></a><h2>Description</h2>
+<a name="id912913"></a><h2>Description</h2>
<p>This template defines several specializations to handle a generic number of function parameters some of which can have default values. The number of supported function parameters <code class="computeroutput">N</code> goes from <code class="computeroutput">0</code> (for a function with no parameter) to a maximum of <code class="computeroutput"><a class="link" href="../../BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html" title="Macro BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX">BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX</a></code>.</p>
<p>Each template specialization defines call operators <code class="computeroutput">operator()(...)</code> with a different set of parameters to handle the number of default parameters specified by <code class="computeroutput">defaults</code> (see <a class="link" href="../../boost_local/Advanced_Topics.html" title="Advanced Topics">
Advanced Topics</a> section): </p>
Modified: sandbox/local/libs/local/doc/html/boost_local/Acknowledgments.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Acknowledgments.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Acknowledgments.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,8 +4,8 @@
<title>Acknowledgments</title>
<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
-<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.2.0">
+<link rel="up" href="../index.html" title="Boost.Local 0.2.0">
<link rel="prev" href="Bibliography.html" title="Bibliography">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Modified: sandbox/local/libs/local/doc/html/boost_local/Advanced_Topics.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Advanced_Topics.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Advanced_Topics.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,8 +4,8 @@
<title>Advanced Topics</title>
<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
-<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.2.0">
+<link rel="up" href="../index.html" title="Boost.Local 0.2.0">
<link rel="prev" href="Tutorial.html" title="Tutorial">
<link rel="next" href="../reference.html" title="Reference">
</head>
@@ -83,7 +83,7 @@
<p>
In addition, local function parameter types cannot start with non-alphanumeric
symbols (alphanumeric symbols are <code class="computeroutput"><span class="identifier">A</span><span class="special">-</span><span class="identifier">Z</span></code>, <code class="computeroutput"><span class="identifier">a</span><span class="special">-</span><span class="identifier">z</span></code>,
- and <code class="computeroutput"><span class="number">0</span><span class="special">-</span><span class="number">9</span></code>). <sup>[<a name="id881137" href="#ftn.id881137" class="footnote">15</a>]</sup> The library will generate (cryptic) preprocessor errors if a
+ and <code class="computeroutput"><span class="number">0</span><span class="special">-</span><span class="number">9</span></code>). <sup>[<a name="id880955" href="#ftn.id880955" class="footnote">14</a>]</sup> The library will generate (cryptic) preprocessor errors if a
parameter type starts with a non-alphanumeric symbol.
</p>
<p>
@@ -206,7 +206,7 @@
<li class="listitem">
Parenthesis to wrap the type expression (and therefore any commas <code class="computeroutput"><span class="special">,</span></code> that it contains) passed as parameter
to the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
- macro. <sup>[<a name="id882495" href="#ftn.id882495" class="footnote">16</a>]</sup>
+ macro. <sup>[<a name="id882313" href="#ftn.id882313" class="footnote">15</a>]</sup>
</li>
</ol></div>
<p>
@@ -407,7 +407,7 @@
</p></td></tr>
</table></div>
<p>
- Consider the following complete example: <sup>[<a name="id883800" href="#ftn.id883800" class="footnote">17</a>]</sup>
+ Consider the following complete example: <sup>[<a name="id883618" href="#ftn.id883618" class="footnote">16</a>]</sup>
</p>
<div class="informaltable"><table class="table">
<colgroup>
@@ -1892,14 +1892,14 @@
</tbody>
</table></div>
<a name="boost_local.Advanced_Topics.limitations__overloading__operators__etc_.overloading"></a><h6>
-<a name="id909526"></a>
+<a name="id909344"></a>
<a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.limitations__overloading__operators__etc_.overloading">Overloading</a>
</h6>
<p>
It is not possible to overload local functions. Declaring multiple local
functions with the same name within the same enclosing scope generates a
compile-time error (even if the different declarations specify different
- parameters). <sup>[<a name="id909550" href="#ftn.id909550" class="footnote">18</a>]</sup>
+ parameters). <sup>[<a name="id909368" href="#ftn.id909368" class="footnote">17</a>]</sup>
</p>
<p>
For example, the following code will <span class="bold"><strong>not</strong></span>
@@ -1918,12 +1918,12 @@
<span class="special">}</span>
</pre>
<a name="boost_local.Advanced_Topics.limitations__overloading__operators__etc_.operators"></a><h6>
-<a name="id909856"></a>
+<a name="id909680"></a>
<a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.limitations__overloading__operators__etc_.operators">Operators</a>
</h6>
<p>
Local functions cannot be operators. Naming a local function <code class="computeroutput"><span class="keyword">operator</span><span class="special">...</span></code>
- will generate a compile-time error. <sup>[<a name="id909893" href="#ftn.id909893" class="footnote">19</a>]</sup>
+ will generate a compile-time error. <sup>[<a name="id909717" href="#ftn.id909717" class="footnote">18</a>]</sup>
</p>
<p>
For example, the following code will <span class="bold"><strong>not</strong></span>
@@ -1944,7 +1944,7 @@
<span class="special">}</span>
</pre>
<a name="boost_local.Advanced_Topics.limitations__overloading__operators__etc_.goto"></a><h6>
-<a name="id910268"></a>
+<a name="id910092"></a>
<a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.limitations__overloading__operators__etc_.goto">Goto</a>
</h6>
<p>
@@ -1970,21 +1970,21 @@
</div>
<div class="footnotes">
<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a id="ftn.id881137" href="#id881137" class="para">15</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id880955" href="#id880955" class="para">14</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> This limitation derives from
the fact that <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>
uses preprocessor token concatenation to inspect the parameter type token
to see if the token is a parameter or a bound variable. The C++ preprocessor
does not allow to concatenate non-alphanumeric tokens.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id882495" href="#id882495" class="para">16</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id882313" href="#id882313" class="para">15</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> Using variadic macros,
this extra set of parenthesis could be eliminated requiring only the
parenthesis to invoke the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
macro. However, this feature is currently not implemented and the double
parenthesis are always needed when invoking this macro.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id883800" href="#id883800" class="para">17</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id883618" href="#id883618" class="para">16</a>] </sup>
The authors recognize that the use of the <span class="emphasis"><em>identity macros</em></span>
adds extra parenthesis to the already significant number of parenthesis
required by the sequencing macro syntax. However, macro parameters usually
@@ -1992,14 +1992,14 @@
(unless template metaprogramming is being used) so this is usually not
a problem.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id909550" href="#id909550" class="para">18</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id909368" href="#id909368" class="para">17</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> This is because a local function
is a functor object declared as a local variable within the enclosing scope.
Therefore, declaring two local functions with the same name within the
same enclosing scope declares two local variables with the same name within
the same scope and that is not allowed in C++.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id909893" href="#id909893" class="para">19</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id909717" href="#id909717" class="para">18</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> This is the because a local
function name must be a valid local variable name (the local variable to
hold the local functor object) and operators cannot be used as local variable
Modified: sandbox/local/libs/local/doc/html/boost_local/Alternatives.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Alternatives.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Alternatives.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,8 +4,8 @@
<title>Appendix: Alternatives</title>
<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
-<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.2.0">
+<link rel="up" href="../index.html" title="Boost.Local 0.2.0">
<link rel="prev" href="Examples.html" title="Appendix: Examples">
<link rel="next" href="Implementation.html" title="Appendix: Implementation">
</head>
Modified: sandbox/local/libs/local/doc/html/boost_local/Bibliography.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Bibliography.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Bibliography.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,8 +4,8 @@
<title>Bibliography</title>
<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
-<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.2.0">
+<link rel="up" href="../index.html" title="Boost.Local 0.2.0">
<link rel="prev" href="Release_Notes.html" title="Release Notes">
<link rel="next" href="Acknowledgments.html" title="Acknowledgments">
</head>
Modified: sandbox/local/libs/local/doc/html/boost_local/Examples.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Examples.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Examples.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,8 +4,8 @@
<title>Appendix: Examples</title>
<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
-<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.2.0">
+<link rel="up" href="../index.html" title="Boost.Local 0.2.0">
<link rel="prev" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">
<link rel="next" href="Alternatives.html" title="Appendix: Alternatives">
</head>
Modified: sandbox/local/libs/local/doc/html/boost_local/Getting_Started.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Getting_Started.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Getting_Started.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,9 +4,9 @@
<title>Getting Started</title>
<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
-<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
-<link rel="prev" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.2.0">
+<link rel="up" href="../index.html" title="Boost.Local 0.2.0">
+<link rel="prev" href="../index.html" title="Boost.Local 0.2.0">
<link rel="next" href="Tutorial.html" title="Tutorial">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -120,7 +120,7 @@
</pre>
<p>
The following symbols are part of the library private API, they are not documented,
- and they should not be directly used by programmers: <sup>[<a name="id866311" href="#ftn.id866311" class="footnote">2</a>]</sup>
+ and they should not be directly used by programmers: <sup>[<a name="id866124" href="#ftn.id866124" class="footnote">1</a>]</sup>
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
@@ -160,7 +160,7 @@
</div>
<div class="footnotes">
<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a id="ftn.id866311" href="#id866311" class="para">2</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id866124" href="#id866124" class="para">1</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> This library concatenates symbols
specified by the programmers (e.g., the local function name) with other
symbols (e.g., special prefixes or preprocessor line numbers) to make internal
Modified: sandbox/local/libs/local/doc/html/boost_local/Implementation.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Implementation.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Implementation.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,8 +4,8 @@
<title>Appendix: Implementation</title>
<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
-<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.2.0">
+<link rel="up" href="../index.html" title="Boost.Local 0.2.0">
<link rel="prev" href="Alternatives.html" title="Appendix: Alternatives">
<link rel="next" href="Release_Notes.html" title="Release Notes">
</head>
Modified: sandbox/local/libs/local/doc/html/boost_local/Release_Notes.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Release_Notes.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Release_Notes.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,8 +4,8 @@
<title>Release Notes</title>
<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
-<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.2.0">
+<link rel="up" href="../index.html" title="Boost.Local 0.2.0">
<link rel="prev" href="Implementation.html" title="Appendix: Implementation">
<link rel="next" href="Bibliography.html" title="Bibliography">
</head>
Modified: sandbox/local/libs/local/doc/html/boost_local/Tutorial.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Tutorial.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Tutorial.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,8 +4,8 @@
<title>Tutorial</title>
<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
-<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.2.0">
+<link rel="up" href="../index.html" title="Boost.Local 0.2.0">
<link rel="prev" href="Getting_Started.html" title="Getting Started">
<link rel="next" href="Advanced_Topics.html" title="Advanced Topics">
</head>
@@ -115,12 +115,12 @@
<span class="special">...</span> <span class="special">}</span></code>
using the usual C++ syntax. The body is specified outside any of the macros
so eventual compiler error messages and line numbers retain their usual meaning.
- <sup>[<a name="id867002" href="#ftn.id867002" class="footnote">3</a>]</sup>
+ <sup>[<a name="id866811" href="#ftn.id866811" class="footnote">2</a>]</sup>
</p>
<p>
The macro <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>
is used to end the local function definition and to specify the local function
- name. <sup>[<a name="id867038" href="#ftn.id867038" class="footnote">4</a>]</sup>
+ name. <sup>[<a name="id866848" href="#ftn.id866848" class="footnote">3</a>]</sup>
</p>
<p>
For example, let's program a local function named <code class="computeroutput"><span class="identifier">add</span></code>
@@ -366,7 +366,7 @@
This library also allows to specify default values for the local function
parameters. However, the usual C++ syntax for default parameters that uses
the assignment symbol <code class="computeroutput"><span class="special">=</span></code> cannot
- be used. <sup>[<a name="id868960" href="#ftn.id868960" class="footnote">5</a>]</sup> The keyword <code class="computeroutput"><span class="keyword">default</span></code>
+ be used. <sup>[<a name="id868774" href="#ftn.id868774" class="footnote">4</a>]</sup> The keyword <code class="computeroutput"><span class="keyword">default</span></code>
is used instead:
</p>
<div class="informaltable"><table class="table">
@@ -508,7 +508,7 @@
variables, the object <code class="computeroutput"><span class="keyword">this</span></code>,
etc) can be bound to a local function declaration. The types of bound variables
are automatically deduced by this library using Boost.Typeof.
- <sup>[<a name="id870184" href="#ftn.id870184" class="footnote">6</a>]</sup>
+ <sup>[<a name="id869998" href="#ftn.id869998" class="footnote">5</a>]</sup>
</p>
<div class="important"><table border="0" summary="Important">
<tr>
@@ -525,7 +525,7 @@
</table></div>
<p>
This library introduces the new "keyword" <code class="computeroutput"><span class="identifier">bind</span></code>
- <sup>[<a name="id870272" href="#ftn.id870272" class="footnote">7</a>]</sup> which is used in place of the parameter type to specify the name
+ <sup>[<a name="id870086" href="#ftn.id870086" class="footnote">6</a>]</sup> which is used in place of the parameter type to specify the name
of a variable in scope to bind. The variable can be bound by value:
</p>
<pre class="programlisting"><span class="identifier">bind</span> <span class="emphasis"><em>variable-name</em></span> <span class="comment">// Bind by value.
@@ -570,7 +570,7 @@
unless constant binding is forced using <code class="computeroutput"><span class="keyword">const</span>
<span class="identifier">bind</span> <span class="special">...</span></code>
(note that binding by constant reference is not supported by <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++0x
- lambda</a> functions). <sup>[<a name="id870552" href="#ftn.id870552" class="footnote">8</a>]</sup> Programmers might want to bind variables of complex types by
+ lambda</a> functions). <sup>[<a name="id870365" href="#ftn.id870365" class="footnote">7</a>]</sup> Programmers might want to bind variables of complex types by
(constant) reference instead than by value to avoid expensive copy operations
when these variables are automatically passed to the local function (as usual
with C++ function parameter passing).
@@ -651,7 +651,7 @@
</tr></tbody>
</table></div>
<a name="boost_local.Tutorial.Binding.binding_the_object__code__phrase_role__keyword__this__phrase___code_"></a><h6>
-<a name="id871539"></a>
+<a name="id871353"></a>
<a class="link" href="Tutorial.html#boost_local.Tutorial.Binding.binding_the_object__code__phrase_role__keyword__this__phrase___code_">Binding
the Object <code class="computeroutput"><span class="keyword">this</span></code></a>
</h6>
@@ -705,12 +705,12 @@
to a local function, the local function <span class="bold"><strong>body must
use the special symbol</strong></span> <code class="computeroutput"><span class="identifier">this_</span></code>
(instead of <code class="computeroutput"><span class="keyword">this</span></code>) to access
- the bound object. <sup>[<a name="id871858" href="#ftn.id871858" class="footnote">9</a>]</sup>
+ the bound object. <sup>[<a name="id871672" href="#ftn.id871672" class="footnote">8</a>]</sup>
</p>
<p>
Unfortunately, mistakenly using <code class="computeroutput"><span class="keyword">this</span></code>
within the local function body instead of <code class="computeroutput"><span class="identifier">this_</span></code>
- will not necessarily generate a compile-time error. <sup>[<a name="id871952" href="#ftn.id871952" class="footnote">10</a>]</sup> Programmers are responsible to make sure that <code class="computeroutput"><span class="keyword">this</span></code> is never used within a local function
+ will not necessarily generate a compile-time error. <sup>[<a name="id871765" href="#ftn.id871765" class="footnote">9</a>]</sup> Programmers are responsible to make sure that <code class="computeroutput"><span class="keyword">this</span></code> is never used within a local function
body which should only use the special symbol <code class="computeroutput"><span class="identifier">this_</span></code>.
</p>
</td></tr>
@@ -893,7 +893,7 @@
A <code class="computeroutput"><span class="keyword">return</span><span class="special">;</span></code>
instruction from within a local block jumps to the end of the local block
body and <span class="bold"><strong>it does not return the enclosing function</strong></span>.
- <sup>[<a name="id875264" href="#ftn.id875264" class="footnote">11</a>]</sup>
+ <sup>[<a name="id875056" href="#ftn.id875056" class="footnote">10</a>]</sup>
</p></td></tr>
</table></div>
<p>
@@ -996,7 +996,7 @@
If multiple local exits are declared within the same scope, their bodies
will be executed in the reverse order in which they have been declared. The
execution of the local exit code can be guaranteed only if the program does
- not terminate because of an uncaught exception. <sup>[<a name="id876468" href="#ftn.id876468" class="footnote">12</a>]</sup>
+ not terminate because of an uncaught exception. <sup>[<a name="id876285" href="#ftn.id876285" class="footnote">11</a>]</sup>
</p>
<p>
Only bound variables specified by <code class="literal"><span class="emphasis"><em>bindings</em></span></code>
@@ -1100,7 +1100,7 @@
Local exits are very similar to the <span class="emphasis"><em>scope exits</em></span> provided
by Boost.ScopeExit
with the addition that they also support constant binding and binding of
- the object <code class="computeroutput"><span class="keyword">this</span></code>. <sup>[<a name="id877720" href="#ftn.id877720" class="footnote">13</a>]</sup> Local exits can be used to emulate the <a href="http://d.digitalmars.com" target="_top">D
+ the object <code class="computeroutput"><span class="keyword">this</span></code>. <sup>[<a name="id877537" href="#ftn.id877537" class="footnote">12</a>]</sup> Local exits can be used to emulate the <a href="http://d.digitalmars.com" target="_top">D
Programming Language</a> <span class="emphasis"><em>scope guards</em></span> (see the
<a class="link" href="Examples.html#boost_local.Examples.Emulating_Ds_Scope_Guards" title="Emulating D's Scope Guards">Emulating
D's Scope Guards</a> example).
@@ -1114,7 +1114,7 @@
When local functions, local blocks, and local exits are programmed within
templates, they need to be declared using the following special macros ending
with the <code class="computeroutput"><span class="identifier">TPL</span></code> postfix (see
- the Reference section): <sup>[<a name="id877999" href="#ftn.id877999" class="footnote">14</a>]</sup>
+ the Reference section): <sup>[<a name="id877819" href="#ftn.id877819" class="footnote">13</a>]</sup>
</p>
<pre class="programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS_TPL">BOOST_LOCAL_FUNCTION_PARAMS_TPL</a></code><span class="special">(</span><span class="emphasis"><em>parameters</em></span><span class="special">)</span>
<code class="computeroutput"><a class="link" href="../BOOST_LOCAL_BLOCK_TPL.html" title="Macro BOOST_LOCAL_BLOCK_TPL">BOOST_LOCAL_BLOCK_TPL</a></code><span class="special">(</span><span class="emphasis"><em>bindings</em></span><span class="special">)</span>
@@ -1247,20 +1247,20 @@
</div>
<div class="footnotes">
<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a id="ftn.id867002" href="#id867002" class="para">3</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id866811" href="#id866811" class="para">2</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> If the local function body
were instead passed as a macro parameter, it would be expanded on a single
line of code (because macros always expand as a single line of code). Therefore,
eventual compiler error line numbers would all have the same value and
would no longer be useful to pinpoint the error.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id867038" href="#id867038" class="para">4</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id866848" href="#id866848" class="para">3</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> The local function name must
be passed to the macro <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>
ending the function definition so this macro can declare a local variable
with the local function name to hold the local functor object.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id868960" href="#id868960" class="para">5</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id868774" href="#id868774" class="para">4</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> The assignment symbol <code class="computeroutput"><span class="special">=</span></code> cannot be used to specify default parameter
values because default values are not part of the parameter type so they
cannot be handled using template metaprogamming. Default parameter values
@@ -1270,7 +1270,7 @@
it counts the number of default values to provide the correct set of call
operators for the local functor object.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id870184" href="#id870184" class="para">6</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id869998" href="#id869998" class="para">5</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> By binding a variable in scope,
the local function declaration is specifying that such a variable should
be accessible within the local function body regardless of its type. Semantically,
@@ -1283,7 +1283,7 @@
This is especially useful for maintenance so if a bound variable type is
changed, the local function declaration does not have to change.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id870272" href="#id870272" class="para">7</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id870086" href="#id870086" class="para">6</a>] </sup>
The token <code class="computeroutput"><span class="identifier">bind</span></code> is not a
real keyword of the C++ language. This library parses <code class="computeroutput"><span class="identifier">bind</span></code>
during macro expansion using preprocessor metaprogramming. Therefore,
@@ -1292,7 +1292,7 @@
within the syntax defined by the macros of this library -- thus it is referred
to as a "keyword" only within quotes.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id870552" href="#id870552" class="para">8</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id870365" href="#id870365" class="para">7</a>] </sup>
An historical note: Constant binding of variables in scope was the main
use case that originally motivated the authors in developing this library.
The authors needed to locally create a chuck of code to assert some correctness
@@ -1307,7 +1307,7 @@
generates an error because the bound variable is of <code class="computeroutput"><span class="keyword">const</span></code>
type within the local function body.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id871858" href="#id871858" class="para">9</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id871672" href="#id871672" class="para">8</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> This limitation comes from
the fact that <code class="computeroutput"><span class="keyword">this</span></code> is a
reserved C++ keyword so it cannot be used as the name of the internal
@@ -1321,7 +1321,7 @@
behaviour of <code class="computeroutput"><span class="keyword">static_cast</span></code></a>
(which might not work on all platforms at the cost of portability).
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id871952" href="#id871952" class="para">10</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id871765" href="#id871765" class="para">9</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> The local function body cannot
be a static member function of the local functor object in order to support
recursion (because the local function name is specified by the <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>
@@ -1334,7 +1334,7 @@
is visible but it refers to the local functor object and not to the bound
object.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id875264" href="#id875264" class="para">11</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id875056" href="#id875056" class="para">10</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> Programmers might expect
<code class="computeroutput"><span class="keyword">return</span><span class="special">;</span></code>
to exit the enclosing function instead of the local block (or local exit),
@@ -1352,7 +1352,7 @@
<code class="computeroutput"><span class="identifier">BOOST_LOCAL_RETURN</span><span class="special">;</span></code>)
to exit local blocks (and local exits).
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id876468" href="#id876468" class="para">12</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id876285" href="#id876285" class="para">11</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> This library (as well as Boost.ScopeExit)
uses the destructor of a local variable to automatically execute the local
exit code upon exit of the enclosing scope. However, in C++ it is no possible
@@ -1361,7 +1361,7 @@
different from the D programming language which executes the scope exit
code even if the main program terminates because of an uncaught exception.)
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id877720" href="#id877720" class="para">13</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id877537" href="#id877537" class="para">12</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> This library could be merged
together with Boost.ScopeExit
into a new library named Boost.Scope (from the meaning of the word "scope"
@@ -1388,7 +1388,7 @@
name of "<a href="http://gcc.gnu.org/onlinedocs/gcc/Nested-Functions.html" target="_top">nested
functions</a>" (GCC compiler extension).
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id877999" href="#id877999" class="para">14</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id877819" href="#id877819" class="para">13</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> Within templates, this library
needs to use <code class="computeroutput"><span class="keyword">typename</span></code> to explicitly
indicate that some expressions evaluate to a type. Because C++ does not
Modified: sandbox/local/libs/local/doc/html/index.html
==============================================================================
--- sandbox/local/libs/local/doc/html/index.html (original)
+++ sandbox/local/libs/local/doc/html/index.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -1,10 +1,10 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
-<title>Boost.Local 0.1.1</title>
+<title>Boost.Local 0.2.0</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
<link rel="next" href="boost_local/Getting_Started.html" title="Getting Started">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -21,7 +21,7 @@
<div class="preface">
<div class="titlepage"><div>
<div><h2 class="title">
-<a name="boost_local"></a>Boost.Local 0.1.1 </h2></div>
+<a name="boost_local"></a>Boost.Local 0.2.0 </h2></div>
<div><div class="authorgroup"><div class="author"><h3 class="author">
<span class="firstname">Lorenzo</span> <span class="surname">Caminiti (lorcaminiti_at_[hidden])</span>
</h3></div></div></div>
@@ -79,8 +79,8 @@
</li>
<li class="listitem">
The local function body is programmed using the usual C++ syntax (as a
- consequence, compiler error messages and line numbers retain their usual
- meaning).
+ consequence, compiler error messages and related line numbers retain their
+ usual meaning).
</li>
<li class="listitem">
Local functions can be passed as template parameters (so they can be conveniently
@@ -109,12 +109,12 @@
</li>
</ul></div>
<a name="boost_local.Introduction.two_syntaxes"></a><h6>
-<a name="id808272"></a>
+<a name="id808269"></a>
<a class="link" href="index.html#boost_local.Introduction.two_syntaxes">Two Syntaxes</a>
</h6>
<p>
This library uses macros to declare the local functions, local blocks, and
- local exits. The library macros support two different syntaxes:
+ local exits. These macros support two different syntaxes:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
@@ -126,9 +126,10 @@
<li class="listitem">
The <span class="emphasis"><em>variadic macro synstax</em></span> is available only on C++
compilers that support <a href="http://en.wikipedia.org/wiki/Variadic_macro" target="_top">variadic
- macros</a>. <sup>[<a name="id808335" href="#ftn.id808335" class="footnote">1</a>]</sup> This syntax allow to use commas <code class="computeroutput"><span class="special">,</span></code>
- to separate macro parameters therefore resembling the usual C++ syntax
- for function parameter declaration.
+ macros</a> (variadic macros are now supported by essentially all modern
+ C++ compilers including GCC and MSVC). This syntax allows to use commas
+ <code class="computeroutput"><span class="special">,</span></code> to separate macro parameters
+ therefore resembling the usual C++ syntax for function parameter declaration.
</li>
</ul></div>
<p>
@@ -141,7 +142,7 @@
of both syntaxes.
</p>
<a name="boost_local.Introduction.an_example"></a><h6>
-<a name="id810396"></a>
+<a name="id810367"></a>
<a class="link" href="index.html#boost_local.Introduction.an_example">An Example</a>
</h6>
<p>
@@ -339,9 +340,9 @@
parameter type to bind variables in scope. Variables can be bound by value,
by reference, by constant value, and by constant reference. In addition,
the object <code class="computeroutput"><span class="keyword">this</span></code> can be bound
- (but never by reference) from within a non-static member function (see
- the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section). For
- example, the variable <code class="computeroutput"><span class="identifier">factor</span></code>
+ (eventually by constant value but never by reference or constant reference)
+ from within a non-static member function (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a>
+ section). For example, the variable <code class="computeroutput"><span class="identifier">factor</span></code>
is bound by constant value so it cannot be mistakenly modified by the local
function body. The variable <code class="computeroutput"><span class="identifier">sum</span></code>
is instead bound by non-constant reference because the local function needs
@@ -349,12 +350,13 @@
</li>
<li class="listitem">
The local function body is programmed outside the macros with the usual
- C++ syntax. Eventual compiler error messages and line numbers retain their
- usual meaning. Exceptions specifications can be programmed outside the
- macro and just before the body code block <code class="computeroutput"><span class="special">{...}</span></code>
+ C++ syntax. Eventual compiler error messages and related line numbers retain
+ their usual meaning. Exceptions specifications can be programmed outside
+ the macro and just before the body code block <code class="computeroutput"><span class="special">{...}</span></code>
as usual. Finally, within the local function body the type of a bound variable
- can be accessed using <code class="literal"><code class="computeroutput"><a class="link" href="BOOST_LOCAL_TYPEOF.html" title="Macro BOOST_LOCAL_TYPEOF">BOOST_LOCAL_TYPEOF</a></code>(<span class="emphasis"><em>variable-name</em></span>)</code>.
- (See the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section.)
+ can be accessed using <code class="literal"><code class="computeroutput"><a class="link" href="BOOST_LOCAL_TYPEOF.html" title="Macro BOOST_LOCAL_TYPEOF">BOOST_LOCAL_TYPEOF</a></code>(<span class="emphasis"><em>bound-variable-name</em></span>)</code>
+ (see the <a class="link" href="boost_local/Advanced_Topics.html" title="Advanced Topics">Advanced Topics</a>
+ section).
</li>
<li class="listitem">
The macro ending the local function definition specifies the local function
@@ -374,8 +376,7 @@
specifies the variables in scope to bind (by reference or value and eventually
as constants). Exceptions specifications can be programmed outside the
macro and just before the body code block <code class="computeroutput"><span class="special">{...}</span></code>
- as usual (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a>
- section).
+ as usual.
</li>
<li class="listitem">
The local exit code will be automatically executed when the enclosing scope
@@ -393,17 +394,18 @@
<li class="listitem">
The <span class="bold"><strong>local block</strong></span> declaration macro only
specifies the variables in scope to bind (by reference or value and eventually
- as constants).
+ as constants). Exceptions specifications can be programmed outside the
+ macro and just before the body code block <code class="computeroutput"><span class="special">{...}</span></code>
+ as usual.
</li>
<li class="listitem">
The local block code is executed "in place" where it is programmed
- like a usual C++ block of code <code class="computeroutput"><span class="special">{</span>
- <span class="special">...</span> <span class="special">}</span></code>.
- In this example, the compiler will correctly generate an error if the assignment
- operator <code class="computeroutput"><span class="special">=</span></code> is mistakenly used
- instead of the equality operator <code class="computeroutput"><span class="special">==</span></code>
+ like a usual C++ block of code. In this example, the compiler will correctly
+ generate an error if the assignment operator <code class="computeroutput"><span class="special">=</span></code>
+ is mistakenly used instead of the equality operator <code class="computeroutput"><span class="special">==</span></code>
because the variable <code class="computeroutput"><span class="identifier">sum</span></code>
- is bound by constant reference so it cannot be modified.
+ is bound by constant reference so it cannot be modified within the local
+ block.
</li>
<li class="listitem">
Local blocks are anonymous so their ending macro takes no argument. No
@@ -412,19 +414,9 @@
</li>
</ol></div>
</div>
-<div class="footnotes">
-<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a id="ftn.id808335" href="#id808335" class="para">1</a>] </sup>
- Variadic macros were first introduced by the C99 preprocessor (via the
- use of the special macro symbols ellipses <code class="computeroutput"><span class="special">...</span></code>
- and <code class="computeroutput"><span class="identifier">__VA_ARGS__</span></code>). They
- are now supported on essentially all modern C++ compilers (GCC, MVSC,
- etc).
- </p></div>
-</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left"><p><small>Last revised: March 25, 2011 at 01:28:30 GMT</small></p></td>
+<td align="left"><p><small>Last revised: March 25, 2011 at 15:58:33 GMT</small></p></td>
<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
Modified: sandbox/local/libs/local/doc/html/reference.html
==============================================================================
--- sandbox/local/libs/local/doc/html/reference.html (original)
+++ sandbox/local/libs/local/doc/html/reference.html 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -4,8 +4,8 @@
<title>Reference</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="index.html" title="Boost.Local 0.1.1">
-<link rel="up" href="index.html" title="Boost.Local 0.1.1">
+<link rel="home" href="index.html" title="Boost.Local 0.2.0">
+<link rel="up" href="index.html" title="Boost.Local 0.2.0">
<link rel="prev" href="boost_local/Advanced_Topics.html" title="Advanced Topics">
<link rel="next" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">
</head>
Modified: sandbox/local/libs/local/doc/qbk/introduction.qbk
==============================================================================
--- sandbox/local/libs/local/doc/qbk/introduction.qbk (original)
+++ sandbox/local/libs/local/doc/qbk/introduction.qbk 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -13,7 +13,7 @@
* Local functions can access, or better [@http://en.wikipedia.org/wiki/Name_binding /bind/], any of the variables from the enclosing scope.
Furthermore, local functions defined within a member function can bind the enclosing object `this`.
-* The local function body is programmed using the usual C++ syntax (as a consequence, compiler error messages and line numbers retain their usual meaning).
+* The local function body is programmed using the usual C++ syntax (as a consequence, compiler error messages and related line numbers retain their usual meaning).
* Local functions can be passed as template parameters (so they can be conveniently passed to STL algorithms, etc).
* However, local functions must be defined within a declarative context (e.g., at a point in the code where local variables can be declared) thus they cannot be defined within an expression.
@@ -26,16 +26,12 @@
[h5 Two Syntaxes]
This library uses macros to declare the local functions, local blocks, and local exits.
-The library macros support two different syntaxes:
+These macros support two different syntaxes:
* The /sequencing macro syntax/ is fully compliant with the ISO C++ standard and supported on all C++ compilers.
This syntax requires to wrap the local function parameters and bound variables between round parenthesis `()`.
-* The /variadic macro synstax/ is available only on C++ compilers that support [@http://en.wikipedia.org/wiki/Variadic_macro variadic macros].
-[footnote
-Variadic macros were first introduced by the C99 preprocessor (via the use of the special macro symbols ellipses `...` and `__VA_ARGS__`).
-They are now supported on essentially all modern C++ compilers (GCC, MVSC, etc).
-]
-This syntax allow to use commas `,` to separate macro parameters therefore resembling the usual C++ syntax for function parameter declaration.
+* The /variadic macro synstax/ is available only on C++ compilers that support [@http://en.wikipedia.org/wiki/Variadic_macro variadic macros] (variadic macros are now supported by essentially all modern C++ compilers including GCC and MSVC).
+This syntax allows to use commas `,` to separate macro parameters therefore resembling the usual C++ syntax for function parameter declaration.
The same library macros accept both syntaxes on compilers that support variadic macros and only the sequencing macro syntax on compilers that do not support variadic macros.
The use of the variadic macro syntax might lead to more readable code however it should only be used when programmers know that their code will be compiled with variadic macros support to avoid portability issues.
@@ -61,27 +57,27 @@
The local function result type is specified just before the parameter macro.
# This library macros introduce the special "keyword" `bind` which can be used instead of the parameter type to bind variables in scope.
Variables can be bound by value, by reference, by constant value, and by constant reference.
-In addition, the object `this` can be bound (but never by reference) from within a non-static member function (see the __Tutorial__ section).
+In addition, the object `this` can be bound (eventually by constant value but never by reference or constant reference) from within a non-static member function (see the __Tutorial__ section).
For example, the variable `factor` is bound by constant value so it cannot be mistakenly modified by the local function body.
The variable `sum` is instead bound by non-constant reference because the local function needs to change its value to report the summation result to the enclosing scope.
# The local function body is programmed outside the macros with the usual C++ syntax.
-Eventual compiler error messages and line numbers retain their usual meaning.
+Eventual compiler error messages and related line numbers retain their usual meaning.
Exceptions specifications can be programmed outside the macro and just before the body code block `{...}` as usual.
-Finally, within the local function body the type of a bound variable can be accessed using [^__BOOST_LOCAL_TYPEOF__(['variable-name])].
-(See the __Tutorial__ section.)
+Finally, within the local function body the type of a bound variable can be accessed using [^__BOOST_LOCAL_TYPEOF__(['bound-variable-name])] (see the __Advanced_Topics__ section).
# The macro ending the local function definition specifies the local function name.
No semicolon `;` is required after the ending macro.
# The local function macros declare a functor object local to the enclosing scope named `add`.
The functor `add` has `void` result type, it can be called by specifying one parameter of type `double`, and it has access to the variables in scope `factor` (by constant value) and `sum` (by reference).
# The *local exit* declaration macro only specifies the variables in scope to bind (by reference or value and eventually as constants).
-Exceptions specifications can be programmed outside the macro and just before the body code block `{...}` as usual (see the __Tutorial__ section).
+Exceptions specifications can be programmed outside the macro and just before the body code block `{...}` as usual.
# The local exit code will be automatically executed when the enclosing scope is exited.
# Local exits are anonymous so their ending macro takes no argument.
No semicolon `;` is required after the ending macro.
# The local function `add` can also be passed as a template parameter (for example, to the STL `std::for_each` algorithm).
# The *local block* declaration macro only specifies the variables in scope to bind (by reference or value and eventually as constants).
-# The local block code is executed "in place" where it is programmed like a usual C++ block of code `{ ... }`.
-In this example, the compiler will correctly generate an error if the assignment operator `=` is mistakenly used instead of the equality operator `==` because the variable `sum` is bound by constant reference so it cannot be modified.
+Exceptions specifications can be programmed outside the macro and just before the body code block `{...}` as usual.
+# The local block code is executed "in place" where it is programmed like a usual C++ block of code.
+In this example, the compiler will correctly generate an error if the assignment operator `=` is mistakenly used instead of the equality operator `==` because the variable `sum` is bound by constant reference so it cannot be modified within the local block.
# Local blocks are anonymous so their ending macro takes no argument.
No semicolon `;` is required after the ending macro.
Modified: sandbox/local/libs/local/doc/qbk/local.qbk
==============================================================================
--- sandbox/local/libs/local/doc/qbk/local.qbk (original)
+++ sandbox/local/libs/local/doc/qbk/local.qbk 2011-03-25 12:03:33 EDT (Fri, 25 Mar 2011)
@@ -6,7 +6,7 @@
[preface Boost.Local
[quickbook 1.5]
- [version 0.1.1 ]
+ [version 0.2.0 ]
[/ purpose Local functions, blocks, and exits for C++]
[/ category Function Objects and Higher-Order Programming]
[authors [Caminiti (lorcaminiti_at_[hidden]), Lorenzo]]
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