Boost-Commit :

Date view	Thread view	Subject view	Author view

Subject: [Boost-commit] svn:boost r77906 - in trunk: boost boost/local_function/aux_/macro libs/local_function/doc libs/local_function/doc/html libs/local_function/doc/html/boost_localfunction libs/local_function/test
From: lorcaminiti_at_[hidden]
Date: 2012-04-11 01:47:40

Author: lcaminiti
Date: 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
New Revision: 77906
URL: http://svn.boost.org/trac/boost/changeset/77906

Log:
Upd docs and added ability to pass function type and default count to NAME so to not use Boost.Typeof at all.
Text files modified:
   trunk/boost/local_function.hpp | 22 +-
   trunk/boost/local_function/aux_/macro/name.hpp | 239 ++++++++++++++++++---------------------
   trunk/libs/local_function/doc/advanced_topics.qbk | 2
   trunk/libs/local_function/doc/getting_started.qbk | 14 -
   trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION.html | 2
   trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html | 2
   trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX.html | 8
   trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_ID.html | 2
   trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_NAME.html | 8
   trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_TPL.html | 2
   trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_TYPEOF.html | 8
   trunk/libs/local_function/doc/html/boost_localfunction/Advanced_Topics.html | 176 ++++++++++++-----------------
   trunk/libs/local_function/doc/html/boost_localfunction/Alternatives.html | 213 +++++++++++++----------------------
   trunk/libs/local_function/doc/html/boost_localfunction/Examples.html | 100 +++++++---------
   trunk/libs/local_function/doc/html/boost_localfunction/Getting_Started.html | 29 +---
   trunk/libs/local_function/doc/html/boost_localfunction/Implementation.html | 36 ++---
   trunk/libs/local_function/doc/html/boost_localfunction/No_Variadic_Macros.html | 20 +-
   trunk/libs/local_function/doc/html/boost_localfunction/Release_Notes.html | 6
   trunk/libs/local_function/doc/html/boost_localfunction/Tutorial.html | 31 ++--
   trunk/libs/local_function/doc/html/index.html | 39 +++---
   trunk/libs/local_function/doc/html/reference.html | 10 +
   trunk/libs/local_function/doc/introduction.qbk | 16 +-
   trunk/libs/local_function/doc/local_function.qbk | 16 +-
   trunk/libs/local_function/test/add_typed.cpp | 17 +-
   trunk/libs/local_function/test/add_typed_seq.cpp | 13 -
   25 files changed, 446 insertions(+), 585 deletions(-)

Modified: trunk/boost/local_function.hpp
==============================================================================
--- trunk/boost/local_function.hpp (original)
+++ trunk/boost/local_function.hpp 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -14,6 +14,7 @@
#include <boost/local_function/aux_/macro/name.hpp>
#include <boost/local_function/aux_/macro/typeof.hpp>
#include <boost/local_function/aux_/preprocessor/traits/decl.hpp>
+#include <boost/local_function/aux_/preprocessor/traits/name.hpp>
#include <boost/local_function/detail/preprocessor/line_counter.hpp>
#include <boost/local_function/detail/preprocessor/void_list.hpp>
#include <boost/config.hpp>
@@ -45,13 +46,12 @@
 BOOST_LOCAL_FUNCTION_DETAIL_PP_LINE_COUNTER, 1, __VA_ARGS__)
#endif // VARIADIC

-#define BOOST_LOCAL_FUNCTION_NAME(qualified_function_name) \
+#define BOOST_LOCAL_FUNCTION_NAME(name) \
 BOOST_LOCAL_FUNCTION_AUX_NAME(0, /* not within template */ \
- qualified_function_name)
-
-#define BOOST_LOCAL_FUNCTION_NAME_TPL(qualified_function_name) \
+ BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS(name))
+#define BOOST_LOCAL_FUNCTION_NAME_TPL(name) \
 BOOST_LOCAL_FUNCTION_AUX_NAME(1, /* within template */ \
- qualified_function_name)
+ BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS(name))

#define BOOST_LOCAL_FUNCTION_TYPEOF(bound_variable_name) \
 BOOST_LOCAL_FUNCTION_AUX_TYPEOF_TYPE(bound_variable_name)
@@ -246,17 +246,17 @@
 ...
 result_type BOOST_LOCAL_FUNCTION(declarations) {
 ... // Body code.
- } BOOST_LOCAL_FUNCTION_NAME(qualified_function_name)
+ } BOOST_LOCAL_FUNCTION_NAME(name)
 ...
}
@endcode

@Params
-_at_Param{qualified_function_name,
+@Param{name,
The name of the local function optionally qualified as follow:
@code
-qualified_function_name:
- [inline] [recursive] name
+name:
+ [(function_type)[(defaults)]] [inline] [recursive] function_name
@endcode
Lexical conventions: <c>token1 | token2</c> means either <c>token1</c> or
<c>token2</c>; <c>[token]</c> means either <c>token</c> or nothing;
@@ -300,12 +300,12 @@
@RefSectId{Advanced_Topics, Advanced Topics} section,
@RefMacro{BOOST_LOCAL_FUNCTION}.
*/
-#define BOOST_LOCAL_FUNCTION_NAME(qualified_function_name)
+#define BOOST_LOCAL_FUNCTION_NAME(name)

/**
In type-dependant context.
*/
-#define BOOST_LOCAL_FUNCTION_NAME_TPL(qualified_function_name)
+#define BOOST_LOCAL_FUNCTION_NAME_TPL(name)

/**
@brief This macro expands to the type of the specified bound variable.

Modified: trunk/boost/local_function/aux_/macro/name.hpp
==============================================================================
--- trunk/boost/local_function/aux_/macro/name.hpp (original)
+++ trunk/boost/local_function/aux_/macro/name.hpp 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -8,11 +8,11 @@
#ifndef BOOST_LOCAL_FUNCTION_AUX_NAME_HPP_
#define BOOST_LOCAL_FUNCTION_AUX_NAME_HPP_

+
#include <boost/local_function/config.hpp>
#include <boost/local_function/aux_/macro/decl.hpp>
#include <boost/local_function/aux_/macro/code_/functor.hpp>
-#include <boost/local_function/detail/preprocessor/keyword/recursive.hpp>
-#include <boost/local_function/detail/preprocessor/keyword/inline.hpp>
+#include <boost/local_function/aux_/preprocessor/traits/name.hpp>
#include <boost/local_function/aux_/function.hpp>
#include <boost/local_function/aux_/symbol.hpp>
#include <boost/typeof/typeof.hpp>
@@ -26,16 +26,44 @@
#define BOOST_LOCAL_FUNCTION_AUX_NAME_INIT_RECURSION_FUNC_ \
 BOOST_LOCAL_FUNCTION_AUX_SYMBOL( (init_recursion) )

-#define BOOST_LOCAL_FUNCTION_AUX_NAME_RECURSIVE_FUNC_( \
- is_recursive, local_function_name) \
- BOOST_PP_IIF(is_recursive, \
- local_function_name \
+#define BOOST_LOCAL_FUNCTION_AUX_NAME_RECURSIVE_FUNC_(name_traits) \
+ BOOST_PP_IIF(BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_IS_RECURSIVE( \
+ name_traits), \
+ BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_FUNCTION_NAME \
 , \
 BOOST_LOCAL_FUNCTION_AUX_SYMBOL( (nonrecursive_local_function_name) ) \
- )
+ BOOST_PP_TUPLE_EAT(1) \
+ )(name_traits)
+
+#define BOOST_LOCAL_FUNCTION_AUX_NAME_FUNCTOR_TYPEOF_( \
+ typename01, name_traits, local_functor_name) \
+ BOOST_PP_IIF(typename01, \
+ BOOST_TYPEOF_TPL \
+ , \
+ BOOST_TYPEOF \
+ )(local_functor_name.BOOST_LOCAL_FUNCTION_AUX_NAME_RECURSIVE_FUNC_( \
+ name_traits))
+
+#define BOOST_LOCAL_FUNCTION_AUX_NAME_FUNCTOR_TYPED_( \
+ typename01, name_traits, local_functor_name) \
+ BOOST_PP_EXPR_IIF(typename01, typename) \
+ BOOST_IDENTITY_TYPE((::boost::local_function::aux::function< \
+ BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_FUNCTION_TYPE( \
+ name_traits) \
+ , BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_DEFAULTS(name_traits) \
+ >))
+
+#define BOOST_LOCAL_FUNCTION_AUX_NAME_FUNCTOR_TYPE_( \
+ typename01, name_traits, local_functor_name) \
+ BOOST_PP_IIF(BOOST_PP_IS_EMPTY( \
+ BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_FUNCTION_TYPE( \
+ name_traits)), \
+ BOOST_LOCAL_FUNCTION_AUX_NAME_FUNCTOR_TYPEOF_ \
+ , \
+ BOOST_LOCAL_FUNCTION_AUX_NAME_FUNCTOR_TYPED_ \
+ )(typename01, name_traits, local_functor_name)

-#define BOOST_LOCAL_FUNCTION_AUX_NAME_END_LOCAL_FUNCTOR_(typename01, \
- local_function_name, is_recursive, \
+#define BOOST_LOCAL_FUNCTION_AUX_NAME_LOCAL_FUNCTOR_(typename01, name_traits, \
 local_functor_name, nonlocal_functor_name) \
 /* `PARAMS() { ... }` expandsion here -- still within functor class */ \
 /* class functor ## __LINE__ { ... */ \
@@ -50,34 +78,30 @@
 /* because this cannot be a mem ref because its name is not known */ \
 /* by the constructor so it cannot be set by the mem init list */ \
 BOOST_LOCAL_FUNCTION_AUX_CODE_FUNCTOR_TYPE \
- BOOST_LOCAL_FUNCTION_AUX_NAME_RECURSIVE_FUNC_(is_recursive, \
- local_function_name); \
- BOOST_PP_EXPR_IIF(is_recursive, \
+ BOOST_LOCAL_FUNCTION_AUX_NAME_RECURSIVE_FUNC_(name_traits); \
+ BOOST_PP_EXPR_IIF(BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_IS_RECURSIVE(\
+ name_traits), \
 /* run-time: the `init_recursion()` function cannot be called */ \
 /* by the constructor to allow for compiler optimization */ \
 /* (inlining) so it must be public */ \
 inline void BOOST_LOCAL_FUNCTION_AUX_NAME_INIT_RECURSION_FUNC_( \
 BOOST_LOCAL_FUNCTION_AUX_CODE_FUNCTOR_TYPE& functor) { \
- local_function_name = functor; \
+ BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_FUNCTION_NAME( \
+ name_traits) = functor; \
 } \
 ) \
 /* local functor can be passed as tparam only on C++11 (faster) */ \
 } local_functor_name(BOOST_LOCAL_FUNCTION_AUX_DECL_ARGS_VAR.value); \
 /* non-local functor can always be passed as tparam (but slower) */ \
- BOOST_PP_IIF(typename01, \
- BOOST_TYPEOF_TPL \
- , \
- BOOST_TYPEOF \
- )(local_functor_name.BOOST_LOCAL_FUNCTION_AUX_NAME_RECURSIVE_FUNC_( \
- is_recursive, local_function_name)) \
- nonlocal_functor_name /* functor variable */ \
- ; \
+ BOOST_LOCAL_FUNCTION_AUX_NAME_FUNCTOR_TYPE_(typename01, name_traits, \
+ local_functor_name) nonlocal_functor_name; /* functor variable */ \
 /* the order of the following 2 function calls cannot be changed */ \
 /* because init_recursion uses the local_functor so the local_functor */ \
 /* must be init first */ \
 local_functor_name.BOOST_LOCAL_FUNCTION_AUX_FUNCTION_INIT_CALL_FUNC( \
 &local_functor_name, nonlocal_functor_name); \
- BOOST_PP_EXPR_IIF(is_recursive, \
+ BOOST_PP_EXPR_IIF(BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_IS_RECURSIVE( \
+ name_traits), \
 /* init recursion causes MSVC to not optimize local function not */ \
 /* even when local functor is used as template parameter so no */ \
 /* recursion unless all inlining optimizations are specified off */ \
@@ -88,116 +112,71 @@
#define BOOST_LOCAL_FUNCTION_AUX_NAME_FUNCTOR_(local_function_name) \
 BOOST_LOCAL_FUNCTION_AUX_SYMBOL( (local_function_name) )

-// This can always be passed as a template parameters (on all compilers).
-// However, it is slower because it cannot be inlined.
-// Passed at tparam: Yes (on all C++). Inlineable: No. Recursive: No.
-#define BOOST_LOCAL_FUNCTION_AUX_NAME_(typename01, local_function_name) \
- BOOST_LOCAL_FUNCTION_AUX_NAME_END_LOCAL_FUNCTOR_(typename01, \
- local_function_name, \
- /* local function is not recursive (because recursion and its */ \
- /* initialization cannot be inlined even on C++11, */ \
- /* so this allows optimization at least on C++11) */ \
- 0 /* not recursive */ , \
- /* local functor */ \
- BOOST_LOCAL_FUNCTION_AUX_NAME_FUNCTOR_(local_function_name), \
- /* local function declared as non-local functor -- but it can */ \
- /* be inlined only by C++11 and it cannot be recursive */ \
- local_function_name)
-
-// This is faster on some compilers but not all (e.g., it is faster on GCC
-// because its optimization inlines it but not on MSVC). However, it cannot be
-// passed as a template parameter on non C++11 compilers.
-// Passed at tparam: Only on C++11. Inlineable: Yes. Recursive: No.
-#define BOOST_LOCAL_FUNCTION_AUX_NAME_INLINE_(typename01, local_function_name) \
- BOOST_LOCAL_FUNCTION_AUX_NAME_END_LOCAL_FUNCTOR_(typename01, \
- local_function_name, \
- /* inlined local function is never recursive (because recursion */ \
- /* and its initialization cannot be inlined)*/ \
- 0 /* not recursive */ , \
- /* inlined local function declared as local functor (maybe */ \
- /* inlined even by non C++11 -- but it can be passed as */ \
- /* template parameter only on C++11 */ \
- local_function_name, \
- /* non-local functor */ \
- BOOST_LOCAL_FUNCTION_AUX_NAME_FUNCTOR_(local_function_name))
-
-// This is slower on all compilers (C++11 and non) because recursion and its
-// initialization can never be inlined.
-// Passed at tparam: Yes. Inlineable: No. Recursive: Yes.
-#define BOOST_LOCAL_FUNCTION_AUX_NAME_RECURSIVE_( \
- typename01, local_function_name) \
- BOOST_LOCAL_FUNCTION_AUX_NAME_END_LOCAL_FUNCTOR_(typename01, \
- local_function_name, \
- /* recursive local function -- but it cannot be inlined */ \
- 1 /* recursive */ , \
- /* local functor */ \
- BOOST_LOCAL_FUNCTION_AUX_NAME_FUNCTOR_(local_function_name), \
- /* local function declared as non-local functor -- but it can */ \
- /* be inlined only by C++11 */ \
- local_function_name)
-
-// Inlined local functions are specified by `..._NAME(inline name)`.
-// They have more chances to be inlined for faster run-times by some compilers
-// (for example by GCC but not by MSVC). C++11 compilers can always inline
-// local functions even if they are not explicitly specified inline.
-#define BOOST_LOCAL_FUNCTION_AUX_NAME_PARSE_INLINE_( \
- typename01, qualified_name) \
- BOOST_PP_IIF(BOOST_PP_BITOR( \
- BOOST_LOCAL_FUNCTION_CONFIG_LOCALS_AS_TPARAMS, \
- BOOST_LOCAL_FUNCTION_DETAIL_PP_KEYWORD_IS_INLINE_FRONT( \
- qualified_name)), \
- /* on C++11 always use inlining because compilers might optimize */ \
- /* it to be faster and it can also be passed as tparam */ \
- BOOST_LOCAL_FUNCTION_AUX_NAME_INLINE_ \
- , \
- /* on non C++11 don't use liniling unless explicitly specified by */ \
- /* programmers `inline name` the inlined local function cannot be */ \
- /* passed as tparam */ \
- BOOST_LOCAL_FUNCTION_AUX_NAME_ \
- )(typename01, BOOST_LOCAL_FUNCTION_DETAIL_PP_KEYWORD_INLINE_REMOVE_FRONT( \
- qualified_name))
-
-// Expand to 1 iff `recursive name` or `recursive inline name` or
-// `inline recursive name`.
-#define BOOST_LOCAL_FUNCTION_AUX_NAME_IS_RECURSIVE_(qualified_name) \
- BOOST_LOCAL_FUNCTION_DETAIL_PP_KEYWORD_IS_RECURSIVE_FRONT( \
- BOOST_LOCAL_FUNCTION_DETAIL_PP_KEYWORD_INLINE_REMOVE_FRONT( \
- qualified_name \
- ))
-
-// Revmoes `recursive`, `inline recursive`, and `recursive inline` from front.
-#define BOOST_LOCAL_FUNCTION_AUX_NAME_REMOVE_RECURSIVE_AND_INLINE_( \
- qualified_name) \
- BOOST_LOCAL_FUNCTION_DETAIL_PP_KEYWORD_RECURSIVE_REMOVE_FRONT( \
- BOOST_LOCAL_FUNCTION_DETAIL_PP_KEYWORD_INLINE_REMOVE_FRONT( \
- BOOST_LOCAL_FUNCTION_DETAIL_PP_KEYWORD_RECURSIVE_REMOVE_FRONT( \
- qualified_name \
- )))
-
-#define BOOST_LOCAL_FUNCTION_AUX_NAME_RECURSIVE_REMOVE_(qualified_name) \
- BOOST_PP_IIF(BOOST_LOCAL_FUNCTION_AUX_NAME_IS_RECURSIVE_(qualified_name), \
- BOOST_LOCAL_FUNCTION_AUX_NAME_REMOVE_RECURSIVE_AND_INLINE_ \
- , \
- qualified_name /* might be `name` or `inline name` */ \
- BOOST_PP_TUPLE_EAT(1) \
- )(qualified_name)
-
-// Recursive local function are specified by `..._NAME(recursive name)`.
-// They can never be inlined for faster run-time (not even by C++11 compilers).
-#define BOOST_LOCAL_FUNCTION_AUX_NAME_PARSE_RECURSIVE_( \
- typename01, qualified_name) \
- BOOST_PP_IIF(BOOST_LOCAL_FUNCTION_AUX_NAME_IS_RECURSIVE_(qualified_name), \
- /* recursion can never be inlined (not even on C++11) */ \
- BOOST_LOCAL_FUNCTION_AUX_NAME_RECURSIVE_ \
- , \
- BOOST_LOCAL_FUNCTION_AUX_NAME_PARSE_INLINE_ \
- )(typename01, \
- BOOST_LOCAL_FUNCTION_AUX_NAME_RECURSIVE_REMOVE_(qualified_name))
-
// PUBLIC //

-#define BOOST_LOCAL_FUNCTION_AUX_NAME(typename01, qualified_name) \
- BOOST_LOCAL_FUNCTION_AUX_NAME_PARSE_RECURSIVE_(typename01, qualified_name)
+// If !INLINE(name_traits) && !RECURSIVE(name_traits):
+// This can always be passed as a template parameters (on all compilers).
+// However, it is slower because it cannot be inlined.
+// If !INLINE(name_traits) && RECURSIVE(name_traits):
+// This is slower on all compilers (C++11 and non) because recursion and
+// its initialization can never be inlined.
+// If INLINE(name_traits) && !RECURSIVE(name_traits):
+// This is faster on some compilers but not all (e.g., it is faster on GCC
+// because its optimization inlines it but not on MSVC). However, it
+// cannot be passed as a template parameter on non C++11 compilers.
+// If INLINE(name_traits) && RECURSIVE(name_traits):
+// Same as RECURSIVE && !INLINE.
+#define BOOST_LOCAL_FUNCTION_AUX_NAME(typename01, name_traits) \
+ BOOST_PP_EXPAND( \
+ BOOST_LOCAL_FUNCTION_AUX_NAME_LOCAL_FUNCTOR_ \
+ BOOST_PP_IIF( /* !RECURSIVE && (C++11 || INLINE) => FASTER */ \
+ BOOST_PP_BITAND( \
+ BOOST_PP_COMPL( \
+ BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_IS_RECURSIVE( \
+ name_traits)) \
+ , BOOST_PP_BITOR( \
+ /* on C++11 always use inlining because compilers */ \
+ /* might optimize it to be faster and it can also */ \
+ /* be passed as template parameter */ \
+ BOOST_LOCAL_FUNCTION_CONFIG_LOCALS_AS_TPARAMS \
+ , BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_IS_INLINE( \
+ name_traits) \
+ ) \
+ ), \
+ /* inlined local function declared as local functor: it maybe */ \
+ /* always be inlined (faster) but it can be passed as template */ \
+ /* parameter only by C++11 -- never recursive */ \
+ ( \
+ typename01 \
+ , \
+ name_traits \
+ , \
+ BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_FUNCTION_NAME( \
+ name_traits) \
+ , \
+ BOOST_LOCAL_FUNCTION_AUX_NAME_FUNCTOR_( \
+ BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_FUNCTION_NAME( \
+ name_traits)) \
+ ) \
+ , /* RECURSIVE || (!C++11 && !INLINE) => SLOWER */ \
+ /* local function declared as non-local functor: it can always */ \
+ /* be passed as template parameter but slower even on C++11 if */ \
+ /* declared recursive -- it can be inlined (faster) only by */ \
+ /* C++11 and if not recursive */ \
+ ( \
+ typename01 \
+ , \
+ name_traits \
+ , \
+ BOOST_LOCAL_FUNCTION_AUX_NAME_FUNCTOR_( \
+ BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_FUNCTION_NAME( \
+ name_traits)) \
+ , \
+ BOOST_LOCAL_FUNCTION_AUX_PP_NAME_TRAITS_FUNCTION_NAME( \
+ name_traits) \
+ ) \
+ ) \
+ )

#endif // #include guard

Modified: trunk/libs/local_function/doc/advanced_topics.qbk
==============================================================================
--- trunk/libs/local_function/doc/advanced_topics.qbk (original)
+++ trunk/libs/local_function/doc/advanced_topics.qbk 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -147,7 +147,7 @@

[endsect]

-[section Assigning and Returning]
+[section Assignments and Returns]

Local functions are function objects so it is possible to assign them to other functors like __Boost_Function__ `boost::function` in order to store the local function into a variable, pass it as a parameter to another function, or return it from the enclosing function.

Modified: trunk/libs/local_function/doc/getting_started.qbk
==============================================================================
--- trunk/libs/local_function/doc/getting_started.qbk (original)
+++ trunk/libs/local_function/doc/getting_started.qbk 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -18,10 +18,11 @@
Some footnotes are marked by the word "*Rationale*".
They explain reasons behind decisions made during the design and implementation of this library.

-In some of the examples presented in this documentation, the __Boost_Test__ macro `BOOST_CHECK` is used equivalently to `assert` and the __Boost_Test__ macro `BOOST_AUTO_TEST_CASE` is used equivalently to `main`.
+In most of the examples presented in this documentation, the Boost.Detail/LightweightTest (=boost/detail/lightweight_test.hpp=) macro `BOOST_TEST` is used to check correctness conditions (conceptually similar to `assert`).
+A failure of the checked condition does not abort the execution of the program, it will instead make `boost::report_errors` return a non-zero program exit code.
[footnote
*Rationale.*
-Using __Boost_Test__ allows to add the documentation examples to the library regression tests so to make sure that the listed examples always compile and run correctly.
+Using Boost.Detail/LightweightTest allows to add the examples to the library regression tests so to make sure that they always compile and run correctly.
]

[endsect]
@@ -29,11 +30,11 @@
[section Compilers and Platforms]

The implementation of this library uses preprocessor and template meta-programming (as supported by __Boost_Preprocessor__ and __Boost_MPL__), templates with partial specializations and function pointers (similarly to __Boost_Function__).
-As a consequence, this library is fairly demanding on compilers' compliance with the __CPP03__ standard.
+As a consequence, this library is fairly demanding on compilers' compliance with the __CXX03__ standard.
The authors originally developed and tested the library on:

# GNU Compiler Collection (GCC) C++ 4.5.1 on Ubuntu Linux 10.
-# GCC 4.3.4 and 4.5.3 (with and without __CPP11__ features enabled `-std=c++0x`) on Cygwin.
+# GCC 4.3.4 and 4.5.3 (with and without __CXX11__ features enabled `-std=c++0x`) on Cygwin.
# Miscrosoft Visual C++ (MSVC) 8.0 on Windows XP and Windows 7.

See the library [@http://www.boost.org/development/tests/release/developer/local_function.html regressions test results] for detailed information on supported compilers and platforms.
@@ -62,13 +63,8 @@
* Any symbol prefixed by `boost_local_function_aux_...` or `boost_local_function_detail_...` (regardless of its namespace).
* Any symbol prefixed by `BOOST_LOCAL_FUNCTION_AUX_...` or `BOOST_LOCAL_FUNCTION_DETAIL_...` (regardless of its namespace).

-[endsect]
-
-[section Configuration]
-
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 are defined in the header file [headerref boost/local_function/config.hpp].
It is strongly recommended not to change the library configuration macro definitions unless strictly necessary.

Modified: trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION.html
==============================================================================
--- trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION.html (original)
+++ trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -33,7 +33,7 @@

BOOST_LOCAL_FUNCTION(declarations)</pre></div>
<div class="refsect1">
-<a name="id869098"></a><h2>Description</h2>
+<a name="id903202"></a><h2>Description</h2>
This macro must be used within a declarative context, it must follow the local function result type, it must be followed by the local function body code, and then by the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code> macro (see the <a class="link" href="boost_localfunction/Tutorial.html" title="Tutorial">Tutorial</a> and <a class="link" href="boost_localfunction/Advanced_Topics.html" title="Advanced Topics"> Advanced Topics</a> sections): 
<pre class="programlisting">{ // Some declarative context.
...

Modified: trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html
==============================================================================
--- trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html (original)
+++ trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -33,7 +33,7 @@

BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX</pre></div>
<div class="refsect1">
-<a name="id870681"></a><h2>Description</h2>
+<a name="id904846"></a><h2>Description</h2>
If programmers leave this configuration macro undefined, its default value is <code class="computeroutput">5</code> (increasing this number might increase compilation time). When defined by programmers, this macro must be a non-negative integer number.
Note: This macro specifies the maximum number of local function parameters excluding bound variables (which are instead specified by <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX">BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX</a></code>).
See: <a class="link" href="boost_localfunction/Tutorial.html" title="Tutorial">Tutorial</a> section, <a class="link" href="boost_localfunction/Getting_Started.html" title="Getting Started"> Getting Started</a> section, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX">BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX</a></code>.

Modified: trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX.html
==============================================================================
--- trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX.html (original)
+++ trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -7,7 +7,7 @@
<link rel="home" href="index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
<link rel="up" href="reference.html#header.boost.local_function.config_hpp" title="Header <boost/local_function/config.hpp>">
<link rel="prev" href="BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX">
-<link rel="next" href="boost_localfunction/Alternatives.html" title="Annex: Alternatives">
+<link rel="next" href="BOOST_LOCAL_FUNCTION_CONFIG_LOCALS_AS_TPARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_LOCALS_AS_TPARAMS">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local_function.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_localfunction/Alternatives.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local_function.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_FUNCTION_CONFIG_LOCALS_AS_TPARAMS.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
</div>
<div class="refentry">
<a name="BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX"></a><div class="titlepage"></div>
@@ -33,7 +33,7 @@

BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX</pre></div>
<div class="refsect1">
-<a name="id870755"></a><h2>Description</h2>
+<a name="id904921"></a><h2>Description</h2>
If programmers leave this configuration macro undefined, its default value is <code class="computeroutput">10</code> (increasing this number might increase compilation time). When defined by programmers, this macro must be a non-negative integer number.
Note: This macro specifies the maximum number of bound variables excluding local function parameters (which are instead specified by <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX">BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX</a></code>).
See: <a class="link" href="boost_localfunction/Tutorial.html" title="Tutorial">Tutorial</a> section, <a class="link" href="boost_localfunction/Getting_Started.html" title="Getting Started"> Getting Started</a> section, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX">BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX</a></code>. 
@@ -50,7 +50,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local_function.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_localfunction/Alternatives.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local_function.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_FUNCTION_CONFIG_LOCALS_AS_TPARAMS.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_ID.html
==============================================================================
--- trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_ID.html (original)
+++ trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_ID.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -33,7 +33,7 @@

BOOST_LOCAL_FUNCTION_ID(id, within_template, declarations)</pre></div>
<div class="refsect1">
-<a name="id869962"></a><h2>Description</h2>
+<a name="id904090"></a><h2>Description</h2>
This macro is equivalent to <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code> but it can be expanded multiple times on the same line if different identifiers <code class="computeroutput">id</code> are provided for each expansion (see <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code> for more detail).
Parameters: 
<div class="informaltable"><table class="table">

Modified: trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_NAME.html
==============================================================================
--- trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_NAME.html (original)
+++ trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_NAME.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -7,7 +7,7 @@
<link rel="home" href="index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
<link rel="up" href="reference.html#header.boost.local_function_hpp" title="Header <boost/local_function.hpp>">
<link rel="prev" href="BOOST_LOCAL_FUNCTION_ID.html" title="Macro BOOST_LOCAL_FUNCTION_ID">
-<link rel="next" href="BOOST_LOCAL_FUNCTION_TYPEOF.html" title="Macro BOOST_LOCAL_FUNCTION_TYPEOF">
+<link rel="next" href="BOOST_LOCAL_FUNCTION_NAME_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_NAME_TPL">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="BOOST_LOCAL_FUNCTION_ID.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_TYPEOF.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION_ID.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_NAME_TPL.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
</div>
<div class="refentry">
<a name="BOOST_LOCAL_FUNCTION_NAME"></a><div class="titlepage"></div>
@@ -33,7 +33,7 @@

BOOST_LOCAL_FUNCTION_NAME(qualified_function_name)</pre></div>
<div class="refsect1">
-<a name="id870159"></a><h2>Description</h2>
+<a name="id904287"></a><h2>Description</h2>
This macro must follow the local function body code block <code class="computeroutput">{ ... }</code>: 
<pre class="programlisting">{ // Some declarative context.
...
@@ -75,7 +75,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="BOOST_LOCAL_FUNCTION_ID.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_TYPEOF.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION_ID.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_NAME_TPL.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_TPL.html
==============================================================================
--- trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_TPL.html (original)
+++ trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_TPL.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -33,7 +33,7 @@

BOOST_LOCAL_FUNCTION_TPL(declarations)</pre></div>
<div class="refsect1">
-<a name="id869783"></a><h2>Description</h2>
+<a name="id903912"></a><h2>Description</h2>
This macro 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> when declaring a local function within a template. A part from that, this macro has the exact same syntax as <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code> (see <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code> for more information): 
<pre class="programlisting">{ // Some declarative context with a template.
...

Modified: trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_TYPEOF.html
==============================================================================
--- trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_TYPEOF.html (original)
+++ trunk/libs/local_function/doc/html/BOOST_LOCAL_FUNCTION_TYPEOF.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
<link rel="up" href="reference.html#header.boost.local_function_hpp" title="Header <boost/local_function.hpp>">
-<link rel="prev" href="BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">
+<link rel="prev" href="BOOST_LOCAL_FUNCTION_NAME_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_NAME_TPL">
<link rel="next" href="BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="BOOST_LOCAL_FUNCTION_NAME.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_CONFIG_ARITY_MAX.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION_NAME_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_CONFIG_ARITY_MAX.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
</div>
<div class="refentry">
<a name="BOOST_LOCAL_FUNCTION_TYPEOF"></a><div class="titlepage"></div>
@@ -33,7 +33,7 @@

BOOST_LOCAL_FUNCTION_TYPEOF(bound_variable_name)</pre></div>
<div class="refsect1">
-<a name="id870468"></a><h2>Description</h2>
+<a name="id904629"></a><h2>Description</h2>
This macro can be used within the local functions body to refer to the bound variable types so to declare local variables, check concepts (using Boost.ConceptCheck), etc (see the <a class="link" href="boost_localfunction/Advanced_Topics.html" title="Advanced Topics"> Advanced Topics</a> section). This way the local function can be programmed entirely without explicitly specifying the bound variable types thus facilitating maintenance (e.g., if the type of a bound variable changes in the enclosing scope, the local function code does not have to change).
Parameters: 
<div class="informaltable"><table class="table">
@@ -72,7 +72,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="BOOST_LOCAL_FUNCTION_NAME.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_CONFIG_ARITY_MAX.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION_NAME_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_CONFIG_ARITY_MAX.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: trunk/libs/local_function/doc/html/boost_localfunction/Advanced_Topics.html
==============================================================================
--- trunk/libs/local_function/doc/html/boost_localfunction/Advanced_Topics.html (original)
+++ trunk/libs/local_function/doc/html/boost_localfunction/Advanced_Topics.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -31,8 +31,8 @@
 Parameters</a></dt>
<dt><a href="Advanced_Topics.html#boost_localfunction.Advanced_Topics.commas_and_symbols_in_macros">Commas
 and Symbols in Macros</a></dt>
-<dt><a href="Advanced_Topics.html#boost_localfunction.Advanced_Topics.assigning_and_returning">Assigning
- and Returning</a></dt>
+<dt><a href="Advanced_Topics.html#boost_localfunction.Advanced_Topics.assignments_and_returns">Assignments
+ and Returns</a></dt>
<dt>Nesting</dt>
<dt><a href="Advanced_Topics.html#boost_localfunction.Advanced_Topics.accessing_types__concepts__etc_">Accessing
 Types (concepts, etc)</a></dt>
@@ -77,11 +77,11 @@
 


-<pre class="programlisting">int BOOST_LOCAL_FUNCTION(int x, int y, default 2) { // Default.
+<pre class="programlisting">int BOOST_LOCAL_FUNCTION(int x, int y, default 2) { // Default parameter.
 return x + y;
} BOOST_LOCAL_FUNCTION_NAME(add)

-BOOST_CHECK(add(1) == 3);
+BOOST_TEST(add(1) == 3);
</pre>

 
@@ -103,7 +103,7 @@
 return x + y;
} BOOST_LOCAL_FUNCTION_NAME(add)

-BOOST_CHECK(add(1) == 3);
+BOOST_TEST(add(1) == 3);
</pre>

 
@@ -287,10 +287,10 @@

 
</div>
-<div class="section boost_localfunction_Advanced_Topics_assigning_and_returning">
+<div class="section boost_localfunction_Advanced_Topics_assignments_and_returns">
<div class="titlepage"><div><div><h3 class="title">
-<a name="boost_localfunction.Advanced_Topics.assigning_and_returning"></a><a class="link" href="Advanced_Topics.html#boost_localfunction.Advanced_Topics.assigning_and_returning" title="Assigning and Returning">Assigning
- and Returning</a>
+<a name="boost_localfunction.Advanced_Topics.assignments_and_returns"></a><a class="link" href="Advanced_Topics.html#boost_localfunction.Advanced_Topics.assignments_and_returns" title="Assignments and Returns">Assignments
+ and Returns</a>
</h3></div></div></div>

 Local functions are function objects so it is possible to assign them to
@@ -304,8 +304,8 @@
 


-<pre class="programlisting">void call1(boost::function<int (int) > f) { BOOST_CHECK(f(1) == 5); }
-void call0(boost::function<int (void)> f) { BOOST_CHECK(f() == 5); }
+<pre class="programlisting">void call1(boost::function<int (int) > f) { BOOST_TEST(f(1) == 5); }
+void call0(boost::function<int (void)> f) { BOOST_TEST(f() == 5); }

boost::function<int (int, int)> linear(const int& slope) {
 int BOOST_LOCAL_FUNCTION(const bind& slope,
@@ -314,7 +314,7 @@
 } BOOST_LOCAL_FUNCTION_NAME(lin)

 boost::function<int (int, int)> f = lin; // Assign to local variable.
- BOOST_CHECK(f(1, 2) == 5);
+ BOOST_TEST(f(1, 2) == 5);

 call1(lin); // Pass to other functions.
 call0(lin);
@@ -324,7 +324,7 @@

void call(void) {
 boost::function<int (int, int)> f = linear(2);
- BOOST_CHECK(f(1, 2) == 5);
+ BOOST_TEST(f(1, 2) == 5);
}
</pre>

@@ -338,15 +338,14 @@
<th align="left">Warning</th>
</tr>
<tr><td align="left" valign="top">
- As with <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions, programmers are responsible to ensure that bound
- variables are valid in any scope where the local function object is called.
- Returning and calling a local function outside its declaration scope will
- lead to undefined behaviour if any of the bound variable is no longer valid
- in the scope where the local function is called (see the __Example__ section
- for more examples on the extra care needed when returning a local function
- closure). It is always safe instead to call a local function within its
- declaration scope.
+ As with __CPP11_lambda__ functions, programmers are responsible to ensure
+ that bound variables are valid in any scope where the local function object
+ is called. Returning and calling a local function outside its declaration
+ scope will lead to undefined behaviour if any of the bound variable is
+ no longer valid in the scope where the local function is called (see the
+ __Example__ section for more examples on the extra care needed when returning
+ a local function closure). It is always safe instead to call a local function
+ within its declaration scope.
 </td></tr>
</table></div>

@@ -363,7 +362,7 @@
std::vector<int> w;

for(int i = 1; i <= 2; ++i) v.push_back(i * 10);
-BOOST_CHECK(v[0] == 10); BOOST_CHECK(v[1] == 20);
+BOOST_TEST(v[0] == 10); BOOST_TEST(v[1] == 20);
w.resize(v.size());

int BOOST_LOCAL_FUNCTION(const bind& offset, int i) {
@@ -371,7 +370,7 @@
} BOOST_LOCAL_FUNCTION_NAME(inc)

std::transform(v.begin(), v.end(), w.begin(), inc);
-BOOST_CHECK(w[0] == 16); BOOST_CHECK(w[1] == 26);
+BOOST_TEST(w[0] == 16); BOOST_TEST(w[1] == 26);

int BOOST_LOCAL_FUNCTION(bind& inc, int i, int j) {
 return inc(i + j); // Call the other bound local function.
@@ -379,7 +378,7 @@

offset = 0;
std::transform(v.begin(), v.end(), w.begin(), v.begin(), inc_sum);
-BOOST_CHECK(v[0] == 27); BOOST_CHECK(v[1] == 47);
+BOOST_TEST(v[0] == 27); BOOST_TEST(v[1] == 47);
</pre>

 
@@ -477,7 +476,7 @@
 BOOST_CONCEPT_ASSERT((Addable<typename boost::remove_reference<
 BOOST_LOCAL_FUNCTION_TYPEOF(sum)>::type>));
 sum += factor * num;
- } BOOST_LOCAL_FUNCTION_NAME(add)
+ } BOOST_LOCAL_FUNCTION_NAME_TPL(add)

 add(6);
 return sum;
@@ -564,15 +563,18 @@
 


-<pre class="programlisting">struct adder {
+<pre class="programlisting">struct adder;
+BOOST_TYPEOF_REGISTER_TYPE(adder) // Unfortunately needed for `..._NAME` below.
+
+struct adder {
 adder() : sum_(0) {}

 int sum(const std::vector<int>& nums, const int& factor = 10) {
- // Explicitly specify bound variable and result types.
+ // Explicitly specify bound variable and result types...
 BOOST_LOCAL_FUNCTION(const bind(const int&) factor,
 bind(adder*) this_, int num, return int) {
 return this_->sum_ += factor * num;
- } BOOST_LOCAL_FUNCTION_NAME(add)
+ } BOOST_LOCAL_FUNCTION_NAME(add) // ... but this still uses type-of.

 std::for_each(nums.begin(), nums.end(), add);
 return sum_;
@@ -622,23 +624,20 @@
 
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- On C++03
- compliant compilers, inlined local functions always have a run-time comparable
- to their equivalent implementation that uses local functors (see the
- <a class="link" href="Alternatives.html" title="Annex: Alternatives">Alternatives</a>
+ On __CPP03__ compliant compilers, inlined local functions always have
+ a run-time comparable to their equivalent implementation that uses local
+ functors (see the <a class="link" href="Alternatives.html" title="Annex: Alternatives">Alternatives</a>
 section). However, inlined local functions have the important limitation
 that they cannot be assigned to other functors (like <code class="computeroutput">boost::function</code>)
 and they cannot be passed as template parameters.
 </li>
<li class="listitem">
- On C++11
- compilers, <code class="computeroutput">inline</code> has no
- effect because this library will automatically generate code that uses
- C++11 specific
- features to inline the local function calls whenever possible even if
- the local function is not declared inline. Furthermore, non C++11
- local functions can always be passes as template parameters even when
- they are declared inline. [<a name="boost_localfunction.Advanced_Topics.inlining.f0" href="#ftn.boost_localfunction.Advanced_Topics.inlining.f0" class="footnote">23</a>]
+ On __CPP11__ compilers, <code class="computeroutput">inline</code>
+ has no effect because this library will automatically generate code that
+ uses __CPP11__ specific features to inline the local function calls whenever
+ possible even if the local function is not declared inline. Furthermore,
+ non __CPP11__ local functions can always be passes as template parameters
+ even when they are declared inline. [<a name="boost_localfunction.Advanced_Topics.inlining.f0" href="#ftn.boost_localfunction.Advanced_Topics.inlining.f0" class="footnote">23</a>]
 </li>
</ul></div>
<div class="important"><table border="0" summary="Important">
@@ -648,9 +647,8 @@
</tr>
<tr><td align="left" valign="top">
 It is recommended to not declare a local function inline unless it is strictly
- necessary for optimizing pure C++03
- compliant code (because in all other cases this library will automatically
- take advantage of C++11
+ necessary for optimizing pure __CPP03__ compliant code (because in all
+ other cases this library will automatically take advantage of __CPP11__
 features to optimize the local function calls while always allowing to
 pass the local function as a template parameter).
 </td></tr>
@@ -735,11 +733,11 @@
 Recursive local functions should never be called outside their declaration
 scope. If a local function is returned from the enclosing function and
 called in a different scope, the behaviour is undefined (and it will likely
- result in a run-time error). [<a name="boost_localfunction.Advanced_Topics.recursion.f0" href="#ftn.boost_localfunction.Advanced_Topics.recursion.f0" class="footnote">24</a>] This is not a limitation with respect to <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions because lambdas can never call themselves recursively
- (in other words, there is no recursive lambda function that can successfully
- be called outside its declaration scope because there is no recursive lambda
- function at all).
+ result in a run-time error). [<a name="boost_localfunction.Advanced_Topics.recursion.f0" href="#ftn.boost_localfunction.Advanced_Topics.recursion.f0" class="footnote">24</a>] This is not a limitation with respect to __CPP11_lambda__ functions
+ because lambdas can never call themselves recursively (in other words,
+ there is no recursive lambda function that can successfully be called outside
+ its declaration scope because there is no recursive lambda function at
+ all).
 </td></tr>
</table></div>
</div>
@@ -761,35 +759,7 @@
 (see also overload.cpp):
 

-
-<pre class="programlisting">int add_i(int x, int y) { return x + y; }
-
-BOOST_AUTO_TEST_CASE(test_overload) {
- std::string s = "abc";
- std::string BOOST_LOCAL_FUNCTION(
- const bind& s, const std::string& x) {
- return s + x;
- } BOOST_LOCAL_FUNCTION_NAME(add_s)
-
- double d = 1.23;
- double BOOST_LOCAL_FUNCTION(const bind d, double x, double y, default 0) {
- return d + x + y;
- } BOOST_LOCAL_FUNCTION_NAME(add_d)
-
- boost::overloaded_function<
- std::string (const std::string&)
- , double (double)
- , double (double, double) // Overload giving default param.
- , int (int, int)
- > add(add_s, add_d, add_d, add_i); // Overloaded function object.
-
- BOOST_CHECK(add("xyz") == "abcxyz"); // Call `add_s`.
- BOOST_CHECK(fabs(add(3.21) - 4.44) < 0.001); // Call `add_d` (no default).
- BOOST_CHECK(fabs(add(3.21, 40.0) - 44.44) < 0.001); // Call `add_d`.
- BOOST_CHECK(add(1, 2) == 3); // Call `add_i`.
-}
-</pre>
-
+ [overload]
 
</div>
<div class="section boost_localfunction_Advanced_Topics_exception_specifications">
@@ -841,7 +811,7 @@
 Classifiers (<code class="computeroutput">auto</code> and <code class="computeroutput">register</code>)</a>
</h3></div></div></div>

- Local function parameters support the storage classifiers as usual in C++03.
+ Local function parameters support the storage classifiers as usual in __CPP03__.
 The <code class="computeroutput">auto</code> storage classifier
 is specified as: [<a name="boost_localfunction.Advanced_Topics.storage_classifiers___auto__and__register__.f0" href="#ftn.boost_localfunction.Advanced_Topics.storage_classifiers___auto__and__register__.f0" class="footnote">25</a>]
 
@@ -906,12 +876,14 @@
 return x - offset; \
 } BOOST_LOCAL_FUNCTION_NAME(dec)

-BOOST_AUTO_TEST_CASE(test_same_line)
-{
+int main(void) {
 int delta = 10;
 LOCAL_INC_DEC(delta) // Multiple local functions on same line.

- BOOST_CHECK(dec(inc(123)) == 123);
+ /** @todo back to BOOST_TEST(dec(inc(123)) == 123)) and doc that on vacpp compiler composition doesn't work */
+ BOOST_TEST(inc(123) == 123 + 10);
+ BOOST_TEST(dec(123) == 123 - 10);
+ return boost::report_errors();
}
</pre>

@@ -989,8 +961,7 @@
<td>
 
 This is not supported because local functions are implemented using
- local classes and C++03
- local classes cannot be templates.
+ local classes and __CPP03__ local classes cannot be templates.
 
 </td>
</tr>
@@ -1025,10 +996,9 @@
<td>
 
 Local functions can be specified <code class="computeroutput">inline</code>
- to improve the chances that C++03
- standard compilers can optimize the local function call run-time
- (but <code class="computeroutput">inline</code> local
- functions cannot be passed as template parameters on C++03
+ to improve the chances that __CPP03__ standard compilers can optimize
+ the local function call run-time (but <code class="computeroutput">inline</code>
+ local functions cannot be passed as template parameters on __CPP03__
 standard compilers, see the <a class="link" href="Advanced_Topics.html" title="Advanced Topics">Advanced
 Topics</a> section).
 
@@ -1210,15 +1180,17 @@
 int x;
 int y;
};
+BOOST_TYPEOF_REGISTER_TYPE(point) // Register for `NAME` below.

-BOOST_AUTO_TEST_CASE(test_operator_error) {
+int main(void) {
 bool BOOST_LOCAL_FUNCTION(const point& p, const point& q) {
 return p.x == q.x && p.y == q.y;
 } BOOST_LOCAL_FUNCTION_NAME(operator==) // Error: Cannot use `operator...`.

 point a; a.x = 1; a.y = 2;
 point b = a;
- BOOST_CHECK(a == b);
+ BOOST_TEST(a == b);
+ return boost::report_errors();
}
</pre>

@@ -1245,7 +1217,7 @@
 } BOOST_LOCAL_FUNCTION_NAME(validate)

 return validate(x + y);
-faliure:
+failure:
 return -1;
}
</pre>
@@ -1299,8 +1271,7 @@
<div class="footnote">[<a id="ftn.boost_localfunction.Advanced_Topics.specifying_types.f0" href="#boost_localfunction.Advanced_Topics.specifying_types.f0" class="para">22</a>] 
 In the examples of this documentation, we specify bound variables, function
 parameters, and result type in this order because this is the order used
- by <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions. However, the library accepts bound variables,
+ by __CPP11_lambda__ functions. However, the library accepts bound variables,
 function parameters, and the result type in any order.
 </div>
<div class="footnote">[<a id="ftn.boost_localfunction.Advanced_Topics.inlining.f0" href="#boost_localfunction.Advanced_Topics.inlining.f0" class="para">23</a>] 
@@ -1312,12 +1283,11 @@
 inlined local functions do not use such indirect function pointer call
 (so they are more likely to be optimized) but because of that they
 cannot be passed as template parameters. The indirect function pointer
- call is needed on C++03
- but it is not needed on C++11
- (see [N2657])
+ call is needed on __CPP03__ but it is not needed on __CPP11__ (see
+ [N2657])
 thus this library automatically generates local function calls that
- can be inlined on C++11
- compilers (even when the local function is not declared inline).
+ can be inlined on __CPP11__ compilers (even when the local function
+ is not declared inline).
 </div>
<div class="footnote">[<a id="ftn.boost_localfunction.Advanced_Topics.recursion.f0" href="#boost_localfunction.Advanced_Topics.recursion.f0" class="para">24</a>] 
 Rationale. This limitation comes from
@@ -1331,13 +1301,11 @@
 </div>
<div class="footnote">[<a id="ftn.boost_localfunction.Advanced_Topics.storage_classifiers___auto__and__register__.f0" href="#boost_localfunction.Advanced_Topics.storage_classifiers___auto__and__register__.f0" class="para">25</a>] 
 The <code class="computeroutput">auto</code> storage classifier
- is part of the C++03
- standard and therefore supported by this library. However, the meaning
- and usage of the <code class="computeroutput">auto</code> keyword
- changed in C++11.
- Therefore, use the <code class="computeroutput">auto</code> storage
- classifier with the usual care in order to avoid writing C++03
- code that might not work on C++11.
+ is part of the __CPP03__ standard and therefore supported by this library.
+ However, the meaning and usage of the <code class="computeroutput">auto</code>
+ keyword changed in __CPP11__. Therefore, use the <code class="computeroutput">auto</code>
+ storage classifier with the usual care in order to avoid writing __CPP03__
+ code that might not work on __CPP11__.
 </div>
<div class="footnote">[<a id="ftn.boost_localfunction.Advanced_Topics.same_line_expansions.f0" href="#boost_localfunction.Advanced_Topics.same_line_expansions.f0" class="para">26</a>] 
 Rationale. The <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION.html" title="Macro BOOST_LOCAL_FUNCTION">BOOST_LOCAL_FUNCTION</a></code>

Modified: trunk/libs/local_function/doc/html/boost_localfunction/Alternatives.html
==============================================================================
--- trunk/libs/local_function/doc/html/boost_localfunction/Alternatives.html (original)
+++ trunk/libs/local_function/doc/html/boost_localfunction/Alternatives.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="../index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
<link rel="up" href="../index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
-<link rel="prev" href="../BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX">
+<link rel="prev" href="Examples.html" title="Examples">
<link rel="next" href="No_Variadic_Macros.html" title="Annex: No Variadic Macros">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX.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="No_Variadic_Macros.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+<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="No_Variadic_Macros.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
</div>
<div class="section boost_localfunction_Alternatives">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
@@ -189,9 +189,8 @@
 </td>
<td>
 
- Yes. The C++03
- standard does not allow to pass local types as template parameters
- (see [N2657])
+ Yes. The __CPP03__ standard does not allow to pass local types as
+ template parameters (see [N2657])
 but this library implements a "trick" to get around this
 limitation (see the <a class="link" href="Implementation.html" title="Annex: Implementation">Implementation</a>
 section).
@@ -204,9 +203,8 @@
 </td>
<td>
 
- No on C++03
- compilers (but yes on C++11
- compilers and some compilers like MSVC 8.0, see [N2657]).
+ No on __CPP03__ compilers (but yes on __CPP11__ compilers and some
+ compilers like MSVC 8.0, see [N2657]).
 
 </td>
<td>
@@ -278,8 +276,7 @@
 </td>
<td>
 
- No (C++11
- lambdas cannot be function templates).
+ No (__CPP11__ lambdas cannot be function templates).
 
 </td>
<td>
@@ -304,39 +301,31 @@
 C++11 Lambda Function
 

- <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions have most of the features of this library (see also
+ __CPP11_lambda__ functions have most of the features of this library (see also
 the example in the <a class="link" href="../index.html#boost_localfunction.Introduction" title="Introduction">Introduction</a>
 section):
 
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
- <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions can be defined within expressions while this library
- local functions can only be defined at declaration scope.
+ __CPP11_lambda__ functions can be defined within expressions while this
+ library local functions can only be defined at declaration scope.
 </li>
<li class="listitem">
- <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions are only supported by the C++11
- standard so they are not supported by all C++ compilers. This library local
- functions can be programmed also on C++03
- compilers (and they have performances comparable to <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions on C++11
- compilers).
+ __CPP11_lambda__ functions are only supported by the __CPP11__ standard
+ so they are not supported by all C++ compilers. This library local functions
+ can be programmed also on __CPP03__ compilers (and they have performances
+ comparable to __CPP11_lambda__ functions on __CPP11__ compilers).
 </li>
<li class="listitem">
- <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions do not allow to bind variables in scope by constant
+ __CPP11_lambda__ functions do not allow to bind variables in scope by constant
 reference or by non-constant value. Because a variable cannot be bound
- by constant reference, <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions can bind a variable by constant only if the variable
- is <code class="computeroutput">CopyConstructible</code> and
- the binding requires a (potentially expensive) extra copy operation. Both
- constant reference and non-constant value binding are instead supported
- by this library. However, <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions provide a short-hand syntax to bind all variables
- in scope at once (<code class="computeroutput">&</code> or
- <code class="computeroutput">=</code>).
+ by constant reference, __CPP11_lambda__ functions can bind a variable by
+ constant only if the variable is <code class="computeroutput">CopyConstructible</code>
+ and the binding requires a (potentially expensive) extra copy operation.
+ Both constant reference and non-constant value binding are instead supported
+ by this library. However, __CPP11_lambda__ functions provide a short-hand
+ syntax to bind all variables in scope at once (<code class="computeroutput">&</code>
+ or <code class="computeroutput">=</code>).
 </li>
</ul></div>

@@ -372,8 +361,8 @@
int main(void) {
 n x(-1);

- auto f = [x](void) { // Error: x is non-copyable, but if
- assert( x.i == -1 ); // bind `&x` then `x` is not constant.
+ auto f = [x](void) { // Error: x is non-copyable, but if
+ assert(x.i == -1); // bind `&x` then `x` is not constant.
 };
 f();

@@ -390,12 +379,13 @@
 int i;
 n(int _i): i(_i) {}
};
+BOOST_TYPEOF_REGISTER_TYPE(n) // Register for `bind& x` below.

int main() {
 n x(-1);

 void BOOST_LOCAL_FUNCTION(const bind& x) { // OK: No copy
- assert( x.i == -1 ); // and constant.
+ assert(x.i == -1); // and constant.
 } BOOST_LOCAL_FUNCTION_NAME(f)
 f();

@@ -412,10 +402,7 @@
 and expensive_copy_local_function.cpp):
 
<div class="informaltable"><table class="table">
-<colgroup>
-<col>
-<col>
-</colgroup>
+<colgroup><col></colgroup>
<thead><tr>
<th>
 
@@ -428,66 +415,27 @@
 
 </th>
</tr></thead>
-<tbody><tr>
-<td>
+<tbody>
+<tr><td>
 
-
-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">struct n {
- int i;
- n(int _i): i(_i) {}
- n(n const& x): i(x.i) { // Some time consuming copy.
- for (unsigned i = 0; i < 10000; ++i) std::cout << '.';
- }
-};
-
-int main(void) {
- n x(-1);
-
- auto f = [x]() { // Problem: Expensive copy, but if bind
- assert( x.i == -1); // by `&x` then `x` is not constant.
- };
- f();
-
- return 0;
-}
-</pre>
-
+ [expensive_copy_lambda
 
- </td>
-<td>
+ </td></tr>
+<tr><td>
 
-
-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">struct n {
- int i;
- n(int _i): i(_i) {}
- n(n const& x): i(x.i) { // Some time consuming copy.
- for (unsigned i = 0; i < 10000; ++i) std::cout << '.';
- }
-};
-
-int main(void) {
- n x(-1);
-
- void BOOST_LOCAL_FUNCTION(const bind& x) { // OK: No copy
- assert( x.i == -1 ); // and constant.
- } BOOST_LOCAL_FUNCTION_NAME(f)
- f();
-
- return 0;
-}
-</pre>
-
+ expensive_copy_local_function
 
- </td>
-</tr></tbody>
+ </td></tr>
+</tbody>
</table></div>

- When constant binding functionality is needed for <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions, the best alternative might be to bind an extra local
- variable declared constant and initialized to the original variable (for example,
- <code class="computeroutput">const decltype(x)&
- const_x =
- x</code> and then bind <code class="computeroutput">const_x</code>
+ ]
+ 
+
+ When constant binding functionality is needed for __CPP11_lambda__ functions,
+ the best alternative might be to bind an extra local variable declared constant
+ and initialized to the original variable (for example, <code class="computeroutput">const
+ decltype(x)& const_x = x</code> and then bind <code class="computeroutput">const_x</code>
 instead of <code class="computeroutput">x</code> to the lambda
 function). In many cases the use of an extra constant variable <code class="computeroutput">const_x</code> can be acceptable but in other cases
 (e.g., constant blocks presented in the <a class="link" href="Examples.html" title="Examples">Examples</a>
@@ -522,7 +470,7 @@
<td>
 

-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">{
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int main(void) {
 int sum = 0, factor = 10;

 struct local_add { // Unfortunately, boilerplate code to program the class.
@@ -541,7 +489,8 @@
 // Unfortunately, cannot pass as template parameter to `std::for_each`.
 for(size_t i = 0; i < 2; ++i) add(nums[i]);

- BOOST_CHECK(sum == 60);
+ BOOST_TEST(sum == 60);
+ return boost::report_errors();
}
</pre>

@@ -550,7 +499,7 @@
<td>
 

-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">{ // Some local scope.
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int main(void) { // Some local scope.
 int sum = 0, factor = 10; // Variables in scope to bind.

 void BOOST_LOCAL_FUNCTION(const bind factor, bind& sum, int num) {
@@ -561,7 +510,8 @@
 int nums[] = {2, 3};
 std::for_each(nums, nums + 2, add); // Pass it to an algorithm.

- BOOST_CHECK(sum == 60); // Assert final summation value.
+ BOOST_TEST(sum == 60); // Assert final summation value.
+ return boost::report_errors();
}
</pre>

@@ -610,7 +560,7 @@
 const int factor; // Make `factor` constant.
};

-BOOST_AUTO_TEST_CASE(test_add_global_functor) {
+int main(void) {
 int sum = 0, factor = 10;

 global_add add(sum, factor);
@@ -619,7 +569,8 @@
 int nums[] = {2, 3};
 std::for_each(nums, nums + 2, add); // Passed as template parameter.

- BOOST_CHECK(sum == 60);
+ BOOST_TEST(sum == 60);
+ return boost::report_errors();
}
</pre>

@@ -628,7 +579,7 @@
<td>
 

-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">{ // Some local scope.
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int main(void) { // Some local scope.
 int sum = 0, factor = 10; // Variables in scope to bind.

 void BOOST_LOCAL_FUNCTION(const bind factor, bind& sum, int num) {
@@ -639,7 +590,8 @@
 int nums[] = {2, 3};
 std::for_each(nums, nums + 2, add); // Pass it to an algorithm.

- BOOST_CHECK(sum == 60); // Assert final summation value.
+ BOOST_TEST(sum == 60); // Assert final summation value.
+ return boost::report_errors();
}
</pre>

@@ -680,7 +632,7 @@
<td>
 

-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">{
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int main(void) {
 using boost::phoenix::let;
 using boost::phoenix::local_names::_f;
 using boost::phoenix::cref;
@@ -696,7 +648,8 @@
 ref(sum) += _f * _1, _1 // Access `sum` by reference.
 ]);

- BOOST_CHECK(sum == 60);
+ BOOST_TEST(sum == 60);
+ return boost::report_errors();
}
</pre>

@@ -705,7 +658,7 @@
<td>
 

-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">{ // Some local scope.
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int main(void) { // Some local scope.
 int sum = 0, factor = 10; // Variables in scope to bind.

 void BOOST_LOCAL_FUNCTION(const bind factor, bind& sum, int num) {
@@ -716,7 +669,8 @@
 int nums[] = {2, 3};
 std::for_each(nums, nums + 2, add); // Pass it to an algorithm.

- BOOST_CHECK(sum == 60); // Assert final summation value.
+ BOOST_TEST(sum == 60); // Assert final summation value.
+ return boost::report_errors();
}
</pre>

@@ -740,13 +694,12 @@
 

 Overall, this library has compile-times and generates binary sizes similar
- to the ones of the other approaches. This library run-times on C++03
- compilers were measured to be larger than other approaches when compiler optimization
+ to the ones of the other approaches. This library run-times on __CPP03__ compilers
+ were measured to be larger than other approaches when compiler optimization
 is enabled (using <code class="computeroutput">bjam release
 ...</code>). However, on compilers that allow
 to pass local types as template parameters (e.g., MSVC 8.0 or GCC 4.5.3 with
- C++11 features
- enabled <code class="literal">-std=c++0x</code>, see also [N2657])
+ __CPP11__ features enabled <code class="literal">-std=c++0x</code>, see also [N2657])
 this library automatically generates optimized code that runs as fast as the
 fastest of the other approaches (see the "Boost.LocalFunction" approach
 below). When this library local function is specified <code class="computeroutput">inline</code>
@@ -768,8 +721,7 @@
</tr>
<tr><td align="left" valign="top">
 The run-time performances of this library local functions are explained because
- on C++03
- compliant compilers (e.g., GCC 4.5.3 without <code class="literal">-std=c++0x</code>)
+ on __CPP03__ compliant compilers (e.g., GCC 4.5.3 without <code class="literal">-std=c++0x</code>)
 this library needs to use a function pointer in order to pass the local function
 class as a template parameter (see [N2657]
 and the <a class="link" href="Implementation.html" title="Annex: Implementation">Implementation</a>
@@ -779,20 +731,19 @@
 have been observed to allow all tested compilers to inline all the function
 calls for optimization. This run-time performance cost is not present on
 compilers that allow to pass local types as template parameters (e.g., MSVC
- 8.0 or GCC 4.5.3 with C++11
- features enabled <code class="literal">-std=c++0x</code>) because this library does
- not have to use the extra function pointer to implement the local function
- call (it directly passes the local class type as template parameter).
+ 8.0 or GCC 4.5.3 with __CPP11__ features enabled <code class="literal">-std=c++0x</code>)
+ because this library does not have to use the extra function pointer to implement
+ the local function call (it directly passes the local class type as template
+ parameter).
 </td></tr>
</table></div>

- This run-time performance cost on C++03
- compilers might or might not be an issue depending on the performance requirements
- of specific applications. For example, an application might already be using
- a number of indirect function calls (function pointers, virtual functions,
- etc) for which the overhead added by using the one extra function pointer required
- by the local function call might not be noticeable within the overall program
- run-time.
+ This run-time performance cost on __CPP03__ compilers might or might not be
+ an issue depending on the performance requirements of specific applications.
+ For example, an application might already be using a number of indirect function
+ calls (function pointers, virtual functions, etc) for which the overhead added
+ by using the one extra function pointer required by the local function call
+ might not be noticeable within the overall program run-time.
 

 Finally, note that only a very simple local function body with just a single
@@ -886,8 +837,7 @@
 </td>
<td>
 
- C++11
- Lambda Function [<a name="boost_localfunction.Alternatives.f0" href="#ftn.boost_localfunction.Alternatives.f0" class="footnote">a</a>]
+ __CPP11__ Lambda Function [<a name="boost_localfunction.Alternatives.f0" href="#ftn.boost_localfunction.Alternatives.f0" class="footnote">a</a>]
 
 </td>
<td>
@@ -949,8 +899,7 @@
</tr>
</tbody>
<tbody class="footnotes"><tr><td colspan="3"><div class="footnote">[<a id="ftn.boost_localfunction.Alternatives.f0" href="#boost_localfunction.Alternatives.f0" class="para">a</a>] 
- Measurements available only for C++11
- compilers.
+ Measurements available only for __CPP11__ compilers.
 </div></td></tr></tbody>
</table></div>
<div class="informaltable"><table class="table">
@@ -983,8 +932,7 @@
<thead><tr><th>
 
 MSVC 8.0 With "Local Types as Template Parameters" (Without
- C++11
- Lambdas)
+ __CPP11__ Lambdas)
 
 </th></tr></thead>
<tbody>
@@ -1007,9 +955,8 @@
<colgroup><col></colgroup>
<thead><tr><th>
 
- GCC 4.3.4 With C++03
- Only (Without C++11
- Lambdas and Without "Local Types as Template Parameters")
+ GCC 4.3.4 With __CPP03__ Only (Without __CPP11__ Lambdas and Without
+ "Local Types as Template Parameters")
 
 </th></tr></thead>
<tbody>
@@ -1041,7 +988,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX.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="No_Variadic_Macros.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+<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="No_Variadic_Macros.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: trunk/libs/local_function/doc/html/boost_localfunction/Examples.html
==============================================================================
--- trunk/libs/local_function/doc/html/boost_localfunction/Examples.html (original)
+++ trunk/libs/local_function/doc/html/boost_localfunction/Examples.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -7,7 +7,7 @@
<link rel="home" href="../index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
<link rel="up" href="../index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
<link rel="prev" href="Advanced_Topics.html" title="Advanced Topics">
-<link rel="next" href="../reference.html" title="Reference">
+<link rel="next" href="Alternatives.html" title="Annex: Alternatives">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="Advanced_Topics.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>
+<a accesskey="p" href="Advanced_Topics.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 boost_localfunction_Examples">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
@@ -50,8 +50,7 @@

 Combing local functions with the <a href="http://gcc.gnu.org/onlinedocs/gcc/Statement-Exprs.html" target="_top">statement
 expression</a> extension of GCC compilers, it is possible to implement
- lambda functions for GCC compilers even without C++11
- support.
+ lambda functions for GCC compilers even without __CPP11__ support.
 
<div class="warning"><table border="0" summary="Warning">
<tr>
@@ -60,8 +59,7 @@
</tr>
<tr><td align="left" valign="top">
 This code only works on compilers that support the statement expression
- GCC extension or that support <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions.
+ GCC extension or that support __CPP11_lambda__ functions.
 </td></tr>
</table></div>

@@ -104,49 +102,35 @@
 </td>
<td>
 
-
-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int val = 2;
-int nums[] = {1, 2, 3};
-int* end = nums + 3;
-
-int* iter = std::find_if(nums, end,
- [val](int num) -> bool {
- return num == val;
- }
-);
-</pre>
-
+ [gcc_lambda_cxx11
 
 </td>
</tr></tbody>
</table></div>

+ ]
+ 
+
 Where the macros are defined in gcc_lambda.hpp.
 

 This is possible because GCC statement expressions allow to use declaration
 statements within expressions and therefore to declare a local function within
- an expression. The macros automatically detect if the compiler supports
- <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions in which case the implementation uses native lambdas
- instead of local functions in statement expressions. However, <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions do not support constant binding so it is best to
- only use <code class="computeroutput">const bind
- variable</code> (same as <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> <code class="computeroutput">=variable</code>)
- and <code class="computeroutput">bind&
- variable</code> (same as <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> <code class="computeroutput">&variable</code>)
- because these have the exact same semantic between the local function and
- native lambda implementation. Unfortunately, the <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> short-hand binds <code class="computeroutput">&</code>
+ an expression. The macros automatically detect if the compiler supports __CPP11_lambda__
+ functions in which case the implementation uses native lambdas instead of
+ local functions in statement expressions. However, __CPP11_lambda__ functions
+ do not support constant binding so it is best to only use <code class="computeroutput">const
+ bind variable</code>
+ (same as __CPP11_lambda__ <code class="computeroutput">=variable</code>) and <code class="computeroutput">bind& variable</code>
+ (same as __CPP11_lambda__ <code class="computeroutput">&variable</code>) because these have the exact
+ same semantic between the local function and native lambda implementation.
+ Unfortunately, the __CPP11_lambda__ short-hand binds <code class="computeroutput">&</code>
 and <code class="computeroutput">=</code> (which automatically bind
 all variables in scope either by reference or value) are not supported by
 the macros because they are not supported by the local function implementation.
 Finally, the result type <code class="computeroutput">return </code><code class="literal">result-type</code>
 is optional and it is assumed <code class="computeroutput">void</code>
- when it is not specified (same as with <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions).
+ when it is not specified (same as with __CPP11_lambda__ functions).
 
</div>
<div class="section boost_localfunction_Examples_constant_blocks">
@@ -236,14 +220,14 @@
 were all specified variables are constant.
 

- Unfortunately, constant blocks cannot be implemented with <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions because these do not support constant binding (of
- course it is always possible to introduce extra constant variables <code class="computeroutput">const int& const_x
- = x</code>,
- etc and use these variables in the assertion). Variables bound by value using
- <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions (<code class="computeroutput">variable</code>,
- <code class="computeroutput">=variable</code>,
+ Unfortunately, constant blocks cannot be implemented with __CPP11_lambda__
+ functions because these do not support constant binding (of course it is
+ always possible to introduce extra constant variables <code class="computeroutput">const
+ int&
+ const_x =
+ x</code>, etc and use these variables
+ in the assertion). Variables bound by value using __CPP11_lambda__ functions
+ (<code class="computeroutput">variable</code>, <code class="computeroutput">=variable</code>,
 and <code class="computeroutput">=</code>) are constant but they
 are required to be <code class="computeroutput">CopyConstructible</code>
 and they introduce potentially expensive copy operations. [<a name="boost_localfunction.Examples.constant_blocks.f0" href="#ftn.boost_localfunction.Examples.constant_blocks.f0" class="footnote">28</a>]
@@ -375,7 +359,7 @@
<td>
 

-<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">BOOST_AUTO_TEST_CASE(test_phoenix_factorial_local) {
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int main(void) {
 using boost::phoenix::arg_names::arg1;

 int BOOST_LOCAL_FUNCTION(int n) { // Unfortunately, monomorphic.
@@ -386,8 +370,9 @@
 factorial(factorial_impl); // Phoenix function from local function.

 int i = 4;
- BOOST_CHECK(factorial(i)() == 24); // Call.
- BOOST_CHECK(factorial(arg1)(i) == 24); // Lazy call.
+ BOOST_TEST(factorial(i)() == 24); // Call.
+ BOOST_TEST(factorial(arg1)(i) == 24); // Lazy call.
+ return boost::report_errors();
}
</pre>

@@ -412,14 +397,15 @@
 }
};

-BOOST_AUTO_TEST_CASE(test_phoenix_factorial) {
+int main(void) {
 using boost::phoenix::arg_names::arg1;

 boost::phoenix::function<factorial_impl> factorial;

 int i = 4;
- BOOST_CHECK(factorial(i)() == 24); // Call.
- BOOST_CHECK(factorial(arg1)(i) == 24); // Lazy call.
+ BOOST_TEST(factorial(i)() == 24); // Call.
+ BOOST_TEST(factorial(arg1)(i) == 24); // Lazy call.
+ return boost::report_errors();
}
</pre>

@@ -553,9 +539,8 @@
<td>
 
 This example is adapted from [N2550]
- (<a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions): It passes a local function to the STL
- algorithm <code class="computeroutput">std::find_if</code>.
+ (__CPP11_lambda__ functions): It passes a local function to the
+ STL algorithm <code class="computeroutput">std::find_if</code>.
 
 </td>
</tr>
@@ -568,8 +553,7 @@
<td>
 
 This example is adapted from [N2529]
- (<a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions): It binds the object in scope <code class="computeroutput">this</code> to a local function.
+ (__CPP11_lambda__ functions): It binds the object in scope <code class="computeroutput">this</code> to a local function.
 
 </td>
</tr>
@@ -579,14 +563,16 @@
<div class="footnotes">
 <hr width="100" align="left">
<div class="footnote">[<a id="ftn.boost_localfunction.Examples.constant_blocks.f0" href="#boost_localfunction.Examples.constant_blocks.f0" class="para">28</a>] 
- Ideally, <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions would allow to bind variables also using <code class="computeroutput">const& variable</code> (constant reference) and <code class="computeroutput">const&</code>
+ Ideally, __CPP11_lambda__ functions would allow to bind variables also
+ using <code class="computeroutput">const&
+ variable</code> (constant reference)
+ and <code class="computeroutput">const&</code>
 (all variables by constant reference).
 </div>
<div class="footnote">[<a id="ftn.boost_localfunction.Examples.boost_phoenix_functions.f0" href="#boost_localfunction.Examples.boost_phoenix_functions.f0" class="para">29</a>] 
 Rationale. Local functions can only be
 monomorphic because they are implemented using local classes and local
- classes cannot be templates in C++ (not even in C++11).
+ classes cannot be templates in C++ (not even in __CPP11__).
 </div>
</div>
</div>
@@ -601,7 +587,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="Advanced_Topics.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>
+<a accesskey="p" href="Advanced_Topics.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>

Modified: trunk/libs/local_function/doc/html/boost_localfunction/Getting_Started.html
==============================================================================
--- trunk/libs/local_function/doc/html/boost_localfunction/Getting_Started.html (original)
+++ trunk/libs/local_function/doc/html/boost_localfunction/Getting_Started.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -32,7 +32,6 @@
<dt><a href="Getting_Started.html#boost_localfunction.Getting_Started.compilers_and_platforms">Compilers
 and Platforms</a></dt>
<dt>Installation</dt>
-<dt>Configuration</dt>
</dl></div>

 This section explains how programmers can setup their system to use this library.
@@ -58,12 +57,12 @@
 of this library.
 

- In some of the examples presented in this documentation, the Boost.Test
- macro <code class="computeroutput">BOOST_CHECK</code> is used
- equivalently to <code class="computeroutput">assert</code> and
- the Boost.Test macro
- <code class="computeroutput">BOOST_AUTO_TEST_CASE</code> is used
- equivalently to <code class="computeroutput">main</code>. [<a name="boost_localfunction.Getting_Started.this_documentation.f0" href="#ftn.boost_localfunction.Getting_Started.this_documentation.f0" class="footnote">3</a>]
+ In most of the examples presented in this documentation, the Boost.Detail/LightweightTest
+ (<code class="literal">boost/detail/lightweight_test.hpp</code>) macro <code class="computeroutput">BOOST_TEST</code> is used to check correctness
+ conditions (conceptually similar to <code class="computeroutput">assert</code>).
+ A failure of the checked condition does not abort the execution of the program,
+ it will instead make <code class="computeroutput">boost::report_errors</code>
+ return a non-zero program exit code. [<a name="boost_localfunction.Getting_Started.this_documentation.f0" href="#ftn.boost_localfunction.Getting_Started.this_documentation.f0" class="footnote">3</a>]
 
</div>
<div class="section boost_localfunction_Getting_Started_compilers_and_platforms">
@@ -139,19 +138,11 @@
 Any symbol prefixed by <code class="computeroutput">BOOST_LOCAL_FUNCTION_AUX_...</code> or <code class="computeroutput">BOOST_LOCAL_FUNCTION_DETAIL_...</code> (regardless of its namespace).
 </li>
</ul></div>
-</div>
-<div class="section boost_localfunction_Getting_Started_configuration">
-<div class="titlepage"><div><div><h3 class="title">
-<a name="boost_localfunction.Getting_Started.configuration"></a><a class="link" href="Getting_Started.html#boost_localfunction.Getting_Started.configuration" title="Configuration">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 are defined in the header file <code class="computeroutput"><a class="link" href="../reference.html#header.boost.local_function.config_hpp" title="Header <boost/local_function/config.hpp>">boost/local_function/config.hpp</a></code>.
+ it. All configuration macros are defined in the header file <code class="computeroutput"><a class="link" href="../reference.html#header.boost.local_function.config_hpp" title="Header <boost/local_function/config.hpp>">boost/local_function/config.hpp</a></code>.
 It is strongly recommended not to change the library configuration macro
 definitions unless strictly necessary.
 
@@ -159,9 +150,9 @@
<div class="footnotes">
 <hr width="100" align="left">
<div class="footnote">[<a id="ftn.boost_localfunction.Getting_Started.this_documentation.f0" href="#boost_localfunction.Getting_Started.this_documentation.f0" class="para">3</a>] 
- Rationale. Using Boost.Test
- allows to add the documentation examples to the library regression tests
- so to make sure that the listed examples always compile and run correctly.
+ Rationale. Using Boost.Detail/LightweightTest
+ allows to add the examples to the library regression tests so to make sure
+ that they always compile and run correctly.
 </div>
<div class="footnote">[<a id="ftn.boost_localfunction.Getting_Started.installation.f0" href="#boost_localfunction.Getting_Started.installation.f0" class="para">4</a>] 
 Rationale. This library concatenates symbols

Modified: trunk/libs/local_function/doc/html/boost_localfunction/Implementation.html
==============================================================================
--- trunk/libs/local_function/doc/html/boost_localfunction/Implementation.html (original)
+++ trunk/libs/local_function/doc/html/boost_localfunction/Implementation.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -7,7 +7,7 @@
<link rel="home" href="../index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
<link rel="up" href="../index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
<link rel="prev" href="No_Variadic_Macros.html" title="Annex: No Variadic Macros">
-<link rel="next" href="Release_Notes.html" title="Release Notes">
+<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>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="No_Variadic_Macros.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="Release_Notes.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+<a accesskey="p" href="No_Variadic_Macros.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 boost_localfunction_Implementation">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
@@ -49,11 +49,10 @@
 </h6>

 This library uses a local class to implement the local function object. However,
- in C++03
- local classes (and therefore the local function objects they implement) cannot
- be passed as template parameters (e.g., to the <code class="computeroutput">std::for_each</code>
- algorithm), this is instead possible in C++11,
- MSVC, and some other compilers (see [N2657]).
+ in __CPP03__ local classes (and therefore the local function objects they implement)
+ cannot be passed as template parameters (e.g., to the <code class="computeroutput">std::for_each</code>
+ algorithm), this is instead possible in __CPP11__, MSVC, and some other compilers
+ (see [N2657]).
 To work around this limitation, this library investigated the following two
 "tricks" (both tricks can be extended to support eventual function
 default parameters):
@@ -78,8 +77,7 @@
 


-<pre class="programlisting">#define BOOST_TEST_MODULE TestImplTparamTricks
-#include <boost/test/unit_test.hpp>
+<pre class="programlisting">#include <boost/detail/lightweight_test.hpp>
#include <vector>
#include <algorithm>

@@ -106,7 +104,7 @@
 interface* func_;
};

-BOOST_AUTO_TEST_CASE(test_impl_tparam_tricks) {
+int main(void) {
 int sum = 0, factor = 10;

 // Local class for local function.
@@ -138,7 +136,8 @@
 std::for_each(v.begin(), v.end(), add_casting); // OK.
 std::for_each(v.begin(), v.end(), add_virtual); // OK.

- BOOST_CHECK(sum == 200);
+ BOOST_TEST(sum == 200);
+ return boost::report_errors();
}
</pre>

@@ -152,8 +151,7 @@
 allow for compiler optimizations that inline the local function calls (because
 they rely on one indirect function call via either a function pointer or a
 virtual function respectively). Therefore, on compilers that accept local types
- as template parameters (MSVC, C++11,
- etc, see [N2657]),
+ as template parameters (MSVC, __CPP11__, etc, see [N2657]),
 this library automatically generates code that passes the local class type
 directly as template parameter without using neither one of these two tricks
 in order to take full advantage of compiler optimizations that inline the local
@@ -184,8 +182,7 @@
<pre class="programlisting">#include <boost/local_function/detail/preprocessor/keyword/thisunderscore.hpp>
#include <boost/local_function/detail/preprocessor/keyword/const.hpp>
#include <boost/local_function/detail/preprocessor/keyword/bind.hpp>
-#define BOOST_TEST_MODULE TestImplPpKeyword
-#include <boost/test/unit_test.hpp>
+#include <boost/detail/lightweight_test.hpp>

// Expand to 1 if space-separated tokens end with `this_`, 0 otherwise.
#define IS_THIS_BACK(tokens) \
@@ -195,9 +192,10 @@
 tokens \
 )))

-BOOST_AUTO_TEST_CASE(test_impl_pp_keyword) {
- BOOST_CHECK(IS_THIS_BACK(const bind this_) == 1);
- BOOST_CHECK(IS_THIS_BACK(const bind& x) == 0);
+int main(void) {
+ BOOST_TEST(IS_THIS_BACK(const bind this_) == 1);
+ BOOST_TEST(IS_THIS_BACK(const bind& x) == 0);
+ return boost::report_errors();
}
</pre>

@@ -222,7 +220,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="No_Variadic_Macros.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="Release_Notes.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+<a accesskey="p" href="No_Variadic_Macros.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>

Modified: trunk/libs/local_function/doc/html/boost_localfunction/No_Variadic_Macros.html
==============================================================================
--- trunk/libs/local_function/doc/html/boost_localfunction/No_Variadic_Macros.html (original)
+++ trunk/libs/local_function/doc/html/boost_localfunction/No_Variadic_Macros.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -37,10 +37,10 @@
 </h6>

 Most modern compilers support <a href="http://en.wikipedia.org/wiki/Variadic_macro" target="_top">variaid
- macros</a> (notably, these include GCC, MSVC, and all C++11
- compilers). However, in the rare case that programmers need to use this library
- on a compiler without variadic macros, this library also allows to specify
- its macro parameters using a Boost.Preprocessor
+ macros</a> (notably, these include GCC, MSVC, and all __CPP11__ compilers).
+ However, in the rare case that programmers need to use this library on a compiler
+ without variadic macros, this library also allows to specify its macro parameters
+ using a Boost.Preprocessor
 sequence where tokens are separated by round parenthesis <code class="computeroutput">()</code>:
 
<pre class="programlisting">(token1) (token2) ... // All compilers.
@@ -57,7 +57,7 @@
 


-<pre class="programlisting">{
+<pre class="programlisting">int main(void) {
 int sum = 0, factor = 10;

 void BOOST_LOCAL_FUNCTION( (const bind factor) (bind& sum) (int num) ) {
@@ -68,7 +68,8 @@
 int nums[] = {2, 3};
 std::for_each(nums, nums + 2, add);

- BOOST_CHECK(sum == 60);
+ BOOST_TEST(sum == 60);
+ return boost::report_errors();
}
</pre>

@@ -79,7 +80,7 @@
 


-<pre class="programlisting">{ // Some local scope.
+<pre class="programlisting">int main(void) { // Some local scope.
 int sum = 0, factor = 10; // Variables in scope to bind.

 void BOOST_LOCAL_FUNCTION(const bind factor, bind& sum, int num) {
@@ -90,7 +91,8 @@
 int nums[] = {2, 3};
 std::for_each(nums, nums + 2, add); // Pass it to an algorithm.

- BOOST_CHECK(sum == 60); // Assert final summation value.
+ BOOST_TEST(sum == 60); // Assert final summation value.
+ return boost::report_errors();
}
</pre>

@@ -107,7 +109,7 @@
 return 10;
} BOOST_LOCAL_FUNCTION_NAME(ten)

-BOOST_CHECK(ten() == 10);
+BOOST_TEST(ten() == 10);
</pre>

Modified: trunk/libs/local_function/doc/html/boost_localfunction/Release_Notes.html
==============================================================================
--- trunk/libs/local_function/doc/html/boost_localfunction/Release_Notes.html (original)
+++ trunk/libs/local_function/doc/html/boost_localfunction/Release_Notes.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="../index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
<link rel="up" href="../index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
-<link rel="prev" href="Implementation.html" title="Annex: Implementation">
+<link rel="prev" href="../BOOST_LOCAL_FUNCTION_CONFIG_LOCALS_AS_TPARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_LOCALS_AS_TPARAMS">
<link rel="next" href="Bibliography.html" title="Bibliography">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="Implementation.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>
+<a accesskey="p" href="../BOOST_LOCAL_FUNCTION_CONFIG_LOCALS_AS_TPARAMS.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 boost_localfunction_Release_Notes">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
@@ -151,7 +151,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="Implementation.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>
+<a accesskey="p" href="../BOOST_LOCAL_FUNCTION_CONFIG_LOCALS_AS_TPARAMS.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>

Modified: trunk/libs/local_function/doc/html/boost_localfunction/Tutorial.html
==============================================================================
--- trunk/libs/local_function/doc/html/boost_localfunction/Tutorial.html (original)
+++ trunk/libs/local_function/doc/html/boost_localfunction/Tutorial.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -43,8 +43,8 @@

 Local functions are defined using macros from the header file <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>. The
 macros must be used 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++11
- lambda</a> functions which can instead be declared also within expressions):
+ with respect to __CPP11_lambda__ functions which can instead be declared
+ also within expressions):
 
<pre class="programlisting">#include <boost/local_function.hpp> // This library header.

@@ -92,7 +92,7 @@
 return x + y;
} BOOST_LOCAL_FUNCTION_NAME(add)

-BOOST_CHECK(add(1, 2) == 3); // Local function call.
+BOOST_TEST(add(1, 2) == 3); // Local function call.
</pre>

 
@@ -113,7 +113,7 @@
 return 10;
} BOOST_LOCAL_FUNCTION_NAME(ten)

-BOOST_CHECK(ten() == 10);
+BOOST_TEST(ten() == 10);
</pre>

 
@@ -202,8 +202,8 @@
 . However, if a bound variable was not declared constant in the enclosing
 scope then it will not be bound as constant unless constant binding is
 forced using <code class="computeroutput">const bind...</code>. (Note that binding by constant reference
- is not supported by <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions but it is supported by this library.) [<a name="boost_localfunction.Tutorial.Binding.f3" href="#ftn.boost_localfunction.Tutorial.Binding.f3" class="footnote">11</a>]
+ is not supported by __CPP11_lambda__ functions but it is supported by
+ this library.) [<a name="boost_localfunction.Tutorial.Binding.f3" href="#ftn.boost_localfunction.Tutorial.Binding.f3" class="footnote">11</a>]
 </li>
<li class="listitem">
 If a bound variable was declared as a reference in the enclosing scope,
@@ -231,7 +231,7 @@
 


-<pre class="programlisting">{ // Some local scope.
+<pre class="programlisting">int main(void) { // Some local scope.
 int sum = 0, factor = 10; // Variables in scope to bind.

 void BOOST_LOCAL_FUNCTION(const bind factor, bind& sum, int num) {
@@ -242,7 +242,8 @@
 int nums[] = {2, 3};
 std::for_each(nums, nums + 2, add); // Pass it to an algorithm.

- BOOST_CHECK(sum == 60); // Assert final summation value.
+ BOOST_TEST(sum == 60); // Assert final summation value.
+ return boost::report_errors();
}
</pre>

@@ -377,10 +378,10 @@
T total(const T& x, const T& y, const T& z) {
 T sum = T(), factor = 10;

- // Using the `..._TPL` macro.
+ // Must use the `..._TPL` macros within templates.
 T BOOST_LOCAL_FUNCTION_TPL(const bind factor, bind& sum, T num) {
 return sum += factor * num;
- } BOOST_LOCAL_FUNCTION_NAME(add)
+ } BOOST_LOCAL_FUNCTION_NAME_TPL(add)

 add(x);
 T nums[2]; nums[0] = y; nums[1] = z;
@@ -411,9 +412,9 @@
 would no longer be useful to pinpoint errors.
 </div>
<div class="footnote">[<a id="ftn.boost_localfunction.Tutorial.local_functions.f2" href="#boost_localfunction.Tutorial.local_functions.f2" class="para">7</a>] 
- Rationale. The C++03
- standard does not allow to pass empty parameters to a macro so the macro
- cannot be invoked as <code class="computeroutput">BOOST_LOCAL_FUNCTION()</code>. On C99
+ Rationale. The __CPP03__ standard does
+ not allow to pass empty parameters to a macro so the macro cannot be invoked
+ as <code class="computeroutput">BOOST_LOCAL_FUNCTION()</code>. On C99
 compilers with properly implemented empty macro parameter support, it would
 be possible to allow <code class="computeroutput">BOOST_LOCAL_FUNCTION()</code> but this is already not the case for
 MSVC so this syntax is never allowed to ensure better portability.
@@ -519,8 +520,8 @@
<div class="footnote">[<a id="ftn.boost_localfunction.Tutorial.templates.f0" href="#boost_localfunction.Tutorial.templates.f0" class="para">16</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++03
- does not allow to use <code class="computeroutput">typename</code>
+ indicate that some expressions evaluate to a type. Because __CPP03__ does
+ not allow to use <code class="computeroutput">typename</code>
 outside templates, the special <code class="computeroutput">TPL</code>
 macro is used to indicate that the enclosing scope is a template so this
 library can safely use <code class="computeroutput">typename</code>

Modified: trunk/libs/local_function/doc/html/index.html
==============================================================================
--- trunk/libs/local_function/doc/html/index.html (original)
+++ trunk/libs/local_function/doc/html/index.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -45,7 +45,6 @@
<dt><a href="boost_localfunction/Getting_Started.html#boost_localfunction.Getting_Started.compilers_and_platforms">Compilers
 and Platforms</a></dt>
<dt>Installation</dt>
-<dt>Configuration</dt>
</dl></dd>
<dt>Tutorial</dt>
<dd><dl>
@@ -61,8 +60,8 @@
 Parameters</a></dt>
<dt><a href="boost_localfunction/Advanced_Topics.html#boost_localfunction.Advanced_Topics.commas_and_symbols_in_macros">Commas
 and Symbols in Macros</a></dt>
-<dt><a href="boost_localfunction/Advanced_Topics.html#boost_localfunction.Advanced_Topics.assigning_and_returning">Assigning
- and Returning</a></dt>
+<dt><a href="boost_localfunction/Advanced_Topics.html#boost_localfunction.Advanced_Topics.assignments_and_returns">Assignments
+ and Returns</a></dt>
<dt>Nesting</dt>
<dt><a href="boost_localfunction/Advanced_Topics.html#boost_localfunction.Advanced_Topics.accessing_types__concepts__etc_">Accessing
 Types (concepts, etc)</a></dt>
@@ -94,15 +93,15 @@
 Nested Functions</a></dt>
<dt>N-Papers</dt>
</dl></dd>
+<dt>Annex: Alternatives</dt>
+<dt><a href="boost_localfunction/No_Variadic_Macros.html">Annex: No Variadic
+ Macros</a></dt>
+<dt>Annex: Implementation</dt>
<dt>Reference</dt>
<dd><dl>
<dt>Header <boost/local_function.hpp></dt>
<dt>Header <boost/local_function/config.hpp></dt>
</dl></dd>
-<dt>Annex: Alternatives</dt>
-<dt><a href="boost_localfunction/No_Variadic_Macros.html">Annex: No Variadic
- Macros</a></dt>
-<dt>Annex: Implementation</dt>
<dt>Release Notes</dt>
<dt>Bibliography</dt>
<dt>Acknowledgments</dt>
@@ -129,12 +128,13 @@
 

 Using <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions, it is possible to implement local functions by naming
- the lambdas assigning them to local variables. For example (see also add_lambda.cpp):
+ lambda functions</a>, it is possible to implement local functions by naming
+ the lambda functions assigning them to local variables. For example (see also
+ add_cxx11_lambda.cpp):
 


-<pre class="programlisting">{ // Some local scope.
+<pre class="programlisting">int main(void) { // Some local scope.
 int sum = 0, factor = 10; // Variables in scope to bind.

 auto add = [factor, &sum](int num) { // C++11 only.
@@ -145,7 +145,8 @@
 int nums[] = {2, 3};
 std::for_each(nums, nums + 2, add); // Pass it to an algorithm.

- BOOST_CHECK(sum == 60); // Assert final summation value.
+ BOOST_TEST(sum == 60); // Assert final summation value.
+ return boost::report_errors();
}
</pre>

@@ -153,13 +154,12 @@

 This library allows to program local functions portably between C++03
 and C++11 (and
- with performances comparable to lambdas on C++11
- compilers, see the <a class="link" href="boost_localfunction/Alternatives.html" title="Annex: Alternatives">Alternatives</a>
- section). For example (see also add.cpp):
+ with performances comparable to lambda functions on C++11
+ compilers). For example (see also add.cpp):
 


-<pre class="programlisting">{ // Some local scope.
+<pre class="programlisting">int main(void) { // Some local scope.
 int sum = 0, factor = 10; // Variables in scope to bind.

 void BOOST_LOCAL_FUNCTION(const bind factor, bind& sum, int num) {
@@ -170,7 +170,8 @@
 int nums[] = {2, 3};
 std::for_each(nums, nums + 2, add); // Pass it to an algorithm.

- BOOST_CHECK(sum == 60); // Assert final summation value.
+ BOOST_TEST(sum == 60); // Assert final summation value.
+ return boost::report_errors();
}
</pre>

@@ -202,7 +203,7 @@

 See the <a class="link" href="boost_localfunction/Alternatives.html" title="Annex: Alternatives">Alternatives</a>
 section for a comparison between this library, <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions, Boost.Phoenix,
+ lambda functions</a>, Boost.Phoenix,
 and other C++ techniques that implement features related to local functions.
 
</div>
@@ -217,14 +218,14 @@
 </div>
<div class="footnote">[<a id="ftn.boost_localfunction.Introduction.f1" href="#boost_localfunction.Introduction.f1" class="para">2</a>] 
 This is a weakness with respect to <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++11
- lambda</a> functions which can instead be specified also within expressions
+ lambda functions</a> which can instead be specified also within expressions
 (see the <a class="link" href="boost_localfunction/Alternatives.html" title="Annex: Alternatives">Alternatives</a>
 section).
 </div>
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left">Last revised: March 22, 2012 at 20:50:10 GMT</td>
+<td align="left">Last revised: April 10, 2012 at 22:33:23 GMT</td>
<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>

Modified: trunk/libs/local_function/doc/html/reference.html
==============================================================================
--- trunk/libs/local_function/doc/html/reference.html (original)
+++ trunk/libs/local_function/doc/html/reference.html 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
<link rel="up" href="index.html" title="Chapter 1. Boost.LocalFunction 1.0.0">
-<link rel="prev" href="boost_localfunction/Examples.html" title="Examples">
+<link rel="prev" href="boost_localfunction/Implementation.html" title="Annex: Implementation">
<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">
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="boost_localfunction/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="BOOST_LOCAL_FUNCTION.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+<a accesskey="p" href="boost_localfunction/Implementation.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_FUNCTION.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
</div>
<div class="section reference">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
@@ -39,6 +39,7 @@
<a class="link" href="BOOST_LOCAL_FUNCTION_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_TPL">BOOST_LOCAL_FUNCTION_TPL</a>(declarations)
<a class="link" href="BOOST_LOCAL_FUNCTION_ID.html" title="Macro BOOST_LOCAL_FUNCTION_ID">BOOST_LOCAL_FUNCTION_ID</a>(id, within_template, declarations)
<a class="link" href="BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a>(qualified_function_name)
+<a class="link" href="BOOST_LOCAL_FUNCTION_NAME_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_NAME_TPL">BOOST_LOCAL_FUNCTION_NAME_TPL</a>(qualified_function_name)
<a class="link" href="BOOST_LOCAL_FUNCTION_TYPEOF.html" title="Macro BOOST_LOCAL_FUNCTION_TYPEOF">BOOST_LOCAL_FUNCTION_TYPEOF</a>(bound_variable_name)</pre>
</div>
<div class="section header_boost_local_function_config_hpp">
@@ -48,7 +49,8 @@
<pre class="synopsis">

<a class="link" href="BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX">BOOST_LOCAL_FUNCTION_CONFIG_ARITY_MAX</a>
-<a class="link" href="BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX">BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX</a></pre>
+<a class="link" href="BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX">BOOST_LOCAL_FUNCTION_CONFIG_BIND_MAX</a>
+<a class="link" href="BOOST_LOCAL_FUNCTION_CONFIG_LOCALS_AS_TPARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_CONFIG_LOCALS_AS_TPARAMS">BOOST_LOCAL_FUNCTION_CONFIG_LOCALS_AS_TPARAMS</a></pre>
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
@@ -62,7 +64,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="boost_localfunction/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="BOOST_LOCAL_FUNCTION.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+<a accesskey="p" href="boost_localfunction/Implementation.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_FUNCTION.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: trunk/libs/local_function/doc/introduction.qbk
==============================================================================
--- trunk/libs/local_function/doc/introduction.qbk (original)
+++ trunk/libs/local_function/doc/introduction.qbk 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -9,14 +9,14 @@

/Local functions/ are a form of /information hiding/ and they 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 [@http://en.wikipedia.org/wiki/Nested_function#An_example Pascal] and [@http://en.wikipedia.org/wiki/Nesting_(computing)#In_programming Ada], yet lacking from __CPP03__ (see also __N2511__).
+Local functions are a feature of many programming languages, notably [@http://en.wikipedia.org/wiki/Nested_function#An_example Pascal] and [@http://en.wikipedia.org/wiki/Nesting_(computing)#In_programming Ada], yet lacking from __CXX03__ (see also __N2511__).

-Using __CPP11_lambda__ functions, it is possible to implement local functions by naming the lambdas assigning them to local variables.
-For example (see also [@../../test/add_lambda.cpp =add_lambda.cpp=]):
+Using __CXX11_lambda_functions__, it is possible to implement local functions by naming the lambda functions assigning them to local variables.
+For example (see also [@../../example/add_cxx11_lambda.cpp =add_cxx11_lambda.cpp=]):

-[add_lambda]
+[add_cxx11_lambda]

-This library allows to program local functions portably between __CPP03__ and __CPP11__ (and with performances comparable to lambdas on __CPP11__ compilers, see the __Alternatives__ section).
+This library allows to program local functions portably between __CXX03__ and __CXX11__ (and with performances comparable to lambda functions on __CXX11__ compilers).
For example (see also [@../../test/add.cpp =add.cpp=]):

[add]
@@ -27,14 +27,14 @@
* The local function body is programmed using the usual C++ statement syntax (as a consequence, compiler errors and debugging retain their usual meaning and format).
* Local functions can be passed as template parameters so they can be conveniently used with STL algorithms, etc.
[footnote
-This is a strength with respect to __CPP03__ functors implemented using local classes which cannot be passed as template parameters (see __N2657__ and the __Alternatives__ section).
+This is a strength with respect to __CXX03__ functors implemented using local classes which cannot be passed as template parameters (see __N2657__ and the __Alternatives__ section).
]
* However, local functions must be specified within a declarative context (e.g., at a point in the code where local variables can be declared) thus they cannot be specified within expressions.
[footnote
-This is a weakness with respect to __CPP11_lambda__ functions which can instead be specified also within expressions (see the __Alternatives__ section).
+This is a weakness with respect to __CXX11_lambda_functions__ which can instead be specified also within expressions (see the __Alternatives__ section).
]

-See the __Alternatives__ section for a comparison between this library, __CPP11_lambda__ functions, __Boost_Phoenix__, and other C++ techniques that implement features related to local functions.
+See the __Alternatives__ section for a comparison between this library, __CXX11_lambda_functions__, __Boost_Phoenix__, and other C++ techniques that implement features related to local functions.

[endsect]

Modified: trunk/libs/local_function/doc/local_function.qbk
==============================================================================
--- trunk/libs/local_function/doc/local_function.qbk (original)
+++ trunk/libs/local_function/doc/local_function.qbk 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -19,8 +19,8 @@
[category Function Objects and Higher-Order Programming]
]

-[def __CPP03__ [@http://www.open-std.org/JTC1/SC22/WG21/docs/standards C++03]]
-[def __CPP11__ [@http://www.open-std.org/JTC1/SC22/WG21/ C++11]]
+[def __CXX03__ [@http://www.open-std.org/JTC1/SC22/WG21/docs/standards C++03]]
+[def __CXX11__ [@http://www.open-std.org/JTC1/SC22/WG21/ C++11]]
[def __C99__ [@http://www.open-std.org/jtc1/sc22/wg14/www/projects#9899 C99]]
[def __Boost__ [@http://www.boost.org Boost]]
[def __Boost_LocalFunction__ [@http://www.boost.org/libs/local_function Boost.LocalFunction]]
@@ -38,7 +38,7 @@
[def __Boost_TypeTraits__ [@http://www.boost.org/libs/type_traits Boost.TypeTraits]]
[def __Boost_Utility_IdentityType__ [@http://www.boost.org/libs/utility/identity_type Boost.Utility/IdentityType]]
[def __Boost_Chrono__ [@http://www.boost.org/libs/chrono Boost.Chrono]]
-[def __CPP11_lambda__ [@http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions C++11 lambda]]
+[def __CXX11_lambda_functions__ [@http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions C++11 lambda functions]]
[def __LISP__ [@http://en.wikipedia.org/wiki/Lisp_(programming_language) LISP]]
[def __Contractpp__ [@http://sourceforge.net/projects/contractpp Contract++]]
[def __D_Programming_Language__ [@http://d.digitalmars.com D Programming Language]]
@@ -64,7 +64,6 @@

[import ../test/add.cpp]
[import ../test/add_seq.cpp]
-[import ../test/add_lambda.cpp]
[import ../test/add_params_only.cpp]
[import ../test/ten_void.cpp]
[import ../test/add_this.cpp]
@@ -87,16 +86,17 @@
[import ../test/goto_error.cpp]
[import ../test/same_line.cpp]

+[import ../example/add_cxx11_lambda.cpp]
[import ../example/gcc_lambda.cpp]
-[import ../example/gcc_lambda_cxx11.cpp]
+[import ../example/gcc_cxx11_lambda.cpp]
[import ../example/const_block_error.cpp]
[import ../example/scope_exit.cpp]
[import ../example/scope_exit.hpp]
[import ../example/phoenix_factorial_local.cpp]
[import ../example/phoenix_factorial.cpp]
-[import ../example/noncopyable_lambda_error.cpp]
+[import ../example/noncopyable_cxx11_lambda_error.cpp]
[import ../example/noncopyable_local_function.cpp]
-[import ../example/expensive_copy_lambda.cpp]
+[import ../example/expensive_copy_cxx11_lambda.cpp]
[import ../example/expensive_copy_local_function.cpp]
[import ../example/add_local_functor.cpp]
[import ../example/add_global_functor.cpp]
@@ -111,10 +111,10 @@
[include tutorial.qbk]
[include advanced_topics.qbk]
[include examples.qbk]
-[xinclude reference.xml]
[include alternatives.qbk]
[include no_variadic_macros.qbk]
[include implementation.qbk]
+[xinclude reference.xml]
[include release_notes.qbk]
[include bibliography.qbk]
[include acknowledgements.qbk]

Modified: trunk/libs/local_function/test/add_typed.cpp
==============================================================================
--- trunk/libs/local_function/test/add_typed.cpp (original)
+++ trunk/libs/local_function/test/add_typed.cpp 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -11,25 +11,20 @@
#else

#include <boost/local_function.hpp>
-#include <boost/typeof/typeof.hpp>
-#include BOOST_TYPEOF_INCREMENT_REGISTRATION_GROUP()
#include <boost/detail/lightweight_test.hpp>
#include <vector>
#include <algorithm>

//[add_typed
-struct adder;
-BOOST_TYPEOF_REGISTER_TYPE(adder) // Unfortunately needed for `..._NAME` below.
-
-struct adder {
- adder() : sum_(0) {}
+struct adder { // No type-of used (or registration needed) because...
+ adder(void) : sum_(0) {}

 int sum(const std::vector<int>& nums, const int& factor = 10) {
- // Explicitly specify bound variable and result types...
+ // ...explicitly specify bound variable types, return type, and ...
 BOOST_LOCAL_FUNCTION(const bind(const int&) factor,
- bind(adder*) this_, int num, return int) {
- return this_->sum_ += factor * num;
- } BOOST_LOCAL_FUNCTION_NAME(add) // ... but this still uses type-of.
+ bind(adder*) this_, int num, return void) {
+ this_->sum_ += factor * num;
+ } BOOST_LOCAL_FUNCTION_NAME((void (int)) add) // ...function type.

 std::for_each(nums.begin(), nums.end(), add);
 return sum_;

Modified: trunk/libs/local_function/test/add_typed_seq.cpp
==============================================================================
--- trunk/libs/local_function/test/add_typed_seq.cpp (original)
+++ trunk/libs/local_function/test/add_typed_seq.cpp 2012-04-11 01:47:37 EDT (Wed, 11 Apr 2012)
@@ -6,23 +6,18 @@
// Home at http://www.boost.org/libs/local_function

#include <boost/local_function.hpp>
-#include <boost/typeof/typeof.hpp>
-#include BOOST_TYPEOF_INCREMENT_REGISTRATION_GROUP()
#include <boost/detail/lightweight_test.hpp>
#include <vector>
#include <algorithm>

-struct adder;
-BOOST_TYPEOF_REGISTER_TYPE(adder) // Needed for `NAME` below.
-
struct adder {
- adder() : sum_(0) {}
+ adder(void) : sum_(0) {}

 int sum(const std::vector<int>& nums, const int& factor = 10) {
 BOOST_LOCAL_FUNCTION( (const bind(const int&) factor)
- (bind(adder*) this_) (int num) (return int) ) {
- return this_->sum_ += factor * num;
- } BOOST_LOCAL_FUNCTION_NAME(add)
+ (bind(adder*) this_) (int num) (return void) ) {
+ this_->sum_ += factor * num;
+ } BOOST_LOCAL_FUNCTION_NAME((void (int)) add)

 std::for_each(nums.begin(), nums.end(), add);
 return sum_;

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