Boost-Commit :

Date view	Thread view	Subject view	Author view

Subject: [Boost-commit] svn:boost r69846 - in sandbox/local: boost/local/aux_ libs/local/doc/html libs/local/doc/html/boost/local libs/local/doc/html/boost_local libs/local/doc/qbk libs/local/example
From: lorcaminiti_at_[hidden]
Date: 2011-03-11 09:33:25

Author: lcaminiti
Date: 2011-03-11 09:33:21 EST (Fri, 11 Mar 2011)
New Revision: 69846
URL: http://svn.boost.org/trac/boost/changeset/69846

Log:
Migrating to new laptop.
Added:
   sandbox/local/libs/local/example/typeof_tpl_va.cpp (contents, props changed)
   sandbox/local/libs/local/example/typeof_va.cpp (contents, props changed)
Text files modified:
   sandbox/local/boost/local/aux_/function.hpp | 2
   sandbox/local/libs/local/doc/html/BOOST_IDENTITY_TYPE.html | 6
   sandbox/local/libs/local/doc/html/BOOST_IDENTITY_VALUE.html | 6
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_END.html | 2
   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_END.html | 2
   sandbox/local/libs/local/doc/html/boost/local/function.html | 6
   sandbox/local/libs/local/doc/html/boost_local/Advanced.html | 502 +++++++++++++++++++++++++++++++--------
   sandbox/local/libs/local/doc/html/boost_local/Alternatives.html | 5
   sandbox/local/libs/local/doc/html/boost_local/Starting.html | 8
   sandbox/local/libs/local/doc/html/boost_local/Tutorial.html | 97 ++++---
   sandbox/local/libs/local/doc/html/index.html | 8
   sandbox/local/libs/local/doc/html/reference.html | 2
   sandbox/local/libs/local/doc/qbk/advanced.qbk | 133 ++++++----
   sandbox/local/libs/local/doc/qbk/alternatives.qbk | 5
   sandbox/local/libs/local/doc/qbk/local.qbk | 4
   sandbox/local/libs/local/doc/qbk/starting.qbk | 2
   sandbox/local/libs/local/doc/qbk/tutorial.qbk | 22 +
   sandbox/local/libs/local/example/typeof_tpl.cpp | 2
   20 files changed, 588 insertions(+), 234 deletions(-)

Modified: sandbox/local/boost/local/aux_/function.hpp
==============================================================================
--- sandbox/local/boost/local/aux_/function.hpp (original)
+++ sandbox/local/boost/local/aux_/function.hpp 2011-03-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -34,7 +34,7 @@
     typename BOOST_LOCAL_AUX_arg_type(z, arg_n, unused)

#define BOOST_LOCAL_AUX_concrete_operator_call(z, defaults_n, arity) \
- inline R operator()(BOOST_PP_ENUM_ ## z(BOOST_PP_SUB(arity, defaults_n), \
+ R operator()(BOOST_PP_ENUM_ ## z(BOOST_PP_SUB(arity, defaults_n), \
                 BOOST_LOCAL_AUX_arg, ~)) const { \
         assert(ptr_); \
         return (*ptr_)(BOOST_PP_ENUM_ ## z(BOOST_PP_SUB(arity, defaults_n), \

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-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -33,8 +33,8 @@

BOOST_IDENTITY_TYPE(parenthesized_type)</pre></div>
<div class="refsect1">
-<a name="id900741"></a><h2>Description</h2>
-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.html" title="Advanced">Advanced</a> section).
+<a name="id908060"></a><h2>Description</h2>
+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.html" title="Advanced Topics">Advanced</a> section).
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).
Parameters: 
<div class="informaltable"><table class="table">
@@ -49,7 +49,7 @@
</table></div>


-See: <a class="link" href="boost_local/Advanced.html" title="Advanced">Advanced</a> section. 
+See: <a class="link" href="boost_local/Advanced.html" title="Advanced Topics">Advanced</a> section. 
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>

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-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -33,8 +33,8 @@

BOOST_IDENTITY_VALUE(parenthesized_value)</pre></div>
<div class="refsect1">
-<a name="id900882"></a><h2>Description</h2>
-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.html" title="Advanced">Advanced</a> section).
+<a name="id908200"></a><h2>Description</h2>
+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.html" title="Advanced Topics">Advanced</a> section).
For example <code class="computeroutput">BOOST_IDENTITY_VALUE((key_size<int, double>::value))</code> can be passed as a single macro parameter when instead <code class="computeroutput">key_size<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).
Parameters: 
<div class="informaltable"><table class="table">
@@ -49,7 +49,7 @@
</table></div>


-See: <a class="link" href="boost_local/Advanced.html" title="Advanced">Advanced</a> section. 
+See: <a class="link" href="boost_local/Advanced.html" title="Advanced Topics">Advanced</a> section. 
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>

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-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -33,7 +33,7 @@

BOOST_LOCAL_BLOCK_END</pre></div>
<div class="refsect1">
-<a name="id898654"></a><h2>Description</h2>
+<a name="id905973"></a><h2>Description</h2>
This macro must follow the local block body code <code class="computeroutput">{ ... }</code> as shown in the <code class="computeroutput">CONTRACT_DETAIL_LOCAL_BLOCK</code> documentation.
See: <code class="computeroutput">CONTRACT_DETAIL_LOCAL_BLOCK</code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. 
</div>

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-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -33,14 +33,14 @@

BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX</pre></div>
<div class="refsect1">
-<a name="id898787"></a><h2>Description</h2>
+<a name="id906105"></a><h2>Description</h2>
Note: If programmers leave this macro undefined, its default value is undefined.
If this macro is defined, variadic macros and empty macro parameters are not supported. Variadic macros, are supported by most recent compilers (like MSVC and GCC) and they were first introduced by the C99 preprocessor. However, they are not part of the official ISO C++ standard.
See: <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. Maximum number of function parameters supported for the local functions.
Note: If programmers leave this macro undefined, its default value is <code class="computeroutput">5</code>.
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).
Warning: Increasing this number will increase compilation time.
-See: <a class="link" href="boost_local/Starting.html" title="Starting">Starting</a> section. 
+See: <a class="link" href="boost_local/Starting.html" title="Getting Started">Starting</a> section. 
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>

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-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -33,10 +33,10 @@

BOOST_LOCAL_CONFIG_THIS_PARAM_NAME</pre></div>
<div class="refsect1">
-<a name="id898920"></a><h2>Description</h2>
+<a name="id906239"></a><h2>Description</h2>
Note: If programmers leave this macro undefined, the default symbol used is <code class="computeroutput">this_</code>.
Warning: 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.
-See: <a class="link" href="boost_local/Starting.html" title="Starting">Starting</a> section. 
+See: <a class="link" href="boost_local/Starting.html" title="Getting Started">Starting</a> section. 
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>

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-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -33,7 +33,7 @@

BOOST_LOCAL_EXIT_END</pre></div>
<div class="refsect1">
-<a name="id899144"></a><h2>Description</h2>
+<a name="id906463"></a><h2>Description</h2>
This macro must follow the local exit body code <code class="computeroutput">{ ... }</code> as shown in the <code class="computeroutput">CONTRACT_DETAIL_LOCAL_EXIT</code> documentation.
See: <code class="computeroutput">CONTRACT_DETAIL_LOCAL_EXIT</code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. 
</div>

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-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -35,9 +35,9 @@
struct <a class="link" href="function.html" title="Struct template function">function</a> {
};</pre></div>
<div class="refsect1">
-<a name="id899480"></a><h2>Description</h2>
+<a name="id906798"></a><h2>Description</h2>
This template defines several specializations to handle a generic number <code class="computeroutput">N</code> of function parameters some of which can have default values. The number of supported function parameters 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>.
-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.html" title="Advanced">Advanced</a> section): 
+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.html" title="Advanced Topics">Advanced</a> section): 
<pre class="programlisting"> template<typename Result, typename Arg1, ..., typename ArgN, size_t defaults = 0>
class function_ref<Result (Arg1, ..., ArgN), defaults> {
public:
@@ -83,7 +83,7 @@


Note: This template is similar to <code class="computeroutput">boost::function<></code> but it also supports eventual default parameters.
-See: <a class="link" href="../../boost_local/Advanced.html" title="Advanced">Advanced</a> section, <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>, <code class="computeroutput">BOOST_LOCAL_FUNCTION</code>, Boost.Function. 
+See: <a class="link" href="../../boost_local/Advanced.html" title="Advanced Topics">Advanced</a> section, <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>, <code class="computeroutput">BOOST_LOCAL_FUNCTION</code>, Boost.Function. 
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>

Modified: sandbox/local/libs/local/doc/html/boost_local/Advanced.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Advanced.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Advanced.html 2011-03-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -1,7 +1,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
-<title>Advanced</title>
+<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">
@@ -24,7 +24,7 @@
</div>
<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="boost_local.Advanced"></a><a class="link" href="Advanced.html" title="Advanced">Advanced</a>
+<a name="boost_local.Advanced"></a><a class="link" href="Advanced.html" title="Advanced Topics">Advanced Topics</a>
</h2></div></div></div>
<div class="toc"><dl>
<dt><a href="Advanced.html#boost_local.Advanced.commas_and_symbols_in_macro_parameters">Commas
@@ -53,13 +53,12 @@
 and Symbols in Macro Parameters</a>
</h3></div></div></div>

- The C++ preprocessor does not allow commas "<code class="computeroutput">,</code>"
+ The C++ preprocessor does not allow commas <code class="computeroutput">,</code>
 within macro parameters unless they are wrapped by the round parenthesis
 <code class="computeroutput">()</code>. Therefore, using commas
- the local function parameters and bindings passed to this library macros
- ill generate (cryptic) preprocessor errors unless they are wrapped within
- extra round parenthesis <code class="computeroutput">()</code> as
- explained here.
+ within the local function parameters and bindings will generate (cryptic)
+ preprocessor errors unless they are wrapped within extra round parenthesis
+ <code class="computeroutput">()</code> as explained here.
 
<div class="note"><table border="0" summary="Note">
<tr>
@@ -83,7 +82,7 @@

 In addition, local function parameter types cannot start with non-alphanumeric
 symbols (alphanumeric symbols are <code class="computeroutput">A-Z</code>, <code class="computeroutput">a-z</code>,
- and <code class="computeroutput">0-9</code>). [<a name="id880579" href="#ftn.id880579" class="footnote">15</a>] The library will generate (cryptic) preprocessor errors if a
+ and <code class="computeroutput">0-9</code>). [<a name="id880823" href="#ftn.id880823" class="footnote">15</a>] The library will generate (cryptic) preprocessor errors if a
 parameter type starts with a non-alphanumeric symbol.
 

@@ -111,13 +110,13 @@
 


-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
 const std::map<std::string, size_t>& m, // (1) Error.
 ::sign_t sign, // (2) Error.
 const size_t& factor, default
 key_size<std::string, size_t>::value, // (3) Error.
 const std::string& separator, default cat(":", " "), // (4) OK.
-)
+) ...
</pre>

 
@@ -126,13 +125,13 @@
 


-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
 (const std::map<std::string, size_t>& m) // (1) Error.
 (::sign_t sign) // (2) Error.
 (const size_t& factor)(default
 key_size<std::string, size_t>::value) // (3) Error.
 (const std::string& separator)(default cat(":", " ")) // (4) OK.
-)
+) ...
</pre>

 
@@ -141,12 +140,12 @@
</table></div>

 (1) The parameter type <code class="computeroutput">const
- std::map<std::string, size_t>&</code> contains a comma "<code class="computeroutput">,</code>" after the first template parameter
- <code class="computeroutput">std::string</code>. This comma is not wrapped by any
- round parenthesis <code class="computeroutput">()</code> (the outer
- parenthesis <code class="computeroutput">()</code> that make the
- sequencing macro syntax do not count) thus it will cause a preprocessor error.
- The macro <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a>(</code>parenthesized-type<code class="computeroutput">)</code> can be used to wrap a type within extra
+ std::map<std::string, size_t>&</code> contains a comma <code class="computeroutput">,</code>
+ after the first template parameter <code class="computeroutput">std::string</code>.
+ This comma is not wrapped by any round parenthesis <code class="computeroutput">()</code>
+ (the outer parenthesis <code class="computeroutput">()</code> that
+ make the sequencing macro syntax do not count) thus it will cause a preprocessor
+ error. The macro <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a>(</code>parenthesized-type<code class="computeroutput">)</code> can be used to wrap a type within extra
 parenthesis <code class="computeroutput">()</code> so to overcome
 this issue:
 
@@ -172,10 +171,10 @@
 


-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <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_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((const std::map<std::string, size_t>&)) m, // OK.
 ...
-)
+) ...
</pre>

 
@@ -184,10 +183,10 @@
 


-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <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_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((const std::map<std::string, size_t>&)) m) // OK.
 ...
-)
+) ...
</pre>

 
@@ -204,16 +203,17 @@
 macro.
 </li>
<li class="listitem">
- Parenthesis to wrap the type expression (and therefore any commas "<code class="computeroutput">,</code>" that it contains) passed as parameter
+ Parenthesis to wrap the type expression (and therefore any commas <code class="computeroutput">,</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. [<a name="id881869" href="#ftn.id881869" class="footnote">16</a>]
+ macro. [<a name="id882181" href="#ftn.id882181" class="footnote">16</a>]
 </li>
</ol></div>

 (2) The parameter type <code class="computeroutput">::sign_t</code> start with the non-alphanumeric
- symbols "<code class="computeroutput">::</code>" thus
- it cannot be used by the parenthesized syntax. The macros <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code> can also
- be used to overcome these issue:
+ symbols <code class="computeroutput">::</code> thus it will generate
+ preprocessor errors if used as a local function parameter type. The macros
+ <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ can also be used to overcome this issue:
 
<div class="informaltable"><table class="table">
<colgroup>
@@ -237,11 +237,11 @@
 


-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <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_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((::sign_t)) sign, // OK.
 ...
-)
+) ...
</pre>

 
@@ -250,11 +250,11 @@
 


-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <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_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((::sign_t)) sign) // OK.
 ...
-)
+) ...
</pre>

 
@@ -263,9 +263,10 @@
</table></div>

 Often, there might be better ways to overcome this limitation that lead to
- code which is more readable than the one using these macros. For example,
- in this case the symbol "<code class="computeroutput">::</code>"
- could be simply dropped to obtain the following and more readable code:
+ code which is more readable than the one using the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro. For example, in this case the symbols <code class="computeroutput">::</code>
+ could have been simply dropped to obtain the following valid and more readable
+ code:
 
<div class="informaltable"><table class="table">
<colgroup>
@@ -289,11 +290,11 @@
 


-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
 ...
- sign_t sign, // OK.
+ sign_t sign, // OK.
 ...
-)
+) ...
</pre>

 
@@ -302,11 +303,11 @@
 


-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
 ...
 (sign_t sign) // OK.
 ...
-)
+) ...
</pre>

 
@@ -315,11 +316,11 @@
</table></div>

 (3) The default parameter value <code class="computeroutput">key_size<std::string, size_t>::value</code>
- contains a comma "<code class="computeroutput">,</code>"
- after the first template parameter <code class="computeroutput">std::string</code>.
+ contains a comma <code class="computeroutput">,</code> after the
+ first template parameter <code class="computeroutput">std::string</code>.
 Again, this comma is not wrapped by any parenthesis <code class="computeroutput">()</code>
 so it will cause a preprocessor error. Because this is a value expression
- (and not a type expression), it can simply be wrapped within an extra set
+ (and not a type expression), it can be simply wrapped within an extra set
 of round parenthesis <code class="computeroutput">()</code>:
 
<div class="informaltable"><table class="table">
@@ -344,12 +345,12 @@
 


-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
 ...
 const size_t& factor, default
 (key_size<std::string, size_t>::value), // OK.
 ...
-)
+) ...
</pre>

 
@@ -358,12 +359,12 @@
 


-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
 ...
 (const size_t& factor)(default
 (key_size<std::string, size_t>::value)) // OK.
 ...
-)
+) ...
</pre>

 
@@ -376,24 +377,36 @@
<th align="left">Note</th>
</tr>
<tr><td align="left" valign="top">
- Alternatively, the macro <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">BOOST_IDENTITY_VALUE</a>(</code>parenthesized-value<code class="computeroutput">)</code> could have been equivalently used. This
- macro expands to an expression that evaluates (at run-time) exactly to
- the specified value (but it adds overhead compared with simply using the
- extra parenthesis <code class="computeroutput">()</code>). Note
- that, similarly to <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>,
+ Alternatively, the macro <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">BOOST_IDENTITY_VALUE</a>(</code>parenthesized-value<code class="computeroutput">)</code> could have been used. This macro expands
+ to an expression that evaluates (at run-time) exactly to the specified
+ value -- but it adds overhead compared with simply using the extra parenthesis
+ <code class="computeroutput">()</code>. Note that, similarly to
+ <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>,
 the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">BOOST_IDENTITY_VALUE</a></code>
 macro also requires two sets of extra parenthesis one set for invoking
- the macro and another set to wrap the value.
+ the macro and another set to wrap the value expression passed as the macro
+ parameter.
 </td></tr>
</table></div>

- (4) The default parameter value <code class="computeroutput">cat(':', ' ')</code>
- is instead fine because it contains a comma "<code class="computeroutput">,</code>"
- which is already wrapped by the parenthesis <code class="computeroutput">()</code>
- of the function call <code class="computeroutput">cat(...)</code>.
+ (4) The default parameter value <code class="computeroutput">cat(":", " ")</code> is instead fine because it contains a comma
+ <code class="computeroutput">,</code> which is already wrapped by
+ the parenthesis <code class="computeroutput">()</code> of the function
+ call <code class="computeroutput">cat(...)</code>.
 
+<div class="important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../../doc/src/images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ The <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro must be prefixed by the <code class="computeroutput">typename</code>
+ keyword when used within templates.
+ </td></tr>
+</table></div>

- Consider the following complete example: [<a name="id883052" href="#ftn.id883052" class="footnote">17</a>]
+ Consider the following complete example: [<a name="id883486" href="#ftn.id883486" class="footnote">17</a>]
 
<div class="informaltable"><table class="table">
<colgroup>
@@ -501,16 +514,306 @@
 </td>
</tr></tbody>
</table></div>
-
- The <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
- macro must be prefixed by the <code class="computeroutput">typename</code>
- keyword when used within templates.
- 
</div>
-<div class="section"><div class="titlepage"><div><div><h3 class="title">
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
<a name="boost_local.Advanced.deducing_bound_types"></a><a class="link" href="Advanced.html#boost_local.Advanced.deducing_bound_types" title="Deducing Bound Types">Deducing Bound
 Types</a>
-</h3></div></div></div></div>
+</h3></div></div></div>
+
+ While the ISO C++ standard does not allow for member functions of local classes
+ to have template parameters, this library allows to call template functions
+ from within a local function, a local block, or a local exit passing bound
+ variables without explicitly specifying their types. This essentially allows
+ local functions, local blocks, and local exits to be polymorphic
+ in the type of the bound variables (like a template is polymorphic in the
+ type of its template parameters).
+ 
+
+ Furthermore, this library allow to access the type of the bound variables
+ from within the local function, local block, or local exit using the following
+ macro:
+ 
+<pre class="programlisting">#include <boost/local/typeof.hpp>
+
+... // Within a local function, local block, or local exit.
+<code class="computeroutput">BOOST_LOCAL_TYPEOF</code>(bound-variable) ...
+...
+</pre>
+
+ This macro expands to a type expression that evaluates (at compile-time)
+ to the fully qualified type of the specified bound variable. This type expression
+ is fully qualified in the sense that it will be constant if the variable
+ is bound by constant and it will also be a reference is the variable is bound
+ by reference (if needed, programmers can strip away the <code class="computeroutput">const</code>
+ and <code class="computeroutput">&</code> qualifiers using
+ <code class="computeroutput">boost::remove_const</code> and <code class="computeroutput">boost::remove_reference</code>,
+ or similar template metafunctions).
+ 
+
+ For example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <algorithm>
+#include <cassert>
+
+double total(const double& x, const double& y, const double& z) {
+ double sum = double();
+ int factor = 10;
+
+ double BOOST_LOCAL_FUNCTION_PARAMS(double num, const bind factor,
+ bind& sum) {
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ double* nums = new double[size];
+ BOOST_LOCAL_EXIT(const bind& size, bind nums) {
+ BOOST_LOCAL_TYPEOF(size) s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK(const bind &sum, const bind& factor,
+ const bind& x, const bind& y, const bind& z) {
+ // Typeof qualified with eventual bind's `const` and `&`.
+ boost::remove_const<boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(sum)>::type>::type s;
+ s = sum;
+ assert(s == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <algorithm>
+#include <cassert>
+
+double total(const double& x, const double& y, const double& z) {
+ double sum = double();
+ int factor = 10;
+
+ double BOOST_LOCAL_FUNCTION_PARAMS( (double num) (const bind factor)
+ (bind& sum) ) {
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ double* nums = new double[size];
+ BOOST_LOCAL_EXIT( (const bind& size) (bind nums) ) {
+ BOOST_LOCAL_TYPEOF(size) s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK( (const bind &sum) (const bind& factor)
+ (const bind& x) (const bind& y) (const bind& z) ) {
+ // Typeof qualified with eventual bind's `const` and `&`.
+ boost::remove_const<boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(sum)>::type>::type s;
+ s = sum;
+ assert(s == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ Within templates, <code class="computeroutput">BOOST_LOCAL_TYPEOF</code>
+ does not require to be prefixed by the <code class="computeroutput">typename</code>
+ keyword but eventual type manipulations need the <code class="computeroutput">typename</code>
+ prefix as usual:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <algorithm>
+#include <cassert>
+
+template<typename T>
+T total(const T& x, const T& y, const T& z) {
+ T sum = T();
+ int factor = 10;
+
+ T BOOST_LOCAL_FUNCTION_PARAMS_TPL(T num, const bind factor,
+ bind& sum) {
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ T* nums = new T[size];
+ BOOST_LOCAL_EXIT_TPL(const bind& size, bind nums) {
+ BOOST_LOCAL_TYPEOF(size) s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK_TPL(const bind &sum, const bind& factor,
+ const bind& x, const bind& y, const bind& z) {
+ // Typeof qualified with eventual bind's `const` and `&`.
+ typename boost::remove_const<typename boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(sum)>::type>::type s;
+ s = sum;
+ assert(s == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <algorithm>
+#include <cassert>
+
+template<typename T>
+T total(const T& x, const T& y, const T& z) {
+ T sum = T();
+ int factor = 10;
+
+ T BOOST_LOCAL_FUNCTION_PARAMS_TPL( (T num) (const bind factor)
+ (bind& sum) ) {
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ T* nums = new T[size];
+ BOOST_LOCAL_EXIT_TPL( (const bind& size) (bind nums) ) {
+ BOOST_LOCAL_TYPEOF(size) s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK_TPL( (const bind &sum) (const bind& factor)
+ (const bind& x) (const bind& y) (const bind& z) ) {
+ // Typeof qualified with eventual bind's `const` and `&`.
+ typename boost::remove_const<typename boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(sum)>::type>::type s;
+ s = sum;
+ assert(s == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
<div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_local.Advanced.passing_local_functions"></a><a class="link" href="Advanced.html#boost_local.Advanced.passing_local_functions" title="Passing Local Functions">Passing
@@ -529,7 +832,7 @@
 Local functions are never copied by value. You can only obtain a reference
 to a local function therefore you need to make sure that the local function survives the scope of its reference
 otherwise the reference will be invalid and its use will generate a run-time
- error (as usual with C++ references). [<a name="id886296" href="#ftn.id886296" class="footnote">18</a>]
+ error (as usual with C++ references). [<a name="id893596" href="#ftn.id893596" class="footnote">18</a>]
 </td></tr>
</table></div>

@@ -723,11 +1026,10 @@
</tr></tbody>
</table></div>

- In addition, a local function can be bind and call another local function.
- For example, the following local function <code class="computeroutput">inc_sum</code>
+ In addition, a local function can bind and call another local function. For
+ example, the following local function <code class="computeroutput">inc_sum</code>
 binds the local function <code class="computeroutput">inc</code>
- so the <code class="computeroutput">inc_sum</code> can call
- <code class="computeroutput">inc</code>:
+ so <code class="computeroutput">inc_sum</code> can call <code class="computeroutput">inc</code>:
 
<div class="informaltable"><table class="table">
<colgroup>
@@ -776,7 +1078,7 @@

 // v = ++(v + w) + 0 = 27 47 67 87 107
 int BOOST_LOCAL_FUNCTION_PARAMS(int i, int j,
- bind inc) { // Bind another local function.
+ const bind& inc) { // Bind another local function.
 return inc(i + j); // Call the bound local function.
 } BOOST_LOCAL_FUNCTION_NAME(inc_sum)
 std::transform(v.begin(), v.end(), w.begin(), v.begin(), inc_sum);
@@ -820,7 +1122,7 @@

 // v = ++(v + w) + 0 = 27 47 67 87 107
 int BOOST_LOCAL_FUNCTION_PARAMS( (int i) (int j)
- (bind inc) ) { // Bind another local function.
+ (const bind& inc) ) { // Bind another local function.
 return inc(i + j); // Call the bound local function.
 } BOOST_LOCAL_FUNCTION_NAME(inc_sum)
 std::transform(v.begin(), v.end(), w.begin(), v.begin(), inc_sum);
@@ -916,9 +1218,6 @@
 </td></tr>
</table></div>

- For example:
- 
-


<pre class="programlisting">#include <boost/local/function.hpp>
@@ -1003,14 +1302,14 @@
 to usual features of C++ functions.
 
<a name="boost_local.Advanced.limitations__overloading_and_operators.overloading"></a><h6>
-<a name="id895860"></a>
+<a name="id903180"></a>
 <a class="link" href="Advanced.html#boost_local.Advanced.limitations__overloading_and_operators.overloading">Overloading</a>
 </h6>

 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). [<a name="id895879" href="#ftn.id895879" class="footnote">19</a>]
+ parameters). [<a name="id903199" href="#ftn.id903199" class="footnote">19</a>]
 

 For example, the following code will not
@@ -1033,12 +1332,12 @@
}
</pre>
<a name="boost_local.Advanced.limitations__overloading_and_operators.nesting"></a><h6>
-<a name="id896320"></a>
+<a name="id903640"></a>
 <a class="link" href="Advanced.html#boost_local.Advanced.limitations__overloading_and_operators.nesting">Nesting</a>
 </h6>

 It is not possible to nest local functions, local blocks, or local exits
- within each other. Nesting will generate a compile-time error. [<a name="id896342" href="#ftn.id896342" class="footnote">20</a>]
+ within each other. Nesting will generate a compile-time error. [<a name="id903662" href="#ftn.id903662" class="footnote">20</a>]
 

 For example, the following code will not
@@ -1061,12 +1360,12 @@
}
</pre>
<a name="boost_local.Advanced.limitations__overloading_and_operators.operators"></a><h6>
-<a name="id896744"></a>
+<a name="id904064"></a>
 <a class="link" href="Advanced.html#boost_local.Advanced.limitations__overloading_and_operators.operators">Operators</a>
 </h6>

 Local functions cannot be operators. Naming a local function <code class="computeroutput">operator...</code>
- will generate a compile-time error. [<a name="id896780" href="#ftn.id896780" class="footnote">21</a>]
+ will generate a compile-time error. [<a name="id904100" href="#ftn.id904100" class="footnote">21</a>]
 

 For example, the following code will not
@@ -1088,7 +1387,7 @@
}
</pre>
<a name="boost_local.Advanced.limitations__overloading_and_operators.etc"></a><h6>
-<a name="id897173"></a>
+<a name="id904493"></a>
 <a class="link" href="Advanced.html#boost_local.Advanced.limitations__overloading_and_operators.etc">Etc</a>
 </h6>

@@ -1219,7 +1518,7 @@
 </td>
<td>
 
- This is supported (see the <a class="link" href="Advanced.html" title="Advanced">Advanced</a>
+ This is supported (see the <a class="link" href="Advanced.html" title="Advanced Topics">Advanced</a>
 section).
 
 </td>
@@ -1320,7 +1619,7 @@
 
 This is supported but it cannot be overloaded and it cannot be
 an operator (see the <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a>
- and <a class="link" href="Advanced.html" title="Advanced">Advanced</a> sections).
+ and <a class="link" href="Advanced.html" title="Advanced Topics">Advanced</a> sections).
 
 </td>
</tr>
@@ -1341,7 +1640,7 @@
 and <code class="computeroutput">register</code> parameter
 classifiers, default parameters, and binding of variables in scope
 (see the <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a> and
- <a class="link" href="Advanced.html" title="Advanced">Advanced</a> sections).
+ <a class="link" href="Advanced.html" title="Advanced Topics">Advanced</a> sections).
 
 
 In addition, the parenthesized syntax could support named parameters
@@ -1393,47 +1692,48 @@
</div>
<div class="footnotes">
 <hr width="100" align="left">
-<div class="footnote">[<a id="ftn.id880579" href="#id880579" class="para">15</a>] 
- Rationale. This limitation cames from
- the implementation of the library parsing macros that use 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.
+<div class="footnote">[<a id="ftn.id880823" href="#id880823" class="para">15</a>] 
+ Rationale. 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.
 </div>
-<div class="footnote">[<a id="ftn.id881869" href="#id881869" class="para">16</a>] 
+<div class="footnote">[<a id="ftn.id882181" href="#id882181" class="para">16</a>] 
 Rationale. 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. This feature is currently not implemented and the double parenthesis
- are always needed when invoking this macro.
+ macro. However, this feature is currently not implemented and the double
+ parenthesis are always needed when invoking this macro.
 </div>
-<div class="footnote">[<a id="ftn.id883052" href="#id883052" class="para">17</a>] 
+<div class="footnote">[<a id="ftn.id883486" href="#id883486" class="para">17</a>] 
 The authors recognize that the use of the identity macros
 adds extra parenthesis to the already significant number of parenthesis
- required by the parenthesized syntax. However, macro parameters usually
- do not contain unwrapped commas "<code class="computeroutput">,</code>"
- (unless template metaprogramming is being used).
+ required by the sequencing macro syntax. However, macro parameters usually
+ do not contain unwrapped commas <code class="computeroutput">,</code>
+ (unless template metaprogramming is being used) so this is usually not
+ a problem.
 </div>
-<div class="footnote">[<a id="ftn.id886296" href="#id886296" class="para">18</a>] 
+<div class="footnote">[<a id="ftn.id893596" href="#id893596" class="para">18</a>] 
 The suffix <code class="computeroutput">ref</code> of <code class="computeroutput">boost::local::<a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code> is meant to
 help programmers remember that they are dealing with references to (and
 not copies of) local functions.
 </div>
-<div class="footnote">[<a id="ftn.id895879" href="#id895879" class="para">19</a>] 
+<div class="footnote">[<a id="ftn.id903199" href="#id903199" class="para">19</a>] 
 Rationale. 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++.
 </div>
-<div class="footnote">[<a id="ftn.id896342" href="#id896342" class="para">20</a>] 
+<div class="footnote">[<a id="ftn.id903662" href="#id903662" class="para">20</a>] 
 Rationale. This is because within a nested
 code block only global or static variables can be accessed while Boost.ScopeExit
 variable <a href="http://lists.boost.org/Archives/boost/2006/11/113658.php" target="_top">binding
 mechanism</a> requires to access local variables that hold the bound
 variables.
 </div>
-<div class="footnote">[<a id="ftn.id896780" href="#id896780" class="para">21</a>] 
+<div class="footnote">[<a id="ftn.id904100" href="#id904100" class="para">21</a>] 
 Rationale. 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-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -42,6 +42,11 @@

The following table compares local function features.

+
+ @todo From Mathias: Minus of Local compared to Lambdas: - creating a local
+ can only be done at statement scope. - locals may not automatically capture
+ all context - size of a local function cannot be optimized to be two words.
+ 
<div class="informaltable"><table class="table">
<colgroup>
<col>

Modified: sandbox/local/libs/local/doc/html/boost_local/Starting.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Starting.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Starting.html 2011-03-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -1,7 +1,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
-<title>Starting</title>
+<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">
@@ -24,7 +24,7 @@
</div>
<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="boost_local.Starting"></a><a class="link" href="Starting.html" title="Starting">Starting</a>
+<a name="boost_local.Starting"></a><a class="link" href="Starting.html" title="Getting Started">Getting Started</a>
</h2></div></div></div>
<div class="toc"><dl>
<dt>This Documentation</dt>
@@ -53,7 +53,7 @@
 provides an overview on the library and its features.
 </li>
<li class="listitem">
- The <a class="link" href="Starting.html" title="Starting">Starting</a> section explains
+ The <a class="link" href="Starting.html" title="Getting Started">Starting</a> section explains
 how to read this documentation, how to install the library to work with
 the supported compilers and platforms.
 </li>
@@ -68,7 +68,7 @@
 
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- The <a class="link" href="Advanced.html" title="Advanced">Advanced</a> section explains
+ The <a class="link" href="Advanced.html" title="Advanced Topics">Advanced</a> section explains
 advanced usages of the library.
 </li>
<li class="listitem">

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-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -6,8 +6,8 @@
<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="Starting.html" title="Starting">
-<link rel="next" href="Advanced.html" title="Advanced">
+<link rel="prev" href="Starting.html" title="Getting Started">
+<link rel="next" href="Advanced.html" title="Advanced Topics">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -49,13 +49,14 @@
 to <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++0x
 lambda</a> functions which can instead be declared within expressions):
 
-<pre class="programlisting">{ // Some declarative context.
- ...
+<pre class="programlisting">#include <boost/local/function.hpp>

+...
+{ // Some declarative context.
+ ...
 result-type <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(parameters) {
 body-code
 } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>(name)
-
 ...
}
</pre>
@@ -114,12 +115,12 @@
 ... }</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.
- [<a name="id865988" href="#ftn.id865988" class="footnote">3</a>]
+ [<a name="id866036" href="#ftn.id866036" class="footnote">3</a>]
 

 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. [<a name="id866018" href="#ftn.id866018" class="footnote">4</a>]
+ name. [<a name="id866072" href="#ftn.id866072" class="footnote">4</a>]
 

 For example, let's program a local function named <code class="computeroutput">add</code>
@@ -365,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">=</code> cannot
- be used. [<a name="id867944" href="#ftn.id867944" class="footnote">5</a>] The keyword <code class="computeroutput">default</code>
+ be used. [<a name="id867998" href="#ftn.id867998" class="footnote">5</a>] The keyword <code class="computeroutput">default</code>
 is used instead:
 
<div class="informaltable"><table class="table">
@@ -468,10 +469,18 @@
 <code class="computeroutput">WITH_DEFAULT</code> macro similar
 to the following if they think it improves readability:
 
-
-
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+

-<pre class="programlisting">#include <boost/local/function.hpp>
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
#include <iostream>

#define WITH_DEFAULT , default
@@ -486,7 +495,9 @@
}
</pre>

- 
+ 
+ </td></tr></tbody>
+</table></div>
</div>
<div class="section">
<div class="titlepage"><div><div><h3 class="title">
@@ -497,7 +508,7 @@
 variables, the object <code class="computeroutput">this</code>,
 etc) can be bound to a local function declaration. The types of bound variables
 are automatically deduced by this library using Boost.Typeof.
- [<a name="id869130" href="#ftn.id869130" class="footnote">6</a>]
+ [<a name="id869232" href="#ftn.id869232" class="footnote">6</a>]
 
<div class="important"><table border="0" summary="Important">
<tr>
@@ -514,7 +525,7 @@
</table></div>

 This library introduces the new "keyword" <code class="computeroutput">bind</code>
- [<a name="id869215" href="#ftn.id869215" class="footnote">7</a>] which is used in place of the parameter type to specify the name
+ [<a name="id869327" href="#ftn.id869327" class="footnote">7</a>] 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:
 
<pre class="programlisting">bind variable-name // Bind by value.
@@ -555,7 +566,7 @@
 unless constant binding is forced using <code class="computeroutput">const
 bind ...</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). [<a name="id869470" href="#ftn.id869470" class="footnote">8</a>] Programmers might want to bind variables of complex types by
+ lambda</a> functions). [<a name="id869592" href="#ftn.id869592" class="footnote">8</a>] 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).
@@ -636,7 +647,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="id870457"></a>
+<a name="id870581"></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">this</code></a>
 </h6>
@@ -690,12 +701,12 @@
 to a local function, the local function body must
 use the special symbol <code class="computeroutput">this_</code>
 (instead of <code class="computeroutput">this</code>) to access
- the bound object. [<a name="id870776" href="#ftn.id870776" class="footnote">9</a>]
+ the bound object. [<a name="id870899" href="#ftn.id870899" class="footnote">9</a>]
 

 Unfortunately, mistakenly using <code class="computeroutput">this</code>
 within the local function body instead of <code class="computeroutput">this_</code>
- will not necessarily generate a compile-time error. [<a name="id870870" href="#ftn.id870870" class="footnote">10</a>] Programmers are responsible to make sure that <code class="computeroutput">this</code> is never used within a local function
+ will not necessarily generate a compile-time error. [<a name="id870993" href="#ftn.id870993" class="footnote">10</a>] Programmers are responsible to make sure that <code class="computeroutput">this</code> is never used within a local function
 body which should only use the special symbol <code class="computeroutput">this_</code>.
 
</td></tr>
@@ -821,13 +832,14 @@
 Local blocks are defined using the following macros within a declarative
 context (see the Reference section):
 
-<pre class="programlisting">{ // Some declarative context.
- ...
+<pre class="programlisting">#include <boost/local/block.hpp>

+...
+{ // Some declarative context.
+ ...
 <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>(bindings) {
 body-code
 } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_BLOCK_END.html" title="Macro BOOST_LOCAL_BLOCK_END">BOOST_LOCAL_BLOCK_END</a></code>
-
 ...
}
</pre>
@@ -855,7 +867,7 @@
 A <code class="computeroutput">return;</code>
 instruction from within a local block jumps to the end of the local block
 body and it does not return the enclosing function.
- [<a name="id873248" href="#ftn.id873248" class="footnote">11</a>]
+ [<a name="id873437" href="#ftn.id873437" class="footnote">11</a>]
 </td></tr>
</table></div>

@@ -941,13 +953,14 @@
 Local exits are defined using the following macros within a declarative context
 (see the Reference section):
 
-<pre class="programlisting">{ // Some declarative context.
- ...
+<pre class="programlisting">#include <boost/local/exit.hpp>

+...
+{ // Some declarative context.
+ ...
 <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code>(bindings) {
- exit-body
+ body-code
 } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_EXIT_END.html" title="Macro BOOST_LOCAL_EXIT_END">BOOST_LOCAL_EXIT_END</a></code>
-
 ...
}
</pre>
@@ -957,7 +970,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. [<a name="id874394" href="#ftn.id874394" class="footnote">12</a>]
+ not terminate because of an uncaught exception. [<a name="id874641" href="#ftn.id874641" class="footnote">12</a>]
 

 Only bound variables specified by <code class="literal">bindings</code>
@@ -1061,10 +1074,10 @@
 Local exits are very similar to the scope exits provided
 by Boost.ScopeExit
 with the addition that they also support constant binding and binding of
- the object <code class="computeroutput">this</code>. [<a name="id875646" href="#ftn.id875646" class="footnote">13</a>]
+ the object <code class="computeroutput">this</code>. [<a name="id875892" href="#ftn.id875892" class="footnote">13</a>]
 
<a name="boost_local.Tutorial.local_exits.d_s_scope_guards"></a><h6>
-<a name="id875873"></a>
+<a name="id876119"></a>
 <a class="link" href="Tutorial.html#boost_local.Tutorial.local_exits.d_s_scope_guards">D's Scope
 Guards</a>
 </h6>
@@ -1156,7 +1169,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">TPL</code> postfix (see
- the Reference section): [<a name="id877428" href="#ftn.id877428" class="footnote">14</a>]
+ the Reference section): [<a name="id877674" href="#ftn.id877674" class="footnote">14</a>]
 
<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>(parameters)
<code class="computeroutput"><a class="link" href="../BOOST_LOCAL_BLOCK_TPL.html" title="Macro BOOST_LOCAL_BLOCK_TPL">BOOST_LOCAL_BLOCK_TPL</a></code>(bindings)
@@ -1289,20 +1302,20 @@
</div>
<div class="footnotes">
 <hr width="100" align="left">
-<div class="footnote">[<a id="ftn.id865988" href="#id865988" class="para">3</a>] 
+<div class="footnote">[<a id="ftn.id866036" href="#id866036" class="para">3</a>] 
 Rationale. 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.
 </div>
-<div class="footnote">[<a id="ftn.id866018" href="#id866018" class="para">4</a>] 
+<div class="footnote">[<a id="ftn.id866072" href="#id866072" class="para">4</a>] 
 Rationale. 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.
 </div>
-<div class="footnote">[<a id="ftn.id867944" href="#id867944" class="para">5</a>] 
+<div class="footnote">[<a id="ftn.id867998" href="#id867998" class="para">5</a>] 
 Rationale. The assignment symbol <code class="computeroutput">=</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
@@ -1312,7 +1325,7 @@
 it counts the number of default values to provide the correct set of call
 operators for the local functor object.
 </div>
-<div class="footnote">[<a id="ftn.id869130" href="#id869130" class="para">6</a>] 
+<div class="footnote">[<a id="ftn.id869232" href="#id869232" class="para">6</a>] 
 Rationale. 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,
@@ -1325,7 +1338,7 @@
 This is especially useful for maintenance so if a bound variable type is
 changed, the local function declaration does not have to change.
 </div>
-<div class="footnote">[<a id="ftn.id869215" href="#id869215" class="para">7</a>] 
+<div class="footnote">[<a id="ftn.id869327" href="#id869327" class="para">7</a>] 
 The token <code class="computeroutput">bind</code> is not a
 real keyword of the C++ language. This library parses <code class="computeroutput">bind</code>
 during macro expansion using preprocessor metaprogramming. Therefore,
@@ -1334,7 +1347,7 @@
 within the syntax defined by the macros of this library -- thus it is referred
 to as a "keyword" only within quotes.
 </div>
-<div class="footnote">[<a id="ftn.id869470" href="#id869470" class="para">8</a>] 
+<div class="footnote">[<a id="ftn.id869592" href="#id869592" class="para">8</a>] 
 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
@@ -1349,7 +1362,7 @@
 generates an error because the bound variable is of <code class="computeroutput">const</code>
 type within the local function body.
 </div>
-<div class="footnote">[<a id="ftn.id870776" href="#id870776" class="para">9</a>] 
+<div class="footnote">[<a id="ftn.id870899" href="#id870899" class="para">9</a>] 
 Rationale. This limitation comes from
 the fact that <code class="computeroutput">this</code> is a
 reserved C++ keyword so it cannot be used as the name of the internal
@@ -1363,7 +1376,7 @@
 behaviour of <code class="computeroutput">static_cast</code></a>
 (which might not work on all platforms at the cost of portability).
 </div>
-<div class="footnote">[<a id="ftn.id870870" href="#id870870" class="para">10</a>] 
+<div class="footnote">[<a id="ftn.id870993" href="#id870993" class="para">10</a>] 
 Rationale. 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>
@@ -1376,7 +1389,7 @@
 is visible but it refers to the local functor object and not to the bound
 object.
 </div>
-<div class="footnote">[<a id="ftn.id873248" href="#id873248" class="para">11</a>] 
+<div class="footnote">[<a id="ftn.id873437" href="#id873437" class="para">11</a>] 
 Rationale. Programmers might expect
 <code class="computeroutput">return;</code>
 to exit the enclosing function instead of the local block (or local exit),
@@ -1394,7 +1407,7 @@
 <code class="computeroutput">BOOST_LOCAL_RETURN;</code>)
 to exit local blocks (and local exits).
 </div>
-<div class="footnote">[<a id="ftn.id874394" href="#id874394" class="para">12</a>] 
+<div class="footnote">[<a id="ftn.id874641" href="#id874641" class="para">12</a>] 
 Rationale. 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
@@ -1403,7 +1416,7 @@
 different from the D programming language which executes the scope exit
 code even if the main program terminates because of an uncaught exception.)
 </div>
-<div class="footnote">[<a id="ftn.id875646" href="#id875646" class="para">13</a>] 
+<div class="footnote">[<a id="ftn.id875892" href="#id875892" class="para">13</a>] 
 Rationale. This library could be merged
 together with Boost.ScopeExit
 into a new library named Boost.Scope (from the meaning of the word "scope"
@@ -1430,7 +1443,7 @@
 name of "<a href="http://gcc.gnu.org/onlinedocs/gcc/Nested-Functions.html" target="_top">nested
 functions</a>".
 </div>
-<div class="footnote">[<a id="ftn.id877428" href="#id877428" class="para">14</a>] 
+<div class="footnote">[<a id="ftn.id877674" href="#id877674" class="para">14</a>] 
 Rationale. Within templates, this library
 needs to use <code class="computeroutput">typename</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-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -5,7 +5,7 @@
<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="next" href="boost_local/Starting.html" title="Starting">
+<link rel="next" href="boost_local/Starting.html" title="Getting Started">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -37,9 +37,9 @@
Table of Contents
<dl>
<dt>Introduction</dt>
-<dt>Starting</dt>
+<dt>Getting Started</dt>
<dt>Tutorial</dt>
-<dt>Advanced</dt>
+<dt>Advanced Topics</dt>
<dt>Reference</dt>
<dt>Appendix: Examples</dt>
<dt>Appendix: Alternatives</dt>
@@ -419,7 +419,7 @@
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left">Last revised: March 10, 2011 at 14:09:29 GMT</td>
+<td align="left">Last revised: March 10, 2011 at 21:42:14 GMT</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-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -6,7 +6,7 @@
<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="boost_local/Advanced.html" title="Advanced">
+<link rel="prev" href="boost_local/Advanced.html" title="Advanced Topics">
<link rel="next" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">

Modified: sandbox/local/libs/local/doc/qbk/advanced.qbk
==============================================================================
--- sandbox/local/libs/local/doc/qbk/advanced.qbk (original)
+++ sandbox/local/libs/local/doc/qbk/advanced.qbk 2011-03-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -4,15 +4,15 @@
[/ License, Version 1.0 (see accompanying file LICENSE_1_0.txt or a ]
[/ copy at http://www.boost.org/LICENSE_1_0.txt). ]

-[section:Advanced Advanced]
+[section:Advanced Advanced Topics]

This section illustrates advanced usage of this library.
At the end of this section there is also a list of knwon limitations of this library.

[section Commas and Symbols in Macro Parameters]

-The C++ preprocessor does not allow commas "`,`" within macro parameters unless they are wrapped by the round parenthesis `()`.
-Therefore, using commas the local function parameters and bindings passed to this library macros ill generate (cryptic) preprocessor errors unless they are wrapped within extra round parenthesis `()` as explained here.
+The C++ preprocessor does not allow commas `,` within macro parameters unless they are wrapped by the round parenthesis `()`.
+Therefore, using commas within the local function parameters and bindings will generate (cryptic) preprocessor errors unless they are wrapped within extra round parenthesis `()` as explained here.

[note
*Macro parameters with commas* which are already wrapped by round parenthesis `()` are fine (function calls, etc).
@@ -23,7 +23,7 @@
In addition, local function parameter types cannot start with non-alphanumeric symbols (alphanumeric symbols are `A-Z`, `a-z`, and `0-9`).
[footnote
*Rationale.*
-This limitation cames from the implementation of the library parsing macros that use preprocessor token concatenation to inspect the parameter type token to see if the token is a parameter or a bound variable.
+This limitation derives from the fact that `__BOOST_LOCAL_FUNCTION_PARAMS__` 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.
]
The library will generate (cryptic) preprocessor errors if a parameter type starts with a non-alphanumeric symbol.
@@ -33,40 +33,40 @@
[table
[ [Variadic Macro Syntax (C99 and later compilers)] [Sequencing Macro Syntax (all C++ compilers)] ]
[ [``
- __BOOST_LOCAL_FUNCTION_PARAMS__(
+ ... __BOOST_LOCAL_FUNCTION_PARAMS__(
 const std::map<std::string, size_t>& m, // (1) Error.
 ::sign_t sign, // (2) Error.
 const size_t& factor, default
 key_size<std::string, size_t>::value, // (3) Error.
 const std::string& separator, default cat(":", " "), // (4) OK.
- )
+ ) ...
``] [``
- __BOOST_LOCAL_FUNCTION_PARAMS__(
+ ... __BOOST_LOCAL_FUNCTION_PARAMS__(
 (const std::map<std::string, size_t>& m) // (1) Error.
 (::sign_t sign) // (2) Error.
 (const size_t& factor)(default
 key_size<std::string, size_t>::value) // (3) Error.
 (const std::string& separator)(default cat(":", " ")) // (4) OK.
- )
+ ) ...
``] ]
]

-[*(1)] The parameter type `const std::map<std::string, size_t>&` contains a comma "`,`" after the first template parameter `std::string`.
+[*(1)] The parameter type `const std::map<std::string, size_t>&` contains a comma `,` after the first template parameter `std::string`.
This comma is not wrapped by any round parenthesis `()` (the outer parenthesis `()` that make the sequencing macro syntax do not count) thus it will cause a preprocessor error.
The macro `__BOOST_IDENTITY_TYPE__(`/parenthesized-type/`)` can be used to wrap a type within extra parenthesis `()` so to overcome this issue:

[table
[ [Variadic Macro Syntax (C99 and later compilers)] [Sequencing Macro Syntax (all C++ compilers)] ]
[ [``
- __BOOST_LOCAL_FUNCTION_PARAMS__(
+ ... __BOOST_LOCAL_FUNCTION_PARAMS__(
 __BOOST_IDENTITY_TYPE__((const std::map<std::string, size_t>&)) m, // OK.
 ...
- )
+ ) ...
``] [``
- __BOOST_LOCAL_FUNCTION_PARAMS__(
+ ... __BOOST_LOCAL_FUNCTION_PARAMS__(
 (__BOOST_IDENTITY_TYPE__((const std::map<std::string, size_t>&)) m) // OK.
 ...
- )
+ ) ...
``] ]
]

@@ -74,89 +74,93 @@
Note that a total of two set of parenthesis `()` are added:

# Parenthesis to invoke the `__BOOST_IDENTITY_TYPE__` macro.
-# Parenthesis to wrap the type expression (and therefore any commas "`,`" that it contains) passed as parameter to the `__BOOST_IDENTITY_TYPE__` macro.
+# Parenthesis to wrap the type expression (and therefore any commas `,` that it contains) passed as parameter to the `__BOOST_IDENTITY_TYPE__` macro.
[footnote
*Rationale.*
Using variadic macros, this extra set of parenthesis could be eliminated requiring only the parenthesis to invoke the `__BOOST_IDENTITY_TYPE__` macro.
-This feature is currently not implemented and the double parenthesis are always needed when invoking this macro.
+However, this feature is currently not implemented and the double parenthesis are always needed when invoking this macro.
]

-[*(2)] The parameter type `::sign_t` start with the non-alphanumeric symbols "`::`" thus it cannot be used by the parenthesized syntax.
-The macros `__BOOST_IDENTITY_TYPE__` can also be used to overcome these issue:
+[*(2)] The parameter type `::sign_t` start with the non-alphanumeric symbols `::` thus it will generate preprocessor errors if used as a local function parameter type.
+The macros `__BOOST_IDENTITY_TYPE__` can also be used to overcome this issue:

[table
[ [Variadic Macro Syntax (C99 and later compilers)] [Sequencing Macro Syntax (all C++ compilers)] ]
[ [``
- __BOOST_LOCAL_FUNCTION_PARAMS__(
+ ... __BOOST_LOCAL_FUNCTION_PARAMS__(
 ...
 __BOOST_IDENTITY_TYPE__((::sign_t)) sign, // OK.
 ...
- )
+ ) ...
``] [``
- __BOOST_LOCAL_FUNCTION_PARAMS__(
+ ... __BOOST_LOCAL_FUNCTION_PARAMS__(
 ...
 (__BOOST_IDENTITY_TYPE__((::sign_t)) sign) // OK.
 ...
- )
+ ) ...
``] ]
]

-Often, there might be better ways to overcome this limitation that lead to code which is more readable than the one using these macros.
-For example, in this case the symbol "`::`" could be simply dropped to obtain the following and more readable code:
+Often, there might be better ways to overcome this limitation that lead to code which is more readable than the one using the `__BOOST_IDENTITY_TYPE__` macro.
+For example, in this case the symbols `::` could have been simply dropped to obtain the following valid and more readable code:

[table
[ [Variadic Macro Syntax (C99 and later compilers)] [Sequencing Macro Syntax (all C++ compilers)] ]
[ [``
- __BOOST_LOCAL_FUNCTION_PARAMS__(
+ ... __BOOST_LOCAL_FUNCTION_PARAMS__(
 ...
- sign_t sign, // OK.
+ sign_t sign, // OK.
 ...
- )
+ ) ...
``] [``
- __BOOST_LOCAL_FUNCTION_PARAMS__(
+ ... __BOOST_LOCAL_FUNCTION_PARAMS__(
 ...
 (sign_t sign) // OK.
 ...
- )
+ ) ...
``] ]
]

-[*(3)] The default parameter value `key_size<std::string, size_t>::value` contains a comma "`,`" after the first template parameter `std::string`.
+[*(3)] The default parameter value `key_size<std::string, size_t>::value` contains a comma `,` after the first template parameter `std::string`.
Again, this comma is not wrapped by any parenthesis `()` so it will cause a preprocessor error.
-Because this is a value expression (and not a type expression), it can simply be wrapped within an extra set of round parenthesis `()`:
+Because this is a value expression (and not a type expression), it can be simply wrapped within an extra set of round parenthesis `()`:

[table
[ [Variadic Macro Syntax (C99 and later compilers)] [Sequencing Macro Syntax (all C++ compilers)] ]
[ [``
- __BOOST_LOCAL_FUNCTION_PARAMS__(
+ ... __BOOST_LOCAL_FUNCTION_PARAMS__(
 ...
 const size_t& factor, default
 (key_size<std::string, size_t>::value), // OK.
 ...
- )
+ ) ...
``] [``
- __BOOST_LOCAL_FUNCTION_PARAMS__(
+ ... __BOOST_LOCAL_FUNCTION_PARAMS__(
 ...
 (const size_t& factor)(default
 (key_size<std::string, size_t>::value)) // OK.
 ...
- )
+ ) ...
``] ]
]

[note
-Alternatively, the macro `__BOOST_IDENTITY_VALUE__(`/parenthesized-value/`)` could have been equivalently used.
-This macro expands to an expression that evaluates (at run-time) exactly to the specified value (but it adds overhead compared with simply using the extra parenthesis `()`).
-Note that, similarly to `__BOOST_IDENTITY_TYPE__`, the `__BOOST_IDENTITY_VALUE__` macro also requires two sets of extra parenthesis one set for invoking the macro and another set to wrap the value.
+Alternatively, the macro `__BOOST_IDENTITY_VALUE__(`/parenthesized-value/`)` could have been used.
+This macro expands to an expression that evaluates (at run-time) exactly to the specified value -- but it adds overhead compared with simply using the extra parenthesis `()`.
+Note that, similarly to `__BOOST_IDENTITY_TYPE__`, the `__BOOST_IDENTITY_VALUE__` macro also requires two sets of extra parenthesis one set for invoking the macro and another set to wrap the value expression passed as the macro parameter.
]

-[*(4)] The default parameter value `cat(':', ' ')` is instead fine because it contains a comma "`,`" which is already wrapped by the parenthesis `()` of the function call `cat(...)`.
+[*(4)] The default parameter value `cat(":", " ")` is instead fine because it contains a comma `,` which is already wrapped by the parenthesis `()` of the function call `cat(...)`.
+
+[important
+The `__BOOST_IDENTITY_TYPE__` macro must be prefixed by the `typename` keyword when used within templates.
+]

Consider the following complete example:
[footnote
-The authors recognize that the use of the /identity macros/ adds extra parenthesis to the already significant number of parenthesis required by the parenthesized syntax.
-However, macro parameters usually do not contain unwrapped commas "`,`" (unless template metaprogramming is being used).
+The authors recognize that the use of the /identity macros/ adds extra parenthesis to the already significant number of parenthesis required by the sequencing macro syntax.
+However, macro parameters usually do not contain unwrapped commas `,` (unless template metaprogramming is being used) so this is usually not a problem.
]

[table
@@ -164,29 +168,49 @@
[ [ [print_map_va_cpp] ] [ [print_map_cpp] ] ]
]

-The `__BOOST_IDENTITY_TYPE__` macro must be prefixed by the `typename` keyword when used within templates.
-
[endsect]

[section Deducing Bound Types]

+While the ISO C++ standard does not allow for member functions of local classes to have template parameters, this library allows to call template functions from within a local function, a local block, or a local exit passing bound variables without explicitly specifying their types.
+This essentially allows local functions, local blocks, and local exits to be [@http://en.wikipedia.org/wiki/Type_polymorphism polymorphic] in the type of the bound variables (like a template is polymorphic in the type of its template parameters).
+
+Furthermore, this library allow to access the type of the bound variables from within the local function, local block, or local exit using the following macro:
+
+ #include <boost/local/typeof.hpp>
+
+ ... // Within a local function, local block, or local exit.
+ __BOOST_LOCAL_TYPEOF__(``/bound-variable/``) ...
+ ...
+
+This macro expands to a type expression that evaluates (at compile-time) to the fully qualified type of the specified bound variable.
+This type expression is fully qualified in the sense that it will be constant if the variable is bound by constant and it will also be a reference is the variable is bound by reference (if needed, programmers can strip away the `const` and `&` qualifiers using `boost::remove_const` and `boost::remove_reference`, or similar template metafunctions).
+
+For example:
+
+[table
+[ [Variadic Macro Syntax (C99 and later compilers)] [Sequencing Macro Syntax (all C++ compilers)] ]
+[ [ [typeof_va_cpp] ] [ [typeof_cpp] ] ]
+]
+
+Within templates, `__BOOST_LOCAL_TYPEOF__` does not require to be prefixed by the `typename` keyword but eventual type manipulations need the `typename` prefix as usual:
+
+[table
+[ [Variadic Macro Syntax (C99 and later compilers)] [Sequencing Macro Syntax (all C++ compilers)] ]
+[ [ [typeof_tpl_va_cpp] ] [ [typeof_tpl_cpp] ] ]
+]
+
[endsect]

[section Passing Local Functions]

-It is possible to obtain a reference to a local function so to assign it to a variable, to pass it as a function parameter, etc.
+It is possible to assign a local function to a functor (e.g., `boost::function`) in order to pass the local function to another function, etc.
+It is in general recommended to use the `boost::local::__function__` functor instead because its API also supports default parameters.

[important
-Local functions are never copied by value.
-You can only obtain a reference to a local function therefore you need to make sure that the *local function survives the scope of its reference* otherwise the reference will be invalid and its use will generate a run-time error (as usual with C++ references).
-[footnote
-The suffix `ref` of `boost::local::__function__` is meant to help programmers remember that they are dealing with references to (and not copies of) local functions.
-]
+When assigning a local function to a functor programmers need to make sure that the *local function survives the scope of the functor* otherwise the functor will be invalid and its use will generate a run-time error (as usual with C++ functors).
]

-For this purpose, it is possible to assign a `boost::function` functor to a local function (see also __Boost_Function__).
-However, it is in general preferable to use the `boost::local::__function__` functor instead because its API also supports default parameters.
-
The `boost::local::__function__` template takes two parameters (see the __Reference__ section):

 template< typename F, size_t defaults = 0 > class __function__;
@@ -200,9 +224,8 @@
 __function__< int(double, char) > // Returns `int`and takes two parameters: a `double` followed by a `char`.
``] ]
[ [defaults] [
-The template parameter `defaults` specifies the number of defaults parameters counting from the last parameter: `0` if no parameter is optional, `1` if the last parameter is optional, `2` if the last two parameters are optional, etc.
-This template parameter must be between `0` and the total number of parameters as specified by `F`.
-This template parameter is optional and it is `0` by default.
+The template parameter `defaults` specifies the number of defaults parameters (counting from the last parameter as usual): `0` if no parameter is optional, `1` if the last parameter is optional, `2` if the last two parameters are optional, etc.
+The `defaults` template parameter must be between `0` and the total number of parameters as specified by `F`, it is optional and it is `0` by default.
For example:``
 __function__< int(double, char) > // No default: All parameters must be specified.
 __function__< int(double, char), 1 > // 1 default: The last `char` parameter is optional.
@@ -247,8 +270,6 @@
Compilers might not be able to optimize away the local function overhead even when `inline`, `auto`, and `register` are used.
]

-For example:
-
[add_optimizers_cpp]

[endsect]

Modified: sandbox/local/libs/local/doc/qbk/alternatives.qbk
==============================================================================
--- sandbox/local/libs/local/doc/qbk/alternatives.qbk (original)
+++ sandbox/local/libs/local/doc/qbk/alternatives.qbk 2011-03-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -12,6 +12,11 @@

The following table compares local function features.

+@todo From Mathias: Minus of Local compared to Lambdas:
+ - creating a local can only be done at statement scope.
+ - locals may not automatically capture all context
+ - size of a local function cannot be optimized to be two words.
+
[table
[
[ Local Function Feature ]

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-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -96,6 +96,10 @@
[import ../../example/doit_va.cpp]
[import ../../example/transform.cpp]
[import ../../example/transform_va.cpp]
+[import ../../example/typeof.cpp]
+[import ../../example/typeof_va.cpp]
+[import ../../example/typeof_tpl.cpp]
+[import ../../example/typeof_tpl_va.cpp]

[import ../../example/add_num_sum.cpp]
[import ../../example/factorial.cpp]

Modified: sandbox/local/libs/local/doc/qbk/starting.qbk
==============================================================================
--- sandbox/local/libs/local/doc/qbk/starting.qbk (original)
+++ sandbox/local/libs/local/doc/qbk/starting.qbk 2011-03-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -4,7 +4,7 @@
[/ License, Version 1.0 (see accompanying file LICENSE_1_0.txt or a ]
[/ copy at http://www.boost.org/LICENSE_1_0.txt). ]

-[section:Starting Starting]
+[section:Starting Getting Started]

This section explains how to setup your system to use this library.

Modified: sandbox/local/libs/local/doc/qbk/tutorial.qbk
==============================================================================
--- sandbox/local/libs/local/doc/qbk/tutorial.qbk (original)
+++ sandbox/local/libs/local/doc/qbk/tutorial.qbk 2011-03-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -13,13 +13,14 @@

Local functions are defined using the following macros (see the __Reference__ section) from within a declarative context (this is a limitation with respect to __CPP0x_lambda__ functions which can instead be declared within expressions):

+ #include <boost/local/function.hpp>
+
+ ...
 { // Some declarative context.
 ...
-
 ``/result-type/`` __BOOST_LOCAL_FUNCTION_PARAMS__(``/parameters/``) {
 ``/body-code/``
 } __BOOST_LOCAL_FUNCTION_NAME__(``/name/``)
-
 ...
 }

@@ -131,7 +132,10 @@

If this variadic macro syntax seems strange, programmers could define a `WITH_DEFAULT` macro similar to the following if they think it improves readability:

-[add_x_y_default_with_va_cpp]
+[table
+[ [Variadic Macro Syntax (C99 and later compilers)] ]
+[ [ [add_x_y_default_with_va_cpp] ] ]
+]

[endsect]

@@ -245,13 +249,14 @@

Local blocks are defined using the following macros within a declarative context (see the __Reference__ section):

+ #include <boost/local/block.hpp>
+
+ ...
 { // Some declarative context.
 ...
-
 __BOOST_LOCAL_BLOCK__(``/bindings/``) {
 ``/body-code/``
 } __BOOST_LOCAL_BLOCK_END__
-
 ...
 }

@@ -283,13 +288,14 @@

Local exits are defined using the following macros within a declarative context (see the __Reference__ section):

+ #include <boost/local/exit.hpp>
+
+ ...
 { // Some declarative context.
 ...
-
 __BOOST_LOCAL_EXIT__(``/bindings/``) {
- ``/exit-body/``
+ ``/body-code/``
 } __BOOST_LOCAL_EXIT_END__
-
 ...
 }

Modified: sandbox/local/libs/local/example/typeof_tpl.cpp
==============================================================================
--- sandbox/local/libs/local/example/typeof_tpl.cpp (original)
+++ sandbox/local/libs/local/example/typeof_tpl.cpp 2011-03-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -4,7 +4,7 @@
// License, Version 1.0 (see accompanying file LICENSE_1_0.txt or a
// copy at http://www.boost.org/LICENSE_1_0.txt).

-//[typeof_template_cpp
+//[typeof_tpl_cpp
#include <boost/local/function.hpp>
#include <boost/local/block.hpp>
#include <boost/local/exit.hpp>

Added: sandbox/local/libs/local/example/typeof_tpl_va.cpp
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/example/typeof_tpl_va.cpp 2011-03-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -0,0 +1,55 @@
+
+// Copyright (C) 2009-2011 Lorenzo Caminiti
+// Use, modification, and distribution is subject to the Boost Software
+// License, Version 1.0 (see accompanying file LICENSE_1_0.txt or a
+// copy at http://www.boost.org/LICENSE_1_0.txt).
+
+//[typeof_tpl_va_cpp
+#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <algorithm>
+#include <cassert>
+
+template<typename T>
+T total(const T& x, const T& y, const T& z) {
+ T sum = T();
+ int factor = 10;
+
+ T BOOST_LOCAL_FUNCTION_PARAMS_TPL(T num, const bind factor,
+ bind& sum) {
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ T* nums = new T[size];
+ BOOST_LOCAL_EXIT_TPL(const bind& size, bind nums) {
+ BOOST_LOCAL_TYPEOF(size) s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK_TPL(const bind &sum, const bind& factor,
+ const bind& x, const bind& y, const bind& z) {
+ // Typeof qualified with eventual bind's `const` and `&`.
+ typename boost::remove_const<typename boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(sum)>::type>::type s;
+ s = sum;
+ assert(s == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+//]
+

Added: sandbox/local/libs/local/example/typeof_va.cpp
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/example/typeof_va.cpp 2011-03-11 09:33:21 EST (Fri, 11 Mar 2011)
@@ -0,0 +1,54 @@
+
+// Copyright (C) 2009-2011 Lorenzo Caminiti
+// Use, modification, and distribution is subject to the Boost Software
+// License, Version 1.0 (see accompanying file LICENSE_1_0.txt or a
+// copy at http://www.boost.org/LICENSE_1_0.txt).
+
+//[typeof_va_cpp
+#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <algorithm>
+#include <cassert>
+
+double total(const double& x, const double& y, const double& z) {
+ double sum = double();
+ int factor = 10;
+
+ double BOOST_LOCAL_FUNCTION_PARAMS(double num, const bind factor,
+ bind& sum) {
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ double* nums = new double[size];
+ BOOST_LOCAL_EXIT(const bind& size, bind nums) {
+ BOOST_LOCAL_TYPEOF(size) s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK(const bind &sum, const bind& factor,
+ const bind& x, const bind& y, const bind& z) {
+ // Typeof qualified with eventual bind's `const` and `&`.
+ boost::remove_const<boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(sum)>::type>::type s;
+ s = sum;
+ assert(s == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+//]
+

Date view	Thread view	Subject view	Author view

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