Boost-Commit :

Date view	Thread view	Subject view	Author view

Subject: [Boost-commit] svn:boost r67960 - in sandbox/local/libs/local/doc/html: . boost boost/local boost_local
From: lorcaminiti_at_[hidden]
Date: 2011-01-11 09:23:23

Author: lcaminiti
Date: 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
New Revision: 67960
URL: http://svn.boost.org/trac/boost/changeset/67960

Log:
Added HTML doc.
Added:
   sandbox/local/libs/local/doc/html/
   sandbox/local/libs/local/doc/html/BOOST_IDENTITY_TYPE.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_IDENTITY_VALUE.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_END.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_TPL.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_END.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_TPL.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_END.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_END_RENAME.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_TPL.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost/
   sandbox/local/libs/local/doc/html/boost/local/
   sandbox/local/libs/local/doc/html/boost/local/function_ref.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/
   sandbox/local/libs/local/doc/html/boost_local/Acknowledgments.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Advanced.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Alternatives.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Bibliography.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Examples.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Grammar.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Releases.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Starting.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Tutorial.html (contents, props changed)
   sandbox/local/libs/local/doc/html/index.html (contents, props changed)
   sandbox/local/libs/local/doc/html/reference.html (contents, props changed)

Added: sandbox/local/libs/local/doc/html/BOOST_IDENTITY_TYPE.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_IDENTITY_TYPE.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,68 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_IDENTITY_TYPE</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.utility.identity_hpp" title="Header <boost/utility/identity.hpp>">
+<link rel="prev" href="boost/local/function_ref.html" title="Struct template function_ref">
+<link rel="next" href="BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="boost/local/function_ref.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.utility.identity_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_IDENTITY_VALUE.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_IDENTITY_TYPE"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_IDENTITY_TYPE</h2>
+BOOST_IDENTITY_TYPE — This macro wraps the specified type expression within extra parenthesis so the type can be passed as a single macro parameter even if it contains commas. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.utility.identity_hpp" title="Header <boost/utility/identity.hpp>">boost/utility/identity.hpp</a>>
+
+BOOST_IDENTITY_TYPE(parenthesized_type)</pre></div>
+<div class="refsect1">
+<a name="id891480"></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).
+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">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<tbody><tr>
+<td><code class="computeroutput">parenthesized_type</code></td>
+<td>The type expression to be passed as macro parameter wrapped by a single set of round parenthesis <code class="computeroutput">(...)</code>. This type expression can contain an arbitrary number of commas. </td>
+</tr></tbody>
+</table></div>
+
+
+See: <a class="link" href="boost_local/Advanced.html" title="Advanced">Advanced</a> section. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="boost/local/function_ref.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.utility.identity_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_IDENTITY_VALUE.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_IDENTITY_VALUE.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_IDENTITY_VALUE.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,68 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_IDENTITY_VALUE</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.utility.identity_hpp" title="Header <boost/utility/identity.hpp>">
+<link rel="prev" href="BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">
+<link rel="next" href="boost_local/Grammar.html" title="Appendix: Grammar">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_IDENTITY_TYPE.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.utility.identity_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="boost_local/Grammar.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_IDENTITY_VALUE"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_IDENTITY_VALUE</h2>
+BOOST_IDENTITY_VALUE — This macro wraps the specified value expression within extra parenthesis so the value can be passed as a single macro parameter even if it contains commas. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.utility.identity_hpp" title="Header <boost/utility/identity.hpp>">boost/utility/identity.hpp</a>>
+
+BOOST_IDENTITY_VALUE(parenthesized_value)</pre></div>
+<div class="refsect1">
+<a name="id891621"></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).
+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">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<tbody><tr>
+<td><code class="computeroutput">parenthesize_value</code></td>
+<td>The value expression to be passed as macro parameter wrapped by a single set of round parenthesis <code class="computeroutput">(...)</code>. This value expression can contain an arbitrary number of commas. </td>
+</tr></tbody>
+</table></div>
+
+
+See: <a class="link" href="boost_local/Advanced.html" title="Advanced">Advanced</a> section. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_IDENTITY_TYPE.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.utility.identity_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="boost_local/Grammar.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,82 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_BLOCK</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.block_hpp" title="Header <boost/local/block.hpp>">
+<link rel="prev" href="reference.html" title="Reference">
+<link rel="next" href="BOOST_LOCAL_BLOCK_TPL.html" title="Macro BOOST_LOCAL_BLOCK_TPL">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="reference.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.block_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_BLOCK_TPL.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_BLOCK"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_BLOCK</h2>
+BOOST_LOCAL_BLOCK — This macro starts the declaration of a local block. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.block_hpp" title="Header <boost/local/block.hpp>">boost/local/block.hpp</a>>
+
+BOOST_LOCAL_BLOCK(parenthesized_binding)</pre></div>
+<div class="refsect1">
+<a name="id887875"></a><h2>Description</h2>
+This macro must be used within a declarative context, it must be followed by the local block body code <code class="computeroutput">{ ... }</code> and then by the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK_END.html" title="Macro BOOST_LOCAL_BLOCK_END">BOOST_LOCAL_BLOCK_END</a></code> macro (see the Tutorial section): 
+<pre class="programlisting"> { // Some declarative context.
+ ...
+
+ BOOST_LOCAL_BLOCK(
+ parenthesized_binding
+ ) exception_specifications_optional {
+ ... // Block body.
+ } BOOST_LOCAL_BLOCK_END
+
+ ...
+ }
+</pre>
+Within templates, the special macro <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK_TPL.html" title="Macro BOOST_LOCAL_BLOCK_TPL">BOOST_LOCAL_BLOCK_TPL</a></code> must be used instead of <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>.
+Note: A <code class="computeroutput">return;</code> instruction from within a local block body jumps to the end of the local block body and it does not return the enclosing scope.
+Parameters: 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<tbody><tr>
+<td><code class="computeroutput">parenthesized_binding</code></td>
+<td>A Boost.Preprocessor sequence that uses the parenthesized syntax to specify the variables in scope to bind (see the Grammar section). </td>
+</tr></tbody>
+</table></div>
+
+
+As usual, exception specifications can be optionally programmed before the body code block (see the Advanced section).
+See: <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section, <a class="link" href="boost_local/Advanced.html" title="Advanced">Advanced</a> section, <a class="link" href="boost_local/Grammar.html" title="Appendix: Grammar">Grammar</a> section, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK_TPL.html" title="Macro BOOST_LOCAL_BLOCK_TPL">BOOST_LOCAL_BLOCK_TPL</a></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>. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="reference.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.block_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_BLOCK_TPL.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_END.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_END.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,54 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_BLOCK_END</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.block_hpp" title="Header <boost/local/block.hpp>">
+<link rel="prev" href="BOOST_LOCAL_BLOCK_TPL.html" title="Macro BOOST_LOCAL_BLOCK_TPL">
+<link rel="next" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html" title="Macro BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_BLOCK_TPL.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.block_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_BLOCK_END"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_BLOCK_END</h2>
+BOOST_LOCAL_BLOCK_END — This macro ends the definition of a local block. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.block_hpp" title="Header <boost/local/block.hpp>">boost/local/block.hpp</a>>
+
+BOOST_LOCAL_BLOCK_END</pre></div>
+<div class="refsect1">
+<a name="id888269"></a><h2>Description</h2>
+This macro must follow the local block body code <code class="computeroutput">{ ... }</code> as shown in the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code> documentation.
+See: <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_BLOCK_TPL.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.block_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_TPL.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_TPL.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,53 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_BLOCK_TPL</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.block_hpp" title="Header <boost/local/block.hpp>">
+<link rel="prev" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">
+<link rel="next" href="BOOST_LOCAL_BLOCK_END.html" title="Macro BOOST_LOCAL_BLOCK_END">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_BLOCK.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.block_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_BLOCK_END.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_BLOCK_TPL"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_BLOCK_TPL</h2>
+BOOST_LOCAL_BLOCK_TPL — This macro is the same as <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code> but it must be used when declaring local blocks within templates. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.block_hpp" title="Header <boost/local/block.hpp>">boost/local/block.hpp</a>>
+
+BOOST_LOCAL_BLOCK_TPL(parenthesized_binding)</pre></div>
+<div class="refsect1">
+<a name="id888195"></a><h2>Description</h2>
+See: <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_BLOCK.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.block_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_BLOCK_END.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,56 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">
+<link rel="prev" href="BOOST_LOCAL_BLOCK_END.html" title="Macro BOOST_LOCAL_BLOCK_END">
+<link rel="next" href="BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html" title="Macro BOOST_LOCAL_CONFIG_THIS_PARAM_NAME">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_BLOCK_END.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.config_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX</h2>
+BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX — Maximum number of function parameters supported for the local functions. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">boost/local/config.hpp</a>>
+
+BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX</pre></div>
+<div class="refsect1">
+<a name="id888412"></a><h2>Description</h2>
+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. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_BLOCK_END.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.config_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,55 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_CONFIG_THIS_PARAM_NAME</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">
+<link rel="prev" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html" title="Macro BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX">
+<link rel="next" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.config_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_EXIT.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_CONFIG_THIS_PARAM_NAME"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_CONFIG_THIS_PARAM_NAME</h2>
+BOOST_LOCAL_CONFIG_THIS_PARAM_NAME — The name of the special symbol used to access the bound object <code class="computeroutput">this</code>. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">boost/local/config.hpp</a>>
+
+BOOST_LOCAL_CONFIG_THIS_PARAM_NAME</pre></div>
+<div class="refsect1">
+<a name="id888511"></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. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.config_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_EXIT.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,82 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_EXIT</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.exit_hpp" title="Header <boost/local/exit.hpp>">
+<link rel="prev" href="BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html" title="Macro BOOST_LOCAL_CONFIG_THIS_PARAM_NAME">
+<link rel="next" href="BOOST_LOCAL_EXIT_TPL.html" title="Macro BOOST_LOCAL_EXIT_TPL">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.exit_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_EXIT_TPL.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_EXIT"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_EXIT</h2>
+BOOST_LOCAL_EXIT — This macro starts the declaration of a local exit. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.exit_hpp" title="Header <boost/local/exit.hpp>">boost/local/exit.hpp</a>>
+
+BOOST_LOCAL_EXIT(parenthesized_binding)</pre></div>
+<div class="refsect1">
+<a name="id888657"></a><h2>Description</h2>
+This macro must be used within a declarative context, it must be followed by the local exit body code <code class="computeroutput">{ ... }</code> and then by the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT_END.html" title="Macro BOOST_LOCAL_EXIT_END">BOOST_LOCAL_EXIT_END</a></code> macro (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section): 
+<pre class="programlisting"> { // Some declarative context.
+ ...
+
+ BOOST_LOCAL_EXIT(
+ parenthesized_binding
+ ) exception_specifications_optional {
+ ... // Block body.
+ } BOOST_LOCAL_EXIT_END
+
+ ...
+ }
+</pre>
+Within templates, the special macro <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT_TPL.html" title="Macro BOOST_LOCAL_EXIT_TPL">BOOST_LOCAL_EXIT_TPL</a></code> must be used instead of <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code>.
+Note: A <code class="computeroutput">return;</code> instruction from within a local exit body jumps to the end of the local exit body and it does not return the enclosing scope.
+Parameters: 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<tbody><tr>
+<td><code class="computeroutput">parenthesized_binding</code></td>
+<td>A Boost.Preprocessor sequence that uses the parenthesized syntax to specify the variables in scope to bind (see the <a class="link" href="boost_local/Grammar.html" title="Appendix: Grammar">Grammar</a> section). </td>
+</tr></tbody>
+</table></div>
+
+
+As usual, exception specifications can be optionally programmed before the body code block (see the <a class="link" href="boost_local/Advanced.html" title="Advanced">Advanced</a> section).
+See: <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section, <a class="link" href="boost_local/Advanced.html" title="Advanced">Advanced</a> section, <a class="link" href="boost_local/Grammar.html" title="Appendix: Grammar">Grammar</a> section, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT_TPL.html" title="Macro BOOST_LOCAL_EXIT_TPL">BOOST_LOCAL_EXIT_TPL</a></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>. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.exit_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_EXIT_TPL.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_END.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_END.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,54 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_EXIT_END</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.exit_hpp" title="Header <boost/local/exit.hpp>">
+<link rel="prev" href="BOOST_LOCAL_EXIT_TPL.html" title="Macro BOOST_LOCAL_EXIT_TPL">
+<link rel="next" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_EXIT_TPL.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.exit_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_FUNCTION.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_EXIT_END"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_EXIT_END</h2>
+BOOST_LOCAL_EXIT_END — This macro ends the definition of a local exit. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.exit_hpp" title="Header <boost/local/exit.hpp>">boost/local/exit.hpp</a>>
+
+BOOST_LOCAL_EXIT_END</pre></div>
+<div class="refsect1">
+<a name="id889074"></a><h2>Description</h2>
+This macro must follow the local exit body code <code class="computeroutput">{ ... }</code> as shown in the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code> documentation.
+See: <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_EXIT_TPL.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.exit_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_FUNCTION.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_TPL.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_TPL.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,53 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_EXIT_TPL</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.exit_hpp" title="Header <boost/local/exit.hpp>">
+<link rel="prev" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">
+<link rel="next" href="BOOST_LOCAL_EXIT_END.html" title="Macro BOOST_LOCAL_EXIT_END">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_EXIT.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.exit_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_EXIT_END.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_EXIT_TPL"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_EXIT_TPL</h2>
+BOOST_LOCAL_EXIT_TPL — This macro is the same as <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code> but it must used when declaring local exits within templates. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.exit_hpp" title="Header <boost/local/exit.hpp>">boost/local/exit.hpp</a>>
+
+BOOST_LOCAL_EXIT_TPL(parenthesized_binding)</pre></div>
+<div class="refsect1">
+<a name="id889000"></a><h2>Description</h2>
+See: <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_EXIT.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.exit_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_EXIT_END.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,82 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_FUNCTION</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">
+<link rel="prev" href="BOOST_LOCAL_EXIT_END.html" title="Macro BOOST_LOCAL_EXIT_END">
+<link rel="next" href="BOOST_LOCAL_FUNCTION_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_TPL">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_EXIT_END.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.function_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_FUNCTION_TPL.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_FUNCTION"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_FUNCTION</h2>
+BOOST_LOCAL_FUNCTION — This macro starts the declaration of a local function. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">boost/local/function.hpp</a>>
+
+BOOST_LOCAL_FUNCTION(parenthesized_signature)</pre></div>
+<div class="refsect1">
+<a name="id889233"></a><h2>Description</h2>
+This macro must be used within a declarative context, it must be followed by the local function body code <code class="computeroutput">{ ... }</code> and then by either the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code> or the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a></code> macro (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> and <a class="link" href="boost_local/Advanced.html" title="Advanced">Advanced</a> sections): 
+<pre class="programlisting"> { // Some declarative context.
+ ...
+
+ BOOST_LOCAL_FUNCTION(
+ parenthesized_signature
+ ) exception_specifications_optional {
+ ... // Block body.
+ } BOOST_LOCAL_FUNCTION_END(local_function_name)
+
+ ...
+ }
+</pre>
+As usual, exception specifications can be optionally programmed before the body code block (see the <a class="link" href="boost_local/Advanced.html" title="Advanced">Advanced</a> section).
+Within templates, the special macro <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_TPL">BOOST_LOCAL_FUNCTION_TPL</a></code> must be used instead of <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>.
+Parameters: 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<tbody><tr>
+<td><code class="computeroutput">parenthesized_signature</code></td>
+<td>A Boost.Preprocessor sequence that uses the parenthesized syntax to specify the local function signature and the variables in scope to bind (see the <a class="link" href="boost_local/Grammar.html" title="Appendix: Grammar">Grammar</a> section). </td>
+</tr></tbody>
+</table></div>
+
+
+Note: Local functions cannot be copied but it is possible to obtain a reference to a local function using <code class="computeroutput"><a class="link" href="boost/local/function_ref.html" title="Struct template function_ref">boost::local::function_ref</a></code>.
+See: <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section, <a class="link" href="boost_local/Advanced.html" title="Advanced">Advanced</a> section, <a class="link" href="boost_local/Grammar.html" title="Appendix: Grammar">Grammar</a> section, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_TPL">BOOST_LOCAL_FUNCTION_TPL</a></code>, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code>, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a></code>, <code class="computeroutput"><a class="link" href="boost/local/function_ref.html" title="Struct template function_ref">boost::local::function_ref</a></code>. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_EXIT_END.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.function_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_FUNCTION_TPL.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_END.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_END.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,67 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_FUNCTION_END</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">
+<link rel="prev" href="BOOST_LOCAL_FUNCTION_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_TPL">
+<link rel="next" href="BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION_TPL.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.function_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_FUNCTION_END_RENAME.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_FUNCTION_END"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_FUNCTION_END</h2>
+BOOST_LOCAL_FUNCTION_END — This macro ends the definition of a local function. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">boost/local/function.hpp</a>>
+
+BOOST_LOCAL_FUNCTION_END(local_function_name)</pre></div>
+<div class="refsect1">
+<a name="id889720"></a><h2>Description</h2>
+This macro must follow the local function body code <code class="computeroutput">{ ... }</code> as shown in the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code> documentation.
+Parameters: 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<tbody><tr>
+<td><code class="computeroutput">local_function_name</code></td>
+<td>The name of the local function as it has been specified by the parenthesized signature passed to <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code> (otherwise, the compiler will generate an error). See the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a></code> macro to relax this constraint. </td>
+</tr></tbody>
+</table></div>
+
+
+See: <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a></code>, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION_TPL.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.function_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_FUNCTION_END_RENAME.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_END_RENAME.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_END_RENAME.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,69 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_FUNCTION_END_RENAME</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">
+<link rel="prev" href="BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">
+<link rel="next" href="boost/local/function_ref.html" title="Struct template function_ref">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION_END.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.function_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="boost/local/function_ref.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_FUNCTION_END_RENAME"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_FUNCTION_END_RENAME</h2>
+BOOST_LOCAL_FUNCTION_END_RENAME — This macro ends the definition of a local function while changing the function name. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">boost/local/function.hpp</a>>
+
+BOOST_LOCAL_FUNCTION_END_RENAME(new_local_function_name)</pre></div>
+<div class="refsect1">
+<a name="id889889"></a><h2>Description</h2>
+This macro must be used instead of the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code> macro and it must follow the local function body code <code class="computeroutput">{ ... }</code> as shown in the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code> documentation.
+Parameters: 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<tbody><tr>
+<td><code class="computeroutput">new_local_function_name</code></td>
+<td>This is the new local function name (see the <a class="link" href="boost_local/Advanced.html" title="Advanced">Advanced</a> section). </td>
+</tr></tbody>
+</table></div>
+
+
+The original local function name (as specified by the parenthesized signature passed to <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>) must still be used within the local function body (e.g., for the local function to recursively call itself). However, within the enclosing scope the new local function as passed to <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a></code> must be used (e.g., to invoke the local function).
+Warning: Renamed local functions cannot be directly passed as template parameters (e.g., to STL algorithms). However, it is possible to workaround this limitation by getting a reference to the renamed local function using <code class="computeroutput"><a class="link" href="boost/local/function_ref.html" title="Struct template function_ref">boost::local::function_ref</a></code> and then by passing the local function reference as template parameter.
+See: <a class="link" href="boost_local/Advanced.html" title="Advanced">Advanced</a> section, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code>, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>, <code class="computeroutput"><a class="link" href="boost/local/function_ref.html" title="Struct template function_ref">boost::local::function_ref</a></code>. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION_END.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.function_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="boost/local/function_ref.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_TPL.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_TPL.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,53 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_FUNCTION_TPL</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">
+<link rel="prev" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">
+<link rel="next" href="BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.function_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_FUNCTION_END.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_FUNCTION_TPL"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_FUNCTION_TPL</h2>
+BOOST_LOCAL_FUNCTION_TPL — This macro is the same as <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code> but it must be used when declaring local functions within templates. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">boost/local/function.hpp</a>>
+
+BOOST_LOCAL_FUNCTION_TPL(parenthesized_signature)</pre></div>
+<div class="refsect1">
+<a name="id889645"></a><h2>Description</h2>
+See: <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.function_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_FUNCTION_END.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost/local/function_ref.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost/local/function_ref.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,102 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Struct template function_ref</title>
+<link rel="stylesheet" href="../../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../../reference.html#header.boost.local.function_ref_hpp" title="Header <boost/local/function_ref.hpp>">
+<link rel="prev" href="../../BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">
+<link rel="next" href="../../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../BOOST_LOCAL_FUNCTION_END_RENAME.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../reference.html#header.boost.local.function_ref_hpp"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../../BOOST_IDENTITY_TYPE.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="boost.local.function_ref"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Struct template function_ref</h2>
+boost::local::function_ref — Template to hold a reference to a local function while supporting eventual default function parameters. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="../../reference.html#header.boost.local.function_ref_hpp" title="Header <boost/local/function_ref.hpp>">boost/local/function_ref.hpp</a>>
+
+template<typename F, size_t defaults = 0>
+struct <a class="link" href="function_ref.html" title="Struct template function_ref">function_ref</a> {
+};</pre></div>
+<div class="refsect1">
+<a name="id890337"></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): 
+<pre class="programlisting"> template<typename Result, typename Arg1, ..., typename ArgN, size_t defaults = 0>
+ class function_ref<Result (Arg1, ..., ArgN), defaults> {
+ public:
+ Result operator()(Arg1, ..., ArgN-2, ArgN-1, ArgN);
+ // Call operators to handle default parameters:
+ Result operator()(Arg1, ..., ArgN-2, ArgN-1); // iff defaults >= 1
+ Result operator()(Arg1, ..., ArgN-2); // iff defaults >= 2
+ ... // etc
+
+ // Copy constructor and assignment operator for local functions:
+ function_ref(local_function<F, defaults>& ref);
+ function_ref& operator=(local_function<F, defaults>& ref);
+ };
+</pre>
+ Where:
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem"><code class="computeroutput">Result</code> is the function result type. It can be <code class="computeroutput">void</code>.</li>
+<li class="listitem"><code class="computeroutput">ArgN</code> is the last function parameter type, <code class="computeroutput">ArgN-1</code> is the second last function parameter type, etc. These are all optional (none is specified for a function with no parameter, only <code class="computeroutput">Arg1</code> is specified for a function with only one parameter, etc).</li>
+<li class="listitem">The operator <code class="computeroutput">Result operator()(Arg1, ..., ArgN-2, ArgN-1)</code> is defined if and only if there are one or more default parameters (<code class="computeroutput">defaults >= 1</code>), the operator <code class="computeroutput">Result operator()(Arg1, ..., ArgN-2)</code> is defined if and only if there are two or more default parameters (<code class="computeroutput">defaults >= 2</code>), etc.</li>
+<li class="listitem"><code class="computeroutput">local_function<F, defaults></code> is an internal type for a local function with a signature matching <code class="computeroutput">F</code> and with a number of default parameters equal to <code class="computeroutput">defaults</code>.</li>
+<li class="listitem">The copy constructor and assignment operator <code class="computeroutput">operator=</code> allow to assign this template to a reference to a local function with a signature matching <code class="computeroutput">F</code> and with a number of default parameters equal to <code class="computeroutput">defaults</code>.</li>
+</ul></div>
+
+
+Warning: Programmers must make sure that the local function survives the scope of the function reference (otherwise the reference will be invalid and its use will generate a run-time error as usual with C++ references).
+Parameters: 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><code class="computeroutput">F</code></td>
+<td>The function signature expressed using the Boost.Function's preferred syntax: <code class="computeroutput">F = Result (Arg1, ..., ArgN)</code>. </td>
+</tr>
+<tr>
+<td><code class="computeroutput">defaults</code></td>
+<td>The number of the function default parameters in <code class="computeroutput">[0,</code> <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">]</code>. As usual in C++, default parameters are counted starting from the last parameter: <code class="computeroutput">defaults = 0</code> means that no parameter is optional, <code class="computeroutput">defaults = 1</code> means that the last parameter is optional, <code class="computeroutput">defaults = 2</code> means that the last two parameters are optional, etc. </td>
+</tr>
+</tbody>
+</table></div>
+
+
+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"><a class="link" href="../../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>, Boost.Function. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../BOOST_LOCAL_FUNCTION_END_RENAME.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../reference.html#header.boost.local.function_ref_hpp"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../../BOOST_IDENTITY_TYPE.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Acknowledgments.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Acknowledgments.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,77 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Acknowledgments</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="Bibliography.html" title="Bibliography">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Bibliography.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Acknowledgments"></a><a class="link" href="Acknowledgments.html" title="Acknowledgments">Acknowledgments</a>
+</h2></div></div></div>
+
+ This section attempts to recognize the contributions of all
+ the different people that participated directly or indirectly to the design
+ and development of this library.
+ 
+
+ Thanks to Steven Watanabe and Vicente Botet for suggesting to use Boost.ScopeExit
+ binding to emulate local functions (in the context of constant-correct checking
+ of block invariants).
+ 
+
+ Thanks to Alexander Nasonov for clarifying how Boost.ScopeExit
+ binding could be used to implement local functions.
+ 
+
+ Thanks to Pierre Morcello for suggesting to use <code class="computeroutput">return;</code> to exit local blocks (in the context of a
+ discussion about a possible Boost.Breakable
+ library). Thanks to Pierre also for sharing some code that already experimented
+ with implementing local functions using Boost.ScopeExit
+ binding (even if this library was not developed using such a code).
+ 
+
+ Thanks to John Bytheway for refining the authors' technique that allows this
+ library to pass local functions as template parameters.
+ 
+
+ Thanks to Jeffrey Lee Hellrung for suggesting the use of the "keyword"
+ <code class="computeroutput">bind</code> to bind variables in scope.
+ 
+
+ Finally, many thanks to the entire Boost
+ community and mailing list for
+ providing valuable comments about this library and great insights on the C++
+ programming language.
+ 
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Bibliography.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Advanced.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Advanced.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,1118 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Advanced</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="Tutorial.html" title="Tutorial">
+<link rel="next" href="../reference.html" title="Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Tutorial.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</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>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt><a href="Advanced.html#boost_local.Advanced.commas_in_macro_parameters">Commas
+ in Macro Parameters</a></dt>
+<dt><a href="Advanced.html#boost_local.Advanced.recursive_local_functions">Recursive
+ Local Functions</a></dt>
+<dt><a href="Advanced.html#boost_local.Advanced.exception_specifications">Exception
+ Specifications</a></dt>
+<dt><a href="Advanced.html#boost_local.Advanced.optimizers___inline____auto___and__register_">Optimizers:
+ <code class="computeroutput">inline</code>, <code class="computeroutput">auto</code>,
+ and <code class="computeroutput">register</code></a></dt>
+<dt><a href="Advanced.html#boost_local.Advanced.references_to_local_functions">References
+ to Local Functions</a></dt>
+<dt><a href="Advanced.html#boost_local.Advanced.renaming_local_functions">Renaming
+ Local Functions</a></dt>
+<dt><a href="Advanced.html#boost_local.Advanced.limitations__overloading__nesting__operators__etc">Limitations:
+ Overloading, Nesting, Operators, Etc</a></dt>
+</dl></div>
+
+ This section illustrates advanced usages of this library. At the end of this
+ section there is also a list of limitations of this library.
+ 
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced.commas_in_macro_parameters"></a><a class="link" href="Advanced.html#boost_local.Advanced.commas_in_macro_parameters" title="Commas in Macro Parameters">Commas
+ in Macro Parameters</a>
+</h3></div></div></div>
+
+ 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>. The elements of the parenthesized
+ signature are internally used as macro parameters while they are being processed
+ by the parsing macros. Therefore, commas within parenthesized signature elements
+ 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>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ Macro parameters with commas which are
+ already wrapped by round parenthesis <code class="computeroutput">()</code>
+ are fine (function calls, etc). However, macro parameters with commas that
+ are not wrapped by round parenthesis need to be wrapped by an extra set
+ of round parenthesis <code class="computeroutput">()</code> as
+ described here. Therefore, also macro parameters with commas wrapped by
+ angular parenthesis <code class="computeroutput"><></code>
+ (templates, etc) or square parenthesis <code class="computeroutput">[]</code>
+ (multidimensional array access, etc) need to be wrapped by the extra round
+ parenthesis <code class="computeroutput">()</code> as explained
+ here (this is because the preprocessor only recognizes the round parenthesis
+ and it does not recognize angular, square, or any other type of parenthesis).
+ </td></tr>
+</table></div>
+
+ For example, let's consider the following parenthesized signature (see the
+ complete example code later in this section):
+ 
+<pre class="programlisting">(void) (print)(
+ (const std::map<std::string, size_t>&)(m) // (1) Error.
+ (const size_t&)(factor)(default)
+ (key_size<std::string, size_t>::value) // (2) Error.
+ (const std::string&)(separator)(default)(cat(":", " ")) // (3) OK.
+ (::sign_t)(sign)(default)(-1) // (4) Error.
+ )
+</pre>
+
+ (1) The parenthesized signature element
+ <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 this
+ a parenthesized signature element 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:
+ 
+<pre class="programlisting">(void) (print)(
+ (<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>
+
+ This macro expands to an expression that evaluates (at compile-time) exactly
+ to the specified type. Note that a total of three set of parenthesis <code class="computeroutput">()</code> are needed:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Parenthesis to wrap the parenthesized signature element.
+ </li>
+<li class="listitem">
+ Parenthesis to call the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ 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
+ to the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro.
+ </li>
+</ol></div>
+
+ (2) The parenthesized signature element
+ <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>.
+ 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), 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> is used to overcome this issue:
+ 
+<pre class="programlisting">(void) (print)(
+ ...
+ (const size_t&)(factor)(default)
+ (<code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">BOOST_IDENTITY_VALUE</a></code>((key_size<std::string, size_t>::value))) // OK.
+ ...
+ )
+</pre>
+
+ This macro expands to an expression that evaluates (at run-time) exactly
+ to the specified value. Note again that a total of three set of parenthesis
+ <code class="computeroutput">()</code> are needed similarly to
+ <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>.
+ 
+
+ (3) The parenthesized signature element
+ <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 parenthesized signature elements
+ <code class="computeroutput">::sign_t</code>
+ and <code class="computeroutput">-1</code>
+ (the type and default value of the <code class="computeroutput">sign</code>
+ parameter) start with the non-alphanumeric symbols "<code class="computeroutput">::</code>"
+ and "<code class="computeroutput">-</code>" respectively
+ thus they 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> and <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">BOOST_IDENTITY_VALUE</a></code> can also
+ be used to overcome these issues:
+ 
+<pre class="programlisting">(void) (print)(
+ ...
+ (<code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((::sign_t)))(sign)(default)
+ (<code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">BOOST_IDENTITY_VALUE</a></code>((-1))) // OK.
+ )
+</pre>
+
+ This way the parenthesized signature elements became <code class="computeroutput">(<a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a>((::sign_t)))</code>
+ and <code class="computeroutput">(<a class="link" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">BOOST_IDENTITY_VALUE</a>((-1)))</code>
+ which start with the alphanumeric symbols of the macro names and they can
+ be used by the parenthesized syntax.
+ 
+
+ 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 dropped and <code class="computeroutput">-1</code>
+ could be wrapped within <code class="computeroutput">int(...)</code> to obtain the following, more readable,
+ and still valid parenthesized signature code:
+ 
+<pre class="programlisting">(void) (print)(
+ ...
+ (sign_t)(sign)(default)(int(-1)) // OK.
+ )
+</pre>
+
+ Consider the following complete example: [<a name="id875940" href="#ftn.id875940" class="footnote">15</a>]
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/function.hpp>
+#include <boost/utility/identity.hpp>
+#include <map>
+#include <string>
+#include <iostream>
+
+template<typename K, typename T> struct key_size { static const size_t value; };
+template<typename K, typename T> const size_t key_size<K, T>::value = sizeof(K);
+
+std::string cat(const std::string& a, const std::string& b) { return a + b; }
+
+typedef int const& sign_t;
+
+int main() {
+ BOOST_LOCAL_FUNCTION(
+ (void) (print)(
+ // Identity macors handle commas.
+ (BOOST_IDENTITY_TYPE((const std::map<std::string, size_t>&)))(m)
+ (const size_t&)(factor)(default)
+ (BOOST_IDENTITY_VALUE((key_size<std::string, size_t>::value)))
+ (const std::string&)(separator)(default)(cat(":", " "))
+ // Also, identity macors handle leading symbols.
+ (BOOST_IDENTITY_TYPE((::sign_t)))(sign)(default)
+ (BOOST_IDENTITY_VALUE((-1)))
+ )
+ ) {
+ for (std::map<std::string, size_t>::const_iterator i = m.begin();
+ i != m.end(); ++i) {
+ std::cout << i->first << separator <<
+ sign * int(i->second) * int(factor) << std::endl;
+ }
+ } BOOST_LOCAL_FUNCTION_END(print)
+
+ std::map<std::string, size_t> sizes;
+ sizes["a"] = 1; sizes["ab"] = 2; sizes["abc"] = 3;
+ print(sizes);
+
+ return 0;
+}
+</pre>
+
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced.recursive_local_functions"></a><a class="link" href="Advanced.html#boost_local.Advanced.recursive_local_functions" title="Recursive Local Functions">Recursive
+ Local Functions</a>
+</h3></div></div></div>
+
+ A local function can recursively call itself as usual with C++ functions.
+ 
+
+ For example, the following local function is used to recursively calculate
+ and print the factorial of the specified numbers:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+#include <sstream>
+#include <algorithm>
+#include <vector>
+
+int main () {
+ std::vector<int> v;
+ v.resize(3);
+ v[0] = 1; v[1] = 4; v[2] = 7;
+ std::ostringstream factorials;
+
+ BOOST_LOCAL_FUNCTION(
+ (int) (factorial)(
+ (int)(n)
+ (bool)(recursion)(default)(false)
+ (bind)((&factorials))
+ )
+ ) {
+ int result = 0;
+
+ if (n < 2 ) result = 1;
+ else result = n * factorial(n - 1, true); // Recursive call.
+
+ if (!recursion) factorials << result << " ";
+ return result;
+ } BOOST_LOCAL_FUNCTION_END(factorial)
+
+ std::for_each(v.begin(), v.end(), factorial);
+ std::cout << factorials.str() << std::endl;
+
+ return 0;
+}
+</pre>
+
+ 
+
+ The original local function name as specified in the parenthesized signature
+ passed to <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>
+ must always be used for recursive calls even when the function is renamed
+ using <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a></code>
+ (see renamed local functions later in this section).
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced.exception_specifications"></a><a class="link" href="Advanced.html#boost_local.Advanced.exception_specifications" title="Exception Specifications">Exception
+ Specifications</a>
+</h3></div></div></div>
+
+ It is possible to program exception specifications for local functions, local
+ blocks, and local exits.
+ 
+
+ Exception specifications are programmed just before the body (and outside
+ the macros). For example:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <stdexcept>
+#include <algorithm>
+#include <cassert>
+
+int main() {
+ double sum = 0.0;
+ int factor = 10;
+
+ BOOST_LOCAL_FUNCTION(
+ (void) (add)( (double)(num) (const bind)((factor)) (bind)((&sum)) )
+ ) throw (std::runtime_error, std::logic_error) { // Throw two exceptions.
+ sum += factor * num;
+ } BOOST_LOCAL_FUNCTION_END(add)
+ add(100.0);
+
+ size_t size = 2;
+ double* nums = new double[size];
+ // Throw nothing.
+ BOOST_LOCAL_EXIT( (const bind)((&size)) (bind)((nums)) ) throw() {
+ if (size && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = 90.5; nums[1] = 7.0;
+ std::for_each(nums, nums + size, add);
+
+ // Throw one exception.
+ BOOST_LOCAL_BLOCK( (const bind)((&sum)) ) throw(std::exception) {
+ assert(sum == 1975.0);
+ } BOOST_LOCAL_BLOCK_END
+
+ return 0;
+}
+</pre>
+
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced.optimizers___inline____auto___and__register_"></a><a class="link" href="Advanced.html#boost_local.Advanced.optimizers___inline____auto___and__register_" title="Optimizers: inline, auto, and register">Optimizers:
+ <code class="computeroutput">inline</code>, <code class="computeroutput">auto</code>,
+ and <code class="computeroutput">register</code></a>
+</h3></div></div></div>
+
+ As specified in the <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a> section,
+ the parenthesized signature also supports <code class="computeroutput">inline</code>d
+ local functions, and the <code class="computeroutput">auto</code>
+ and <code class="computeroutput">register</code> classifiers for
+ local function parameters.
+ 
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ However, note that local functions will always add some overhead because
+ of the functor object used to internally implement them. Compilers might
+ not be able to optimize away the local function overhead even when <code class="computeroutput">inline</code>, <code class="computeroutput">auto</code>,
+ and <code class="computeroutput">register</code> are used.
+ </td></tr>
+</table></div>
+
+ For example:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+
+int main() {
+ BOOST_LOCAL_FUNCTION(
+ (inline) (int) (add)( // Inlined local function.
+ (auto)(int)(x) // Auto parameter.
+ (register)(int)(y) // Register parameter.
+ )
+ ) {
+ return x + y;
+ } BOOST_LOCAL_FUNCTION_END(add)
+
+ std::cout << add(3, 5) << std::endl;
+
+ return 0;
+}
+</pre>
+
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced.references_to_local_functions"></a><a class="link" href="Advanced.html#boost_local.Advanced.references_to_local_functions" title="References to Local Functions">References
+ to Local Functions</a>
+</h3></div></div></div>
+
+ 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.
+ 
+<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">
+ 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="id880460" href="#ftn.id880460" class="footnote">16</a>]
+ </td></tr>
+</table></div>
+
+ For this purpose, it is possible to assign a <code class="computeroutput">boost::function</code>
+ functor to a local function (see also Boost.Function).
+ However, it is in general preferable to use the <code class="computeroutput">boost::local::<a class="link" href="../boost/local/function_ref.html" title="Struct template function_ref">function_ref</a></code>
+ functor instead because its API also supports default parameters.
+ 
+
+ The <code class="computeroutput">boost::local::<a class="link" href="../boost/local/function_ref.html" title="Struct template function_ref">function_ref</a></code> template
+ takes two parameters (see the Reference
+ section):
+ 
+<pre class="programlisting">template<typename F, size_t defaults = 0>
+class <code class="computeroutput"><a class="link" href="../boost/local/function_ref.html" title="Struct template function_ref">function_ref</a></code> { ... };
+</pre>
+
+ Where:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+ The template parameter <code class="computeroutput">F</code>
+ specifies the function signature using the same syntax as Boost.Function's
+ preferred syntax. For example:
+ </li></ul></div>
+<pre class="programlisting"><code class="computeroutput"><a class="link" href="../boost/local/function_ref.html" title="Struct template function_ref">function_ref</a></code>< int() > // Returns `int` and takes no parameter.
+<code class="computeroutput"><a class="link" href="../boost/local/function_ref.html" title="Struct template function_ref">function_ref</a></code>< int(double, char) > // Returns `int`and takes two parameters: a `double` followed by a `char`.
+</pre>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+ The template parameter <code class="computeroutput">defaults</code>
+ specifies the number of defaults parameters counting from the last parameter:
+ <code class="computeroutput">0</code> if no parameter is optional,
+ <code class="computeroutput">1</code> if the last parameter is
+ optional, <code class="computeroutput">2</code> if the last two
+ parameters are optional, etc. This template parameter must be between
+ <code class="computeroutput">0</code> and the total number of
+ parameters as specified by <code class="computeroutput">F</code>.
+ This template parameter is optional and it is <code class="computeroutput">0</code>
+ by default. For example:
+ </li></ul></div>
+<pre class="programlisting"><code class="computeroutput"><a class="link" href="../boost/local/function_ref.html" title="Struct template function_ref">function_ref</a></code>< int(double, char) > // No default: All parameters must be specified.
+<code class="computeroutput"><a class="link" href="../boost/local/function_ref.html" title="Struct template function_ref">function_ref</a></code>< int(double, char), 1 > // 1 default: The last `char` parameter is optional.
+<code class="computeroutput"><a class="link" href="../boost/local/function_ref.html" title="Struct template function_ref">function_ref</a></code>< int(double, char), 2 > // 2 defaults: All parameters are optional.
+</pre>
+
+ For example:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/function_ref.hpp>
+#include <boost/local/function.hpp>
+#include <boost/function.hpp>
+#include <iostream>
+
+// Using `function_ref` allows to use the same functor for all calls
+// (regardless of which set of default parameters is specified).
+void doit(boost::local::function_ref< int (int, int), 2 > l) {
+ std::cout << l(1, 2) << std::endl;
+ std::cout << l(1) << std::endl;
+ std::cout << l() << std::endl;
+}
+
+// Using `function` requires different functors for calls with different set of
+// default parameters.
+void doit2(boost::function< int (int, int) > l)
+ { std::cout << l(1, 2) << std::endl; }
+void doit1(boost::function< int (int) > l) { std::cout << l(1) << std::endl; }
+void doit0(boost::function< int () > l) { std::cout << l() << std::endl; }
+
+int main() {
+ boost::function<int (int, int)> l2;
+
+ {
+ int i = 2;
+
+ BOOST_LOCAL_FUNCTION(
+ (int) (linear)( (int)(x)(default)(1) (int)(y)(default)(2)
+ (bind)( (i) ) )
+ ) {
+ return x + i * y;
+ } BOOST_LOCAL_FUNCTION_END(linear)
+
+ // Assign local functions variables.
+ boost::local::function_ref< int (int, int), 2 > l = linear;
+ l(1, 2); l(1); l(); // All calls because of default parameters.
+ l2 = linear;
+ l2(1, 2); // Only one call operation (without default parameters).
+
+ // Similarly, pass local functions as a function parameter.
+ doit(linear);
+ std::cout << std::endl;
+ doit2(linear);
+ doit1(linear);
+ doit0(linear);
+ }
+
+ if (false) {
+ l2(1, 2); // This wouuld raise run-time error because invalid reference.
+ }
+
+ return 0;
+}
+</pre>
+
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced.renaming_local_functions"></a><a class="link" href="Advanced.html#boost_local.Advanced.renaming_local_functions" title="Renaming Local Functions">Renaming
+ Local Functions</a>
+</h3></div></div></div>
+
+ Local functions can be renamed using the <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a></code>
+ macro instead of <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code>:
+ 
+<pre class="programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a></code>(new-local-function-name)
+</pre>
+
+ Where the new-local-function-name no longer has to match
+ the local function name as originally specified in the parenthesized signature
+ passed to <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>.
+ For example: [<a name="id883162" href="#ftn.id883162" class="footnote">17</a>]
+ 
+<pre class="programlisting">{
+ <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>(
+ (void) (l)( (int)(x) )
+ ) {
+ ... // Body uses original name `l`.
+ } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a></code>(m) // Renamed to `m`.
+
+ ... // Enclosing scope uses new name `m`.
+}
+</pre>
+
+ Note that the local function is renamed only after the call to <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a></code>.
+ Therefore, within the local function body the original local function name
+ as specified by <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>
+ must be used (e.g., to recursively call the local function). However, within
+ the enclosing scope only the new local function name as specified by <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a></code>
+ is available.
+ 
+
+ A limitation is that renamed local functions cannot be directly passed as
+ template parameters (e.g., they cannot be passed to STL algorithms like
+ <code class="computeroutput">std::for_each</code>). However, it is possible to workaround
+ this limitation by obtaining a reference of the renamed local function and
+ then passing the reference as template parameter. For example:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/function.hpp>
+#include <boost/local/function_ref.hpp>
+#include <algorithm>
+#include <iostream>
+
+int main() {
+ BOOST_LOCAL_FUNCTION(
+ (void) (print)( (int)(x) )
+ ) {
+ // Only original `print` name available within local function body.
+ std::cout << x << std::endl;
+ } BOOST_LOCAL_FUNCTION_END_RENAME(new_print)
+ // Only new `new_print` name available within enclosing scope.
+
+ int a[3] = {1, 2, 3};
+
+ // std::for_each(a, a + 3, new_print); // Error: Passing renamed function.
+
+ boost::local::function_ref< void (int) > print_ref = new_print;
+ std::for_each(a, a + 3, print_ref); // OK: Passing function reference.
+
+ return 0;
+}
+</pre>
+
+ 
+<a name="boost_local.Advanced.renaming_local_functions.motivation"></a><h6>
+<a name="id884109"></a>
+ <a class="link" href="Advanced.html#boost_local.Advanced.renaming_local_functions.motivation">Motivation</a>
+ </h6>
+
+ The motivation for renaming a local function might not be obvious at first.
+ In fact, in most cases programmers will not need to rename local functions.
+ 
+
+ Renaming local functions might be useful at least to program macros that
+ expand using local functions and that do not want to pass the local function
+ body as a macro parameter (so to retain the usual meaning of compiler error
+ line numbers for the body code). Consider the following example that implements
+ a simple version of the local exit macros using a renamed local function:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/function.hpp>
+#include <boost/local/function_ref.hpp>
+#include <boost/preprocessor/cat.hpp>
+
+#define EXIT(parenthesized_binding) \
+ BOOST_LOCAL_FUNCTION( \
+ (void) (BOOST_PP_CAT(exit_code, __LINE__))( parenthesized_binding ) \
+ ) /* followed by exit body here */
+
+// Local function renaming is necessary because `__LINE__` has a different
+// value when `EXIT_END` macro expands respect to its value when the `EXIT()`
+// macro expands.
+#define EXIT_END \
+ /* preceded by exit body here */ \
+ BOOST_LOCAL_FUNCTION_END_RENAME( \
+ BOOST_PP_CAT(exit_code, __LINE__)) \
+ exit_guard BOOST_PP_CAT(exit_guardian, __LINE__)( \
+ BOOST_PP_CAT(exit_code, __LINE__));
+
+struct exit_guard {
+ typedef boost::local::function_ref< void () > ref_type;
+ explicit exit_guard(ref_type ref): ref_(ref) {}
+ ~exit_guard() { ref_(); } // Execute local function code at scope exit.
+private:
+ ref_type ref_;
+};
+
+int main() {
+ int* a = new int[3];
+ EXIT( (bind)((a)) ) {
+ // Body outside macros so retain complier error meaning.
+ if (a) delete[] a;
+ } EXIT_END
+
+ return 0;
+}
+</pre>
+
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced.limitations__overloading__nesting__operators__etc"></a><a class="link" href="Advanced.html#boost_local.Advanced.limitations__overloading__nesting__operators__etc" title="Limitations: Overloading, Nesting, Operators, Etc">Limitations:
+ Overloading, Nesting, Operators, Etc</a>
+</h3></div></div></div>
+
+ This is a list of limitations of this library's local functions compared
+ to usual features of C++ functions.
+ 
+<a name="boost_local.Advanced.limitations__overloading__nesting__operators__etc.overloading"></a><h6>
+<a name="id885100"></a>
+ <a class="link" href="Advanced.html#boost_local.Advanced.limitations__overloading__nesting__operators__etc.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="id885120" href="#ftn.id885120" class="footnote">18</a>]
+ 
+
+ For example, the following code will not
+ compile:
+ 
+<pre class="programlisting">void f() {
+ <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>(
+ (void) (l)( (const int&)(i) )
+ ) {
+ std::cout << i << std::endl;
+ } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code>(l)
+
+ <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>(
+ (void) (l)( (const double&)(d) )
+ ) {
+ std::cout << d << std::endl;
+ } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code>(l) // Error: Cannot overload.
+
+ ...
+}
+</pre>
+<a name="boost_local.Advanced.limitations__overloading__nesting__operators__etc.nesting"></a><h6>
+<a name="id885584"></a>
+ <a class="link" href="Advanced.html#boost_local.Advanced.limitations__overloading__nesting__operators__etc.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="id885606" href="#ftn.id885606" class="footnote">19</a>]
+ 
+
+ For example, the following code will not
+ compile:
+ 
+<pre class="programlisting">void f() {
+ <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>(
+ (int) (l)( (int)(i) )
+ ) {
+ <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>( // Error: Cannot nest.
+ (int) (m)( (int)(j) )
+ ) {
+ return j * 10;
+ } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code>(m)
+
+ return m(i) * 10;
+ } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code>(l)
+
+ ...
+}
+</pre>
+<a name="boost_local.Advanced.limitations__overloading__nesting__operators__etc.operators"></a><h6>
+<a name="id886028"></a>
+ <a class="link" href="Advanced.html#boost_local.Advanced.limitations__overloading__nesting__operators__etc.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="id886065" href="#ftn.id886065" class="footnote">20</a>]
+ 
+
+ For example, the following code will not
+ compile:
+ 
+<pre class="programlisting">void f() {
+ struct point {
+ double x;
+ double y;
+ };
+
+ <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>( // Error: Cannot be `operator==`.
+ (bool) (operator==)( (const point&)(p) (const point&)(q) )
+ ) {
+ return p.x == q.x && p.y == q.y;
+ ) <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code>(operator==)
+
+ ...
+}
+</pre>
+<a name="boost_local.Advanced.limitations__overloading__nesting__operators__etc.etc"></a><h6>
+<a name="id886471"></a>
+ <a class="link" href="Advanced.html#boost_local.Advanced.limitations__overloading__nesting__operators__etc.etc">Etc</a>
+ </h6>
+
+ Some usual C++ function features like <code class="computeroutput">inline</code>
+ and default parameters are supported for local functions while other features
+ are not supported. The parenthesized syntax itself (see the <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a>
+ section) could be extended to support all C++ function
+ features even with the addition of concepts and named parameters (see Contract++):
+ 
+<pre class="programlisting">parenthesized-signature:
+ [(export)] [(template)(template-parameter-list)] [(requires)(concept-list)]
+ [(explicit)]
+ [(inline)] [(extern)]
+ [(static)] [(virtual)]
+ (result-type) (function-name)(parameter-list)
+ [(const)] [(volatile)]
+</pre>
+
+ However, not all these features apply to local functions:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ C++ Function Feature
+ 
+ </th>
+<th>
+ 
+ Local Function Support
+ 
+ </th>
+<th>
+ 
+ Rationale
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">(export)</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions cannot be templates
+ (plus most C++ compilers do not implement <code class="computeroutput">export</code>).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">(template)(</code>template-parameter-list<code class="computeroutput">)</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are implemented using
+ local classes and C++ local classes cannot be templates.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">(requires)(</code>concept-list<code class="computeroutput">)</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This library could internally use Boost.ConceptCheck
+ to check the concepts specified by using the parenthesized syntax.
+ However, concept checking is not supported because local functions
+ cannot be templates.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">(explicit)</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not constructors.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">(inline)</code>
+ 
+ </td>
+<td>
+ 
+ Yes
+ 
+ </td>
+<td>
+ 
+ This is supported (see the <a class="link" href="Advanced.html" title="Advanced">Advanced</a>
+ section).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">(extern)</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are always defined
+ locally within the enclosing scope and together with their declarations.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">(static)</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not member functions.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">(virtual)</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not member functions.
+ 
+ 
+ In theory, it would be possible for a local functor class to inherit
+ from another local functor class. The parenthesized syntax could
+ be extended to specify the eventual base local functor class within
+ the parenthesized signature (e.g., using <code class="computeroutput">...
+ (extends)(</code>base<code class="computeroutput">)</code>). However, this "inheritance"
+ feature is not implemented because it seems of <a href="http://lists.boost.org/Archives/boost/2010/09/170895.php" target="_top">no
+ use</a> given that local functions can be bound to one another
+ thus they can simply call each other directly without recurring
+ to dynamic binding or base function call.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">(</code>result-type<code class="computeroutput">)</code>
+ 
+ </td>
+<td>
+ 
+ Yes
+ 
+ </td>
+<td>
+ 
+ This is supported (see the <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a>
+ section).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">(</code>function-name<code class="computeroutput">)</code>
+ 
+ </td>
+<td>
+ 
+ Yes
+ 
+ </td>
+<td>
+ 
+ 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).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">(</code>parameter-list<code class="computeroutput">)</code>
+ 
+ </td>
+<td>
+ 
+ Yes
+ 
+ </td>
+<td>
+ 
+ This is supported and it also supports the <code class="computeroutput">auto</code>
+ 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).
+ 
+ 
+ In addition, the parenthesized syntax could support named parameters
+ introducing the "keywords" <code class="computeroutput">(in)</code>,
+ <code class="computeroutput">(out)</code>, <code class="computeroutput">(inout)</code>,
+ and then using Boost.Paramater
+ to internally implement named parameters. However, local functions
+ cannot be templates so they cannot be used with Boost.Paramater
+ thus named parameters are not supported for local functions.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Trailing <code class="computeroutput">(const)</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not member functions.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Trailing <code class="computeroutput">(volatile)</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not member functions.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a id="ftn.id875940" href="#id875940" class="para">15</a>] 
+ We recognize that the use of the identity macros adds
+ extra parenthesis to the already significant number of parenthesis required
+ by the parenthesized syntax. However, parenthesized signatures usually
+ do not contain unwrapped commas "<code class="computeroutput">,</code>"
+ (unless template metaprogramming is being used).
+ </div>
+<div class="footnote">[<a id="ftn.id880460" href="#id880460" class="para">16</a>] 
+ The suffix <code class="computeroutput">ref</code> of <code class="computeroutput">boost::local::<a class="link" href="../boost/local/function_ref.html" title="Struct template function_ref">function_ref</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.id883162" href="#id883162" class="para">17</a>] 
+ Rationale. Local functions are often named
+ <code class="computeroutput">l</code> in the casual examples
+ of this documentation because the name of the author starts with the letter
+ "<code class="computeroutput">l</code>". <img src="../../images/smiley.png" alt="smiley">
+ </div>
+<div class="footnote">[<a id="ftn.id885120" href="#id885120" class="para">18</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.id885606" href="#id885606" class="para">19</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.id886065" href="#id886065" class="para">20</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
+ names.
+ </div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Tutorial.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Alternatives.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Alternatives.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,261 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Appendix: Alternatives</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="Grammar.html" title="Appendix: Grammar">
+<link rel="next" href="Examples.html" title="Appendix: Examples">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Grammar.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Examples.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Alternatives"></a><a class="link" href="Alternatives.html" title="Appendix: Alternatives">Appendix: Alternatives</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt>Local Functions</dt>
+<dt>Local Blocks</dt>
+<dt>Local Exits</dt>
+</dl></div>
+
+ This section compares the features offered by this library with similar features
+ offered by other libraries and by the new C++0x standard.
+ 
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Alternatives.local_functions"></a><a class="link" href="Alternatives.html#boost_local.Alternatives.local_functions" title="Local Functions">Local Functions</a>
+</h3></div></div></div>
+
+ The following table compares local function features.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Local Function Feature
+ 
+ </th>
+<th>
+ 
+ This Library
+ 
+ </th>
+<th>
+ 
+ Local Classes
+ 
+ </th>
+<th>
+ 
+ <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++0x
+ lambda</a>
+ 
+ </th>
+<th>
+ 
+ Boost.Lambda
+ 
+ </th>
+<th>
+ 
+ Boost.Phoenix
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ Program body using usual C++ syntax
+ 
+ </td>
+<td>
+ 
+ Yes.
+ 
+ </td>
+<td>
+ 
+ Yes.
+ 
+ </td>
+<td>
+ 
+ Yes.
+ 
+ </td>
+<td>
+ 
+ No.
+ 
+ </td>
+<td>
+ 
+ No.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Can be passed as template parameter (e.g., to STL algorithms)
+ 
+ </td>
+<td>
+ 
+ Yes.
+ 
+ </td>
+<td>
+ 
+ No (see "local class" in [StroustupGlossary]).
+ 
+ </td>
+<td>
+ 
+ Yes.
+ 
+ </td>
+<td>
+ 
+ Yes.
+ 
+ </td>
+<td>
+ 
+ Yes.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Bind variables in scope
+ 
+ </td>
+<td>
+ 
+ Yes, bind by value, constant value, reference, and constant reference
+ (also bind the object <code class="computeroutput">this</code>).
+ 
+ </td>
+<td>
+ 
+ No.
+ 
+ </td>
+<td>
+ 
+ Yes, but no bind by constant (value or reference).
+ 
+ </td>
+<td>
+ 
+ No.
+ 
+ </td>
+<td>
+ 
+ No.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Can be defined within expressions
+ 
+ </td>
+<td>
+ 
+ No, defined only within declarations.
+ 
+ </td>
+<td>
+ 
+ No, defined only within declarations.
+ 
+ </td>
+<td>
+ 
+ Yes.
+ 
+ </td>
+<td>
+ 
+ Yes.
+ 
+ </td>
+<td>
+ 
+ Yes.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Alternatives.local_blocks"></a><a class="link" href="Alternatives.html#boost_local.Alternatives.local_blocks" title="Local Blocks">Local Blocks</a>
+</h3></div></div></div>
+
+ The authors know of no other library or language feature that supports local
+ blocks (i.e., with the ability to bind by constant value or reference).
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Alternatives.local_exits"></a><a class="link" href="Alternatives.html#boost_local.Alternatives.local_exits" title="Local Exits">Local Exits</a>
+</h3></div></div></div>
+
+ This library local exits provide a functionality very similar to the one
+ provided by Boost.ScopeExit
+ but with the following additional features:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Bind by constant (value or reference).
+ </li>
+<li class="listitem">
+ Bind the object <code class="computeroutput">this</code>.
+ </li>
+</ul></div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Grammar.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Examples.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Bibliography.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Bibliography.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,67 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Bibliography</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="Releases.html" title="Releases">
+<link rel="next" href="Acknowledgments.html" title="Acknowledgments">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Releases.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Acknowledgments.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Bibliography"></a><a class="link" href="Bibliography.html" title="Bibliography">Bibliography</a>
+</h2></div></div></div>
+
+ This section lists all the bibliographic references cited by this documentation.
+ 
+
+ [N2511]
+ Alisdair Meredith. Named Lambdas and Local Functions.
+ The C++ Standards Committee, document no. N2511=08-0021, 2008.
+ 
+
+ [N2529]
+ Jaakko Jarvi, John Freeman, Lawrence Crowl. Lambda Expressions and
+ Closures: Wording for Monomorphic Lambdas (Revision 3). The C++
+ Standards Committee, document no. N2529=08-0039, 2008.
+ 
+
+ [N2550]
+ Jaakko Jarvi, John Freeman, Lawrence Crowl. Lambda Expressions and
+ Closures: Wording for Monomorphic Lambdas (Revision 4). The C++
+ Standards Committee, document no. N2550=08-0060, 2008.
+ 
+
+ [StroustupGlossary]
+ Bjarne Stroustrup. Bjarne Stroustrup's C++ Glossary.
+ 
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Releases.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Acknowledgments.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Examples.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Examples.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,239 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Appendix: Examples</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="Alternatives.html" title="Appendix: Alternatives">
+<link rel="next" href="Releases.html" title="Releases">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Alternatives.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Releases.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Examples"></a><a class="link" href="Examples.html" title="Appendix: Examples">Appendix: Examples</a>
+</h2></div></div></div>
+
+ This section lists the complete source code of some examples that can be compiled
+ and executed using this library (see also the many examples listed within the
+ text of this documentation).
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Adapted From
+ 
+ </th>
+<th>
+ 
+ Name
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+<th>
+ 
+ Source File(s)
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ Boost.ScopeExit
+ documentation
+ 
+ </td>
+<td>
+ 
+ Local Exit
+ 
+ </td>
+<td>
+ 
+ Local exits with user defined types registered using Boost.Typeof.
+ 
+ </td>
+<td>
+ 
+ exit.cpp
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ N/A
+ 
+ </td>
+<td>
+ 
+ STL Transform
+ 
+ </td>
+<td>
+ 
+ Bind a local function to another local function.
+ 
+ </td>
+<td>
+ 
+ transform.cpp
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ [N2550]
+ 
+ </td>
+<td>
+ 
+ STL Find
+ 
+ </td>
+<td>
+ 
+ Pass a local function to <code class="computeroutput">std::find_if</code>.
+ 
+ </td>
+<td>
+ 
+ find_if.cpp
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ [N2529]
+ 
+ </td>
+<td>
+ 
+ Bind This
+ 
+ </td>
+<td>
+ 
+ Bind object <code class="computeroutput">this</code> to
+ a local function.
+ 
+ </td>
+<td>
+ 
+ this.cpp
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ N/A
+ 
+ </td>
+<td>
+ 
+ Local Block
+ 
+ </td>
+<td>
+ 
+ Local blocks with biding (constant, non-constant, and <code class="computeroutput">this</code>) and <code class="computeroutput">return</code>.
+ 
+ </td>
+<td>
+ 
+ block.cpp
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ N/A
+ 
+ </td>
+<td>
+ 
+ Parameters Permutations
+ 
+ </td>
+<td>
+ 
+ Exhaustively shows all possible parameter permutations (with/without
+ parameters, with/without binding constant and not, with/without
+ <code class="computeroutput">this</code> binding constant
+ and not).
+ 
+ </td>
+<td>
+ 
+ params.cpp
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ N/A
+ 
+ </td>
+<td>
+ 
+ Same Line
+ 
+ </td>
+<td>
+ 
+ Two local functions defined on the same line of code.
+ 
+ </td>
+<td>
+ 
+ same_line.cpp
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Alternatives.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Releases.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Grammar.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Grammar.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,200 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Appendix: Grammar</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">
+<link rel="next" href="Alternatives.html" title="Appendix: Alternatives">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../BOOST_IDENTITY_VALUE.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Alternatives.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Grammar"></a><a class="link" href="Grammar.html" title="Appendix: Grammar">Appendix: Grammar</a>
+</h2></div></div></div>
+
+ This section describes the complete grammar of the parenthesized
+ syntax used by this library to specify the local function signature
+ with binding of variables in scope.
+ 
+
+ This should be considered a reference section. See the <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a>
+ and the <a class="link" href="Advanced.html" title="Advanced">Advanced</a> sections for explanations
+ and examples on how to use the parenthesized syntax.
+ 
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ The parsers of the parenthesized syntax are implemented using macros and
+ the Boost.Preprocessor
+ library so the parenthesized syntax is parsed by the
+ preprocessor.
+ 
+
+ Using preprocessor metaprogramming allows the parsers to introduce new "keywords"
+ at the same syntactic level as the usual C++ keywords but that are used to
+ support new features specific to this library (for example the new "keyword"
+ <code class="computeroutput">bind</code> which is used to bind
+ variables in scope). However, the use of the preprocessor also requires using
+ a significant number of extra parenthesis <code class="computeroutput">()</code>
+ with respect to usual C++ syntax (from which the parenthesized syntax's name).
+ 
+
+ In addition, there is only a limited amount of syntactic error checking that
+ can be done using macros thus sometimes a parenthesized syntax error generates
+ cryptic preprocessor errors. When the macros can catch syntactic errors,
+ these errors are reported as compile-time errors (using static assertions)
+ with names of the form <code class="computeroutput">ERROR_</code>description_text.
+ 
+</td></tr>
+</table></div>
+
+ Macros using the parenthesized syntax (see the Reference
+ section):
+ 
+<pre class="programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>( parenthesized-signature )
+<code class="computeroutput"><a class="link" href="../BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>( parenthesized-binding )
+<code class="computeroutput"><a class="link" href="../BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code>( parenthesized-binding )
+</pre>
+
+ Additional "keywords":
+ 
+<pre class="programlisting">bind used to bind variables in scope
+default used to specify default parameters
+</pre>
+
+ Terminals:
+ 
+<pre class="programlisting">result-type a function return type (can be void)
+function-name a function name (cannot be an operator)
+
+parameter-type a parameter type
+parameter-name a parameter name
+parameter-default a valid default value for the specified parameter
+
+variable-name the name of a variable in scope (can be this)
+</pre>
+
+ Lexical conventions:
+ 
+<pre class="programlisting">a | b symbol a or symbol b
+[a] the symbol a is optional and it can be omitted
+a+ symbol a repeated one or more times
+</pre>
+
+ Parenthesized syntax:
+ 
+<pre class="programlisting">parenthesized-signature:
+ [(inline)] (result-type) (function-name)( parameter-list )
+
+parenthesized-binding:
+ (void) // No bindings.
+ | bindings // Bindings (constant and/or not).
+
+parameter-list:
+ (void) // No parameters and no bindings.
+ | parameters // Only parameters.
+ | bindings // Only bindings.
+ | parameters bindings // Both parameters and bindings (must appear in this order).
+</pre>
+
+ Function parameters:
+ 
+<pre class="programlisting">parameters:
+ parameter+ // Only required parameters.
+ | optional-parameter+ // Only optional parameters.
+ | parameter+ optional-parameter+ // Both required and optional parameters (must appear in this order).
+
+parameter:
+ [(auto) | (register)] // Optional parameter classifier `auto` or `register`.
+ (parameter-type)(parameter-name)
+
+optional-parameter:
+ parameter
+ (default)(parameter-default) // Default value for this optional parameter.
+</pre>
+
+ Binding variables in scope: [<a name="id892428" href="#ftn.id892428" class="footnote">21</a>] [<a name="id892732" href="#ftn.id892732" class="footnote">22</a>]
+ 
+<pre class="programlisting">bindings:
+ const-bindings // Only constant binding.
+ | plain-bindings // Only plain binding.
+ | const-bindings plain-bindings // Both constant and plain bindings (must appear in this order).
+
+const-bindings:
+ (const bind)(bound-variable+) // Force constant type for bound variable.
+
+plain-bindings:
+ (bind)(bound-variable+) // Use bound variable's plain type (constant or not).
+
+bound-variable:
+ (variable-name) // Bind by value.
+ | (&variable-name) // Bind by reference.
+</pre>
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a id="ftn.id892428" href="#id892428" class="para">21</a>] 
+ Rationale. The alternative syntax <code class="computeroutput">(bind)((const& x)...)</code>
+ would have been preferred because <code class="computeroutput">const</code>
+ appears before the reference as usual in C++ and because a single <code class="computeroutput">bind</code> sequence is used for both plain and
+ constant binding (e.g., the single sequence <code class="computeroutput">(bind)((a)(&b)(const
+ a)(const& b))</code> would
+ bind by value, by constant value, by reference, and by constant reference
+ respectively). However, the parenthesized syntax parsers cannot process both
+ <code class="computeroutput">const&
+ x</code> and <code class="computeroutput">&x</code> because if they inspect the beginning
+ of the token <code class="computeroutput">&x</code>
+ to search for the leading <code class="computeroutput">const</code>
+ they will find the non-alphanumeric symbol <code class="computeroutput">&</code>
+ which cannot be used for token concatenation thus generating preprocessor
+ errors. The tokens <code class="computeroutput">&x</code>
+ and <code class="computeroutput">x</code> can instead be processed
+ by the parsing macros because they do not need to be inspected from the front
+ (they are instead inspected from the back to check if a token matches <code class="computeroutput">this</code> and that is fine because the non-alphanumeric
+ symbol <code class="computeroutput">&</code> never appears in
+ the back).
+ </div>
+<div class="footnote">[<a id="ftn.id892732" href="#id892732" class="para">22</a>] 
+ Rationale. Binding is used within the function
+ parameter list because this syntax seemed natural given that the bound variables
+ are used by the function body as if they were function parameters (only their
+ type is not explicitly specified by the function signature and the caller
+ does not explicitly pass their values). However, the parenthesized syntax
+ could be modified to accept <code class="computeroutput">(const bind)(...)</code> and <code class="computeroutput">(bind)(...)</code>
+ outside the parameter list (e.g., at the very end or beginning of the function
+ signature) if an alternative syntax was to be identified as more intuitive.
+ </div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../BOOST_IDENTITY_VALUE.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Alternatives.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Releases.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Releases.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,95 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Releases</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="Examples.html" title="Appendix: Examples">
+<link rel="next" href="Bibliography.html" title="Bibliography">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Examples.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Bibliography.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Releases"></a><a class="link" href="Releases.html" title="Releases">Releases</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt>Version 0.1.1</dt>
+<dt>Version 0.1.0</dt>
+<dt>Version 0.0.1</dt>
+<dt>TODO</dt>
+</dl></div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Releases.version_0_1_1"></a><a class="link" href="Releases.html#boost_local.Releases.version_0_1_1" title="Version 0.1.1">Version 0.1.1</a>
+</h3></div></div></div>
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Uploaded library source into Boost SVN sandbox.
+ </li>
+<li class="listitem">
+ Fixed prev/next arrows and other minor layouts in documentation.
+ </li>
+<li class="listitem">
+ Added Release section to documentation.
+ </li>
+</ol></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Releases.version_0_1_0"></a><a class="link" href="Releases.html#boost_local.Releases.version_0_1_0" title="Version 0.1.0">Version 0.1.0</a>
+</h3></div></div></div>
+<div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
+ Shared with Boost for first round of comments.
+ </li></ol></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Releases.version_0_0_1"></a><a class="link" href="Releases.html#boost_local.Releases.version_0_0_1" title="Version 0.0.1">Version 0.0.1</a>
+</h3></div></div></div>
+<div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
+ Completed development, examples, and documentation.
+ </li></ol></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Releases.todo"></a><a class="link" href="Releases.html#boost_local.Releases.todo" title="TODO">TODO</a>
+</h3></div></div></div>
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Finish local function parenthesized syntax validation macros.
+ </li>
+<li class="listitem">
+ Add examples to Alternatives section for Local Classes, C++0x lambads,
+ Boost.Lambda, and Boost.Phoenix (ask boosters).
+ </li>
+</ol></div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Examples.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Bibliography.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Starting.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Starting.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,257 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Starting</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="next" href="Tutorial.html" title="Tutorial">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../index.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Tutorial.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</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>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt>This Documentation</dt>
+<dt><a href="Starting.html#boost_local.Starting.compilers_and_platforms">Compilers
+ and Platforms</a></dt>
+<dt>Installation</dt>
+<dt>File Structure</dt>
+<dt>Symbols</dt>
+<dt><a href="Starting.html#boost_local.Starting.compile_time_configuration">Compile-Time
+ Configuration</a></dt>
+</dl></div>
+
+ This section explains how to setup your system to use this library.
+ 
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Starting.this_documentation"></a><a class="link" href="Starting.html#boost_local.Starting.this_documentation" title="This Documentation">This Documentation</a>
+</h3></div></div></div>
+
+ Programmers should be ready to use this library, at least at a basic level,
+ after reading the following sections of this documentation:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The <a class="link" href="../index.html#boost_local.Introduction" title="Introduction">Introduction</a> section
+ 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
+ how to read this documentation, how to install the library to work with
+ the supported compilers and platforms.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a> section provides
+ a good explanation of basic usages of the library with extensive examples.
+ </li>
+</ul></div>
+
+ The following sections could be consulted at a later point to gain a more
+ in-depth knowledge of the library features:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The <a class="link" href="Advanced.html" title="Advanced">Advanced</a> section explains
+ advanced usages of the library.
+ </li>
+<li class="listitem">
+ The Reference section is the reference
+ manual of the library public API.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a> section formally
+ describes the parenthesized syntax used by this library to specify the
+ local function signatures.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Alternatives.html" title="Appendix: Alternatives">Alternatives</a> section
+ describes alternatives to this library to implement local functions.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Examples.html" title="Appendix: Examples">Examples</a> section lists
+ the source code of a few additional examples that use this library.
+ </li>
+</ul></div>
+
+ The following sections are for reference only:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The <a class="link" href="Releases.html" title="Releases">Releases</a> section contains
+ short release notes.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Bibliography.html" title="Bibliography">Bibliography</a> section
+ lists references that were consulted in the design and development of
+ this library.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Acknowledgments.html" title="Acknowledgments">Acknowledgments</a>
+ section attempts to recognize all the people that contributes directly
+ or indirectly to the design and development of this library.
+ </li>
+</ul></div>
+
+ Furthermore, some footnotes are marked by the word "Rationale"
+ because they explain reasons behind decisions made during the design and
+ implementation of this library.
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Starting.compilers_and_platforms"></a><a class="link" href="Starting.html#boost_local.Starting.compilers_and_platforms" title="Compilers and Platforms">Compilers
+ and Platforms</a>
+</h3></div></div></div>
+
+ The implementation of this library uses preprocessor and template metaprogramming
+ (as supported by Boost.Preprocessor
+ and Boost.MPL),
+ templates with partial specializations and function pointers (to support
+ an interface similar to the one of Boost.Function).
+ As a consequence, this library is fairly demanding on compilers' compliance
+ with the ISO C++ standard. At present, this library has been successfully
+ compiled and tested on the following compilers and platforms:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ GCC 4.2.4 on Ubuntu Linux.
+ </li>
+<li class="listitem">
+ GCC 3.4.4 on Cygwin.
+ </li>
+<li class="listitem">
+ Miscrosoft Visual Studio 8.0 on Windows XP.
+ </li>
+</ol></div>
+
+ This library has not yet been tested on any other compiler or platform.
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Starting.installation"></a><a class="link" href="Starting.html#boost_local.Starting.installation" title="Installation">Installation</a>
+</h3></div></div></div>
+
+ This library is composed of header files only. Therefore there is no pre-compiled
+ object file which needs to be installed. Programmers can simply instruct
+ the C++ compiler where to find the library header files (<code class="computeroutput">-I</code> option for GCC, <code class="computeroutput">/I</code> option for MSVC, etc) and they can start
+ compiling the code from the <a class="link" href="Examples.html" title="Appendix: Examples">Examples</a>
+ section, the code cut-and-pasted from the examples in this documentation,
+ and their own programs that use this library.
+ 
+
+ This library implementation uses a number of Boost
+ libraries among which: Boost.Preprocessor,
+ Boost.ScopeExit,
+ Boost.Typeof,
+ Boost.TypeTraits,
+ and Boost.MPL.
+ These Boost libraries must be
+ properly installed on your system in order for this library to work.
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Starting.file_structure"></a><a class="link" href="Starting.html#boost_local.Starting.file_structure" title="File Structure">File Structure</a>
+</h3></div></div></div>
+
+ The header files of this library are divided as follow:
+ 
+<pre class="programlisting"><code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">boost/local/function.hpp</a></code> local functions
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.block_hpp" title="Header <boost/local/block.hpp>">boost/local/block.hpp</a></code> local blocks
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.exit_hpp" title="Header <boost/local/exit.hpp>">boost/local/exit.hpp</a></code> local exits
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.function_ref_hpp" title="Header <boost/local/function_ref.hpp>">boost/local/function_ref.hpp</a></code> references to local functions
+</pre>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Starting.symbols"></a><a class="link" href="Starting.html#boost_local.Starting.symbols" title="Symbols">Symbols</a>
+</h3></div></div></div>
+
+ The following symbols are part of the library private API, they are not documented,
+ and they should not be directly used by programmers: [<a name="id864012" href="#ftn.id864012" class="footnote">1</a>]
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Any symbol defined by files within the <code class="computeroutput">"boost/local/aux_/"</code>
+ directory (these header files should not be directly included by programmers).
+ </li>
+<li class="listitem">
+ Any symbol prefixed by <code class="computeroutput">BOOST_LOCAL_AUX</code>.
+ </li>
+<li class="listitem">
+ Any symbol within the <code class="computeroutput">boost::local::aux</code>
+ namespace.
+ </li>
+<li class="listitem">
+ Any symbol prefixed by <code class="computeroutput">boost_local_aux</code>
+ (regardless of its namespace).
+ </li>
+</ul></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Starting.compile_time_configuration"></a><a class="link" href="Starting.html#boost_local.Starting.compile_time_configuration" title="Compile-Time Configuration">Compile-Time
+ Configuration</a>
+</h3></div></div></div>
+
+ Some of the library behaviour can be changed at compile-time by defining
+ special configuration macros. If a configuration macro
+ is left undefined, the library will use an appropriate default value for
+ it.
+ 
+
+ All configuration macros have names prefixed by <code class="computeroutput">BOOST_LOCAL_CONFIG</code>
+ (see Reference section). It is strongly
+ recommended not to change this library configuration macros unless strictly
+ necessary.
+ 
+</div>
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a id="ftn.id864012" href="#id864012" class="para">1</a>] 
+ Rationale. This library concatenates symbols
+ specified by the programmers (e.g., the local function name) with other
+ symbols (e.g., special prefixes or preprocessor line numbers) to make internal
+ symbols with unique names to avoid name clashes. These symbols are separated
+ by the letter "<code class="computeroutput">X</code>"
+ when they are concatenated so they can be read more easily while debugging
+ the library. The underscore character "<code class="computeroutput">_</code>"
+ could not be used instead of the letter "<code class="computeroutput">X</code>"
+ because if the original symbols already contain a leading or trailing underscore
+ the concatenation would result in a symbol with double underscores "<code class="computeroutput">__</code>" which is reserved by the C++
+ standard.
+ </div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../index.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Tutorial.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Tutorial.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Tutorial.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,1026 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Tutorial</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="Starting.html" title="Starting">
+<link rel="next" href="Advanced.html" title="Advanced">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Starting.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Advanced.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Tutorial"></a><a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt><a href="Tutorial.html#boost_local.Tutorial.parenthesized_syntax">Parenthesized
+ Syntax</a></dt>
+<dt>Local Functions</dt>
+<dt>Binding</dt>
+<dt>Local Blocks</dt>
+<dt>Local Exits</dt>
+<dt>Templates</dt>
+</dl></div>
+
+ This section illustrates basic usages of local functions, local blocks, and
+ local exits.
+ 
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Tutorial.parenthesized_syntax"></a><a class="link" href="Tutorial.html#boost_local.Tutorial.parenthesized_syntax" title="Parenthesized Syntax">Parenthesized
+ Syntax</a>
+</h3></div></div></div>
+
+ The parenthesized syntax is used to pass the syntactic
+ elements of a function signature as macro parameters in a way that resembles
+ the usual C++ syntax. All the function signature elements are wrapped within
+ round parenthesis <code class="computeroutput">()</code> to form
+ a Boost.Preprocessor
+ sequence called parenthesized signature. This allows
+ to program preprocessor macros that can parse the parenthesized syntax expanding
+ differently based on the different elements that are specified in the signature
+ (if the function has parameters or not, if the result type token matches
+ the <code class="computeroutput">void</code> keyword or not, etc).
+ 
+<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 general rules to program the parenthesized signature
+ are:
+ 
+
+ 1. Wrap all the signature syntactic elements within parenthesis <code class="computeroutput">()</code>. [<a name="id864335" href="#ftn.id864335" class="footnote">2</a>]
+ 
+
+ 2. If a token does not start with an alphanumeric symbol (i.e., <code class="computeroutput">a-z</code>,
+ <code class="computeroutput">A-Z</code>, or <code class="computeroutput">0-9</code>), replace
+ the token with its alphanumeric equivalent (as indicated in the <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a>
+ section). [<a name="id864462" href="#ftn.id864462" class="footnote">3</a>]
+ 
+
+ 3. Empty parenthesis <code class="computeroutput">()</code> are
+ not allowed. [<a name="id864498" href="#ftn.id864498" class="footnote">4</a>]
+ 
+
+ 4. Spaces and newlines do not matter and they can be used anywhere.
+ 
+</td></tr>
+</table></div>
+
+ For example, let's rewrite the following C++ function signature using the
+ parenthesized syntax:
+ 
+<pre class="programlisting">int l(double& y, const double& x = 0.0)
+</pre>
+
+ Step 1. We start by wrapping all the syntactic
+ elements within round parenthesis <code class="computeroutput">()</code>:
+ 
+<pre class="programlisting">(int) (l)( (double&)(y) (,) (const double&)(x)(=)(0.0) ) <code class="literal">/* wrap all elements within parenthesis `()` */</code>
+</pre>
+
+ Note how parameter types are wrapped within parenthesis separately from parameter
+ names. However, all the tokens of a parameter type are wrapped together within
+ a single set of parenthesis because the parameter type is one single syntactic
+ element of the function signature. For example, <code class="computeroutput">x</code>'s
+ type is specified by <code class="computeroutput">(const
+ double&)</code>
+ and not by <code class="computeroutput">(const)(double)(&)</code>.
+ 
+
+ Step 2. We note that the element <code class="computeroutput">(,)</code> wraps the non-alphanumeric symbol "<code class="computeroutput">,</code>" so it needs to be replaced. The parenthesized
+ syntax requires no special delimiter to separate function parameters (see
+ the <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a> section) so <code class="computeroutput">(,)</code> can simply be removed (if you like, you
+ can use a space or a newline to separate the function parameters):
+ 
+<pre class="programlisting">(int) (l)( (double&)(y) <code class="literal">/* use spaces or newlines instead of commas to separate parameters */</code> (const double&)(x)(=)(0.0) )
+</pre>
+
+ Step 3. We note also that the element <code class="computeroutput">(=)</code> wraps the non-alphanumeric symbol "<code class="computeroutput">=</code>" so it also needs to be replaced. The
+ parenthesized syntax uses the keyword <code class="computeroutput">default</code>
+ to specify a parameter default value (see the <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a>
+ section) so <code class="computeroutput">(=)</code> is replaced
+ by <code class="computeroutput">(default)</code>:
+ 
+<pre class="programlisting">(int) (l)( (double&)(y) (const double&)(x)(default)(0.0) )
+</pre>
+
+ We are done. The following is the valid parenthesized signature:
+ 
+<pre class="programlisting">(int) (l)( (double&)(y) (const double&)(x)(default)(0.0) )
+</pre>
+
+ for a function:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ With <code class="computeroutput">int</code> result type.
+ </li>
+<li class="listitem">
+ Named <code class="computeroutput">l</code>.
+ </li>
+<li class="listitem">
+ With one required parameter of type <code class="computeroutput">double&</code> and named <code class="computeroutput">y</code>.
+ </li>
+<li class="listitem">
+ With an optional parameter of type <code class="computeroutput">const
+ double&</code>,
+ named <code class="computeroutput">x</code>, and with default
+ value <code class="computeroutput">0.0</code>.
+ </li>
+</ul></div>
+<div class="warning"><table border="0" summary="Warning">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../../../../../doc/src/images/warning.png"></td>
+<th align="left">Warning</th>
+</tr>
+<tr><td align="left" valign="top">
+ Unfortunately, there are intrinsic limitations to the amount of syntactic
+ error checking that can be done by the parsing macros implemented using
+ the preprocessor. As a consequence, an error in using the parenthesized
+ syntax might result in cryptic preprocessor errors.
+ The best way to identify and correct these errors is usually to visually
+ inspect the signature comparing it with the parenthesized syntax grammar
+ (see the <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a> section). When
+ syntactic errors can be detected by the parsing macros, they are raised
+ at compile-time using error messages of the form <code class="computeroutput">ERROR_</code>description_text.
+ [<a name="id865444" href="#ftn.id865444" class="footnote">5</a>]
+ </td></tr>
+</table></div>
+<a name="boost_local.Tutorial.parenthesized_syntax.functions_with_no_parameters"></a><h6>
+<a name="id865483"></a>
+ <a class="link" href="Tutorial.html#boost_local.Tutorial.parenthesized_syntax.functions_with_no_parameters">Functions
+ With No Parameters</a>
+ </h6>
+
+ Let's rewrite the following C++ signature for a function with no parameters
+ using the parenthesized syntax:
+ 
+<pre class="programlisting">int l()
+</pre>
+
+ If we wrap all the elements within parenthesis we have:
+ 
+<pre class="programlisting">(int) (l)() // Error: Empty parenthesis `()` cannot be used.
+</pre>
+
+ However, this is not a valid parenthesized signature because it contains
+ the empty parenthesis <code class="computeroutput">()</code>.
+ 
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ This limitation applies to the ISO C++ standard preprocessor but it does
+ not apply to the C99 and other more recent preprocessors. This library
+ allows the use of empty parenthesis <code class="computeroutput">()</code> if the preprocessor used supports empty
+ macro parameters. However, programmers should be well aware that if they
+ use empty parenthesis in the parenthesized syntax, the code is not C++
+ ISO standard compliant and it will be less portable (that is why the use
+ of empty parenthesis is excluded by the <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a>
+ section).
+ </td></tr>
+</table></div>
+
+ C++ also allows to use the keyword <code class="computeroutput">void</code>
+ to specify empty parameter lists. Therefore, the original C++ function signature
+ can be equivalently rewritten as:
+ 
+<pre class="programlisting">int l(void)
+</pre>
+
+ If we now wrap all the elements within parenthesis we obtain the valid parenthesized
+ signature:
+ 
+<pre class="programlisting">(int) (l)( (void) ) // OK: Use `(void)` for empty parameter lists.
+</pre>
+
+ In conclusion, the parenthesized syntax requires to use <code class="computeroutput">(void)</code> to indicate
+ an empty parameter list (see the <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a>
+ section).
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Tutorial.local_functions"></a><a class="link" href="Tutorial.html#boost_local.Tutorial.local_functions" title="Local Functions">Local Functions</a>
+</h3></div></div></div>
+
+ Local functions are defined using the following macros (see the Reference
+ section) from within a declarative context (this is a limitation with respect
+ 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 appear within expressions):
+ 
+<pre class="programlisting">{ // Some declarative context.
+ ...
+
+ <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>(
+ parenthesized-signature
+ ) {
+ local-function-body
+ } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code>(local-function-name)
+
+ ...
+}
+</pre>
+
+ This creates a functor object with the local function name that can be called
+ from the enclosing scope. Note that:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The usual C++ scope visibility rules apply to local functions for which
+ a local function is visible and can be called only within the enclosing
+ scope in which it is defined.
+ </li>
+<li class="listitem">
+ The local function signature is expressed using the parenthesized syntax
+ and passed to the <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>
+ macro.
+ </li>
+<li class="listitem">
+ The local function body is defined in a code block <code class="computeroutput">{
+ ... }</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="id865976" href="#ftn.id865976" class="footnote">6</a>]
+ </li>
+<li class="listitem">
+ The macro <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code>
+ is used to end the local function definition and it must repeat the local
+ function name. [<a name="id866010" href="#ftn.id866010" class="footnote">7</a>] The compiler will generate an error if the name specified
+ by this macro does not match the one from the local function signature
+ (see <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a></code>
+ to remove this constraint).
+ </li>
+</ul></div>
+
+ For example, let's program a local function <code class="computeroutput">add</code>
+ similar to the one in the example from the <a class="link" href="../index.html#boost_local.Introduction" title="Introduction">Introduction</a>
+ section. We start by rewriting its signature:
+ 
+<pre class="programlisting">void add(double num)
+</pre>
+
+ using the parenthesized syntax:
+ 
+<pre class="programlisting">(void) (add)( (double)(num) )
+</pre>
+
+ For simplicity, we will not bind any of the variables in scope just yet (binding
+ is explained later in this section).
+ 
+
+ Then we pass the parenthesized signature to the <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>
+ macro, we implement a simple body that prints the number, and we pass the
+ local function name <code class="computeroutput">add</code> to
+ the <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code>
+ macro:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+
+int main() {
+ BOOST_LOCAL_FUNCTION(
+ (void) (add)( (double)(num) )
+ ) {
+ std::clog << num << std::endl;
+ } BOOST_LOCAL_FUNCTION_END(add)
+
+ add(100.0);
+
+ return 0;
+}
+</pre>
+
+ 
+
+ This creates a local function <code class="computeroutput">add</code>
+ that can be called from within the enclosing scope as for example by the
+ <code class="computeroutput">add(100.0);</code> instruction.
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Tutorial.binding"></a><a class="link" href="Tutorial.html#boost_local.Tutorial.binding" title="Binding">Binding</a>
+</h3></div></div></div>
+
+ Variables in scope (local variables, enclosing function parameters, member
+ variables, the object <code class="computeroutput">this</code>,
+ etc) can be bound to a local function declaration. Variables in scope can
+ be bound by reference, by constant reference, by value, or by constant value.
+ The types of bound variables are automatically deduced by this library using
+ Boost.Typeof.
+ [<a name="id866628" href="#ftn.id866628" class="footnote">8</a>]
+ 
+<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">
+ User defined types need to be manually registered
+ as usual when using Boost.Typeof
+ (see Boost.Typeof
+ documentation and the Local Exit example from the <a class="link" href="Examples.html" title="Appendix: Examples">Examples</a>
+ section).
+ </td></tr>
+</table></div>
+
+ The parenthesized syntax introduces the additional "keyword" <code class="computeroutput">bind</code> which is used to list all the bound
+ variable names wrapped within parenthesis at the end of the local function
+ parameter list (see the <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a>
+ section):
+ 
+<pre class="programlisting">(result-type) (function-name)( parameters (bind)((var1)(var2)...(varN)) )
+</pre>
+
+ Where var is the name of the variable in scope to bind
+ and it is prefixed by <code class="computeroutput">&</code>
+ if the variable is bound by reference, otherwise is it bound by value.
+ 
+
+ For example, let's assume we want to bind two variables in scope <code class="computeroutput">a</code> and <code class="computeroutput">b</code>
+ to the local function <code class="computeroutput">l</code> shown
+ before. Let's also assume we want to bind <code class="computeroutput">a</code>
+ by value and <code class="computeroutput">b</code> by reference.
+ Then we use the following parenthesized signature for the local function:
+ 
+<pre class="programlisting">(int) (l)( (double&)(y) (const double&)(x)(default)(0.0) (bind)((a)(&b)) )
+</pre>
+
+ If a variable is bound by value, then a copy of the variable value is taken
+ at the point of the local function declaration. If a variable is bound by
+ reference instead, the variable will refer to the value it has at the point
+ of the local function call. Furthermore, it is the programmers' responsibility
+ to ensure that variables bound by reference survive the scope of declaration
+ of the local function otherwise the bound references will be invalid causing
+ run-time errors (in other words, the usual care in using C++ references must
+ be used for variables in scope bound by reference). It is also possible to
+ bind a local function to another local function as shown in the STL Transform
+ example from the <a class="link" href="Examples.html" title="Appendix: Examples">Examples</a> section
+ (note that local functions cannot be copied so they are always bound by reference
+ even if <code class="computeroutput">&</code> is not specified).
+ 
+
+ The type of bound variables is automatically deduced and it is the exact
+ same type used to declare such variables in the enclosing scope. Therefore:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ If a bound variable was declared constant using the <code class="computeroutput">const</code>
+ qualifier then it will be bound by constant value or reference.
+ </li>
+<li class="listitem">
+ If a bound variable was not declared constant then it will not be bound
+ as constant. This library allows to force constant biding even for variables
+ that are not originally declared constant using <code class="computeroutput">(const bind)(...)</code> as explained below.
+ </li>
+<li class="listitem">
+ You 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).
+ </li>
+</ul></div>
+
+ For example, let's continue to program a local function <code class="computeroutput">add</code>
+ similar to the one from the example in <a class="link" href="../index.html#boost_local.Introduction" title="Introduction">Introduction</a>
+ section. We bind the local variable <code class="computeroutput">sum</code>
+ by (non-constant) reference and update the body to perform the summation:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+
+int main() {
+ double sum = 0.0;
+
+ BOOST_LOCAL_FUNCTION(
+ (void) (add)( (double)(num) (bind)((&sum)) )
+ ) {
+ sum += num;
+ std::clog << "Summed: " << sum << std::endl;
+ } BOOST_LOCAL_FUNCTION_END(add)
+
+ add(100.0);
+
+ return 0;
+}
+</pre>
+
+ 
+<a name="boost_local.Tutorial.binding.constant_binding"></a><h6>
+<a name="id867562"></a>
+ <a class="link" href="Tutorial.html#boost_local.Tutorial.binding.constant_binding">Constant Binding</a>
+ </h6>
+
+ Constant binding allows to bind variables in scope by constant reference
+ or constant value (constant binding 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="id867586" href="#ftn.id867586" class="footnote">9</a>]
+ 
+
+ The parenthesized syntax uses the "keywords" <code class="computeroutput">const
+ bind</code> to list constant bound variables
+ wrapped within parenthesis at the end of the function parameter list (see
+ the <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a> section):
+ 
+<pre class="programlisting">(result-type) (function-name)( parameters (const bind)((cvar1)(cvar2)...(cvarM)) )
+</pre>
+
+ Where cvar is the name of the variable in scope to bind
+ by constant and it is prefixed by <code class="computeroutput">&</code>
+ if the variable is bound by constant reference, otherwise it is bound by
+ constant value. If both constant and plain bindings are used, constant bindings
+ must be specified before plain bindings (see the <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a>
+ section):
+ 
+<pre class="programlisting">(result-type) (function-name)( parameters (const bind)((cvar1)(cvar2)...(cvarM)) (bind)((var1)(var2)...(varN)) ) /* `(const bind)(...)` before `(bind)(...)` */
+</pre>
+
+ For example, let's assume we want to bind two variables in scope <code class="computeroutput">c</code> and <code class="computeroutput">d</code>
+ to the local function <code class="computeroutput">l</code> shown
+ before. Let's also assume we want to bind <code class="computeroutput">c</code>
+ by constant value and <code class="computeroutput">b</code> by
+ costant reference. Then we use the following parenthesized signature for
+ the local function:
+ 
+<pre class="programlisting">(int) (l)( (double&)(y) (const double&)(x)(default)(0.0) (const bind)((c)(&d)) )
+</pre>
+
+ If the variables in scope <code class="computeroutput">a</code>
+ and <code class="computeroutput">b</code> are also bound but
+ by (plain) value and reference respectively then the parenthesized signature
+ becomes:
+ 
+<pre class="programlisting">(int) (l)( (double&)(y) (const double&)(x)(default)(0.0) (const bind)((c)(&d)) (bind)((a)(&b)) )
+</pre>
+
+ Note how <code class="computeroutput">(const
+ bind)(...)</code>
+ must always be used before <code class="computeroutput">(bind)(...)</code>
+ when they are both present.
+ 
+
+ For example, let's continue to program a local function <code class="computeroutput">add</code>
+ similar to the one in the example from the <a class="link" href="../index.html#boost_local.Introduction" title="Introduction">Introduction</a>
+ section. We bind the local variable <code class="computeroutput">factor</code>
+ by constant value and update the body to perform the factor scaling:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+
+int main() {
+ double sum = 0.0;
+ int factor = 10;
+
+ BOOST_LOCAL_FUNCTION(
+ (void) (add)( (double)(num) (const bind)((factor)) (bind)((&sum)) )
+ ) {
+ sum += factor * num;
+ std::clog << "Summed: " << sum << std::endl;
+ } BOOST_LOCAL_FUNCTION_END(add)
+
+ add(100.0);
+
+ return 0;
+}
+</pre>
+
+ 
+<a name="boost_local.Tutorial.binding.binding_the_object__code__phrase_role__keyword__this__phrase___code_"></a><h6>
+<a name="id868889"></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>
+
+ It is also possible to bind the object <code class="computeroutput">this</code>
+ when it is in scope (from enclosing member functions, etc). This is done
+ by using <code class="computeroutput">this</code> as the name of
+ the variable to bind and by using the special symbol <code class="computeroutput">this_</code>
+ (instead of <code class="computeroutput">this</code>) to access
+ the object within the local function body. Note that:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The object <code class="computeroutput">this</code> can be bound
+ by value using <code class="computeroutput">(bind)((this)...)</code>. In this case the local function
+ will be able to modify the object when the enclosing scope is a non-constant
+ member, or it will not be able to modify the object when the enclosing
+ scope is a constant member.
+ </li>
+<li class="listitem">
+ The object <code class="computeroutput">this</code> can be bound
+ by constant value <code class="computeroutput">(const
+ bind)((this)...)</code>.
+ In this case the local function will never be able to modify the object
+ (regardless of whether the enclosing scope is a constant member or not).
+ </li>
+<li class="listitem">
+ Finally, the object <code class="computeroutput">this</code>
+ can never be bound by reference because C++ does not allow to get a reference
+ to <code class="computeroutput">this</code>. You will get a
+ compile-time error if you try to use <code class="computeroutput">(bind)((&this)...)</code>
+ or <code class="computeroutput">(const
+ bind)((&this)...)</code>.
+ However, <code class="computeroutput">this</code> is a pointer
+ so the object is not copied even if it is bound by value. (Note that
+ it is not possible to bind <code class="computeroutput">*this</code> because it starts with <code class="computeroutput">*</code> and it is not a variable name.)
+ </li>
+</ul></div>
+<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">
+ When the object <code class="computeroutput">this</code> is bound
+ 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="id869243" href="#ftn.id869243" class="footnote">10</a>] Using <code class="computeroutput">this</code> within
+ the local function body will generate a compile-time error so programmers
+ cannot mistakenly confuse the use of <code class="computeroutput">this_</code>
+ with <code class="computeroutput">this</code>. [<a name="id869342" href="#ftn.id869342" class="footnote">11</a>]
+ </td></tr>
+</table></div>
+
+ For example, let's rewrite a local function <code class="computeroutput">add</code>
+ similar to the one in the example from the <a class="link" href="../index.html#boost_local.Introduction" title="Introduction">Introduction</a>
+ section but using a member function to illustrate how to bind the object
+ <code class="computeroutput">this</code>:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/function.hpp>
+#include <vector>
+#include <algorithm>
+#include <iostream>
+#include <cassert>
+
+class adder {
+public:
+ adder(): sum_(0.0) {}
+
+ double sum(const std::vector<double>& nums, const int& factor = 10) {
+
+ BOOST_LOCAL_FUNCTION(
+ (void) (add)( (double)(num) (const bind)((factor)) (bind)((this)) )
+ ) {
+ this_->sum_ += factor * num; // Use `this_` instead of `this`.
+ std::clog << "Summed: " << this_->sum_ << std::endl;
+ } BOOST_LOCAL_FUNCTION_END(add)
+
+ std::for_each(nums.begin(), nums.end(), add);
+ return sum_;
+ }
+
+private:
+ double sum_;
+};
+
+int main() {
+ std::vector<double> v(3);
+ v[0] = 100.0; v[1] = 90.5; v[2] = 7.0;
+
+ adder a;
+ // sum = 10 * 100.0 + 10 * 90.5 + 10 * 7.0 = 1975.0
+ assert(a.sum(v) == 1975.0);
+
+ return 0;
+}
+</pre>
+
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Tutorial.local_blocks"></a><a class="link" href="Tutorial.html#boost_local.Tutorial.local_blocks" title="Local Blocks">Local Blocks</a>
+</h3></div></div></div>
+
+ Local blocks are defined using the following macros within a declarative
+ context (see the Reference section):
+ 
+<pre class="programlisting">{ // Some declarative context.
+ ...
+
+ <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>( parenthesized-binding ) {
+ block-body
+ } <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>
+
+ This expands to code that executes the body instructions in place where the
+ block is defined. However, only bound variables specified by the parenthesized-binding
+ are accessible from within the local block body.
+ 
+
+ Adopting a parenthesized syntax similar to the one used for local functions
+ (see the <a class="link" href="Grammar.html" title="Appendix: Grammar">Grammar</a> section), the
+ parenthesized-binding can specify to bind no variable:
+ 
+<pre class="programlisting">(void)
+</pre>
+
+ Or, to bind variables by constant type only:
+ 
+<pre class="programlisting">(const bind)((cvar1)(cvar2)...(cvarM))
+</pre>
+
+ Or, to bind variables by plain type only:
+ 
+<pre class="programlisting">(bind)((var1)(var2)...(varN))
+</pre>
+
+ Or, to bind variables by both constant and plain types:
+ 
+<pre class="programlisting">(const bind)((cvar1)(cvar2)...(cvarM)) (bind)((var1)(var2)...(varN))
+</pre>
+
+ Where cvar and var are the names
+ of the variables in scope to bind. They can be prefixed by <code class="computeroutput">&</code> to bind by reference instead of by value,
+ and one of them can be <code class="computeroutput">this</code>
+ to bind the object when it is in scope.
+ 
+<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">
+ 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 scope.
+ [<a name="id870864" href="#ftn.id870864" class="footnote">12</a>]
+ </td></tr>
+</table></div>
+
+ For example, let's program a local block similar to the one in the example
+ from the <a class="link" href="../index.html#boost_local.Introduction" title="Introduction">Introduction</a> section:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/block.hpp>
+#include <iostream>
+#include <cassert>
+
+int main() {
+ double sum = 1975.0;
+
+ BOOST_LOCAL_BLOCK( (const bind)((&sum)) ) {
+ assert(sum == 1975.0); // OK: Complier error if `==` confused with `=`.
+ std::clog << "Asserted summation: " << sum << std::endl;
+
+ return; // Return this local block (and not the enclosing scope).
+ assert(false); // OK: Never executed.
+ } BOOST_LOCAL_BLOCK_END
+
+ return 0;
+}
+</pre>
+
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Tutorial.local_exits"></a><a class="link" href="Tutorial.html#boost_local.Tutorial.local_exits" title="Local Exits">Local Exits</a>
+</h3></div></div></div>
+
+ Local exits are defined using the following macros within a declarative context
+ (see the Reference section):
+ 
+<pre class="programlisting">{ // Some declarative context.
+ ...
+
+ <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code>( parenthesized-binding ) {
+ exit-body
+ } <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>
+
+ This expands to code that executes the body instructions when the enclosing
+ scope is exited (i.e., at the very end of the enclosing scope). If multiple
+ local exits are defined within the same scope, their bodies will be executed
+ in the reverse order in which they have been defined. Only bound variables
+ specified by parenthesized-binding are accessible from
+ within the local exit body. The parenthesized-biding
+ is specified following the exact same syntax as for the one used by local
+ blocks.
+ 
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ A <code class="computeroutput">return;</code>
+ instruction from within a local exit jumps to the end of the local exit
+ body and it does not return the enclosing scope.
+ </td></tr>
+</table></div>
+
+ For example, let's program a local exit similar to the one in the example
+ from the <a class="link" href="../index.html#boost_local.Introduction" title="Introduction">Introduction</a> section:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/exit.hpp>
+#include <iostream>
+#include <cassert>
+
+int main() {
+ size_t size = 2;
+ double* nums = new double[size];
+
+ BOOST_LOCAL_EXIT( (const bind)((&size)) (bind)((nums)) ) {
+ if (size && nums) delete[] nums;
+ std::clog << "Freed array: " << nums << std::endl;
+
+ return; // Return this local exit (and not the enclosing scope).
+ assert(false); // OK: Never executed.
+ } BOOST_LOCAL_EXIT_END
+
+ return 0;
+}
+</pre>
+
+ 
+
+ Local exits are very similar to the functionality already provided by Boost.ScopeExit
+ with the addition that they also support constant binding and the binding
+ of the object <code class="computeroutput">this</code>. [<a name="id872160" href="#ftn.id872160" class="footnote">13</a>]
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Tutorial.templates"></a><a class="link" href="Tutorial.html#boost_local.Tutorial.templates" title="Templates">Templates</a>
+</h3></div></div></div>
+
+ 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="id872510" href="#ftn.id872510" class="footnote">14</a>]
+ 
+<pre class="programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_TPL">BOOST_LOCAL_FUNCTION_TPL</a></code>( parenthesized-signature )
+<code class="computeroutput"><a class="link" href="../BOOST_LOCAL_BLOCK_TPL.html" title="Macro BOOST_LOCAL_BLOCK_TPL">BOOST_LOCAL_BLOCK_TPL</a></code>( parenthesized-binding )
+<code class="computeroutput"><a class="link" href="../BOOST_LOCAL_EXIT_TPL.html" title="Macro BOOST_LOCAL_EXIT_TPL">BOOST_LOCAL_EXIT_TPL</a></code>( parenthesized-binding )
+</pre>
+
+ These macros have the exact same API as their equivalents without the <code class="computeroutput">TPL</code> postfix that we have seen so far. The
+ local function, local block, and local exit ending macros (with the <code class="computeroutput">END</code> postfix) can be used unchanged within
+ templates.
+ 
+
+ For example, let's rewrite an example similar to the one from the <a class="link" href="../index.html#boost_local.Introduction" title="Introduction">Introduction</a>
+ section but wrapped within a template:
+ 
+
+
+
+<pre class="programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.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;
+
+ BOOST_LOCAL_FUNCTION_TPL( // Use `..._TPL()` macros in templates.
+ (void) (add)( (T)(num) (const bind)((factor)) (bind)((&sum)) )
+ ) {
+ sum += factor * num;
+ } BOOST_LOCAL_FUNCTION_END(add)
+ add(x);
+
+ size_t size = 2;
+ T* nums = new T[size];
+ BOOST_LOCAL_EXIT_TPL( (const bind)((&size)) (bind)((nums)) ) {
+ if (size && 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)(&factor)(&x)(&y)(&z)) ) {
+ assert(sum == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+</div>
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a id="ftn.id864335" href="#id864335" class="para">2</a>] 
+ The parenthesized syntax owes its name to the indeed large number of
+ parenthesis <code class="computeroutput">()</code> that are
+ required to wrap its elements. Programmers might notice some similarities
+ between the parenthesized syntax and the syntax of the LISP
+ programming language. However, these similarities are not intentional
+ in that they were not a design choice but rather a consequence of the
+ fact that both LISP
+ sequences and Boost.Preprocessor
+ sequences are formed by wrapping tokens within round parenthesis <code class="computeroutput">()</code>.
+ </div>
+<div class="footnote">[<a id="ftn.id864462" href="#id864462" class="para">3</a>] 
+ Rationale. This constraint comes form
+ the fact that the C++ preprocessor can only concatenate <code class="literal">##</code>
+ alphanumeric symbols.
+ </div>
+<div class="footnote">[<a id="ftn.id864498" href="#id864498" class="para">4</a>] 
+ Rationale. This constraint comes from
+ the fact that the ISO C++ standard preprocessor forbids empty macro parameters
+ (this is different for C99 and other more recent preprocessors).
+ </div>
+<div class="footnote">[<a id="ftn.id865444" href="#id865444" class="para">5</a>] 
+ While there are fundamental limitations to the amount of parenthesized
+ syntax error checking that can be done using the preprocessor (e.g.,
+ there is no way to gracefully detect and report a missing parenthesis
+ "<code class="computeroutput">)</code>"), the current
+ implementation of the parsing macros does not perform all the error checking
+ that could be done. Improving the parenthesized syntax error checking
+ is a work in progress. Programmers are encouraged to report cryptic error
+ messages they experience because of parenthesized syntax errors so to
+ help this development effort.
+ </div>
+<div class="footnote">[<a id="ftn.id865976" href="#id865976" class="para">6</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.id866010" href="#id866010" class="para">7</a>] 
+ Rationale. The local function name
+ must be passed to the ending macro <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a></code>
+ so this macro can declare a local variable with the local function
+ name to hold the local functor object. At the same time, the local
+ function name must also be passed to the declaration macro <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>
+ to allow the local function to recursively call itself. The local function
+ declaration and ending macros are kept as two separate macros so that
+ the local function body does not have to be passed as a macro parameter
+ (otherwise, the compiler error line numbers will all appear on the
+ same line and they will no longer be useful to pinpoint the errors).
+ </div>
+<div class="footnote">[<a id="ftn.id866628" href="#id866628" class="para">8</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,
+ this binding should be seen as an "extension" of the scope of
+ the bound variable from the enclosing scope to the scope of the local function
+ body. Contrary to the semantics of a function parameter passing, in-scope
+ variable binding does not depend on the variable type but just on the variable
+ name: "The variable in scope named x should be
+ accessible within the local function named l".
+ 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.id867586" href="#id867586" class="para">9</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
+ conditions while these assertions were not supposed to modify any of the
+ variables they were using (see the Contract++
+ library). This was achieved by binding by constant reference the variables
+ needed by the assertions and then by programming the local function body
+ to check the assertions (or more conveniently by using <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>). This way
+ if any of the assertions mistakenly changes a bound variable (for example
+ confusing the operator <code class="computeroutput">==</code>
+ with <code class="computeroutput">=</code>), the compiler correctly
+ 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.id869243" href="#id869243" class="para">10</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
+ parameter passing the bound object to the local function body. It would
+ be possible to use <code class="computeroutput">this</code>
+ (instead of <code class="computeroutput">this_</code>) within
+ the local function body either at the expenses of copying the bound object
+ (which would introduce run-time overhead and also the stringent requirement
+ that the bound object must have a deep copy constructor) or by relying
+ on an <a href="http://groups.google.com/group/comp.lang.c++.moderated/browse_thread/thread/d3a86f27277f713b" target="_top">undefined
+ 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.id869342" href="#id869342" class="para">11</a>] 
+ Rationale. This is because the body
+ function is implemented as static function of the local functor class.
+ </div>
+<div class="footnote">[<a id="ftn.id870864" href="#id870864" class="para">12</a>] 
+ Rationale. Programmers might expect
+ <code class="computeroutput">return;</code>
+ to exit the enclosing function instead of the local block (or local exit),
+ especially if the enclosing function has a <code class="computeroutput">void</code>
+ result type. However, using <code class="computeroutput">return;</code> to exit local blocks (and local exits)
+ seemed to follow a more natural syntax and also it is the same syntax
+ already provided by Boost.ScopeExit
+ (in fact, <code class="computeroutput">return;</code>
+ is used by Boost.ScopeExit
+ to exit the local scope and not to exit the enclosing scope). However,
+ if programmers were to find this use of <code class="computeroutput">return;</code> confusing, this library API could be
+ changed to forbid the use of <code class="computeroutput">return</code>
+ from within local blocks (and local exits) generating a compile-time
+ error, and to use a different instruction (e.g., <code class="computeroutput">break;</code> or a special macro instruction like
+ <code class="computeroutput">BOOST_LOCAL_RETURN;</code>)
+ to exit local blocks (and local exits).
+ </div>
+<div class="footnote">[<a id="ftn.id872160" href="#id872160" 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"
+ in computer programming). This would be justified by the fact that <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code> simply extends
+ the functionality already provided by <code class="computeroutput">BOOST_SCOPE_EXIT</code>.
+ The headers will be <code class="computeroutput">"boost/scope/function.hpp"</code>,
+ <code class="computeroutput">"boost/scope/block.hpp"</code>,
+ and <code class="computeroutput">"boost/scope/exit.hpp"</code>.
+ For backward compatibility with Boost.ScopeExit,
+ the header <code class="computeroutput">"boost/scope_exit.hpp"</code>
+ could also be kept and it would be equivalent to including <code class="computeroutput">"boost/scope/exit.hpp"</code>. In addition
+ and again for backward compatibility, the <code class="computeroutput">BOOST_SCOPE_EXIT</code>
+ macro could be extended to accept either the original Boost.ScopeExit
+ sequence of <code class="computeroutput">(var1)...(varN)</code> without the <code class="computeroutput">bind</code>
+ "keyword" (which would be equivalent to plain binding) or the
+ parenthesized binding sequence with the <code class="computeroutput">(bind)(...)</code>
+ and <code class="computeroutput">(const
+ bind)(...)</code>
+ "keywords" plus the binding of the object <code class="computeroutput">this</code>.
+ Local blocks would be named "scope blocks" and they would be
+ provided by the <code class="computeroutput">BOOST_SCOPE_BLOCK...</code> macros. However, local functions would
+ have to be named "scope functions" and they would be provided
+ by the <code class="computeroutput">BOOST_SCOPE_FUNCTION...</code> macros. This might not be ideal because
+ local functions are not known under the name of "scope functions"
+ (they are indeed known by the name of "local functions" or "nested functions").
+ </div>
+<div class="footnote">[<a id="ftn.id872510" href="#id872510" 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
+ allow this use of <code class="computeroutput">typename</code>
+ outside templates, the special <code class="computeroutput">TPL</code>
+ macros are used to indicate that the enclosing scope is a template so this
+ library can safety use <code class="computeroutput">typename</code>
+ to resolve expression type ambiguities.
+ </div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Starting.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Advanced.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/index.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/index.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,308 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Boost.Local 0.1.1</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="next" href="boost_local/Starting.html" title="Starting">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav"><a accesskey="n" href="boost_local/Starting.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a></div>
+<div class="preface">
+<div class="titlepage"><div>
+<div><h2 class="title">
+<a name="boost_local"></a>Boost.Local 0.1.1 </h2></div>
+<div><div class="authorgroup"><div class="author"><h3 class="author">
+Lorenzo Caminiti
+</h3></div></div></div>
+<div>Copyright © 2009 -2011 Lorenzo Caminiti</div>
+<div><div class="legalnotice">
+<a name="id807693"></a>
+ 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).
+ 
+</div></div>
+</div></div>
+<div class="toc">
+Table of Contents
+<dl>
+<dt>Introduction</dt>
+<dt>Starting</dt>
+<dt>Tutorial</dt>
+<dt>Advanced</dt>
+<dt>Reference</dt>
+<dt>Appendix: Grammar</dt>
+<dt>Appendix: Alternatives</dt>
+<dt>Appendix: Examples</dt>
+<dt>Releases</dt>
+<dt>Bibliography</dt>
+<dt>Acknowledgments</dt>
+</dl>
+</div>
+
+ The Boost Local library implements local functions, local blocks, and local exits
+ for the C++ programming language.
+ 
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Introduction"></a><a class="link" href="index.html#boost_local.Introduction" title="Introduction">Introduction</a>
+</h2></div></div></div>
+
+ Local functions are a form of information hiding
+ and are useful for dividing procedural tasks into subtasks which are only meaningful
+ locally, avoiding cluttering other parts of the program with functions, variables,
+ etc unrelated to those parts. Local functions therefore complement other structuring
+ possibilities such as namespaces and classes. Local functions are a feature
+ of many programming languages, notably Pascal
+ and Ada,
+ yet lacking from C++ (see also [N2511]).
+ 
+
+ This library supports the following features for local functions (see the
+ <a class="link" href="boost_local/Alternatives.html" title="Appendix: Alternatives">Alternatives</a> section for a
+ comparison between this library and features offered by C++ local class members,
+ <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++0x
+ lambda</a> functions, Boost.Lambda,
+ Boost.Phoenix,
+ and Boost.ScopeExit):
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Local functions can access, or better bind,
+ any of the variables from the enclosing scope. Furthermore, local functions
+ defined within a member function can bind the enclosing object <code class="computeroutput">this</code>.
+ </li>
+<li class="listitem">
+ The local function body is programmed using the usual C++ syntax.
+ </li>
+<li class="listitem">
+ Local functions can be passed as template parameters (so they can be conveniently
+ passed to STL algorithms, etc).
+ </li>
+<li class="listitem">
+ However, local functions must be defined within a declarative context (e.g.,
+ at a point in the code where local variables can be declared) thus they
+ cannot be defined within an expression.
+ </li>
+</ul></div>
+
+ In addition to local functions, this library also supports the following features:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Local blocks which define blocks of code that bind
+ variables from the enclosing scope. Local blocks allow programmers to bind
+ variables as constants (constant binding) so to prevent
+ local chunks of code from modifying selected variables.
+ </li>
+<li class="listitem">
+ Local exits which define blocks of code that are executed
+ when the enclosing scope is exited (again with support for constant binding
+ and binding of the object <code class="computeroutput">this</code>).
+ </li>
+</ul></div>
+<a name="boost_local.Introduction.an_example"></a><h6>
+<a name="id807257"></a>
+ <a class="link" href="index.html#boost_local.Introduction.an_example">An Example</a>
+ </h6>
+
+ The following example illustrates a simple use of this library and it starts
+ introducing the library API (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a>
+ section for more details on how to use this library):
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ A local function is passed to the STL <code class="computeroutput">std::for_each</code>
+ algorithm to add together the values of an array. Variables in scope are
+ bound to the local function by both constant value and non-constant reference.
+ </li>
+<li class="listitem">
+ A local exit is used to automatically release the array's memory at scope
+ exit.
+ </li>
+<li class="listitem">
+ A local block is used to assert the correct final value of the summation
+ in a constant-correct context (therefore preventing the assertion from
+ mistakenly changing any of the variables in scope).
+ </li>
+</ul></div>
+
+
+
+<pre class="programlisting"><a class="co" name="boost_local0co" href="index.html#boost_local0"><img src="../../../../doc/src/images/callouts/1.png" alt="1" border="0"></a>
+#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <algorithm>
+#include <iostream>
+#include <cassert>
+
+int main() {
+ double sum = 0.0;
+ int factor = 10;
+
+ BOOST_LOCAL_FUNCTION( <a class="co" name="boost_local1co" href="index.html#boost_local1"><img src="../../../../doc/src/images/callouts/2.png" alt="2" border="0"></a>
+ (void) (add)( (double)(num) (const bind)((factor)) <a class="co" name="boost_local2co" href="index.html#boost_local2"><img src="../../../../doc/src/images/callouts/3.png" alt="3" border="0"></a> (bind)((&sum)) <a class="co" name="boost_local3co" href="index.html#boost_local3"><img src="../../../../doc/src/images/callouts/4.png" alt="4" border="0"></a> <spa
n class="special">)
+ ) { <a class="co" name="boost_local4co" href="index.html#boost_local4"><img src="../../../../doc/src/images/callouts/5.png" alt="5" border="0"></a>
+ sum += factor * num;
+ std::clog << "Summed: " << sum << std::endl;
+ } BOOST_LOCAL_FUNCTION_END(add) <a class="co" name="boost_local5co" href="index.html#boost_local5"><img src="../../../../doc/src/images/callouts/6.png" alt="6" border="0"></a>
+ add(100.0); <a class="co" name="boost_local6co" href="index.html#boost_local6"><img src="../../../../doc/src/images/callouts/7.png" alt="7" border="0"></a>
+
+ size_t size = 2;
+ double* nums = new double[size];
+ BOOST_LOCAL_EXIT( (const bind)((&size)) (bind)((nums)) ) { <a class="co" name="boost_local7co" href="index.html#boost_local7"><img src="../../../../doc/src/images/callouts/8.png" alt="8" border="0"></a>
+ if (size && nums) delete[] nums; <a class="co" name="boost_local8co" href="index.html#boost_local8"><img src="../../../../doc/src/images/callouts/9.png" alt="9" border="0"></a>
+ std::clog << "Freed array: " << nums << std::endl;
+ } BOOST_LOCAL_EXIT_END <a class="co" name="boost_local9co" href="index.html#boost_local9"><img src="../../../../doc/src/images/callouts/10.png" alt="10" border="0"></a>
+
+ nums[0] = 90.5; nums[1] = 7.0;
+ std::for_each(nums, nums + size, add); <a class="co" name="boost_local10co" href="index.html#boost_local10"><img src="../../../../doc/src/images/callouts/11.png" alt="11" border="0"></a>
+
+ BOOST_LOCAL_BLOCK( (const bind)((&sum)) ) { <a class="co" name="boost_local11co" href="index.html#boost_local11"><img src="../../../../doc/src/images/callouts/12.png" alt="12" border="0"></a>
+ // So far: sum = 10 * 100.0 + 10 * 90.5 + 10 * 7.0 = 1975.0
+ assert(sum == 1975.0); <a class="co" name="boost_local12co" href="index.html#boost_local12"><img src="../../../../doc/src/images/callouts/13.png" alt="13" border="0"></a>
+ std::clog << "Asserted summation: " << sum << std::endl;
+ } BOOST_LOCAL_BLOCK_END <a class="co" name="boost_local13co" href="index.html#boost_local13"><img src="../../../../doc/src/images/callouts/14.png" alt="14" border="0"></a>
+
+ return 0;
+}
+</pre>
+
+ 
+<div class="calloutlist"><table border="0" summary="Callout list">
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local0"></a> </td>
+<td valign="top" align="left">
+ Include the header files for this library local functions, local blocks,
+ and local exits.
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local1"></a> </td>
+<td valign="top" align="left">
+ The local function declaration macro.
+ This macro takes one parameter specifying the local function signature
+ using the parenthesized syntax. This syntax resembles
+ the usual C++ function declaration syntax but it wraps all tokens within
+ parenthesis (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a>
+ section). The parenthesized syntax for local functions introduces the new
+ "keyword" <code class="computeroutput">bind</code>
+ which is used in place of a parameter type to indicate that the following
+ sequence of parameters bind to variables in scope.
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local2"></a> </td>
+<td valign="top" align="left">
+ The variable <code class="computeroutput">factor</code> is
+ bound by constant value so it cannot be mistakenly modified by the local
+ function body.
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local3"></a> </td>
+<td valign="top" align="left">
+ The variable <code class="computeroutput">sum</code> is instead
+ bound by non-constant reference because the local function needs to change
+ its value to report the summation result to the enclosing scope.
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local4"></a> </td>
+<td valign="top" align="left">
+ The local function body is programmed using the usual C++ syntax.
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local5"></a> </td>
+<td valign="top" align="left">
+ The macro ending the local function definition (note how the local function
+ name needs to be repeated here).
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local6"></a> </td>
+<td valign="top" align="left">
+ The local function macros declare a functor object local to the enclosing
+ scope named <code class="computeroutput">add</code>. As indicated
+ by the local function parenthesized signature, the functor <code class="computeroutput">add</code> has <code class="computeroutput">void</code>
+ result type, it can be called by specifying one parameter of type <code class="computeroutput">double</code>, and it has access to the variables
+ in scope <code class="computeroutput">factor</code> and <code class="computeroutput">sum</code>.
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local7"></a> </td>
+<td valign="top" align="left">
+ The local exit declaration macro only
+ specifies the variables in scope to bind (eventually as constants).
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local8"></a> </td>
+<td valign="top" align="left">
+ The local exit code will be automatically executed when the enclosing scope
+ is exited.
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local9"></a> </td>
+<td valign="top" align="left">
+ A local exit is anonymous so its ending macro takes no argument.
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local10"></a> </td>
+<td valign="top" align="left">
+ The local function <code class="computeroutput">add</code>
+ can also be passed as a template parameter to the STL <code class="computeroutput">std::for_each</code>
+ algorithm.
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local11"></a> </td>
+<td valign="top" align="left">
+ The local block declaration macro only
+ specifies the variables in scope to bind (eventually as constants).
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local12"></a> </td>
+<td valign="top" align="left">
+ The local block code is executed "in place" where it is programmed
+ like a usual C++ block of code <code class="computeroutput">{
+ ... }</code>.
+ In this example, the compiler will correctly generate an error if the assignment
+ operator <code class="computeroutput">=</code> is mistakenly used
+ instead of the equality operator <code class="computeroutput">==</code>
+ because the variable <code class="computeroutput">sum</code>
+ is bound by constant reference so it cannot be modified.
+ </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="boost_local13"></a> </td>
+<td valign="top" align="left">
+ A local block is anonymous so its ending macro takes no argument.
+ </td>
+</tr>
+</table></div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left">Last revised: January 11, 2011 at 14:15:21 GMT</td>
+<td align="right"><div class="copyright-footer"></div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav"><a accesskey="n" href="boost_local/Starting.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a></div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/reference.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/reference.html 2011-01-11 09:23:20 EST (Tue, 11 Jan 2011)
@@ -0,0 +1,110 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Reference</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="boost_local/Advanced.html" title="Advanced">
+<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">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="boost_local/Advanced.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="index.html"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_BLOCK.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="reference"></a>Reference</h2></div></div></div>
+<div class="toc"><dl>
+<dt>Header <boost/local/block.hpp></dt>
+<dt>Header <boost/local/config.hpp></dt>
+<dt>Header <boost/local/exit.hpp></dt>
+<dt>Header <boost/local/function.hpp></dt>
+<dt>Header <boost/local/function_ref.hpp></dt>
+<dt>Header <boost/utility/identity.hpp></dt>
+</dl></div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.local.block_hpp"></a>Header <boost/local/block.hpp></h3></div></div></div>
+Local blocks allow to program code that is executed accessing some of the variables in scope as constants. 
+<pre class="synopsis">
+
+<a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a>(parenthesized_binding)
+<a class="link" href="BOOST_LOCAL_BLOCK_TPL.html" title="Macro BOOST_LOCAL_BLOCK_TPL">BOOST_LOCAL_BLOCK_TPL</a>(parenthesized_binding)
+<a class="link" href="BOOST_LOCAL_BLOCK_END.html" title="Macro BOOST_LOCAL_BLOCK_END">BOOST_LOCAL_BLOCK_END</a></pre>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.local.config_hpp"></a>Header <boost/local/config.hpp></h3></div></div></div>
+Configuration macros allow to change the behaviour of this library at compile-time. 
+<pre class="synopsis">
+
+<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>
+<a class="link" href="BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html" title="Macro BOOST_LOCAL_CONFIG_THIS_PARAM_NAME">BOOST_LOCAL_CONFIG_THIS_PARAM_NAME</a></pre>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.local.exit_hpp"></a>Header <boost/local/exit.hpp></h3></div></div></div>
+Local exits allow to program code that is executed when the enclosing scope is exited. 
+<pre class="synopsis">
+
+<a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a>(parenthesized_binding)
+<a class="link" href="BOOST_LOCAL_EXIT_TPL.html" title="Macro BOOST_LOCAL_EXIT_TPL">BOOST_LOCAL_EXIT_TPL</a>(parenthesized_binding)
+<a class="link" href="BOOST_LOCAL_EXIT_END.html" title="Macro BOOST_LOCAL_EXIT_END">BOOST_LOCAL_EXIT_END</a></pre>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.local.function_hpp"></a>Header <boost/local/function.hpp></h3></div></div></div>
+Local functions allow to program functions locally within the scope where they are needed. 
+<pre class="synopsis">
+
+<a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a>(parenthesized_signature)
+<a class="link" href="BOOST_LOCAL_FUNCTION_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_TPL">BOOST_LOCAL_FUNCTION_TPL</a>(parenthesized_signature)
+<a class="link" href="BOOST_LOCAL_FUNCTION_END.html" title="Macro BOOST_LOCAL_FUNCTION_END">BOOST_LOCAL_FUNCTION_END</a>(local_function_name)
+<a class="link" href="BOOST_LOCAL_FUNCTION_END_RENAME.html" title="Macro BOOST_LOCAL_FUNCTION_END_RENAME">BOOST_LOCAL_FUNCTION_END_RENAME</a>(new_local_function_name)</pre>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.local.function_ref_hpp"></a>Header <boost/local/function_ref.hpp></h3></div></div></div>
+Local function references can be passed as function and template parameters, they can be assigned to variables, etc. 
+<pre class="synopsis">namespace boost {
+ namespace local {
+ template<typename F, size_t defaults = 0> struct <a class="link" href="boost/local/function_ref.html" title="Struct template function_ref">function_ref</a>;
+ }
+}</pre>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.utility.identity_hpp"></a>Header <boost/utility/identity.hpp></h3></div></div></div>
+Identity macros are used to pass expressions with commas (not already wrapped within round parenthesis) as macros parameters. 
+Note: The only way (at least as far as the authors know) to pass an arbitrary number of commas within macro parameters without explicitly indicating the number of commas is to wrap the parameter within round parenthesis that are not replaced by macro expansion and then to remove the extra parenthesis at compile-time (for type expressions) or at run-time (for value expressions). This is what these macros do. 
+<pre class="synopsis">
+
+<a class="link" href="BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a>(parenthesized_type)
+<a class="link" href="BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">BOOST_IDENTITY_VALUE</a>(parenthesized_value)</pre>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 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).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="boost_local/Advanced.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="index.html"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_BLOCK.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

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