Boost-Commit :

Date view	Thread view	Subject view	Author view

From: oryol_at_[hidden]
Date: 2008-07-25 20:02:32

Next message: oryol_at_[hidden]: "[Boost-commit] svn:boost r47823 - sandbox/boost/extension"
Previous message: daniel_james_at_[hidden]: "[Boost-commit] svn:boost r47821 - in branches/release: . tools/boostbook/xsl"

Author: jeremypack
Date: 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
New Revision: 47822
URL: http://svn.boost.org/trac/boost/changeset/47822

Log:
Doc updates - new second tutorial, modified tutorial 3.

Added examples.

Added:
   sandbox/libs/extension/doc/html/boost/extensions/basic_type_map/
   sandbox/libs/extension/doc/html/boost/extensions/basic_type_map/type_map_convertible/
   sandbox/libs/extension/doc/html/boost/extensions/basic_type_map/type_map_convertible.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost/extensions/basic_type_map/type_map_convertible/generic_type_holder.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost/extensions/basic_type_map/type_map_convertible/type_holder.html (contents, props changed)
   sandbox/libs/extension/doc/html/extension/
   sandbox/libs/extension/doc/html/extension/reference.html (contents, props changed)
   sandbox/libs/extension/doc/html/header/
   sandbox/libs/extension/doc/html/header/boost/
   sandbox/libs/extension/doc/html/header/boost/extension/
   sandbox/libs/extension/doc/html/header/boost/extension/convenience/
   sandbox/libs/extension/doc/html/header/boost/extension/convenience/hpp.html (contents, props changed)
   sandbox/libs/extension/doc/html/header/boost/extension/extension/
   sandbox/libs/extension/doc/html/header/boost/extension/extension/hpp.html (contents, props changed)
   sandbox/libs/extension/doc/html/header/boost/extension/factory/
   sandbox/libs/extension/doc/html/header/boost/extension/factory/hpp.html (contents, props changed)
   sandbox/libs/extension/doc/html/header/boost/extension/factory_map/
   sandbox/libs/extension/doc/html/header/boost/extension/factory_map/hpp.html (contents, props changed)
   sandbox/libs/extension/doc/html/header/boost/extension/filesystem/
   sandbox/libs/extension/doc/html/header/boost/extension/filesystem/hpp.html (contents, props changed)
   sandbox/libs/extension/doc/html/header/boost/extension/functor/
   sandbox/libs/extension/doc/html/header/boost/extension/functor/hpp.html (contents, props changed)
   sandbox/libs/extension/doc/html/header/boost/extension/shared_library/
   sandbox/libs/extension/doc/html/header/boost/extension/shared_library/hpp.html (contents, props changed)
   sandbox/libs/extension/examples/tutorial_1/
   sandbox/libs/extension/examples/tutorial_1/hello_world.cpp (contents, props changed)
   sandbox/libs/extension/examples/tutorial_1/main.cpp (contents, props changed)
   sandbox/libs/extension/examples/tutorial_2/
   sandbox/libs/extension/examples/tutorial_2/animal.hpp (contents, props changed)
   sandbox/libs/extension/examples/tutorial_2/factories_lib.cpp (contents, props changed)
   sandbox/libs/extension/examples/tutorial_2/factories_main.cpp (contents, props changed)
Text files modified:
   sandbox/libs/extension/doc/extension.qbk | 11 +
   sandbox/libs/extension/doc/html/BOOST_EXTENSION_EXPORT_DECL.html | 10
   sandbox/libs/extension/doc/html/BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html | 10
   sandbox/libs/extension/doc/html/boost/extensions/adaptable_factory.html | 44 ++--
   sandbox/libs/extension/doc/html/boost/extensions/basic_factory_map.html | 22 +-
   sandbox/libs/extension/doc/html/boost/extensions/basic_type_map.html | 24 +-
   sandbox/libs/extension/doc/html/boost/extensions/factory.html | 44 ++--
   sandbox/libs/extension/doc/html/boost/extensions/factory_map.html | 8
   sandbox/libs/extension/doc/html/boost/extensions/shared_library.html | 82 +++++++--
   sandbox/libs/extension/doc/html/boost/extensions/type_map.html | 2
   sandbox/libs/extension/doc/html/boost/reflections/basic_data_info.html | 26 +-
   sandbox/libs/extension/doc/html/boost/reflections/basic_parameter_map.html | 38 ++--
   sandbox/libs/extension/doc/html/boost/reflections/basic_reflection.html | 30 +-
   sandbox/libs/extension/doc/html/boost/reflections/basic_reflection/reflector.html | 32 ++--
   sandbox/libs/extension/doc/html/boost/reflections/conversion_not_found_exception.html | 12
   sandbox/libs/extension/doc/html/boost/reflections/data.html | 28 +-
   sandbox/libs/extension/doc/html/boost/reflections/generic_constructor.html | 24 +-
   sandbox/libs/extension/doc/html/boost/reflections/generic_parameter.html | 40 ++--
   sandbox/libs/extension/doc/html/boost/reflections/generic_parameter/basic_converter.html | 24 +-
   sandbox/libs/extension/doc/html/boost/reflections/instance.html | 20 +-
   sandbox/libs/extension/doc/html/boost/reflections/parameter.html | 36 ++--
   sandbox/libs/extension/doc/html/boost/reflections/parameter/default_converter.html | 18 +-
   sandbox/libs/extension/doc/html/boost/reflections/parameter/specialized_converter.html | 24 +-
   sandbox/libs/extension/doc/html/boost/reflections/parameter_map.html | 2
   sandbox/libs/extension/doc/html/boost/reflections/parameter_unavailable_exception.html | 16 +-
   sandbox/libs/extension/doc/html/boost_extension/appendices/appendix_a.html | 2
   sandbox/libs/extension/doc/html/boost_extension/performance_analysis.html | 6
   sandbox/libs/extension/doc/html/boost_extension/reference.html | 21 +-
   sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_class.html | 6
   sandbox/libs/extension/doc/html/boost_extension/tutorials.html | 50 +----
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial02.html | 313 +++++++++++++++++++++++++++------------
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial03.html | 298 ++++++++++++++++++++++++-------------
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial04.html | 3
   sandbox/libs/extension/doc/html/index.html | 28 ++
   sandbox/libs/extension/doc/tutorial1.qbk | 2
   sandbox/libs/extension/doc/tutorial2.qbk | 242 +++++++++++++++++++++---------
   sandbox/libs/extension/doc/tutorial3.qbk | 254 +++++++++++++++++++------------
   sandbox/libs/extension/doc/tutorials.qbk | 17 --
   sandbox/libs/extension/examples/Jamfile.v2 | 4
   sandbox/libs/extension/examples/multiple_inheritance/boat.cpp | 15 +
   sandbox/libs/extension/examples/multiple_inheritance/car.cpp | 15 +
   sandbox/libs/extension/examples/multiple_inheritance/car_of_the_future.cpp | 26 +-
   sandbox/libs/extension/examples/multiple_inheritance/computer.cpp | 14
   sandbox/libs/extension/examples/multiple_inheritance/flying_car.cpp | 24 +-
   sandbox/libs/extension/examples/multiple_inheritance/main_mi.cpp | 80 ++++-----
   sandbox/libs/extension/examples/multiple_inheritance/plane.cpp | 20 +-
   sandbox/libs/extension/examples/multiple_inheritance/vehicle.cpp | 13
   sandbox/libs/extension/test/Jamfile.v2 | 3
   48 files changed, 1232 insertions(+), 851 deletions(-)

Modified: sandbox/libs/extension/doc/extension.qbk
==============================================================================
--- sandbox/libs/extension/doc/extension.qbk (original)
+++ sandbox/libs/extension/doc/extension.qbk 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -17,11 +17,12 @@
         [@http://www.boost.org/LICENSE_1_0.txt http://www.boost.org/LICENSE_1_0.txt])
     ]
     [category Programming Interfaces]
- [last-revision $Date: 2008/7/23 21:36:00 $]
+ [last-revision $Date: 2008/7/25 7:36:00 $]
]

[def _shared_library_ [^[classref boost::extensions::shared_library shared_library]]]
+[def _shared_library_get_ [^[funcref boost::extensions::shared_library::get shared_library::get]]]
[def _factory_map_ [^[classref boost::extensions::factory_map factory_map]]]
[def _factory_ [^[classref boost::extensions::factory factory]]]
[def _type_map_ [^[classref boost::extensions::type_map type_map]]]
@@ -61,11 +62,15 @@

Tutorials:

-* [link tutorial01 Tutorial 1: The shared_library class]
+* [link boost_extension.tutorials.tutorial01 Tutorial 1 - `shared_library` class]
+* [link boost_extension.tutorials.tutorial02 Tutorial 2 - `factory` class]
+* [link boost_extension.tutorials.tutorial03 Tutorial 3 - Multiple and Implementation Inheritance]

Other Sections:

-* [link motivation Motivation]
+* [link boost_extension.motivation Motivation]
+* [link boost_extension.shared_libraries Shared Libraries]
+* [link boost_extension.extension_reflection Extension/Reflection Interoperability]

The other sections in the documentation should be updated over the next few weeks, in
preparation for review.

Modified: sandbox/libs/extension/doc/html/BOOST_EXTENSION_EXPORT_DECL.html
==============================================================================
--- sandbox/libs/extension/doc/html/BOOST_EXTENSION_EXPORT_DECL.html (original)
+++ sandbox/libs/extension/doc/html/BOOST_EXTENSION_EXPORT_DECL.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -6,8 +6,8 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="index.html" title="Chapter 1. Boost.Extension">
<link rel="up" href="boost_extension/reference.html#header.boost.extension.extension.hpp" title="Header <boost/extension/extension.hpp>">
-<link rel="prev" href="boost/extensions/load_single_library.html" title="Function load_single_library">
-<link rel="next" href="boost/extensions/factory.html" title="Class template factory">
+<link rel="prev" href="boost/extensions/load_single_library_id294352.html" title="Function load_single_library">
+<link rel="next" href="boost/extensions/basic_factory_map.html" title="Class template basic_factory_map">
</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/extensions/load_single_library.html"><img src="../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="boost_extension/reference.html#header.boost.extension.extension.hpp"><img src="../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="boost/extensions/factory.html"><img src="../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="boost/extensions/load_single_library_id294352.html"><img src="../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="boost_extension/reference.html#header.boost.extension.extension.hpp"><img src="../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="boost/extensions/basic_factory_map.html"><img src="../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="BOOST_EXTENSION_EXPORT_DECL"></a><div class="titlepage"></div>
@@ -31,7 +31,7 @@
<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">BOOST_EXTENSION_EXPORT_DECL</pre></div>
<div class="refsect1" lang="en">
-<a name="id449932"></a><h2>Description</h2>
+<a name="id458574"></a><h2>Description</h2>
Macro to place in a function definition to cause it to be exported, if necessary on the given platform and with the current compiler settings. This is always required for MSVC and other compilers, but only required depending on compiler settings for GCC and other compilers. 
</div>
</div>
@@ -45,7 +45,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="boost/extensions/load_single_library.html"><img src="../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="boost_extension/reference.html#header.boost.extension.extension.hpp"><img src="../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="boost/extensions/factory.html"><img src="../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="boost/extensions/load_single_library_id294352.html"><img src="../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="boost_extension/reference.html#header.boost.extension.extension.hpp"><img src="../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="boost/extensions/basic_factory_map.html"><img src="../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html
==============================================================================
--- sandbox/libs/extension/doc/html/BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html (original)
+++ sandbox/libs/extension/doc/html/BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -6,8 +6,8 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="index.html" title="Chapter 1. Boost.Extension">
<link rel="up" href="boost_extension/reference.html#header.boost.extension.common.hpp" title="Header <boost/extension/common.hpp>">
-<link rel="prev" href="boost_extension/reference.html" title="Reference">
-<link rel="next" href="boost/extensions/load_single_library.html" title="Function load_single_library">
+<link rel="prev" href="BOOST_REFLECTION_MAX_FUNCTOR_PARAMS.html" title="Macro BOOST_REFLECTION_MAX_FUNCTOR_PARAMS">
+<link rel="next" href="BOOST_PP_ITERATION_LIMITS_id295262.html" title="Macro BOOST_PP_ITERATION_LIMITS">
</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_extension/reference.html"><img src="../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="boost_extension/reference.html#header.boost.extension.common.hpp"><img src="../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="boost/extensions/load_single_library.html"><img src="../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="BOOST_REFLECTION_MAX_FUNCTOR_PARAMS.html"><img src="../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="boost_extension/reference.html#header.boost.extension.common.hpp"><img src="../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_PP_ITERATION_LIMITS_id295262.html"><img src="../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="BOOST_EXTENSION_MAX_FUNCTOR_PARAMS"></a><div class="titlepage"></div>
@@ -31,7 +31,7 @@
<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">BOOST_EXTENSION_MAX_FUNCTOR_PARAMS</pre></div>
<div class="refsect1" lang="en">
-<a name="id449650"></a><h2>Description</h2>
+<a name="id462200"></a><h2>Description</h2>
This determines the maximum number of parameters that a constructor or exported shared library function can have. 10 is the same default as Boost.Function. 
</div>
</div>
@@ -45,7 +45,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="boost_extension/reference.html"><img src="../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="boost_extension/reference.html#header.boost.extension.common.hpp"><img src="../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="boost/extensions/load_single_library.html"><img src="../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="BOOST_REFLECTION_MAX_FUNCTOR_PARAMS.html"><img src="../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="boost_extension/reference.html#header.boost.extension.common.hpp"><img src="../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_PP_ITERATION_LIMITS_id295262.html"><img src="../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost/extensions/adaptable_factory.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/extensions/adaptable_factory.html (original)
+++ sandbox/libs/extension/doc/html/boost/extensions/adaptable_factory.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -7,7 +7,7 @@
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension">
<link rel="up" href="../../boost_extension/reference.html#header.boost.extension.adaptable_factory.hpp" title="Header <boost/extension/adaptable_factory.hpp>">
<link rel="prev" href="../../boost_extension/reference.html" title="Reference">
-<link rel="next" href="load_single_library_id292277.html" title="Function load_single_library">
+<link rel="next" href="load_single_library_id294352.html" title="Function load_single_library">
</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_extension/reference.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.adaptable_factory.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="load_single_library_id292277.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../../boost_extension/reference.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.adaptable_factory.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="load_single_library_id294352.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="boost.extensions.adaptable_factory"></a><div class="titlepage"></div>
@@ -34,37 +34,37 @@
class adaptable_factory {
public:
 // construct/copy/destruct
- adaptable_factory();
- adaptable_factory(adaptable_factory< Interface > const &);
- adaptable_factory& operator=(adaptable_factory< Interface > const &);
+ adaptable_factory();
+ adaptable_factory(adaptable_factory< Interface > const &);
+ adaptable_factory& operator=(adaptable_factory< Interface > const &);

- // public member functions
- Interface * create(boost::reflections::parameter_map &) const;
+ // public member functions
+ Interface * create(boost::reflections::parameter_map &) const;
 std::map< TypeInfo, Info >
- get_missing_parameter_list(const boost::reflections::parameter_map &) const;
- bool is_valid() const;
- template<typename Derived, typename Params...> void set(Info) ;
+ get_missing_parameter_list(const boost::reflections::parameter_map &) const;
+ bool is_valid() const;
+ template<typename Derived, typename Params...> void set(Info) ;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id455677"></a><h2>Description</h2>
+<a name="id457818"></a><h2>Description</h2>
This class is a function object that returns new instances of type Interface, using factories that take parameters described in the variable length list Params... 
<div class="refsect2" lang="en">
-<a name="id455687"></a><h3>
+<a name="id457828"></a><h3>
<a name="boost.extensions.adaptable_factoryconstruct-copy-destruct"></a><code class="computeroutput">adaptable_factory</code>
 public
 construct/copy/destruct</h3>
<div class="orderedlist"><ol type="1">
-<li><pre class="literallayout"><a name="id292240-bb"></a>adaptable_factory();</pre></li>
-<li><pre class="literallayout"><a name="id292244-bb"></a>adaptable_factory(adaptable_factory< Interface > const & first);</pre></li>
-<li><pre class="literallayout">adaptable_factory& <a name="id292255-bb"></a>operator=(adaptable_factory< Interface > const & first);</pre></li>
+<li><pre class="literallayout"><a name="id294314-bb"></a>adaptable_factory();</pre></li>
+<li><pre class="literallayout"><a name="id294319-bb"></a>adaptable_factory(adaptable_factory< Interface > const & first);</pre></li>
+<li><pre class="literallayout">adaptable_factory& <a name="id294329-bb"></a>operator=(adaptable_factory< Interface > const & first);</pre></li>
</ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id455798"></a><h3>
-<a name="id292102-bb"></a><code class="computeroutput">adaptable_factory</code> public member functions</h3>
+<a name="id457939"></a><h3>
+<a name="id294176-bb"></a><code class="computeroutput">adaptable_factory</code> public member functions</h3>
<div class="orderedlist"><ol type="1">
<li>
-<pre class="literallayout">Interface * <a name="id292105-bb"></a>create(boost::reflections::parameter_map & map) const;</pre>
+<pre class="literallayout">Interface * <a name="id294179-bb"></a>create(boost::reflections::parameter_map & map) const;</pre>
Returns an instance of Interface (but does NOT retain ownership of the instance).

@@ -105,7 +105,7 @@
</li>
<li>
<pre class="literallayout">std::map< TypeInfo, Info >
-<a name="id292138-bb"></a>get_missing_parameter_list(const boost::reflections::parameter_map & map) const;</pre>
+<a name="id294213-bb"></a>get_missing_parameter_list(const boost::reflections::parameter_map & map) const;</pre>
Returns a map of the TypeInfo/Info pairs describing any parameters still needed before this function can be called.

@@ -145,7 +145,7 @@
</table></div>
</li>
<li>
-<pre class="literallayout">bool <a name="id292175-bb"></a>is_valid() const;</pre>
+<pre class="literallayout">bool <a name="id294250-bb"></a>is_valid() const;</pre>
Until set is called, a adaptable_factory cannot be used. This function can be used to determine if set has been called.

@@ -173,7 +173,7 @@
</li>
<li>
<pre class="literallayout">template<typename Derived, typename Params...>
- void <a name="id292201-bb"></a>set(Info parameter_names...) ;</pre>
+ void <a name="id294276-bb"></a>set(Info parameter_names...) ;</pre>
This sets the factory function to the constructor for type D. It takes as arguments Info about each parameter in the constructor.

@@ -208,7 +208,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../../boost_extension/reference.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.adaptable_factory.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="load_single_library_id292277.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../../boost_extension/reference.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.adaptable_factory.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="load_single_library_id294352.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost/extensions/basic_factory_map.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/extensions/basic_factory_map.html (original)
+++ sandbox/libs/extension/doc/html/boost/extensions/basic_factory_map.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -33,32 +33,32 @@
class basic_factory_map {
public:
 // construct/copy/destruct
- ~basic_factory_map();
+ ~basic_factory_map();

- // public member functions
+ // public member functions
 template<typename Interface, typename Info, typename Params...>
- std::map< Info, factory< Interface, Params...> > & get() ;
+ std::map< Info, factory< Interface, Params...> > & get() ;
 template<typename Interface, typename Info, typename Params...>
- operator std::map< Info, factory< Interface, Params...> > &() ;
+ operator std::map< Info, factory< Interface, Params...> > &() ;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id456712"></a><h2>Description</h2>
+<a name="id458846"></a><h2>Description</h2>


<div class="refsect2" lang="en">
-<a name="id456720"></a><h3>
+<a name="id458853"></a><h3>
<a name="boost.extensions.basic_factory_mapconstruct-copy-destruct"></a><code class="computeroutput">basic_factory_map</code>
 public
 construct/copy/destruct</h3>
-<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id292467-bb"></a>~basic_factory_map();</pre></li></ol></div>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id294537-bb"></a>~basic_factory_map();</pre></li></ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id456760"></a><h3>
-<a name="id292397-bb"></a><code class="computeroutput">basic_factory_map</code> public member functions</h3>
+<a name="id458893"></a><h3>
+<a name="id294466-bb"></a><code class="computeroutput">basic_factory_map</code> public member functions</h3>
<div class="orderedlist"><ol type="1">
<li>
<pre class="literallayout">template<typename Interface, typename Info, typename Params...>
- std::map< Info, factory< Interface, Params...> > & <a name="id292400-bb"></a>get() ;</pre>
+ std::map< Info, factory< Interface, Params...> > & <a name="id294469-bb"></a>get() ;</pre>


This returns a map of the given type of factories. It can return an empty map if no such factories are found. 
@@ -73,7 +73,7 @@
</li>
<li>
<pre class="literallayout">template<typename Interface, typename Info, typename Params...>
- <a name="id292436-bb"></a>operator std::map< Info, factory< Interface, Params...> > &() ;</pre>
+ <a name="id294506-bb"></a>operator std::map< Info, factory< Interface, Params...> > &() ;</pre>
A conversion operator for convenience in calling functions that take a map of factories. This is identical to the get() function. 
</li>
</ol></div>

Modified: sandbox/libs/extension/doc/html/boost/extensions/basic_type_map.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/extensions/basic_type_map.html (original)
+++ sandbox/libs/extension/doc/html/boost/extensions/basic_type_map.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -38,7 +38,7 @@

 struct generic_type_holder {
 // construct/copy/destruct
- ~generic_type_holder();
+ ~generic_type_holder();
 };
 template<typename T>
 struct type_holder : public boost::extensions::basic_type_map< TypeInfo >::type_map_convertible::generic_type_holder
@@ -46,26 +46,26 @@
 T val;
 };
 // construct/copy/destruct
- ~type_map_convertible();
+ ~type_map_convertible();

- // public member functions
- template<typename Type> operator Type &() ;
+ // public member functions
+ template<typename Type> operator Type &() ;
 };

- // public member functions
- type_map_convertible & get() ;
- template<typename Type> Type & get() ;
+ // public member functions
+ type_map_convertible & get() ;
+ template<typename Type> Type & get() ;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id458116"></a><h2>Description</h2>
+<a name="id460386"></a><h2>Description</h2>


<div class="refsect2" lang="en">
-<a name="id458124"></a><h3>
-<a name="id292787-bb"></a><code class="computeroutput">basic_type_map</code> public member functions</h3>
+<a name="id460393"></a><h3>
+<a name="id294902-bb"></a><code class="computeroutput">basic_type_map</code> public member functions</h3>
<div class="orderedlist"><ol type="1">
-<li><pre class="literallayout">type_map_convertible & <a name="id292790-bb"></a>get() ;</pre></li>
-<li><pre class="literallayout">template<typename Type> Type & <a name="id292797-bb"></a>get() ;</pre></li>
+<li><pre class="literallayout">type_map_convertible & <a name="id294905-bb"></a>get() ;</pre></li>
+<li><pre class="literallayout">template<typename Type> Type & <a name="id294912-bb"></a>get() ;</pre></li>
</ol></div>
</div>
</div>

Added: sandbox/libs/extension/doc/html/boost/extensions/basic_type_map/type_map_convertible.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/boost/extensions/basic_type_map/type_map_convertible.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,81 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Class type_map_convertible</title>
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Boost.Extension">
+<link rel="up" href="../basic_type_map.html#id460386" title="Description">
+<link rel="prev" href="../shared_library.html" title="Class shared_library">
+<link rel="next" href="type_map_convertible/generic_type_holder.html" title="Struct generic_type_holder">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../shared_library.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../basic_type_map.html#id460386"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="type_map_convertible/generic_type_holder.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry" lang="en">
+<a name="boost.extensions.basic_type_map.type_map_convertible"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Class type_map_convertible</h2>
+boost::extensions::basic_type_map::type_map_convertible — 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">
+
+class type_map_convertible {
+public:
+
+ struct generic_type_holder {
+ // construct/copy/destruct
+ ~generic_type_holder();
+ };
+ template<typename T>
+ struct type_holder : public boost::extensions::basic_type_map< TypeInfo >::type_map_convertible::generic_type_holder
+ {
+ T val;
+ };
+ // construct/copy/destruct
+ ~type_map_convertible();
+
+ // public member functions
+ template<typename Type> operator Type &() ;
+};</pre></div>
+<div class="refsect1" lang="en">
+<a name="id460645"></a><h2>Description</h2>
+<div class="refsect2" lang="en">
+<a name="id460650"></a><h3>
+<a name="boost.extensions.basic_type_map.type_map_convertibleconstruct-copy-destruct"></a><code class="computeroutput">type_map_convertible</code>
+ public
+ construct/copy/destruct</h3>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id294901-bb"></a>~type_map_convertible();</pre></li></ol></div>
+</div>
+<div class="refsect2" lang="en">
+<a name="id460693"></a><h3>
+<a name="id294885-bb"></a><code class="computeroutput">type_map_convertible</code> public member functions</h3>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout">template<typename Type> <a name="id294888-bb"></a>operator Type &() ;</pre></li></ol></div>
+</div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../shared_library.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../basic_type_map.html#id460386"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="type_map_convertible/generic_type_holder.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/boost/extensions/basic_type_map/type_map_convertible/generic_type_holder.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/boost/extensions/basic_type_map/type_map_convertible/generic_type_holder.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,62 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Struct generic_type_holder</title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Boost.Extension">
+<link rel="up" href="../type_map_convertible.html#id460645" title="Description">
+<link rel="prev" href="../../shared_library.html" title="Class shared_library">
+<link rel="next" href="type_holder.html" title="Struct template type_holder">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../shared_library.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../type_map_convertible.html#id460645"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="type_holder.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry" lang="en">
+<a name="boost.extensions.basic_type_map.type_map_convertible.generic_type_holder"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Struct generic_type_holder</h2>
+boost::extensions::basic_type_map::type_map_convertible::generic_type_holder — 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">
+
+struct generic_type_holder {
+ // construct/copy/destruct
+ ~generic_type_holder();
+};</pre></div>
+<div class="refsect1" lang="en">
+<a name="id460810"></a><h2>Description</h2>
+<div class="refsect2" lang="en">
+<a name="id460815"></a><h3>
+<a name="boost.extensions.basic_type_map.type_map_convertible.generic_type_holderconstruct-copy-destruct"></a><code class="computeroutput">generic_type_holder</code>
+ public
+ construct/copy/destruct</h3>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id294865-bb"></a>~generic_type_holder();</pre></li></ol></div>
+</div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../shared_library.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../type_map_convertible.html#id460645"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="type_holder.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/boost/extensions/basic_type_map/type_map_convertible/type_holder.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/boost/extensions/basic_type_map/type_map_convertible/type_holder.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,52 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Struct template type_holder</title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Boost.Extension">
+<link rel="up" href="../type_map_convertible.html#id460645" title="Description">
+<link rel="prev" href="generic_type_holder.html" title="Struct generic_type_holder">
+<link rel="next" href="../../type_map.html" title="Type definition type_map">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="generic_type_holder.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../type_map_convertible.html#id460645"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../type_map.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry" lang="en">
+<a name="boost.extensions.basic_type_map.type_map_convertible.type_holder"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Struct template type_holder</h2>
+boost::extensions::basic_type_map::type_map_convertible::type_holder — 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">
+template<typename T>
+struct type_holder : public boost::extensions::basic_type_map< TypeInfo >::type_map_convertible::generic_type_holder
+{
+ T val;
+};</pre></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="generic_type_holder.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../type_map_convertible.html#id460645"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../type_map.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Modified: sandbox/libs/extension/doc/html/boost/extensions/factory.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/extensions/factory.html (original)
+++ sandbox/libs/extension/doc/html/boost/extensions/factory.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -6,8 +6,8 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension">
<link rel="up" href="../../boost_extension/reference.html#header.boost.extension.factory.hpp" title="Header <boost/extension/factory.hpp>">
-<link rel="prev" href="../../BOOST_REFLECTION_CONSTRUCTI_FUNCTION_id293418.html" title="Macro BOOST_REFLECTION_CONSTRUCTI_FUNCTION">
-<link rel="next" href="../../BOOST_PP_ITERATION_LIMITS_id293579.html" title="Macro BOOST_PP_ITERATION_LIMITS">
+<link rel="prev" href="../../BOOST_REFLECTION_CONSTRUCTI_FUNCTION_id295534.html" title="Macro BOOST_REFLECTION_CONSTRUCTI_FUNCTION">
+<link rel="next" href="../../BOOST_PP_ITERATION_LIMITS_id295694.html" title="Macro BOOST_PP_ITERATION_LIMITS">
</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_REFLECTION_CONSTRUCTI_FUNCTION_id293418.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.factory.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../BOOST_PP_ITERATION_LIMITS_id293579.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../../BOOST_REFLECTION_CONSTRUCTI_FUNCTION_id295534.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.factory.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../BOOST_PP_ITERATION_LIMITS_id295694.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="boost.extensions.factory"></a><div class="titlepage"></div>
@@ -33,39 +33,39 @@
class factory {
public:
 // construct/copy/destruct
- factory();
- factory(factory< T > const &);
- factory& operator=(factory< T > const &);
-
- // public member functions
- template<typename D> void set() ;
- bool is_valid() const;
- T * create(Params...) const;
+ factory();
+ factory(factory< T > const &);
+ factory& operator=(factory< T > const &);
+
+ // public member functions
+ template<typename D> void set() ;
+ bool is_valid() const;
+ T * create(Params...) const;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id461460"></a><h2>Description</h2>
+<a name="id463734"></a><h2>Description</h2>
This class is a function object that returns new instances of type T, using factories that take parameters described in the variable length list Params... 
<div class="refsect2" lang="en">
-<a name="id461470"></a><h3>
+<a name="id463744"></a><h3>
<a name="boost.extensions.factoryconstruct-copy-destruct"></a><code class="computeroutput">factory</code>
 public
 construct/copy/destruct</h3>
<div class="orderedlist"><ol type="1">
-<li><pre class="literallayout"><a name="id293537-bb"></a>factory();</pre></li>
-<li><pre class="literallayout"><a name="id293541-bb"></a>factory(factory< T > const & first);</pre></li>
-<li><pre class="literallayout">factory& <a name="id293552-bb"></a>operator=(factory< T > const & first);</pre></li>
+<li><pre class="literallayout"><a name="id295652-bb"></a>factory();</pre></li>
+<li><pre class="literallayout"><a name="id295657-bb"></a>factory(factory< T > const & first);</pre></li>
+<li><pre class="literallayout">factory& <a name="id295667-bb"></a>operator=(factory< T > const & first);</pre></li>
</ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id461577"></a><h3>
-<a name="id293461-bb"></a><code class="computeroutput">factory</code> public member functions</h3>
+<a name="id463851"></a><h3>
+<a name="id295576-bb"></a><code class="computeroutput">factory</code> public member functions</h3>
<div class="orderedlist"><ol type="1">
<li>
-<pre class="literallayout">template<typename D> void <a name="id293464-bb"></a>set() ;</pre>
+<pre class="literallayout">template<typename D> void <a name="id295579-bb"></a>set() ;</pre>
This sets the factory function to the constructor for type D. Example: factory<Base, int, int> f; f.set<Derived>(); 
</li>
<li>
-<pre class="literallayout">bool <a name="id293485-bb"></a>is_valid() const;</pre>
+<pre class="literallayout">bool <a name="id295600-bb"></a>is_valid() const;</pre>
Until set is called, a factory cannot be used. This function can be used to determine if set has been called.

@@ -92,7 +92,7 @@
</table></div>
</li>
<li>
-<pre class="literallayout">T * <a name="id293511-bb"></a>create(Params...) const;</pre>
+<pre class="literallayout">T * <a name="id295626-bb"></a>create(Params...) const;</pre>
Returns an instance of T (but does NOT retain ownership of the instance).

@@ -133,7 +133,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../../BOOST_REFLECTION_CONSTRUCTI_FUNCTION_id293418.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.factory.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../BOOST_PP_ITERATION_LIMITS_id293579.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../../BOOST_REFLECTION_CONSTRUCTI_FUNCTION_id295534.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.factory.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../BOOST_PP_ITERATION_LIMITS_id295694.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost/extensions/factory_map.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/extensions/factory_map.html (original)
+++ sandbox/libs/extension/doc/html/boost/extensions/factory_map.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -7,7 +7,7 @@
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension">
<link rel="up" href="../../boost_extension/reference.html#header.boost.extension.factory_map.hpp" title="Header <boost/extension/factory_map.hpp>">
<link rel="prev" href="basic_factory_map.html" title="Class template basic_factory_map">
-<link rel="next" href="../../BOOST_PP_ITERATION_LIMITS_id292527.html" title="Macro BOOST_PP_ITERATION_LIMITS">
+<link rel="next" href="../../BOOST_PP_ITERATION_LIMITS_id294597.html" title="Macro BOOST_PP_ITERATION_LIMITS">
</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="basic_factory_map.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.factory_map.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../BOOST_PP_ITERATION_LIMITS_id292527.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="basic_factory_map.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.factory_map.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../BOOST_PP_ITERATION_LIMITS_id294597.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="boost.extensions.factory_map"></a><div class="titlepage"></div>
@@ -32,7 +32,7 @@
<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">
typedef basic_factory_map< default_type_info > factory_map;</pre></div>
<div class="refsect1" lang="en">
-<a name="id456938"></a><h2>Description</h2>
+<a name="id459072"></a><h2>Description</h2>
A typedef for convenience - provides the most common type of basic_factory_map. 
</div>
</div>
@@ -46,7 +46,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="basic_factory_map.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.factory_map.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../BOOST_PP_ITERATION_LIMITS_id292527.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="basic_factory_map.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.factory_map.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../BOOST_PP_ITERATION_LIMITS_id294597.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost/extensions/shared_library.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/extensions/shared_library.html (original)
+++ sandbox/libs/extension/doc/html/boost/extensions/shared_library.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension">
<link rel="up" href="../../boost_extension/reference.html#header.boost.extension.shared_library.hpp" title="Header <boost/extension/shared_library.hpp>">
-<link rel="prev" href="../../BOOST_PP_FILENAME_1_id292533.html" title="Macro BOOST_PP_FILENAME_1">
+<link rel="prev" href="../../BOOST_PP_FILENAME_1_id294603.html" title="Macro BOOST_PP_FILENAME_1">
<link rel="next" href="basic_type_map.html" title="Class template basic_type_map">
</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_PP_FILENAME_1_id292533.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.shared_library.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="basic_type_map.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../../BOOST_PP_FILENAME_1_id294603.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.shared_library.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="basic_type_map.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="boost.extensions.shared_library"></a><div class="titlepage"></div>
@@ -33,28 +33,29 @@
class shared_library {
public:
 // construct/copy/destruct
- shared_library(const std::string &, bool = false);
- ~shared_library();
+ shared_library(const std::string &, bool = false);
+ ~shared_library();

- // public member functions
- bool is_open() const;
- bool open() ;
- bool close() ;
+ // public member functions
+ bool is_open() const;
+ bool open() ;
+ bool close() ;
+ template<typename TypeInfo> bool call(basic_type_map< TypeInfo > &) ;
 template<typename RetValue, typename Params...>
- FunctionPtr< ReturnValue(Params...)> get(const std::string &) const;
+ FunctionPtr< ReturnValue(Params...)> get(const std::string &) const;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id457366"></a><h2>Description</h2>
+<a name="id459537"></a><h2>Description</h2>


<div class="refsect2" lang="en">
-<a name="id457373"></a><h3>
+<a name="id459544"></a><h3>
<a name="boost.extensions.shared_libraryconstruct-copy-destruct"></a><code class="computeroutput">shared_library</code>
 public
 construct/copy/destruct</h3>
<div class="orderedlist"><ol type="1">
<li>
-<pre class="literallayout"><a name="id292685-bb"></a>shared_library(const std::string & location, bool auto_close = false);</pre>
+<pre class="literallayout"><a name="id294800-bb"></a>shared_library(const std::string & location, bool auto_close = false);</pre>
shared_library constructor

<div class="variablelist"><table border="0">
@@ -81,17 +82,17 @@
</table></div>
</li>
<li>
-<pre class="literallayout"><a name="id292711-bb"></a>~shared_library();</pre>
+<pre class="literallayout"><a name="id294826-bb"></a>~shared_library();</pre>
shared_library destructor If auto_close_ was set to true in the constructor, this closes the library if it is currently open. 
</li>
</ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id457490"></a><h3>
-<a name="id292558-bb"></a><code class="computeroutput">shared_library</code> public member functions</h3>
+<a name="id459660"></a><h3>
+<a name="id294628-bb"></a><code class="computeroutput">shared_library</code> public member functions</h3>
<div class="orderedlist"><ol type="1">
<li>
-<pre class="literallayout">bool <a name="id292561-bb"></a>is_open() const;</pre>
+<pre class="literallayout">bool <a name="id294630-bb"></a>is_open() const;</pre>


@@ -118,7 +119,7 @@
</table></div>
</li>
<li>
-<pre class="literallayout">bool <a name="id292582-bb"></a>open() ;</pre>
+<pre class="literallayout">bool <a name="id294652-bb"></a>open() ;</pre>


@@ -145,7 +146,7 @@
</table></div>
</li>
<li>
-<pre class="literallayout">bool <a name="id292606-bb"></a>close() ;</pre>
+<pre class="literallayout">bool <a name="id294676-bb"></a>close() ;</pre>


@@ -172,8 +173,49 @@
</table></div>
</li>
<li>
+<pre class="literallayout">template<typename TypeInfo> bool <a name="id294703-bb"></a>call(basic_type_map< TypeInfo > & types) ;</pre>
+There is a special function called boost_extension_exported_type_map_function which is commonly used by shared libraries. The call function attempts to find and call that function, given a type_map.
+
+
+
+
+
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td>
+Parameters:</td>
+<td><div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody><tr>
+<td>
+<code class="computeroutput">types</code></td>
+<td>A type_map that will be sent to the function. </td>
+</tr></tbody>
+</table></div></td>
+</tr>
+<tr>
+<td>
+Requires:</td>
+<td>is_open() == true </td>
+</tr>
+<tr>
+<td>
+Postconditions:</td>
+<td>None. </td>
+</tr>
+<tr>
+<td>
+Returns:</td>
+<td>true on success. </td>
+</tr>
+</tbody>
+</table></div>
+</li>
+<li>
<pre class="literallayout">template<typename RetValue, typename Params...>
- FunctionPtr< ReturnValue(Params...)> <a name="id292633-bb"></a>get(const std::string & name) const;</pre>
+ FunctionPtr< ReturnValue(Params...)> <a name="id294749-bb"></a>get(const std::string & name) const;</pre>
A templated function taking as template arguments the type of the return value and parameters of a function to look up in the shared library.
This function must have been declared with the same parameters and return type and marked as extern "C".
Depending on platform and compiler settings, it may also be necessary to prefix the function with BOOST_EXTENSION_DECL, to make it externally visible.
@@ -212,7 +254,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../../BOOST_PP_FILENAME_1_id292533.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.shared_library.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="basic_type_map.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../../BOOST_PP_FILENAME_1_id294603.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.extension.shared_library.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="basic_type_map.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost/extensions/type_map.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/extensions/type_map.html (original)
+++ sandbox/libs/extension/doc/html/boost/extensions/type_map.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -32,7 +32,7 @@
<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">
typedef basic_type_map< default_type_info > type_map;</pre></div>
<div class="refsect1" lang="en">
-<a name="id458690"></a><h2>Description</h2>
+<a name="id460960"></a><h2>Description</h2>
A typedef for convenience - provides the most common type of basic_factory_map. 
</div>
</div>

Modified: sandbox/libs/extension/doc/html/boost/reflections/basic_data_info.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/basic_data_info.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/basic_data_info.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -32,32 +32,32 @@
<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">template<typename Info, typename TypeInfo>
struct basic_data_info {
 // construct/copy/destruct
- basic_data_info(TypeInfo, Info);
- basic_data_info(const basic_data_info &);
- basic_data_info& operator=(basic_data_info &);
+ basic_data_info(TypeInfo, Info);
+ basic_data_info(const basic_data_info &);
+ basic_data_info& operator=(basic_data_info &);

- // public member functions
- BOOST_CONCEPT_ASSERT((LessThanComparable< TypeInfo >)) ;
+ // public member functions
+ BOOST_CONCEPT_ASSERT((LessThanComparable< TypeInfo >)) ;
 TypeInfo type_info_;
 Info info_;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id460891"></a><h2>Description</h2>
+<a name="id463163"></a><h2>Description</h2>
<div class="refsect2" lang="en">
-<a name="id460896"></a><h3>
+<a name="id463168"></a><h3>
<a name="boost.reflections.basic_data_infoconstruct-copy-destruct"></a><code class="computeroutput">basic_data_info</code>
 public
 construct/copy/destruct</h3>
<div class="orderedlist"><ol type="1">
-<li><pre class="literallayout"><a name="id293346-bb"></a>basic_data_info(TypeInfo t, Info i);</pre></li>
-<li><pre class="literallayout"><a name="id293357-bb"></a>basic_data_info(const basic_data_info & s);</pre></li>
-<li><pre class="literallayout">basic_data_info& <a name="id293363-bb"></a>operator=(basic_data_info & s);</pre></li>
+<li><pre class="literallayout"><a name="id295461-bb"></a>basic_data_info(TypeInfo t, Info i);</pre></li>
+<li><pre class="literallayout"><a name="id295473-bb"></a>basic_data_info(const basic_data_info & s);</pre></li>
+<li><pre class="literallayout">basic_data_info& <a name="id295479-bb"></a>operator=(basic_data_info & s);</pre></li>
</ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id460983"></a><h3>
-<a name="id293331-bb"></a><code class="computeroutput">basic_data_info</code> public member functions</h3>
-<div class="orderedlist"><ol type="1"><li><pre class="literallayout"> <a name="id293334-bb"></a>BOOST_CONCEPT_ASSERT((LessThanComparable< TypeInfo >)) ;</pre></li></ol></div>
+<a name="id463255"></a><h3>
+<a name="id295447-bb"></a><code class="computeroutput">basic_data_info</code> public member functions</h3>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout"> <a name="id295450-bb"></a>BOOST_CONCEPT_ASSERT((LessThanComparable< TypeInfo >)) ;</pre></li></ol></div>
</div>
</div>
</div>

Modified: sandbox/libs/extension/doc/html/boost/reflections/basic_parameter_map.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/basic_parameter_map.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/basic_parameter_map.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -38,42 +38,42 @@
 typedef std::multimap< Info, generic_parameter< TypeInfo > * > <a name="boost.reflections.basic_parameter_map.map_type"></a>map_type;

 // construct/copy/destruct
- ~basic_parameter_map();
- ~basic_parameter_map();
+ ~basic_parameter_map();
+ ~basic_parameter_map();

- // public member functions
+ // public member functions
 template<typename D>
- std::vector< generic_parameter< TypeInfo > * > get(Info) ;
+ std::vector< generic_parameter< TypeInfo > * > get(Info) ;
 template<typename D>
- std::vector< const generic_parameter< TypeInfo > * > get(Info) const;
+ std::vector< const generic_parameter< TypeInfo > * > get(Info) const;
 template<typename D>
- std::vector< generic_parameter< TypeInfo > * > get(Info) ;
- template<typename D> bool has(Info) const;
- template<typename D> generic_parameter< TypeInfo > * get_first(Info) ;
+ std::vector< generic_parameter< TypeInfo > * > get(Info) ;
+ template<typename D> bool has(Info) const;
+ template<typename D> generic_parameter< TypeInfo > * get_first(Info) ;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id459291"></a><h2>Description</h2>
+<a name="id461560"></a><h2>Description</h2>
The basic_parameter_map is designed to hold arbitrary data indexed by the value of the Info parameter, and can return all items that match a certain type and Info parameter, ie all integers called "foobar". 
<div class="refsect2" lang="en">
-<a name="id459302"></a><h3>
+<a name="id461570"></a><h3>
<a name="boost.reflections.basic_parameter_mapconstruct-copy-destruct"></a><code class="computeroutput">basic_parameter_map</code>
 public
 construct/copy/destruct</h3>
<div class="orderedlist"><ol type="1">
<li>
-<pre class="literallayout"><a name="id293095-bb"></a>~basic_parameter_map();</pre>
+<pre class="literallayout"><a name="id295211-bb"></a>~basic_parameter_map();</pre>
The destructor deletes all of the parameters that it references. 
</li>
-<li><pre class="literallayout"><a name="id293101-bb"></a>~basic_parameter_map();</pre></li>
+<li><pre class="literallayout"><a name="id295216-bb"></a>~basic_parameter_map();</pre></li>
</ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id459362"></a><h3>
-<a name="id292890-bb"></a><code class="computeroutput">basic_parameter_map</code> public member functions</h3>
+<a name="id461631"></a><h3>
+<a name="id295005-bb"></a><code class="computeroutput">basic_parameter_map</code> public member functions</h3>
<div class="orderedlist"><ol type="1">
<li>
<pre class="literallayout">template<typename D>
- std::vector< generic_parameter< TypeInfo > * > <a name="id292893-bb"></a>get(Info info) ;</pre>
+ std::vector< generic_parameter< TypeInfo > * > <a name="id295008-bb"></a>get(Info info) ;</pre>
Given an Info value and a type, this will return all parameters that either match the given type or are convertible to the given type.

@@ -115,7 +115,7 @@
</li>
<li>
<pre class="literallayout">template<typename D>
- std::vector< const generic_parameter< TypeInfo > * > <a name="id292935-bb"></a>get(Info info) const;</pre>
+ std::vector< const generic_parameter< TypeInfo > * > <a name="id295051-bb"></a>get(Info info) const;</pre>
Given an Info value and a type, this will return all parameters that either match the given type or are convertible to the given type. This function is const.

@@ -157,7 +157,7 @@
</li>
<li>
<pre class="literallayout">template<typename D>
- std::vector< generic_parameter< TypeInfo > * > <a name="id292979-bb"></a>get(Info info) ;</pre>
+ std::vector< generic_parameter< TypeInfo > * > <a name="id295094-bb"></a>get(Info info) ;</pre>
Given a type (D) and Info (ie, string describing the parameter), return a vector containing all generic_parameters that match, or can be converted to the given type.


@@ -187,7 +187,7 @@
</table></div>
</li>
<li>
-<pre class="literallayout">template<typename D> bool <a name="id293019-bb"></a>has(Info info) const;</pre>
+<pre class="literallayout">template<typename D> bool <a name="id295134-bb"></a>has(Info info) const;</pre>
Given a type (D) and Info (ie, string describing the parameter), return true if the element exists in the parameter_map.


@@ -217,7 +217,7 @@
</table></div>
</li>
<li>
-<pre class="literallayout">template<typename D> generic_parameter< TypeInfo > * <a name="id293057-bb"></a>get_first(Info info) ;</pre>
+<pre class="literallayout">template<typename D> generic_parameter< TypeInfo > * <a name="id295172-bb"></a>get_first(Info info) ;</pre>
Given a type (D) and Info (ie, string describing the parameter), return first parameter matching, or that can be converted to that type.

Modified: sandbox/libs/extension/doc/html/boost/reflections/basic_reflection.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/basic_reflection.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/basic_reflection.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -44,30 +44,30 @@
 typedef basic_constructor_info< TypeInfo, ParameterInfo > constructor_info;

 // construct/copy/destruct
- reflector(basic_reflection< Info, ParameterInfo, TypeInfo > *);
+ reflector(basic_reflection< Info, ParameterInfo, TypeInfo > *);

- // public member functions
- template<typename Params...> reflector & constructor() ;
- template<typename Data> reflector & data(Data T::*, Info) ;
+ // public member functions
+ template<typename Params...> reflector & constructor() ;
+ template<typename Data> reflector & data(Data T::*, Info) ;
 template<typename ReturnValue = void, typename Params...>
- reflector & function(void(T::*)(), Info) ;
+ reflector & function(void(T::*)(), Info) ;
 };

- // public member functions
+ // public member functions
 template<typename Params...>
- instance_constructor< Params...> get_constructor() const;
- template<typename Data> data< Data > get_data(Info) const;
- template<typename T> reflector< T > reflect() ;
+ instance_constructor< Params...> get_constructor() const;
+ template<typename Data> data< Data > get_data(Info) const;
+ template<typename T> reflector< T > reflect() ;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id465290"></a><h2>Description</h2>
+<a name="id467550"></a><h2>Description</h2>
<div class="refsect2" lang="en">
-<a name="id465295"></a><h3>
-<a name="id294252-bb"></a><code class="computeroutput">basic_reflection</code> public member functions</h3>
+<a name="id467556"></a><h3>
+<a name="id296368-bb"></a><code class="computeroutput">basic_reflection</code> public member functions</h3>
<div class="orderedlist"><ol type="1">
<li>
<pre class="literallayout">template<typename Params...>
- instance_constructor< Params...> <a name="id294255-bb"></a>get_constructor() const;</pre>
+ instance_constructor< Params...> <a name="id296370-bb"></a>get_constructor() const;</pre>


Attempt to retrieve any constructor whose Params match the list in Params... For example: 
@@ -103,7 +103,7 @@
</table></div>
</li>
<li>
-<pre class="literallayout">template<typename Data> data< Data > <a name="id294293-bb"></a>get_data(Info info) const;</pre>
+<pre class="literallayout">template<typename Data> data< Data > <a name="id296409-bb"></a>get_data(Info info) const;</pre>


Attempt to retrieve any data of type Data and the same Info. For example: 
@@ -140,7 +140,7 @@
</table></div>
</li>
<li>
-<pre class="literallayout">template<typename T> reflector< T > <a name="id294336-bb"></a>reflect() ;</pre>
+<pre class="literallayout">template<typename T> reflector< T > <a name="id296455-bb"></a>reflect() ;</pre>

Modified: sandbox/libs/extension/doc/html/boost/reflections/basic_reflection/reflector.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/basic_reflection/reflector.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/basic_reflection/reflector.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -5,7 +5,7 @@
<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../../index.html" title="Chapter 1. Boost.Extension">
-<link rel="up" href="../basic_reflection.html#id465290" title="Description">
+<link rel="up" href="../basic_reflection.html#id467550" title="Description">
<link rel="prev" href="../parameter/specialized_converter.html" title="Class template specialized_converter">
<link rel="next" href="../../../boost_extension/appendices/appendix_a.html" title=" Appendix A -
 Windows Export and Import Declarations">
@@ -21,7 +21,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../parameter/specialized_converter.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../basic_reflection.html#id465290"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../boost_extension/appendices/appendix_a.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../parameter/specialized_converter.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../basic_reflection.html#id467550"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../boost_extension/appendices/appendix_a.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="boost.reflections.basic_reflection.reflector"></a><div class="titlepage"></div>
@@ -40,16 +40,16 @@
 typedef basic_constructor_info< TypeInfo, ParameterInfo > <a name="boost.reflections.basic_reflection.reflector.constructor_info"></a>constructor_info;

 // construct/copy/destruct
- reflector(basic_reflection< Info, ParameterInfo, TypeInfo > *);
+ reflector(basic_reflection< Info, ParameterInfo, TypeInfo > *);

- // public member functions
- template<typename Params...> reflector & constructor() ;
- template<typename Data> reflector & data(Data T::*, Info) ;
+ // public member functions
+ template<typename Params...> reflector & constructor() ;
+ template<typename Data> reflector & data(Data T::*, Info) ;
 template<typename ReturnValue = void, typename Params...>
- reflector & function(void(T::*)(), Info) ;
+ reflector & function(void(T::*)(), Info) ;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id465794"></a><h2>Description</h2>
+<a name="id468055"></a><h2>Description</h2>
The reflector class is returned by the reflect method, and can then be used to reflect constructors, functions or data. It is normally used chained: 
<pre class="programlisting"> reflection r;
 r.reflect<MyClass>()
@@ -58,12 +58,12 @@
</pre>
 
<div class="refsect2" lang="en">
-<a name="id465812"></a><h3>
+<a name="id468073"></a><h3>
<a name="boost.reflections.basic_reflection.reflectorconstruct-copy-destruct"></a><code class="computeroutput">reflector</code>
 public
 construct/copy/destruct</h3>
<div class="orderedlist"><ol type="1"><li>
-<pre class="literallayout"><a name="id294223-bb"></a>reflector(basic_reflection< Info, ParameterInfo, TypeInfo > * current_reflection);</pre>
+<pre class="literallayout"><a name="id296338-bb"></a>reflector(basic_reflection< Info, ParameterInfo, TypeInfo > * current_reflection);</pre>
Initialize with a pointer to the reflection this reflector will be reflecting into. This is called by the reflection::reflect function.

@@ -98,11 +98,11 @@
</li></ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id465902"></a><h3>
-<a name="id294089-bb"></a><code class="computeroutput">reflector</code> public member functions</h3>
+<a name="id468163"></a><h3>
+<a name="id296204-bb"></a><code class="computeroutput">reflector</code> public member functions</h3>
<div class="orderedlist"><ol type="1">
<li>
-<pre class="literallayout">template<typename Params...> reflector & <a name="id294092-bb"></a>constructor() ;</pre>
+<pre class="literallayout">template<typename Params...> reflector & <a name="id296207-bb"></a>constructor() ;</pre>


@@ -130,7 +130,7 @@
</table></div>
</li>
<li>
-<pre class="literallayout">template<typename Data> reflector & <a name="id294124-bb"></a>data(Data T::* data_ptr, Info info) ;</pre>
+<pre class="literallayout">template<typename Data> reflector & <a name="id296240-bb"></a>data(Data T::* data_ptr, Info info) ;</pre>


@@ -173,7 +173,7 @@
</li>
<li>
<pre class="literallayout">template<typename ReturnValue = void, typename Params...>
- reflector & <a name="id294170-bb"></a>function(void(T::*)() func, Info info) ;</pre>
+ reflector & <a name="id296286-bb"></a>function(void(T::*)() func, Info info) ;</pre>


@@ -228,7 +228,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../parameter/specialized_converter.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../basic_reflection.html#id465290"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../boost_extension/appendices/appendix_a.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../parameter/specialized_converter.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../basic_reflection.html#id467550"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../boost_extension/appendices/appendix_a.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost/reflections/conversion_not_found_exception.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/conversion_not_found_exception.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/conversion_not_found_exception.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -33,15 +33,15 @@
class conversion_not_found_exception {
public:

- // public member functions
- const char * what() ;
+ // public member functions
+ const char * what() ;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id462930"></a><h2>Description</h2>
+<a name="id465200"></a><h2>Description</h2>
<div class="refsect2" lang="en">
-<a name="id462935"></a><h3>
-<a name="id293755-bb"></a><code class="computeroutput">conversion_not_found_exception</code> public member functions</h3>
-<div class="orderedlist"><ol type="1"><li><pre class="literallayout">const char * <a name="id293758-bb"></a>what() ;</pre></li></ol></div>
+<a name="id465205"></a><h3>
+<a name="id295870-bb"></a><code class="computeroutput">conversion_not_found_exception</code> public member functions</h3>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout">const char * <a name="id295873-bb"></a>what() ;</pre></li></ol></div>
</div>
</div>
</div>

Modified: sandbox/libs/extension/doc/html/boost/reflections/data.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/data.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/data.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension">
<link rel="up" href="../../boost_extension/reference.html#header.boost.reflection.data.hpp" title="Header <boost/reflection/data.hpp>">
-<link rel="prev" href="../../basic_constructor_info_TypeInfo__id293156.html" title="Struct template basic_constructor_info<TypeInfo>">
+<link rel="prev" href="../../basic_constructor_info_TypeInfo__id295272.html" title="Struct template basic_constructor_info<TypeInfo>">
<link rel="next" href="basic_data_info.html" title="Struct template basic_data_info">
</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="../../basic_constructor_info_TypeInfo__id293156.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.reflection.data.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="basic_data_info.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../../basic_constructor_info_TypeInfo__id295272.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.reflection.data.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="basic_data_info.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="boost.reflections.data"></a><div class="titlepage"></div>
@@ -33,28 +33,28 @@
class data {
public:
 // construct/copy/destruct
- data(impl::MemberPtr = 0, T &(*)(void *, impl::MemberPtr) = 0);
+ data(impl::MemberPtr = 0, T &(*)(void *, impl::MemberPtr) = 0);

- // public member functions
- T & operator()(instance &) const;
- bool valid() const;
+ // public member functions
+ T & operator()(instance &) const;
+ bool valid() const;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id460553"></a><h2>Description</h2>
+<a name="id462824"></a><h2>Description</h2>
<div class="refsect2" lang="en">
-<a name="id460558"></a><h3>
+<a name="id462829"></a><h3>
<a name="boost.reflections.dataconstruct-copy-destruct"></a><code class="computeroutput">data</code>
 public
 construct/copy/destruct</h3>
-<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id293250-bb"></a>data(impl::MemberPtr data_ptr = 0,
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id295366-bb"></a>data(impl::MemberPtr data_ptr = 0,
 T &(*)(void *, impl::MemberPtr) conversion_function = 0);</pre></li></ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id460605"></a><h3>
-<a name="id293229-bb"></a><code class="computeroutput">data</code> public member functions</h3>
+<a name="id462877"></a><h3>
+<a name="id295344-bb"></a><code class="computeroutput">data</code> public member functions</h3>
<div class="orderedlist"><ol type="1">
-<li><pre class="literallayout">T & <a name="id293232-bb"></a>operator()(instance & inst) const;</pre></li>
-<li><pre class="literallayout">bool <a name="id293244-bb"></a>valid() const;</pre></li>
+<li><pre class="literallayout">T & <a name="id295347-bb"></a>operator()(instance & inst) const;</pre></li>
+<li><pre class="literallayout">bool <a name="id295359-bb"></a>valid() const;</pre></li>
</ol></div>
</div>
</div>
@@ -69,7 +69,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../../basic_constructor_info_TypeInfo__id293156.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.reflection.data.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="basic_data_info.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../../basic_constructor_info_TypeInfo__id295272.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.reflection.data.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="basic_data_info.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost/reflections/generic_constructor.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/generic_constructor.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/generic_constructor.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension">
<link rel="up" href="../../boost_extension/reference.html#header.boost.reflection.generic_constructor.hpp" title="Header <boost/reflection/generic_constructor.hpp>">
-<link rel="prev" href="../../basic_function_info_Info,_TypeInfo__id293588.html" title="Struct template basic_function_info<Info, TypeInfo>">
+<link rel="prev" href="../../basic_function_info_Info,_TypeInfo__id295704.html" title="Struct template basic_function_info<Info, TypeInfo>">
<link rel="next" href="instance.html" title="Class instance">
</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="../../basic_function_info_Info,_TypeInfo__id293588.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.reflection.generic_constructor.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="instance.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../../basic_function_info_Info,_TypeInfo__id295704.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.reflection.generic_constructor.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="instance.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="boost.reflections.generic_constructor"></a><div class="titlepage"></div>
@@ -33,24 +33,24 @@
class generic_constructor {
public:
 // construct/copy/destruct
- ~generic_constructor();
+ ~generic_constructor();

- // public member functions
- T * create(void **) const;
+ // public member functions
+ T * create(void **) const;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id462348"></a><h2>Description</h2>
+<a name="id464619"></a><h2>Description</h2>
<div class="refsect2" lang="en">
-<a name="id462353"></a><h3>
+<a name="id464624"></a><h3>
<a name="boost.reflections.generic_constructorconstruct-copy-destruct"></a><code class="computeroutput">generic_constructor</code>
 public
 construct/copy/destruct</h3>
-<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id293699-bb"></a>~generic_constructor();</pre></li></ol></div>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id295814-bb"></a>~generic_constructor();</pre></li></ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id462394"></a><h3>
-<a name="id293684-bb"></a><code class="computeroutput">generic_constructor</code> public member functions</h3>
-<div class="orderedlist"><ol type="1"><li><pre class="literallayout">T * <a name="id293687-bb"></a>create(void ** params) const;</pre></li></ol></div>
+<a name="id464665"></a><h3>
+<a name="id295799-bb"></a><code class="computeroutput">generic_constructor</code> public member functions</h3>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout">T * <a name="id295802-bb"></a>create(void ** params) const;</pre></li></ol></div>
</div>
</div>
</div>
@@ -64,7 +64,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../../basic_function_info_Info,_TypeInfo__id293588.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.reflection.generic_constructor.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="instance.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../../basic_function_info_Info,_TypeInfo__id295704.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../boost_extension/reference.html#header.boost.reflection.generic_constructor.hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="instance.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost/reflections/generic_parameter.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/generic_parameter.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/generic_parameter.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -38,42 +38,42 @@
 class basic_converter {
 public:
 // construct/copy/destruct
- ~basic_converter();
+ ~basic_converter();

- // public member functions
- void convert(void *, void *) const;
+ // public member functions
+ void convert(void *, void *) const;
 };

 // construct/copy/destruct
- generic_parameter(void *);
- ~generic_parameter();
+ generic_parameter(void *);
+ ~generic_parameter();

- // public member functions
- TypeInfo type() const;
- template<typename T> bool can_cast() const;
- template<typename S> S cast() const;
- template<typename S> void cast(S *) ;
+ // public member functions
+ TypeInfo type() const;
+ template<typename T> bool can_cast() const;
+ template<typename S> S cast() const;
+ template<typename S> void cast(S *) ;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id463318"></a><h2>Description</h2>
+<a name="id465584"></a><h2>Description</h2>
<div class="refsect2" lang="en">
-<a name="id463323"></a><h3>
+<a name="id465589"></a><h3>
<a name="boost.reflections.generic_parameterconstruct-copy-destruct"></a><code class="computeroutput">generic_parameter</code>
 public
 construct/copy/destruct</h3>
<div class="orderedlist"><ol type="1">
-<li><pre class="literallayout"><a name="id293863-bb"></a>generic_parameter(void * value);</pre></li>
-<li><pre class="literallayout"><a name="id293859-bb"></a>~generic_parameter();</pre></li>
+<li><pre class="literallayout"><a name="id295979-bb"></a>generic_parameter(void * value);</pre></li>
+<li><pre class="literallayout"><a name="id295975-bb"></a>~generic_parameter();</pre></li>
</ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id463386"></a><h3>
-<a name="id293805-bb"></a><code class="computeroutput">generic_parameter</code> public member functions</h3>
+<a name="id465652"></a><h3>
+<a name="id295921-bb"></a><code class="computeroutput">generic_parameter</code> public member functions</h3>
<div class="orderedlist"><ol type="1">
-<li><pre class="literallayout">TypeInfo <a name="id293808-bb"></a>type() const;</pre></li>
-<li><pre class="literallayout">template<typename T> bool <a name="id293815-bb"></a>can_cast() const;</pre></li>
-<li><pre class="literallayout">template<typename S> S <a name="id293828-bb"></a>cast() const;</pre></li>
-<li><pre class="literallayout">template<typename S> void <a name="id293841-bb"></a>cast(S * dest) ;</pre></li>
+<li><pre class="literallayout">TypeInfo <a name="id295924-bb"></a>type() const;</pre></li>
+<li><pre class="literallayout">template<typename T> bool <a name="id295930-bb"></a>can_cast() const;</pre></li>
+<li><pre class="literallayout">template<typename S> S <a name="id295944-bb"></a>cast() const;</pre></li>
+<li><pre class="literallayout">template<typename S> void <a name="id295957-bb"></a>cast(S * dest) ;</pre></li>
</ol></div>
</div>
</div>

Modified: sandbox/libs/extension/doc/html/boost/reflections/generic_parameter/basic_converter.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/generic_parameter/basic_converter.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/generic_parameter/basic_converter.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -5,7 +5,7 @@
<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../../index.html" title="Chapter 1. Boost.Extension">
-<link rel="up" href="../generic_parameter.html#id463318" title="Description">
+<link rel="up" href="../generic_parameter.html#id465584" title="Description">
<link rel="prev" href="../conversion_not_found_exception.html" title="Class conversion_not_found_exception">
<link rel="next" href="../parameter.html" title="Class template parameter">
</head>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../conversion_not_found_exception.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generic_parameter.html#id463318"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../parameter.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../conversion_not_found_exception.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generic_parameter.html#id465584"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../parameter.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="boost.reflections.generic_parameter.basic_converter"></a><div class="titlepage"></div>
@@ -34,24 +34,24 @@
class basic_converter {
public:
 // construct/copy/destruct
- ~basic_converter();
+ ~basic_converter();

- // public member functions
- void convert(void *, void *) const;
+ // public member functions
+ void convert(void *, void *) const;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id463654"></a><h2>Description</h2>
+<a name="id465919"></a><h2>Description</h2>
<div class="refsect2" lang="en">
-<a name="id463660"></a><h3>
+<a name="id465924"></a><h3>
<a name="boost.reflections.generic_parameter.basic_converterconstruct-copy-destruct"></a><code class="computeroutput">basic_converter</code>
 public
 construct/copy/destruct</h3>
-<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id293799-bb"></a>~basic_converter();</pre></li></ol></div>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id295914-bb"></a>~basic_converter();</pre></li></ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id463701"></a><h3>
-<a name="id293779-bb"></a><code class="computeroutput">basic_converter</code> public member functions</h3>
-<div class="orderedlist"><ol type="1"><li><pre class="literallayout">void <a name="id293782-bb"></a>convert(void * src, void * dest) const;</pre></li></ol></div>
+<a name="id465965"></a><h3>
+<a name="id295894-bb"></a><code class="computeroutput">basic_converter</code> public member functions</h3>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout">void <a name="id295897-bb"></a>convert(void * src, void * dest) const;</pre></li></ol></div>
</div>
</div>
</div>
@@ -65,7 +65,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../conversion_not_found_exception.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generic_parameter.html#id463318"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../parameter.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../conversion_not_found_exception.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generic_parameter.html#id465584"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../parameter.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost/reflections/instance.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/instance.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/instance.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -33,23 +33,23 @@
class instance {
public:
 // construct/copy/destruct
- instance(void * = 0, void(*)(void *val) = 0);
- instance(const instance &);
- instance& operator=(instance &);
- ~instance();
+ instance(void * = 0, void(*)(void *val) = 0);
+ instance(const instance &);
+ instance& operator=(instance &);
+ ~instance();
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id462614"></a><h2>Description</h2>
+<a name="id464885"></a><h2>Description</h2>
<div class="refsect2" lang="en">
-<a name="id462620"></a><h3>
+<a name="id464890"></a><h3>
<a name="boost.reflections.instanceconstruct-copy-destruct"></a><code class="computeroutput">instance</code>
 public
 construct/copy/destruct</h3>
<div class="orderedlist"><ol type="1">
-<li><pre class="literallayout"><a name="id293714-bb"></a>instance(void * val = 0, void(*)(void *val) destructor = 0);</pre></li>
-<li><pre class="literallayout"><a name="id293731-bb"></a>instance(const instance & first);</pre></li>
-<li><pre class="literallayout">instance& <a name="id293737-bb"></a>operator=(instance & first);</pre></li>
-<li><pre class="literallayout"><a name="id293730-bb"></a>~instance();</pre></li>
+<li><pre class="literallayout"><a name="id295830-bb"></a>instance(void * val = 0, void(*)(void *val) destructor = 0);</pre></li>
+<li><pre class="literallayout"><a name="id295846-bb"></a>instance(const instance & first);</pre></li>
+<li><pre class="literallayout">instance& <a name="id295853-bb"></a>operator=(instance & first);</pre></li>
+<li><pre class="literallayout"><a name="id295845-bb"></a>~instance();</pre></li>
</ol></div>
</div>
</div>

Modified: sandbox/libs/extension/doc/html/boost/reflections/parameter.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/parameter.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/parameter.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -38,8 +38,8 @@
 {
 public:

- // public member functions
- void convert(void *, void *) const;
+ // public member functions
+ void convert(void *, void *) const;
 };
 template<typename S>
 class specialized_converter :
@@ -47,36 +47,36 @@
 {
 public:
 // construct/copy/destruct
- specialized_converter(void(*)(T *, S *));
+ specialized_converter(void(*)(T *, S *));

- // public member functions
- void convert(void *, void *) const;
+ // public member functions
+ void convert(void *, void *) const;
 };
 // construct/copy/destruct
- parameter(T);
+ parameter(T);

- // public member functions
- TypeInfo type() const;
- template<typename S> void converts_to_with_func(void(*)(T *, S *)) ;
- template<typename S> void converts_to() ;
+ // public member functions
+ TypeInfo type() const;
+ template<typename S> void converts_to_with_func(void(*)(T *, S *)) ;
+ template<typename S> void converts_to() ;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id464148"></a><h2>Description</h2>
+<a name="id466409"></a><h2>Description</h2>
<div class="refsect2" lang="en">
-<a name="id464153"></a><h3>
+<a name="id466414"></a><h3>
<a name="boost.reflections.parameterconstruct-copy-destruct"></a><code class="computeroutput">parameter</code>
 public
 construct/copy/destruct</h3>
-<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id294006-bb"></a>parameter(T value);</pre></li></ol></div>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id296121-bb"></a>parameter(T value);</pre></li></ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id464194"></a><h3>
-<a name="id293965-bb"></a><code class="computeroutput">parameter</code> public member functions</h3>
+<a name="id466456"></a><h3>
+<a name="id296080-bb"></a><code class="computeroutput">parameter</code> public member functions</h3>
<div class="orderedlist"><ol type="1">
-<li><pre class="literallayout">TypeInfo <a name="id293968-bb"></a>type() const;</pre></li>
+<li><pre class="literallayout">TypeInfo <a name="id296083-bb"></a>type() const;</pre></li>
<li><pre class="literallayout">template<typename S>
- void <a name="id293974-bb"></a>converts_to_with_func(void(*)(T *, S *) convert_func) ;</pre></li>
-<li><pre class="literallayout">template<typename S> void <a name="id293993-bb"></a>converts_to() ;</pre></li>
+ void <a name="id296090-bb"></a>converts_to_with_func(void(*)(T *, S *) convert_func) ;</pre></li>
+<li><pre class="literallayout">template<typename S> void <a name="id296108-bb"></a>converts_to() ;</pre></li>
</ol></div>
</div>
</div>

Modified: sandbox/libs/extension/doc/html/boost/reflections/parameter/default_converter.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/parameter/default_converter.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/parameter/default_converter.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -5,7 +5,7 @@
<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../../index.html" title="Chapter 1. Boost.Extension">
-<link rel="up" href="../parameter.html#id464148" title="Description">
+<link rel="up" href="../parameter.html#id466409" title="Description">
<link rel="prev" href="../generic_parameter/basic_converter.html" title="Class basic_converter">
<link rel="next" href="specialized_converter.html" title="Class template specialized_converter">
</head>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../generic_parameter/basic_converter.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parameter.html#id464148"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="specialized_converter.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../generic_parameter/basic_converter.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parameter.html#id466409"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="specialized_converter.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="boost.reflections.parameter.default_converter"></a><div class="titlepage"></div>
@@ -36,15 +36,15 @@
{
public:

- // public member functions
- void convert(void *, void *) const;
+ // public member functions
+ void convert(void *, void *) const;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id464421"></a><h2>Description</h2>
+<a name="id466683"></a><h2>Description</h2>
<div class="refsect2" lang="en">
-<a name="id464426"></a><h3>
-<a name="id293904-bb"></a><code class="computeroutput">default_converter</code> public member functions</h3>
-<div class="orderedlist"><ol type="1"><li><pre class="literallayout">void <a name="id293907-bb"></a>convert(void * val, void * dest) const;</pre></li></ol></div>
+<a name="id466688"></a><h3>
+<a name="id296020-bb"></a><code class="computeroutput">default_converter</code> public member functions</h3>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout">void <a name="id296022-bb"></a>convert(void * val, void * dest) const;</pre></li></ol></div>
</div>
</div>
</div>
@@ -58,7 +58,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../generic_parameter/basic_converter.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parameter.html#id464148"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="specialized_converter.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../generic_parameter/basic_converter.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parameter.html#id466409"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="specialized_converter.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost/reflections/parameter/specialized_converter.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/parameter/specialized_converter.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/parameter/specialized_converter.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -5,7 +5,7 @@
<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../../index.html" title="Chapter 1. Boost.Extension">
-<link rel="up" href="../parameter.html#id464148" title="Description">
+<link rel="up" href="../parameter.html#id466409" title="Description">
<link rel="prev" href="default_converter.html" title="Class template default_converter">
<link rel="next" href="../basic_reflection.html" title="Class template basic_reflection">
</head>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="default_converter.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parameter.html#id464148"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../basic_reflection.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="default_converter.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parameter.html#id466409"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../basic_reflection.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="boost.reflections.parameter.specialized_converter"></a><div class="titlepage"></div>
@@ -36,24 +36,24 @@
{
public:
 // construct/copy/destruct
- specialized_converter(void(*)(T *, S *));
+ specialized_converter(void(*)(T *, S *));

- // public member functions
- void convert(void *, void *) const;
+ // public member functions
+ void convert(void *, void *) const;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id464622"></a><h2>Description</h2>
+<a name="id466884"></a><h2>Description</h2>
<div class="refsect2" lang="en">
-<a name="id464627"></a><h3>
+<a name="id466889"></a><h3>
<a name="boost.reflections.parameter.specialized_converterconstruct-copy-destruct"></a><code class="computeroutput">specialized_converter</code>
 public
 construct/copy/destruct</h3>
-<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id293958-bb"></a>specialized_converter(void(*)(T *, S *) convert_function);</pre></li></ol></div>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id296074-bb"></a>specialized_converter(void(*)(T *, S *) convert_function);</pre></li></ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id464676"></a><h3>
-<a name="id293938-bb"></a><code class="computeroutput">specialized_converter</code> public member functions</h3>
-<div class="orderedlist"><ol type="1"><li><pre class="literallayout">void <a name="id293941-bb"></a>convert(void * val, void * dest) const;</pre></li></ol></div>
+<a name="id466937"></a><h3>
+<a name="id296054-bb"></a><code class="computeroutput">specialized_converter</code> public member functions</h3>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout">void <a name="id296057-bb"></a>convert(void * val, void * dest) const;</pre></li></ol></div>
</div>
</div>
</div>
@@ -67,7 +67,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="default_converter.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parameter.html#id464148"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../basic_reflection.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="default_converter.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parameter.html#id466409"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../basic_reflection.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost/reflections/parameter_map.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/parameter_map.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/parameter_map.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -32,7 +32,7 @@
<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">
typedef basic_parameter_map parameter_map;</pre></div>
<div class="refsect1" lang="en">
-<a name="id459807"></a><h2>Description</h2>
+<a name="id462075"></a><h2>Description</h2>
The most common version of basic_parameter_map. 
</div>
</div>

Modified: sandbox/libs/extension/doc/html/boost/reflections/parameter_unavailable_exception.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/reflections/parameter_unavailable_exception.html (original)
+++ sandbox/libs/extension/doc/html/boost/reflections/parameter_unavailable_exception.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -33,18 +33,18 @@
class parameter_unavailable_exception {
public:

- // public member functions
- const char * what() ;
- const char * what() ;
+ // public member functions
+ const char * what() ;
+ const char * what() ;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id458908"></a><h2>Description</h2>
+<a name="id461177"></a><h2>Description</h2>
<div class="refsect2" lang="en">
-<a name="id458913"></a><h3>
-<a name="id292834-bb"></a><code class="computeroutput">parameter_unavailable_exception</code> public member functions</h3>
+<a name="id461182"></a><h3>
+<a name="id294949-bb"></a><code class="computeroutput">parameter_unavailable_exception</code> public member functions</h3>
<div class="orderedlist"><ol type="1">
-<li><pre class="literallayout">const char * <a name="id292837-bb"></a>what() ;</pre></li>
-<li><pre class="literallayout">const char * <a name="id292844-bb"></a>what() ;</pre></li>
+<li><pre class="literallayout">const char * <a name="id294952-bb"></a>what() ;</pre></li>
+<li><pre class="literallayout">const char * <a name="id294959-bb"></a>what() ;</pre></li>
</ol></div>
</div>
</div>

Modified: sandbox/libs/extension/doc/html/boost_extension/appendices/appendix_a.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/appendices/appendix_a.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/appendices/appendix_a.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -45,7 +45,7 @@
 how this is done.
 
<a name="boost_extension.appendices.appendix_a.warning"></a><h3>
-<a name="id466257"></a>
+<a name="id468514"></a>
 <a href="appendix_a.html#boost_extension.appendices.appendix_a.warning">Warning</a>
 </h3>

Modified: sandbox/libs/extension/doc/html/boost_extension/performance_analysis.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/performance_analysis.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/performance_analysis.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -41,7 +41,7 @@
 Boost) more optimization will be performed.
 
<a name="boost_extension.performance_analysis.first_comparison"></a><h1>
-<a name="id454716"></a>
+<a name="id456856"></a>
 <a href="performance_analysis.html#boost_extension.performance_analysis.first_comparison">First
 comparison</a>
 </h1>
@@ -74,7 +74,7 @@
 So Boost.Extension is (aprox.) three times slower.
 
<a name="boost_extension.performance_analysis.multiple_calls_and_libraries"></a><h1>
-<a name="id454802"></a>
+<a name="id456943"></a>
 <a href="performance_analysis.html#boost_extension.performance_analysis.multiple_calls_and_libraries">Multiple
 calls and libraries</a>
 </h1>
@@ -124,7 +124,7 @@
 RTTI works across shared libraries.
 
<a name="boost_extension.performance_analysis.boost__function_overhead"></a><h1>
-<a name="id454809"></a>
+<a name="id456950"></a>
 <a href="performance_analysis.html#boost_extension.performance_analysis.boost__function_overhead">boost::function
 overhead</a>
 </h1>

Modified: sandbox/libs/extension/doc/html/boost_extension/reference.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/reference.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/reference.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -69,11 +69,10 @@
<a name="header.boost.extension.convenience.hpp"></a>Header <boost/extension/convenience.hpp></h4></div></div></div>
<pre class="synopsis">namespace boost {
 namespace extensions {
- bool load_single_library(factory_map &, const std::string &,
+ bool load_single_library(factory_map &, const std::string &,
 const std::string &);
- bool <a name="boost.extensions.load_single_library_id292336"></a>load_single_library(type_map & current_type_map,
- const std::string & library_path,
- const std::string & external_function_name);
+ bool <a name="boost.extensions.load_single_library_id294411"></a>load_single_library(type_map & current_type_map,
+ const std::string & library_path);
 }
}</pre>
</div>
@@ -111,8 +110,8 @@
<a name="header.boost.extension.functor.hpp"></a>Header <boost/extension/functor.hpp></h4></div></div></div>
<pre class="synopsis">

-BOOST_PP_ITERATION_LIMITS
-BOOST_PP_FILENAME_1</pre>
+BOOST_PP_ITERATION_LIMITS
+BOOST_PP_FILENAME_1</pre>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
@@ -165,8 +164,8 @@
<a name="header.boost.reflection.constructor.hpp"></a>Header <boost/reflection/constructor.hpp></h4></div></div></div>
<pre class="synopsis">

-BOOST_PP_ITERATION_LIMITS
-BOOST_PP_FILENAME_1</pre>
+BOOST_PP_ITERATION_LIMITS
+BOOST_PP_FILENAME_1</pre>
</div>
<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
<a name="header.boost.reflection.constructor_info.hpp"></a>Header <boost/reflection/constructor_info.hpp></h4></div></div></div></div>
@@ -199,7 +198,7 @@
<pre class="synopsis">

<a href="../BOOST_REFLECTION_CONSTRUCT_FUNCTION.html" title="Macro BOOST_REFLECTION_CONSTRUCT_FUNCTION">BOOST_REFLECTION_CONSTRUCT_FUNCTION</a>(Z, N, _)
-BOOST_REFLECTION_CONSTRUCTI_FUNCTION(Z, N, _)</pre>
+BOOST_REFLECTION_CONSTRUCTI_FUNCTION(Z, N, _)</pre>
<pre class="synopsis">namespace boost {
 namespace reflections {
 <a href="../boost/reflections/BOOST_REFLECTION_CONSTRUCTI_FUNCTION.html" title="Global BOOST_REFLECTION_CONSTRUCTI_FUNCTION">BOOST_REFLECTION_CONSTRUCTI_FUNCTION</a>;
@@ -222,8 +221,8 @@
<a name="header.boost.reflection.function.hpp"></a>Header <boost/reflection/function.hpp></h4></div></div></div>
<pre class="synopsis">

-BOOST_PP_ITERATION_LIMITS
-BOOST_PP_FILENAME_1</pre>
+BOOST_PP_ITERATION_LIMITS
+BOOST_PP_FILENAME_1</pre>
<pre class="synopsis">namespace boost {
 namespace reflections {
 namespace impl {

Modified: sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_class.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_class.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_class.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -9,7 +9,7 @@
<link rel="up" href="../shared_libraries.html" title=" Shared Libraries">
<link rel="prev" href="shared_library_inefficiencies.html" title="
Possible Inefficiencies in Shared Libraries">
-<link rel="next" href="../factories.html" title=" Factories">
+<link rel="next" href="../tutorials.html" title="Tutorials">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -22,7 +22,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="shared_library_inefficiencies.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../factories.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="shared_library_inefficiencies.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../tutorials.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
@@ -62,7 +62,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="shared_library_inefficiencies.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../factories.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="shared_library_inefficiencies.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../tutorials.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost_extension/tutorials.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/tutorials.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/tutorials.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -6,8 +6,10 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../index.html" title="Chapter 1. Boost.Extension">
<link rel="up" href="../index.html" title="Chapter 1. Boost.Extension">
-<link rel="prev" href="factories.html" title=" Factories">
-<link rel="next" href="tutorials/tutorial02.html" title=" Tutorial 2">
+<link rel="prev" href="shared_libraries/shared_library_class.html" title="shared_library
+ class">
+<link rel="next" href="tutorials/tutorial02.html" title=" Tutorial 2 - Basic
+ Factories">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,27 +22,26 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="factories.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tutorials/tutorial02.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="shared_libraries/shared_library_class.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tutorials/tutorial02.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="boost_extension.tutorials"></a>Tutorials</h2></div></div></div>
<div class="toc"><dl>
<dt><a href="tutorials.html#boost_extension.tutorials.tutorial01"> Tutorial 1 - Using
- the <code class="literal"><code class="computeroutput">shared_library</code></code>
- class</a></dt>
-<dt> Tutorial 2</dt>
-<dt> Tutorial 3</dt>
+ the <code class="computeroutput">shared_library</code> class</a></dt>
+<dt><a href="tutorials/tutorial02.html"> Tutorial 2 - Basic
+ Factories</a></dt>
+<dt><a href="tutorials/tutorial03.html"> Tutorial 3 - Multiple
+ and Implementation Inheritance</a></dt>
<dt> Tutorial 4</dt>
<dt> Tutorial 5</dt>
</dl></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_extension.tutorials.tutorial01"></a><a href="tutorials.html#boost_extension.tutorials.tutorial01" title=" Tutorial 1 - Using
- the shared_library
- class"> Tutorial 1 - Using
- the <code class="literal"><code class="computeroutput">shared_library</code></code>
- class</a></h3></div></div></div>
+ the shared_library class"> Tutorial 1 - Using
+ the <code class="computeroutput">shared_library</code> class</a></h3></div></div></div>

 The <code class="literal"><code class="computeroutput">shared_library</code></code>
 class facilitates loading shared libraries and calling functions from them.
@@ -300,31 +301,6 @@
 This will print out "Hello World" four times.
 
</div>
-
- There are currently five tutorials.
- 
-
- The first tutorial is a basic hello world example.
- 
-
- The second tutorial is a more complex example involving multiple inheritance,
- virtual inheritance, and inheritance across shared libraries.
- 
-
- The third tutorial shows how to register classes with multi parameter constructors.
- 
-
- The fourth tutorial is a about multiple library loading, with some strange
- cases like loading the same library many times and loading very similar classes.
- 
-
- The fifth tutorial is an advanced example of using the Info template parameter.
- There is a simpler usage of this parameter in the examples/info folder as well.
- 
-
- The tutorial code can be found in the examples folder. They all share the same
- Jamfile, but the Jamfile contents are separated out for each tutorial.
- 
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
@@ -336,7 +312,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="factories.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tutorials/tutorial02.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="shared_libraries/shared_library_class.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tutorials/tutorial02.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial02.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial02.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial02.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -1,13 +1,15 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title> Tutorial 2</title>
+<title> Tutorial 2 - Basic
+ Factories</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension">
<link rel="up" href="../tutorials.html" title="Tutorials">
<link rel="prev" href="../tutorials.html" title="Tutorials">
-<link rel="next" href="tutorial03.html" title=" Tutorial 3">
+<link rel="next" href="tutorial03.html" title=" Tutorial 3 - Multiple
+ and Implementation Inheritance">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,141 +26,264 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="boost_extension.tutorials.tutorial02"></a> Tutorial 2</h3></div></div></div>
+<a name="boost_extension.tutorials.tutorial02"></a><a href="tutorial02.html" title=" Tutorial 2 - Basic
+ Factories"> Tutorial 2 - Basic
+ Factories</a></h3></div></div></div>

- This tutorial shows more advanced class loading. The example described here
- is contrived, and such a convoluted design is not used as an example of good
- object-oriented program, but as a way to illustrate some of the possibilities
- with this library.
+ The easiest method for creating plugins in C++ is to use factories. Consider
+ the following base class:
 

- Let's design a class hierarchy based on the following:
- 
-<div class="itemizedlist"><ul type="disc">
-<li>
- There is a vehicle class
- </li>
-<li>
- There is a computer class
- </li>
-<li>
- A car is a vehicle
- </li>
-<li>
- A boat is a vehicle
- </li>
-<li>
- A plane is a vehicle
- </li>
-<li>
- A flying_car is a plane and a car
- </li>
-<li>
- A car_of_the_future is a flying_car, a boat, and a computer.
- </li>
-</ul></div>
+
+
+<pre class="programlisting">class animal {
+public:
+ animal(int age) : age_(age) {
+ }
+ virtual ~animal(void) {
+ }
+ virtual std::string get_name(void) {
+ return "A generic animal";
+ }
+ int get_age(void) {
+ return age_;
+ }
+protected:
+ int age_;
+};
+</pre>

- In addition, we are not going to have any of these classes be interfaces.
- They will each have an implementation in a .cpp file. This will require multiple
- inheritance, as well as virtual inheritance (because otherwise a car_of_the_future
- would consist of three separate vehicle base classes!).
 

- In addition, each class will be compiled into a separate shared library.
- This is not necessary, certainly, but will serve to illustrate some of the
- more advanced capabilities of the library, as well as some of the techniques
- necessary in this situation.
+ The goal here is to create a main executable which creates and uses instances
+ of the <code class="computeroutput">animal</code> class. A shared
+ library will then be created which includes classes derived from the <code class="computeroutput">animal</code> class, which the main executable
+ will also be able to load and use as <code class="computeroutput">animal</code>s.
 

- To begin with, let's look at the Jamfile:
+ The main executable will use a number of Extension and other Boost headers:
 



-<pre class="programlisting">import type : change-generated-target-suffix ;
-import type : change-generated-target-prefix ;
-type.change-generated-target-suffix SHARED_LIB : : extension ;
-type.change-generated-target-prefix SHARED_LIB : : lib ;
+<pre class="programlisting">#include <iostream>
+#include <map>
+
+#include <boost/extension/factory.hpp>
+#include <boost/extension/shared_library.hpp>
+#include <boost/extension/type_map.hpp>
+#include <boost/function.hpp>
+#include <boost/scoped_ptr.hpp>
</pre>

 

- First we must rename the generated libraries (this is required for cross-platform
- use - but the prefix and suffix are arbitrary).
+ It will also use the <code class="computeroutput">animal</code>
+ header, which will also be used by the shared library:
 



-<pre class="programlisting">lib Vehicle : multiple_inheritance/vehicle.cpp : <link>shared ;
-lib Car : multiple_inheritance/car.cpp Vehicle : <link>shared ;
+<pre class="programlisting">#include "animal.hpp"
</pre>

 

- Notice here that the Car library is linked to the Vehicle library - this
- is necessary because the Car class needs the implementation of the Vehicle
- class. This is unrelated to the Boost.Extension library, but just a standard
- requirement when inheriting from shared library classes. The same will be
- done with the other shared libraries.
+ The main function is similar to that from <a href="../../">Tutorial
+ 1</a>.
 



-<pre class="programlisting">lib Plane : multiple_inheritance/plane.cpp Vehicle : <link>shared ;
-lib Boat : multiple_inheritance/boat.cpp Vehicle : <link>shared ;
-lib Computer : multiple_inheritance/computer.cpp : <link>shared ;
-lib FlyingCar : multiple_inheritance/flying_car.cpp Plane Car Vehicle
- : <link>shared ;
-lib CarOfTheFuture :
- multiple_inheritance/car_of_the_future.cpp
- Plane Car Vehicle
- FlyingCar Computer Boat
- :
- <link>shared
-;
+<pre class="programlisting">int main() {
+ using namespace boost::extensions;
+ std::string library_path = "libtutorial_2.extension";
+
+ // Create shared_library object with the relative or absolute
+ // path to the shared library.
+ shared_library lib(library_path);

-install ../bin :
- HelloWorld HelloWorldLib Vehicle Boat FlyingCar
- CarOfTheFuture MultipleInheritance
- :
- ;
+ // Attempt to open the shared library.
+ if (!lib.open()) {
+ std::cerr << "Library failed to open: " << library_path << std::endl;
+ return 1;
+ }
</pre>

 

- Refer to the examples/multiple_inheritance folder for the source code of
- these classes. Only the most complex will be described here - the rest are
- similar.
+ Here though, instead of using the <code class="literal"><code class="computeroutput">shared_library::get</code></code>
+ function, we use the _shared_librarycall
+ function. It expects a function with the following signature:
 

- On the Windows platform, there are special declarations that are required
- when a dll must use a class that is defined in another dll. For interface
- only classes this is unnecessary, and is not needed on other platforms. The
- macros BOOST_EXTENSION_IMPORT_DECL and BOOST_EXTENSION_EXPORT_DECL can be
- used to insert the proper declaration. This is detailed in the appendix.
+
+
+<pre class="programlisting">extern "C" void boost_extension_exported_type_map_function
+ (boost::extensions::type_map& types);
+</pre>
+
+ 
+
+ A <code class="literal"><code class="computeroutput">type_map</code></code>
+ is a generic container with items indexed by type - only one item of each
+ type can be contained in it. To retrieve (or add) an integer to it, do the
+ following:
 



-<pre class="programlisting">#define BOOST_EXTENSION_FLYING_CAR_DECL BOOST_EXTENSION_IMPORT_DECL
-#define BOOST_EXTENSION_BOAT_DECL BOOST_EXTENSION_IMPORT_DECL
-#define BOOST_EXTENSION_COMPUTER_DECL BOOST_EXTENSION_IMPORT_DECL
-#include "flying_car.hpp"
-#include "boat.hpp"
-#include "computer.hpp"
-#include <iostream>
-#include <typeinfo>
-class BOOST_EXTENSION_CAR_OF_THE_FUTURE_DECL
- car_of_the_future : public flying_car, public boat, public computer
-{
-public:
- car_of_the_future(void){std::cout << "\nCreated a Car of the Future";}
- ~car_of_the_future(void){std::cout << "\nDestroyed a Car of the Future";}
- virtual std::string list_capabilities(void);
+<pre class="programlisting">int& my_int(my_type_map.get());
+</pre>
+
+ 
+
+ For the rationale of the <code class="literal"><code class="computeroutput">type_map</code></code>
+ class, see the discussion on type safety.
+ 
+
+
+
+<pre class="programlisting">// Use the shared_library::call to automatically call an
+// Extension-specific function in the shared library,
+// which takes a type_map.
+type_map types;
+if (!lib.call(types)) {
+ std::cerr << "Function not found!" << std::endl;
+ return 1;
+}
+</pre>
+
+ 
+
+ Now, a <code class="computeroutput">std::map</code> of factories, indexed by <code class="computeroutput">std::string</code>
+ is retrieved from the <code class="literal"><code class="computeroutput">type_map</code></code>
+ that was sent to the shared library.
+ 
+
+ The <code class="literal"><code class="computeroutput">factory</code></code>
+ is declared as <code class="computeroutput">factory<animal, int></code> meaning
+ it returns pointers to instances of the <code class="computeroutput">animal</code>
+ class, and that it is used for constructors taking integer arguments.
+ 
+
+
+
+<pre class="programlisting">// Retrieve a map of all animal factories taking an int and indexed
+// by a string from the type_map.
+std::map<std::string, factory<animal, int> >& factories(types.get());
+if (factories.empty()) {
+ std::cerr << "Animals not found!" << std::endl;
+ return 1;
+}
+</pre>
+
+ 
+
+ Now, iterate through the factory, creating each available <code class="computeroutput">animal</code>.
+ 
+
+
+
+<pre class="programlisting"> // Create each animal.
+ int age = 1;
+ for (std::map<std::string, factory<animal, int> >::iterator it
+ = factories.begin();
+ it != factories.end(); ++it) {
+ ++age;
+ std::cout << "Creating an animal using factory: " << it->first << std::endl;
+ boost::scoped_ptr<animal> current_animal(it->second.create(age));
+ std::cout << "Created an animal: " << current_animal->get_name()
+ << " Age: " << current_animal->get_age() << std::endl;
+ }
+}
+</pre>
+
+ 
+
+ Now, the shared library will define a number of animals. It will use the
+ following headers:
+ 
+
+
+
+<pre class="programlisting">#include <iostream>
+#include <map>
+
+#include <boost/extension/extension.hpp>
+#include <boost/extension/factory.hpp>
+#include <boost/extension/type_map.hpp>
+
+#include "animal.hpp"
+</pre>
+
+ 
+
+ The following animals will be exported:
+ 
+
+
+
+<pre class="programlisting">class puma : public animal {
+ public:
+ puma(int age) : animal(age) {}
+ virtual std::string get_name() {
+ return "puma";
+ }
};
+
+class leopard : public animal {
+ public:
+ leopard(int age) : animal(age) {}
+ virtual std::string get_name() {
+ return "leopard";
+ }
+};
+
+class wildcat : public animal {
+ public:
+ wildcat(int age) : animal(age) {}
+ virtual std::string get_name() {
+ return "wildcat";
+ }
+};
+
+class cougar : public animal {
+ public:
+ cougar(int age) : animal(age) {}
+ virtual std::string get_name() {
+ return "cougar";
+ }
+};
+</pre>
+
+ 
+
+ The <code class="computeroutput">BOOST_EXTENSION_TYPE_MAP_FUNCTION</code>
+ declaration can be used in place of a function declaration to automatically
+ insert the function definition referred to above, that takes a <code class="literal"><code class="computeroutput">type_map</code></code>. See <code class="computeroutput"><boost/extension/extension.hpp></code>
+ for more details.
+ 
+
+
+
+<pre class="programlisting">BOOST_EXTENSION_TYPE_MAP_FUNCTION {
+ using namespace boost::extensions;
+ std::map<std::string, factory<animal, int> >&
+ animal_factories(types.get());
+ animal_factories["Puma factory"].set<puma>();
+ animal_factories["Leopard factory"].set<leopard>();
+ animal_factories["Wildcat factory"].set<wildcat>();
+ animal_factories["Cougar factory"].set<cougar>();
+}
</pre>

 
+
+ Now, compile the shared library and main executable. Then run the main executable
+ in the directory with the compiled library. If all is successful, a message
+ will be printed out for each animal.
+ 
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>

Modified: sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial03.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial03.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial03.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -1,12 +1,14 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title> Tutorial 3</title>
+<title> Tutorial 3 - Multiple
+ and Implementation Inheritance</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension">
<link rel="up" href="../tutorials.html" title="Tutorials">
-<link rel="prev" href="tutorial02.html" title=" Tutorial 2">
+<link rel="prev" href="tutorial02.html" title=" Tutorial 2 - Basic
+ Factories">
<link rel="next" href="tutorial04.html" title=" Tutorial 4">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -24,151 +26,231 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="boost_extension.tutorials.tutorial03"></a> Tutorial 3</h3></div></div></div>
+<a name="boost_extension.tutorials.tutorial03"></a><a href="tutorial03.html" title=" Tutorial 3 - Multiple
+ and Implementation Inheritance"> Tutorial 3 - Multiple
+ and Implementation Inheritance</a></h3></div></div></div>

- This tutorial shows how to register and instantiate classes that have multi-argument
- constructors (not default constructors) in Boost.Extension. In the example
- that we will describe in this tutorial (examples/parameters) we create a
- dummy class with a constructor that have six arguments. We'll register this
- class in a factory map and then get it from the main file.
+ This tutorial shows more advanced class loading. The example described here
+ is contrived, and such a convoluted design is not used as an example of good
+ object-oriented program, but as a way to illustrate some of the possibilities
+ with this library.
 

- It is expected that before following this tutorial you have gone trough the
- first tutorial at least, and you are familiar with the basic use of Boost.Extension.
+ Most complications with this type of factory usage only occur on Windows,
+ or with less popular compiler options. Refer to <a href="../appendices/appendix_a.html" title=" Appendix A -
+ Windows Export and Import Declarations">Appendix
+ A</a>.
 

- Let's start defining our class. Its constructor receives six parameters (we
- chose that number because it's the default argument limit of the library),
- each one of a different type including a class defined in the interface (class
- A) and a smart pointer to this class. It shows via stdout the received parameters
- at construction.
+ Let's design a class hierarchy based on the following:
+ 
+<div class="itemizedlist"><ul type="disc">
+<li>
+ There is a vehicle class
+ </li>
+<li>
+ There is a computer class
+ </li>
+<li>
+ A car is a vehicle
+ </li>
+<li>
+ A boat is a vehicle
+ </li>
+<li>
+ A plane is a vehicle
+ </li>
+<li>
+ A flying_car is a plane and a car
+ </li>
+<li>
+ A car_of_the_future is a flying_car, a boat, and a computer.
+ </li>
+</ul></div>
+
+ In addition, we are not going to have any of these classes be interfaces.
+ They will each have an implementation in a .cpp file. This will require multiple
+ inheritance, as well as virtual inheritance (because otherwise a car_of_the_future
+ would consist of three separate vehicle base classes!).
+ 
+
+ In addition, each class will be compiled into a separate shared library.
+ This is not necessary, certainly, but will serve to illustrate some of the
+ more advanced capabilities of the library, as well as some of the techniques
+ necessary in this situation.
+ 
+
+ To begin with, let's look at the Jamfile:
 



-<pre class="programlisting">class six_parameters : public lots_of_parameters_interface
-{
- public:
- six_parameters(bool b, unsigned int i, char c, std::string s, A a,
- boost::shared_ptr<A> ptr_a)
- lots_of_parameters_interface(b, i, c, s, a, ptr_a)
- {
- std::cout << "Constructor called." << std::endl << std::endl;
- std::cout << "Parameters:" << std::endl;
- std::cout << "\tbool: " << b << std::endl;
- std::cout << "\tunsigned int: " << i << std::endl;
- std::cout << "\tchar: " << c << std::endl;
- std::cout << "\tstring: " << s << std::endl;
- std::cout << "\tA.i: " << a.i << std::endl;
- std::cout << "\tptr_a->i: " << ptr_a->i << std::endl;
- std::cout << std::endl;
- }
-
- virtual ~six_parameters(void) {}
-};
+<pre class="programlisting">import type : change-generated-target-suffix ;
+import type : change-generated-target-prefix ;
+type.change-generated-target-suffix SHARED_LIB : : extension ;
+type.change-generated-target-prefix SHARED_LIB : : lib ;
</pre>

- The interface that we are inheriting is just the bare minimum needed
- to make it compile:
+ 
+
+ As usual, first we must rename the generated libraries (this is required
+ for cross-platform use - but the prefix and suffix are arbitrary).
+ 
+
+ Next, some special options are needed for certain compilers, to make sure
+ that the shared libraries are found correctly. This is only needed for this
+ example because we have shared libraries that are linked by the linker after
+ compilation to other shared libraries, rather than loaded by the shared_library
+ class at runtime. Library paths and includes need to be set as follows:
 



-<pre class="programlisting">class A
-{
- public:
- A(unsigned int i) : i(i) {}
- int i;
-};
+<pre class="programlisting">local BOOST_ROOT = [ os.environ BOOST_ROOT ] ;
+project
+ : requirements
+ <include>../../../
+ <include>#(BOOST_ROOT)
+ <toolset>gcc:<find-shared-library>dl
+ <toolset>gcc:<linkflags>"-Wl,-rpath,'$ORIGIN'"
+ <toolset>darwin:<define>DYLD_LIBRARY_PATH=./
+ :
+ ;

+</pre>
+
+ 
+
+ The rules for building the first two libraries are the same as those from
+ earlier tutorials.
+ 
+
+
+
+<pre class="programlisting">lib Vehicle : multiple_inheritance/vehicle.cpp : <link>shared ;
+lib Car : multiple_inheritance/car.cpp Vehicle : <link>shared ;
+</pre>
+
+ 
+
+ Notice here that the Car library is linked to the Vehicle library - this
+ is necessary because the Car class needs the implementation of the Vehicle
+ class. This is not specific to the Boost.Extension library, but just a standard
+ requirement when inheriting from shared library classes. The same will be
+ done with the other shared libraries.
+ 
+
+
+
+<pre class="programlisting">lib Plane : multiple_inheritance/plane.cpp Vehicle : <link>shared ;
+lib Boat : multiple_inheritance/boat.cpp Vehicle : <link>shared ;
+lib Computer : multiple_inheritance/computer.cpp : <link>shared ;
+lib FlyingCar : multiple_inheritance/flying_car.cpp Plane Car Vehicle
+ : <link>shared ;
+lib CarOfTheFuture :
+ multiple_inheritance/car_of_the_future.cpp
+ Plane Car Vehicle
+ FlyingCar Computer Boat
+ :
+ <link>shared
+;

-class lots_of_parameters_interface
-{
- public:
- lots_of_parameters_interface(bool b, unsigned int i, char c,
- std::string s, A a,
- boost::shared_ptr<A> ptr_a) {}
- virtual ~lots_of_parameters_interface(void) {}
-};
+install ../bin :
+ HelloWorld HelloWorldLib Vehicle Boat FlyingCar
+ CarOfTheFuture MultipleInheritance
+ :
+ ;
</pre>

- Having the class defined, we should write the export function to register
- the class in the passed factory map. The point here is that the factory_map::add
- method must be set with the first type as the third argument, and with the
- second type as the fourth argument and so on.
+ 
+
+ Refer to the examples/multiple_inheritance folder for the source code of
+ these classes. Only the most complex will be described here - the rest are
+ similar.
+ 
+
+ On the Windows platform, there are special declarations that are required
+ when a dll must use a class that is defined in another dll. For interface
+ only classes this is unnecessary, and is not needed on other platforms. The
+ macros BOOST_EXTENSION_IMPORT_DECL and BOOST_EXTENSION_EXPORT_DECL can be
+ used to insert the proper declaration. This is detailed in <a href="../appendices/appendix_a.html" title=" Appendix A -
+ Windows Export and Import Declarations">Appendix
+ A</a>.
+ 
+
+ The macros here are defined in such a way that in the <code class="computeroutput">car_of_the_future</code>
+ class, the classes it depends on from other shared libraries are declared
+ as imports. The BOOST_EXTENSION_CAR_OF_THE_FUTURE_DECL must be defined by
+ any source file using this class - as <code class="computeroutput">BOOST_EXTENSION_IMPORT_DECL</code>
+ by the shared library containing the <code class="computeroutput">car_of_the_future</code>,
+ and as <code class="computeroutput">BOOST_EXTENSION_EXPORT_DECL</code>
+ by any shared library or executable linking directly to that shared library.
 



-<pre class="programlisting">extern "C" void BOOST_EXTENSION_EXPORT_DECL
-extension_export(boost::extensions::factory_map & fm)
+<pre class="programlisting">#define BOOST_EXTENSION_FLYING_CAR_DECL BOOST_EXTENSION_IMPORT_DECL
+#define BOOST_EXTENSION_BOAT_DECL BOOST_EXTENSION_IMPORT_DECL
+#define BOOST_EXTENSION_COMPUTER_DECL BOOST_EXTENSION_IMPORT_DECL
+#include "flying_car.hpp"
+#include "boat.hpp"
+#include "computer.hpp"
+#include <iostream>
+#include <typeinfo>
+class BOOST_EXTENSION_CAR_OF_THE_FUTURE_DECL
+ car_of_the_future : public flying_car, public boat, public computer
{
- fm.get<lots_of_parameters_interface, int, bool,
- unsigned int, char, std::string, A,
- boost::shared_ptr<A> >()[6].set<six_parameters>();
-}
+public:
+ car_of_the_future(void){std::cout << "\nCreated a Car of the Future";}
+ ~car_of_the_future(void){std::cout << "\nDestroyed a Car of the Future";}
+ virtual std::string list_capabilities(void);
+};
</pre>

- Finally, let's see how it is used in the main file.
+ 
+
+ In the implementation file for the <code class="computeroutput">car_of_the_future</code>,
+ it is exported as an implementation of each of its base classes.
 



-<pre class="programlisting">int main(void)
-{
- using namespace boost::extensions;
-
- // Create the factory_map object - it will hold all of the available
- // constructors. Multiple factory_maps can be constructed.
- factory_map fm;
-
- // load the shared library with
- load_single_library(fm, "libParametersLib.extension", "extension_export");
-
- std::map<int, factory<lots_of_parameters_interface, bool, unsigned int,
- char, std::string, A, boost::shared_ptr<A> > > &
- factory_list =
- fm.get<lots_of_parameters_interface, int, bool, unsigned int, char,
- std::string, A, boost::shared_ptr<A> >();
- if (factory_list.size() != 1) {
- std::cout << "Error - the class was not found.";
- return 1;
- }
+<pre class="programlisting">std::string car_of_the_future::list_capabilities() {
+ return boat::list_capabilities() + flying_car::list_capabilities() +
+ computer::list_capabilities() + "\nCosts an arm and a leg";
+}

- std::map<int, factory<lots_of_parameters_interface, bool, unsigned int,
- char, std::string, A, boost::shared_ptr<A> > >
- ::iterator par = factory_list.begin();
- std::auto_ptr<lots_of_parameters_interface>
- par_ptr(par->create(true, 4, 'c', "test", A(2),
- boost::shared_ptr<A>(new A(15))));
+using boost::extensions::factory;

- return 0;
+BOOST_EXTENSION_TYPE_MAP_FUNCTION {
+ types.get<std::map<std::string, factory<vehicle> > >()
+ ["A car of the future exported as a vehicle"].set<car_of_the_future>();
+ types.get<std::map<std::string, factory<car> > >()
+ ["A car of the future exported as a car"].set<car_of_the_future>();
+ types.get<std::map<std::string, factory<plane> > >()
+ ["A car of the future exported as a plane"].set<car_of_the_future>();
+ types.get<std::map<std::string, factory<flying_car> > >()
+ ["A car of the future exported as a flying car"].set<car_of_the_future>();
+ types.get<std::map<std::string, factory<boat> > >()
+ ["A car of the future exported as a boat"].set<car_of_the_future>();
+ types.get<std::map<std::string, factory<computer> > >()
+ ["A car of the future exported as a computer"].set<car_of_the_future>();
+ types.get<std::map<std::string, factory<car_of_the_future> > >()
+ ["A car of the future exported as a car of the future"].set<car_of_the_future>();
}
</pre>

 

- Please note the following details:
- 
-<div class="itemizedlist"><ul type="disc">
-<li>
- Shared library loading is exactly the same.
- </li>
-<li>
- When we get the factory we should specify the template parameters, as we
- did in the factory_map::add method.
- </li>
-<li>
- When we call the create method we just supply the needed arguments and
- just works!
- </li>
-</ul></div>
-
- 
+ The main executable is relatively straightforward, but does introduce a new
+ function: <code class="computeroutput">load_single_library</code>,
+ which takes a <code class="literal"><code class="computeroutput">type_map</code></code>
+ and the location of the shared library, and loads the library and calls the
+ function declared as <code class="computeroutput">BOOST_EXTENSION_TYPE_MAP_FUNCTION</code>.
 

- It is expected that at this point you can create your own classes with multi-argument
- constructors and use them via Boost.extensions without problems.
+ Now, place all of the compiled libraries and the main executable in a directory
+ together, and run the executable.
 
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>

Modified: sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial04.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial04.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial04.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -6,7 +6,8 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension">
<link rel="up" href="../tutorials.html" title="Tutorials">
-<link rel="prev" href="tutorial03.html" title=" Tutorial 3">
+<link rel="prev" href="tutorial03.html" title=" Tutorial 3 - Multiple
+ and Implementation Inheritance">
<link rel="next" href="tutorial05.html" title=" Tutorial 5">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">

Added: sandbox/libs/extension/doc/html/extension/reference.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/extension/reference.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,296 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Reference</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
+<link rel="start" href="../index.html" title="Chapter 1. Boost.Extension">
+<link rel="up" href="../boost_extension/appendices.html" title=" Appendices">
+<link rel="prev" href="../boost_extension/appendices.html" title=" Appendices">
+<link rel="next" href="../boost/extensions/adaptable_factory.html" title="Class template adaptable_factory">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../boost_extension/appendices.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../boost_extension/appendices.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../boost/extensions/adaptable_factory.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="extension.reference"></a>Reference</h3></div></div></div>
+<div class="toc"><dl>
+<dt>Header <boost/extension/adaptable_factory.hpp></dt>
+<dt>Header <boost/extension/convenience.hpp></dt>
+<dt>Header <boost/extension/extension.hpp></dt>
+<dt>Header <boost/extension/factory_map.hpp></dt>
+<dt>Header <boost/extension/filesystem.hpp></dt>
+<dt>Header <boost/extension/functor.hpp></dt>
+<dt>Header <boost/extension/shared_library.hpp></dt>
+<dt>Header <boost/extension/type_map.hpp></dt>
+<dt>Header <boost/reflection/adapter.hpp></dt>
+<dt>Header <boost/reflection/common.hpp></dt>
+<dt>Header <boost/extension/common.hpp></dt>
+<dt>Header <boost/reflection/constructor.hpp></dt>
+<dt>Header <boost/reflection/constructor_info.hpp></dt>
+<dt>Header <boost/reflection/data.hpp></dt>
+<dt>Header <boost/reflection/data_info.hpp></dt>
+<dt>Header <boost/reflection/factory.hpp></dt>
+<dt>Header <boost/extension/factory.hpp></dt>
+<dt>Header <boost/reflection/function.hpp></dt>
+<dt>Header <boost/reflection/function_info.hpp></dt>
+<dt>Header <boost/reflection/generic_constructor.hpp></dt>
+<dt>Header <boost/reflection/instance.hpp></dt>
+<dt>Header <boost/reflection/parameter.hpp></dt>
+<dt>Header <boost/reflection/parameter_map.hpp></dt>
+<dt>Header <boost/reflection/reflection.hpp></dt>
+</dl></div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.extension.adaptable_factory.hpp"></a>Header <boost/extension/adaptable_factory.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace extensions {
+ template<typename Interface, typename Info = std::string,
+ typename TypeInfo = default_type_info>
+ class adaptable_factory;
+ namespace impl {
+ }
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.extension.convenience.hpp"></a>Header <boost/extension/convenience.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace extensions {
+ bool load_single_library(factory_map &, const std::string &,
+ const std::string &);
+ bool <a name="boost.extensions.load_single_library_id294417"></a>load_single_library(type_map & current_type_map,
+ const std::string & library_path);
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.extension.extension.hpp"></a>Header <boost/extension/extension.hpp></h4></div></div></div>
+<pre class="synopsis">
+
+BOOST_EXTENSION_EXPORT_DECL</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.extension.factory_map.hpp"></a>Header <boost/extension/factory_map.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace extensions {
+ template<typename TypeInfo> class basic_factory_map;
+ typedef basic_factory_map< default_type_info > factory_map;
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.extension.filesystem.hpp"></a>Header <boost/extension/filesystem.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace extensions {
+ void <a name="boost.extensions.load_all_libraries"></a>load_all_libraries(factory_map & current_zone,
+ const char * directory,
+ const char * external_function_name,
+ int max_depth = 0);
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.extension.functor.hpp"></a>Header <boost/extension/functor.hpp></h4></div></div></div>
+<pre class="synopsis">
+
+BOOST_PP_ITERATION_LIMITS
+BOOST_PP_FILENAME_1</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.extension.shared_library.hpp"></a>Header <boost/extension/shared_library.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace extensions {
+ class shared_library;
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.extension.type_map.hpp"></a>Header <boost/extension/type_map.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace extensions {
+ template<typename TypeInfo> class basic_type_map;
+ typedef basic_type_map< default_type_info > type_map;
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.adapter.hpp"></a>Header <boost/reflection/adapter.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace reflections {
+ class parameter_unavailable_exception;
+ template<typename Info = std::string,
+ typename TypeInfo = extensions::default_type_info>
+ class basic_parameter_map;
+ typedef basic_parameter_map parameter_map;
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.common.hpp"></a>Header <boost/reflection/common.hpp></h4></div></div></div>
+<pre class="synopsis">
+
+BOOST_REFLECTION_MAX_FUNCTOR_PARAMS</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.extension.common.hpp"></a>Header <boost/extension/common.hpp></h4></div></div></div>
+<pre class="synopsis">
+
+BOOST_EXTENSION_MAX_FUNCTOR_PARAMS</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.constructor.hpp"></a>Header <boost/reflection/constructor.hpp></h4></div></div></div>
+<pre class="synopsis">
+
+BOOST_PP_ITERATION_LIMITS
+BOOST_PP_FILENAME_1</pre>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.constructor_info.hpp"></a>Header <boost/reflection/constructor_info.hpp></h4></div></div></div></div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.data.hpp"></a>Header <boost/reflection/data.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace reflections {
+ template<typename T> class data;
+ namespace impl {
+ typedef void *instance::* <a name="boost.reflections.impl.MemberPtr"></a>MemberPtr;
+ template<typename Object, typename Data>
+ Data & <a name="boost.reflections.impl.get_data_from_ptr"></a>get_data_from_ptr(void * inst, MemberPtr ptr);
+ }
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.data_info.hpp"></a>Header <boost/reflection/data_info.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace reflections {
+ template<typename Info, typename TypeInfo> struct basic_data_info;
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.factory.hpp"></a>Header <boost/reflection/factory.hpp></h4></div></div></div>
+<pre class="synopsis">
+
+BOOST_REFLECTION_CONSTRUCT_FUNCTION(Z, N, _)
+BOOST_REFLECTION_CONSTRUCTI_FUNCTION(Z, N, _)</pre>
+<pre class="synopsis">namespace boost {
+ namespace reflections {
+ BOOST_REFLECTION_CONSTRUCTI_FUNCTION;
+ <a name="boost.reflections.BOOST_PP_REPEAT"></a>BOOST_PP_REPEAT(BOOST_PP_INC(BOOST_REFLECTION_MAX_FUNCTOR_PARAMS),
+ BOOST_REFLECTION_CONSTRUCT_FUNCTION, _);
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.extension.factory.hpp"></a>Header <boost/extension/factory.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace extensions {
+ template<typename T, typename Params...> class factory;
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.function.hpp"></a>Header <boost/reflection/function.hpp></h4></div></div></div>
+<pre class="synopsis">
+
+BOOST_PP_ITERATION_LIMITS
+BOOST_PP_FILENAME_1</pre>
+<pre class="synopsis">namespace boost {
+ namespace reflections {
+ namespace impl {
+ typedef void(instance::* <a name="boost.reflections.impl.MemberFunctionPtr"></a>MemberFunctionPtr;
+ }
+ }
+}</pre>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.function_info.hpp"></a>Header <boost/reflection/function_info.hpp></h4></div></div></div></div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.generic_constructor.hpp"></a>Header <boost/reflection/generic_constructor.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace reflections {
+ template<typename T> class generic_constructor;
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.instance.hpp"></a>Header <boost/reflection/instance.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace reflections {
+ class instance;
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.parameter.hpp"></a>Header <boost/reflection/parameter.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace reflections {
+ class conversion_not_found_exception;
+ template<typename TypeInfo = extensions::default_type_info>
+ class generic_parameter;
+ template<typename T, typename TypeInfo = extensions::default_type_info>
+ class parameter;
+ }
+}</pre>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.parameter_map.hpp"></a>Header <boost/reflection/parameter_map.hpp></h4></div></div></div></div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="header.boost.reflection.reflection.hpp"></a>Header <boost/reflection/reflection.hpp></h4></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace reflections {
+ template<typename Info = std::string, typename ParameterInfo = void,
+ typename TypeInfo = extensions::default_type_info>
+ class basic_reflection;
+
+ typedef basic_reflection <a name="boost.reflections.reflection"></a>reflection;
+ }
+}</pre>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../boost_extension/appendices.html"><img src="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../boost_extension/appendices.html"><img src="../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../boost/extensions/adaptable_factory.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/header/boost/extension/convenience/hpp.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/header/boost/extension/convenience/hpp.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,48 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Header <boost/extension/convenience.hpp></title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Boost.Extension">
+<link rel="up" href="../../../../boost_extension/reference.html" title="Reference">
+<link rel="prev" href="../../../../BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html" title="Macro BOOST_EXTENSION_MAX_FUNCTOR_PARAMS">
+<link rel="next" href="../../../../boost/extensions/load_single_library.html" title="Function load_single_library">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../../../BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../../boost/extensions/load_single_library.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.extension.convenience.hpp"></a>Header <boost/extension/convenience.hpp></h3></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace extensions {
+ bool load_single_library(factory_map &, const std::string &,
+ const std::string &);
+ }
+}</pre>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../../../BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../../boost/extensions/load_single_library.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/header/boost/extension/extension/hpp.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/header/boost/extension/extension/hpp.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,45 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Header <boost/extension/extension.hpp></title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Boost.Extension">
+<link rel="up" href="../../../../boost_extension/reference.html" title="Reference">
+<link rel="prev" href="../../../../boost/extensions/load_single_library.html" title="Function load_single_library">
+<link rel="next" href="../../../../BOOST_EXTENSION_EXPORT_DECL.html" title="Macro BOOST_EXTENSION_EXPORT_DECL">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../../../boost/extensions/load_single_library.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../../BOOST_EXTENSION_EXPORT_DECL.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.extension.extension.hpp"></a>Header <boost/extension/extension.hpp></h3></div></div></div>
+<pre class="synopsis">
+
+BOOST_EXTENSION_EXPORT_DECL</pre>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../../../boost/extensions/load_single_library.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../../BOOST_EXTENSION_EXPORT_DECL.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/header/boost/extension/factory/hpp.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/header/boost/extension/factory/hpp.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,47 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Header <boost/extension/factory.hpp></title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Boost.Extension">
+<link rel="up" href="../../../../boost_extension/reference.html" title="Reference">
+<link rel="prev" href="../../../../BOOST_EXTENSION_EXPORT_DECL.html" title="Macro BOOST_EXTENSION_EXPORT_DECL">
+<link rel="next" href="../../../../boost/extensions/factory.html" title="Class template factory">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../../../BOOST_EXTENSION_EXPORT_DECL.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../../boost/extensions/factory.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.extension.factory.hpp"></a>Header <boost/extension/factory.hpp></h3></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace extensions {
+ template<typename T, typename Params...> class factory;
+ }
+}</pre>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../../../BOOST_EXTENSION_EXPORT_DECL.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../../boost/extensions/factory.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/header/boost/extension/factory_map/hpp.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/header/boost/extension/factory_map/hpp.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,48 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Header <boost/extension/factory_map.hpp></title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Boost.Extension">
+<link rel="up" href="../../../../boost_extension/reference.html" title="Reference">
+<link rel="prev" href="../../../../boost/extensions/factory.html" title="Class template factory">
+<link rel="next" href="../../../../boost/extensions/basic_factory_map.html" title="Class template basic_factory_map">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../../../boost/extensions/factory.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../../boost/extensions/basic_factory_map.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.extension.factory_map.hpp"></a>Header <boost/extension/factory_map.hpp></h3></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace extensions {
+ template<typename TypeInfo> class basic_factory_map;
+ typedef basic_factory_map< default_type_info > factory_map;
+ }
+}</pre>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../../../boost/extensions/factory.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../../boost/extensions/basic_factory_map.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/header/boost/extension/filesystem/hpp.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/header/boost/extension/filesystem/hpp.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,50 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Header <boost/extension/filesystem.hpp></title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Boost.Extension">
+<link rel="up" href="../../../../boost_extension/reference.html" title="Reference">
+<link rel="prev" href="../../../../boost/extensions/factory_map.html" title="Type definition factory_map">
+<link rel="next" href="../functor/hpp.html" title="Header <boost/extension/functor.hpp>">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../../../boost/extensions/factory_map.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../functor/hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.extension.filesystem.hpp"></a>Header <boost/extension/filesystem.hpp></h3></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace extensions {
+ void <a name="boost.extensions.load_all_libraries"></a>load_all_libraries(factory_map & current_zone,
+ const char * directory,
+ const char * external_function_name,
+ int max_depth = 0);
+ }
+}</pre>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../../../boost/extensions/factory_map.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../functor/hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/header/boost/extension/functor/hpp.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/header/boost/extension/functor/hpp.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,46 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Header <boost/extension/functor.hpp></title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Boost.Extension">
+<link rel="up" href="../../../../boost_extension/reference.html" title="Reference">
+<link rel="prev" href="../filesystem/hpp.html" title="Header <boost/extension/filesystem.hpp>">
+<link rel="next" href="../../../../BOOST_PP_ITERATION_LIMITS.html" title="Macro BOOST_PP_ITERATION_LIMITS">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../filesystem/hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../../BOOST_PP_ITERATION_LIMITS.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.extension.functor.hpp"></a>Header <boost/extension/functor.hpp></h3></div></div></div>
+<pre class="synopsis">
+
+BOOST_PP_ITERATION_LIMITS
+BOOST_PP_FILENAME_1</pre>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../filesystem/hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../../BOOST_PP_ITERATION_LIMITS.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/header/boost/extension/shared_library/hpp.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/header/boost/extension/shared_library/hpp.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,47 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Header <boost/extension/shared_library.hpp></title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Boost.Extension">
+<link rel="up" href="../../../../boost_extension/reference.html" title="Reference">
+<link rel="prev" href="../../../../BOOST_PP_FILENAME_1.html" title="Macro BOOST_PP_FILENAME_1">
+<link rel="next" href="../../../../boost/extensions/shared_library.html" title="Class shared_library">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../../../BOOST_PP_FILENAME_1.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../../boost/extensions/shared_library.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.extension.shared_library.hpp"></a>Header <boost/extension/shared_library.hpp></h3></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace extensions {
+ class shared_library;
+ }
+}</pre>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../../../../BOOST_PP_FILENAME_1.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../../boost_extension/reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../../boost/extensions/shared_library.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Modified: sandbox/libs/extension/doc/html/index.html
==============================================================================
--- sandbox/libs/extension/doc/html/index.html (original)
+++ sandbox/libs/extension/doc/html/index.html 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -50,14 +50,14 @@
<dt><a href="boost_extension/shared_libraries/shared_library_class.html">shared_library
 class</a></dt>
</dl></dd>
-<dt> Factories</dt>
<dt>Tutorials</dt>
<dd><dl>
<dt><a href="boost_extension/tutorials.html#boost_extension.tutorials.tutorial01"> Tutorial 1 - Using
- the <code class="literal"><code class="computeroutput">shared_library</code></code>
- class</a></dt>
-<dt> Tutorial 2</dt>
-<dt> Tutorial 3</dt>
+ the <code class="computeroutput">shared_library</code> class</a></dt>
+<dt><a href="boost_extension/tutorials/tutorial02.html"> Tutorial 2 - Basic
+ Factories</a></dt>
+<dt><a href="boost_extension/tutorials/tutorial03.html"> Tutorial 3 - Multiple
+ and Implementation Inheritance</a></dt>
<dt> Tutorial 4</dt>
<dt> Tutorial 5</dt>
</dl></dd>
@@ -127,11 +127,25 @@

 Tutorials:
 
-<div class="itemizedlist"><ul type="disc"><li>Tutorial 1: The shared_library class</li></ul></div>
+<div class="itemizedlist"><ul type="disc">
+<li><a href="boost_extension/tutorials.html#boost_extension.tutorials.tutorial01" title=" Tutorial 1 - Using
+ the shared_library class">Tutorial 1 - <code class="computeroutput">shared_library</code> class</a></li>
+<li><a href="boost_extension/tutorials/tutorial02.html" title=" Tutorial 2 - Basic
+ Factories">Tutorial 2 - <code class="computeroutput">factory</code> class</a></li>
+<li><a href="boost_extension/tutorials/tutorial03.html" title=" Tutorial 3 - Multiple
+ and Implementation Inheritance">Tutorial 3 - Multiple
+ and Implementation Inheritance</a></li>
+</ul></div>

 Other Sections:
 
-<div class="itemizedlist"><ul type="disc"><li>Motivation</li></ul></div>
+<div class="itemizedlist"><ul type="disc">
+<li>Motivation</li>
+<li>Shared Libraries</li>
+<li><a href="boost_extension/extension_reflection.html" title=" Boost.Reflection/Boost.Extension
+ Interoperability">Extension/Reflection
+ Interoperability</a></li>
+</ul></div>

 The other sections in the documentation should be updated over the next few
 weeks, in preparation for review.

Modified: sandbox/libs/extension/doc/tutorial1.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial1.qbk (original)
+++ sandbox/libs/extension/doc/tutorial1.qbk 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -6,7 +6,7 @@
[/ See http://www.boost.org/ for latest version. ]

-[section:tutorial01 Tutorial 1 - Using the _shared_library_ class]
+[section:tutorial01 Tutorial 1 - Using the `shared_library` class]

The _shared_library_ class facilitates loading shared libraries
and calling functions from them.

Modified: sandbox/libs/extension/doc/tutorial2.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial2.qbk (original)
+++ sandbox/libs/extension/doc/tutorial2.qbk 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -5,117 +5,207 @@
[/ http://www.boost.org/LICENSE_1_0.txt) ]
[/ See http://www.boost.org/ for latest version. ]

-[section:tutorial02 Tutorial 2]
+[section:tutorial02 Tutorial 2 - Basic Factories]

-This tutorial shows more advanced class loading. The example described here is
-contrived, and such a convoluted design is not used as an example of good
-object-oriented program, but as a way to illustrate some of the possibilities
-with this library.
-
-Let's design a class hierarchy based on the following:
+The easiest method for creating plugins in C++ is to use factories.
+Consider the following base class:

+``
+class animal {
+public:
+ animal(int age) : age_(age) {
+ }
+ virtual ~animal(void) {
+ }
+ virtual std::string get_name(void) {
+ return "A generic animal";
+ }
+ int get_age(void) {
+ return age_;
+ }
+protected:
+ int age_;
+};
+``

-* There is a vehicle class
-* There is a computer class
-* A car is a vehicle
-* A boat is a vehicle
-* A plane is a vehicle
-* A flying_car is a plane and a car
-* A car_of_the_future is a flying_car, a boat, and a computer.
+The goal here is to create a main executable which creates and uses
+instances of the `animal` class. A shared library will then be created
+which includes classes derived from the `animal` class, which the main
+executable will also be able to load and use as `animal`s.

+The main executable will use a number of Extension and other Boost headers:

-In addition, we are not going to have any of these classes be interfaces. They
-will each have an implementation in a .cpp file. This will require multiple
-inheritance, as well as virtual inheritance (because otherwise a
-car_of_the_future would consist of three separate vehicle base classes!).
+``

+#include <iostream>
+#include <map>

-In addition, each class will be compiled into a separate shared library. This
-is not necessary, certainly, but will serve to illustrate some of the more
-advanced capabilities of the library, as well as some of the techniques
-necessary in this situation.
+#include <boost/extension/factory.hpp>
+#include <boost/extension/shared_library.hpp>
+#include <boost/extension/type_map.hpp>
+#include <boost/function.hpp>
+#include <boost/scoped_ptr.hpp>
+``

+It will also use the `animal` header, which will also be used by the
+shared library:

-To begin with, let's look at the Jamfile:
+``
+#include "animal.hpp"
+``

+The main function is similar to that from [link tutorial01 Tutorial 1].

``
-import type : change-generated-target-suffix ;
-import type : change-generated-target-prefix ;
-type.change-generated-target-suffix SHARED_LIB : : extension ;
-type.change-generated-target-prefix SHARED_LIB : : lib ;
-``
+int main() {
+ using namespace boost::extensions;
+ std::string library_path = "libtutorial_2.extension";

+ // Create shared_library object with the relative or absolute
+ // path to the shared library.
+ shared_library lib(library_path);

-First we must rename the generated libraries (this is required for
-cross-platform use - but the prefix and suffix are arbitrary).
+ // Attempt to open the shared library.
+ if (!lib.open()) {
+ std::cerr << "Library failed to open: " << library_path << std::endl;
+ return 1;
+ }
+``

+Here though, instead of using the _shared_library_get_ function, we use the
+_shared_library_call_ function. It expects a function with the following signature:

``
-lib Vehicle : multiple_inheritance/vehicle.cpp : <link>shared ;
-lib Car : multiple_inheritance/car.cpp Vehicle : <link>shared ;
+extern "C" void boost_extension_exported_type_map_function
+ (boost::extensions::type_map& types);
``

+A _type_map_ is a generic container with items indexed by type - only one
+item of each type can be contained in it. To retrieve (or add) an integer
+to it, do the following:

-Notice here that the Car library is linked to the Vehicle library - this is
-necessary because the Car class needs the implementation of the Vehicle class.
-This is unrelated to the Boost.Extension library, but just a standard
-requirement when inheriting from shared library classes. The same will be done
-with the other shared libraries.
+``
+int& my_int(my_type_map.get());
+``

+For the rationale of the _type_map_ class, see the discussion on
+[link type_safety type safety].

``
-lib Plane : multiple_inheritance/plane.cpp Vehicle : <link>shared ;
-lib Boat : multiple_inheritance/boat.cpp Vehicle : <link>shared ;
-lib Computer : multiple_inheritance/computer.cpp : <link>shared ;
-lib FlyingCar : multiple_inheritance/flying_car.cpp Plane Car Vehicle
- : <link>shared ;
-lib CarOfTheFuture :
- multiple_inheritance/car_of_the_future.cpp
- Plane Car Vehicle
- FlyingCar Computer Boat
- :
- <link>shared
-;

-install ../bin :
- HelloWorld HelloWorldLib Vehicle Boat FlyingCar
- CarOfTheFuture MultipleInheritance
- :
- ;
+ // Use the shared_library::call to automatically call an
+ // Extension-specific function in the shared library,
+ // which takes a type_map.
+ type_map types;
+ if (!lib.call(types)) {
+ std::cerr << "Function not found!" << std::endl;
+ return 1;
+ }
``

+Now, a `std::map` of factories, indexed by `std::string` is retrieved from
+the _type_map_ that was sent to the shared library.

-Refer to the examples/multiple_inheritance folder for the source code of these
-classes. Only the most complex will be described here - the rest are similar.
+The _factory_ is declared as `factory<animal, int>` meaning it returns pointers
+to instances of the `animal` class, and that it is used for constructors taking
+integer arguments.

+``
+ // Retrieve a map of all animal factories taking an int and indexed
+ // by a string from the type_map.
+ std::map<std::string, factory<animal, int> >& factories(types.get());
+ if (factories.empty()) {
+ std::cerr << "Animals not found!" << std::endl;
+ return 1;
+ }
+``

-On the Windows platform, there are special declarations that are required when
-a dll must use a class that is defined in another dll. For interface only
-classes this is unnecessary, and is not needed on other platforms. The macros
-BOOST_EXTENSION_IMPORT_DECL and BOOST_EXTENSION_EXPORT_DECL can be used
-to insert the proper declaration. This is detailed in the appendix.
+Now, iterate through the factory, creating each available `animal`.

+``
+ // Create each animal.
+ int age = 1;
+ for (std::map<std::string, factory<animal, int> >::iterator it
+ = factories.begin();
+ it != factories.end(); ++it) {
+ ++age;
+ std::cout << "Creating an animal using factory: " << it->first << std::endl;
+ boost::scoped_ptr<animal> current_animal(it->second.create(age));
+ std::cout << "Created an animal: " << current_animal->get_name()
+ << " Age: " << current_animal->get_age() << std::endl;
+ }
+}
+``
+
+Now, the shared library will define a number of animals. It will
+use the following headers:

``
-#define BOOST_EXTENSION_FLYING_CAR_DECL BOOST_EXTENSION_IMPORT_DECL
-#define BOOST_EXTENSION_BOAT_DECL BOOST_EXTENSION_IMPORT_DECL
-#define BOOST_EXTENSION_COMPUTER_DECL BOOST_EXTENSION_IMPORT_DECL
-#include "flying_car.hpp"
-#include "boat.hpp"
-#include "computer.hpp"
#include <iostream>
-#include <typeinfo>
-class BOOST_EXTENSION_CAR_OF_THE_FUTURE_DECL
- car_of_the_future : public flying_car, public boat, public computer
-{
-public:
- car_of_the_future(void){std::cout << "\nCreated a Car of the Future";}
- ~car_of_the_future(void){std::cout << "\nDestroyed a Car of the Future";}
- virtual std::string list_capabilities(void);
-};
+#include <map>
+
+#include <boost/extension/extension.hpp>
+#include <boost/extension/factory.hpp>
+#include <boost/extension/type_map.hpp>
+
+#include "animal.hpp"
+``
+
+The following animals will be exported:
+
``
+class puma : public animal {
+ public:
+ puma(int age) : animal(age) {}
+ virtual std::string get_name() {
+ return "puma";
+ }
+};
+
+class leopard : public animal {
+ public:
+ leopard(int age) : animal(age) {}
+ virtual std::string get_name() {
+ return "leopard";
+ }
+};

+class wildcat : public animal {
+ public:
+ wildcat(int age) : animal(age) {}
+ virtual std::string get_name() {
+ return "wildcat";
+ }
+};
+
+class cougar : public animal {
+ public:
+ cougar(int age) : animal(age) {}
+ virtual std::string get_name() {
+ return "cougar";
+ }
+};
+``

+The `BOOST_EXTENSION_TYPE_MAP_FUNCTION` declaration can be used in place
+of a function declaration to automatically insert the function definition
+referred to above, that takes a _type_map_. See `<boost/extension/extension.hpp>`
+for more details.
+
+``
+BOOST_EXTENSION_TYPE_MAP_FUNCTION {
+ using namespace boost::extensions;
+ std::map<std::string, factory<animal, int> >&
+ animal_factories(types.get());
+ animal_factories["Puma factory"].set<puma>();
+ animal_factories["Leopard factory"].set<leopard>();
+ animal_factories["Wildcat factory"].set<wildcat>();
+ animal_factories["Cougar factory"].set<cougar>();
+}
+``
+
+Now, compile the shared library and main executable. Then run the main executable
+in the directory with the compiled library. If all is successful, a message will
+be printed out for each animal.

[endsect]
\ No newline at end of file

Modified: sandbox/libs/extension/doc/tutorial3.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial3.qbk (original)
+++ sandbox/libs/extension/doc/tutorial3.qbk 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -1,135 +1,189 @@
-[/ Boost.Extension - third tutorial ]
-[/ Copyright 2008 Mariano G. Consoni ]
+[/ Boost.Extension - second tutorial ]
+[/ Copyright 2008 Jeremy Pack ]
[/ Distributed under the Boost Software License, Version 1.0. (See]
[/ accompanying file LICENSE_1_0.txt or copy at ]
[/ http://www.boost.org/LICENSE_1_0.txt) ]
[/ See http://www.boost.org/ for latest version. ]

+[section:tutorial03 Tutorial 3 - Multiple and Implementation Inheritance]

-[section:tutorial03 Tutorial 3]
+This tutorial shows more advanced class loading. The example described here is
+contrived, and such a convoluted design is not used as an example of good
+object-oriented program, but as a way to illustrate some of the possibilities
+with this library.

-This tutorial shows how to register and instantiate classes that have
-multi-argument constructors (not default constructors) in Boost.Extension.
-In the example that we will describe in this tutorial (examples/parameters)
-we create a dummy class with a constructor that have six arguments. We'll
-register this class in a factory map and then get it from the main file.
+Most complications with this type of factory usage only occur on Windows, or with
+less popular compiler options. Refer to
+[link boost_extension.appendices.appendix_a Appendix A].

-It is expected that before following this tutorial you have gone trough the
-first tutorial at least, and you are familiar with the basic use of
-Boost.Extension.
+Let's design a class hierarchy based on the following:

-Let's start defining our class. Its constructor receives six parameters (we
-chose that number because it's the default argument limit of the library),
-each one of a different type including a class defined in the interface
-(class A) and a smart pointer to this class. It shows via stdout the received
-parameters at construction.
+* There is a vehicle class
+* There is a computer class
+* A car is a vehicle
+* A boat is a vehicle
+* A plane is a vehicle
+* A flying_car is a plane and a car
+* A car_of_the_future is a flying_car, a boat, and a computer.
+
+
+In addition, we are not going to have any of these classes be interfaces. They
+will each have an implementation in a .cpp file. This will require multiple
+inheritance, as well as virtual inheritance (because otherwise a
+car_of_the_future would consist of three separate vehicle base classes!).
+
+
+In addition, each class will be compiled into a separate shared library. This
+is not necessary, certainly, but will serve to illustrate some of the more
+advanced capabilities of the library, as well as some of the techniques
+necessary in this situation.
+
+
+To begin with, let's look at the Jamfile:

``
-class six_parameters : public lots_of_parameters_interface
-{
- public:
- six_parameters(bool b, unsigned int i, char c, std::string s, A a,
- boost::shared_ptr<A> ptr_a)
- lots_of_parameters_interface(b, i, c, s, a, ptr_a)
- {
- std::cout << "Constructor called." << std::endl << std::endl;
- std::cout << "Parameters:" << std::endl;
- std::cout << "\tbool: " << b << std::endl;
- std::cout << "\tunsigned int: " <i: " << ptr_a->i << std::endl;
- std::cout << std::endl;
- }
+import type : change-generated-target-suffix ;
+import type : change-generated-target-prefix ;
+type.change-generated-target-suffix SHARED_LIB : : extension ;
+type.change-generated-target-prefix SHARED_LIB : : lib ;
+``
+
+As usual, first we must rename the generated libraries (this is required for
+cross-platform use - but the prefix and suffix are arbitrary).
+
+Next, some special options are needed for certain compilers, to make sure
+that the shared libraries are found correctly. This is only needed for this
+example because we have shared libraries that are linked by the linker after
+compilation to other shared libraries, rather than loaded by the shared_library
+class at runtime. Library paths and includes need to be set as follows:

- virtual ~six_parameters(void) {}
-};
``
-\n
-The interface that we are inheriting is just the bare minimum needed to make it
-compile:
+local BOOST_ROOT = [ os.environ BOOST_ROOT ] ;
+project
+ : requirements
+ <include>../../../
+ <include>$(BOOST_ROOT)
+ <toolset>gcc:<find-shared-library>dl
+ <toolset>gcc:<linkflags>"-Wl,-rpath,'$ORIGIN'"
+ <toolset>darwin:<define>DYLD_LIBRARY_PATH=./
+ :
+ ;

``
-class A
-{
- public:
- A(unsigned int i) : i(i) {}
- int i;
-};

+The rules for building the first two libraries are the same
+as those from earlier tutorials.

-class lots_of_parameters_interface
-{
- public:
- lots_of_parameters_interface(bool b, unsigned int i, char c,
- std::string s, A a,
- boost::shared_ptr<A> ptr_a) {}
- virtual ~lots_of_parameters_interface(void) {}
-};
``
-\n
-Having the class defined, we should write the export function to register the
-class in the passed factory map. The point here is that the factory_map::add
-method must be set with the first type as the third argument, and with the
-second type as the fourth argument and so on.
+lib Vehicle : multiple_inheritance/vehicle.cpp : <link>shared ;
+lib Car : multiple_inheritance/car.cpp Vehicle : <link>shared ;
+``
+
+
+Notice here that the Car library is linked to the Vehicle library - this is
+necessary because the Car class needs the implementation of the Vehicle class.
+This is not specific to the Boost.Extension library, but just a standard
+requirement when inheriting from shared library classes. The same will be done
+with the other shared libraries.
+

``
-extern "C" void BOOST_EXTENSION_EXPORT_DECL
-extension_export(boost::extensions::factory_map & fm)
-{
- fm.get<lots_of_parameters_interface, int, bool,
- unsigned int, char, std::string, A,
- boost::shared_ptr<A> >()[6].set<six_parameters>();
-}
+lib Plane : multiple_inheritance/plane.cpp Vehicle : <link>shared ;
+lib Boat : multiple_inheritance/boat.cpp Vehicle : <link>shared ;
+lib Computer : multiple_inheritance/computer.cpp : <link>shared ;
+lib FlyingCar : multiple_inheritance/flying_car.cpp Plane Car Vehicle
+ : <link>shared ;
+lib CarOfTheFuture :
+ multiple_inheritance/car_of_the_future.cpp
+ Plane Car Vehicle
+ FlyingCar Computer Boat
+ :
+ <link>shared
+;
+
+install ../bin :
+ HelloWorld HelloWorldLib Vehicle Boat FlyingCar
+ CarOfTheFuture MultipleInheritance
+ :
+ ;
``
-\n
-Finally, let's see how it is used in the main file.
+
+
+Refer to the examples/multiple_inheritance folder for the source code of these
+classes. Only the most complex will be described here - the rest are similar.
+
+
+On the Windows platform, there are special declarations that are required when
+a dll must use a class that is defined in another dll. For interface only
+classes this is unnecessary, and is not needed on other platforms. The macros
+BOOST_EXTENSION_IMPORT_DECL and BOOST_EXTENSION_EXPORT_DECL can be used
+to insert the proper declaration. This is detailed in
+[link boost_extension.appendices.appendix_a Appendix A].
+
+The macros here are defined in such a way that in the `car_of_the_future`
+class, the classes it depends on from other shared libraries are
+declared as imports. The BOOST_EXTENSION_CAR_OF_THE_FUTURE_DECL must be
+defined by any source file using this class - as `BOOST_EXTENSION_IMPORT_DECL`
+by the shared library containing the `car_of_the_future`, and as
+`BOOST_EXTENSION_EXPORT_DECL` by any shared library or executable linking
+directly to that shared library.

``
-int main(void)
+#define BOOST_EXTENSION_FLYING_CAR_DECL BOOST_EXTENSION_IMPORT_DECL
+#define BOOST_EXTENSION_BOAT_DECL BOOST_EXTENSION_IMPORT_DECL
+#define BOOST_EXTENSION_COMPUTER_DECL BOOST_EXTENSION_IMPORT_DECL
+#include "flying_car.hpp"
+#include "boat.hpp"
+#include "computer.hpp"
+#include <iostream>
+#include <typeinfo>
+class BOOST_EXTENSION_CAR_OF_THE_FUTURE_DECL
+ car_of_the_future : public flying_car, public boat, public computer
{
- using namespace boost::extensions;
+public:
+ car_of_the_future(void){std::cout << "\nCreated a Car of the Future";}
+ ~car_of_the_future(void){std::cout << "\nDestroyed a Car of the Future";}
+ virtual std::string list_capabilities(void);
+};
+``

- // Create the factory_map object - it will hold all of the available
- // constructors. Multiple factory_maps can be constructed.
- factory_map fm;
-
- // load the shared library with
- load_single_library(fm, "libParametersLib.extension", "extension_export");
-
- std::map<int, factory<lots_of_parameters_interface, bool, unsigned int,
- char, std::string, A, boost::shared_ptr<A> > > &
- factory_list =
- fm.get<lots_of_parameters_interface, int, bool, unsigned int, char,
- std::string, A, boost::shared_ptr<A> >();
- if (factory_list.size() != 1) {
- std::cout << "Error - the class was not found.";
- return 1;
- }
-
- std::map<int, factory<lots_of_parameters_interface, bool, unsigned int,
- char, std::string, A, boost::shared_ptr<A> > >
- ::iterator par = factory_list.begin();
- std::auto_ptr<lots_of_parameters_interface>
- par_ptr(par->create(true, 4, 'c', "test", A(2),
- boost::shared_ptr<A>(new A(15))));
+In the implementation file for the `car_of_the_future`, it is exported
+as an implementation of each of its base classes.

- return 0;
-}
``
+std::string car_of_the_future::list_capabilities() {
+ return boat::list_capabilities() + flying_car::list_capabilities() +
+ computer::list_capabilities() + "\nCosts an arm and a leg";
+}

-Please note the following details:
+using boost::extensions::factory;

-* Shared library loading is exactly the same.
-* When we get the factory we should specify the template parameters, as we did in the factory_map::add method.
-* When we call the create method we just supply the needed arguments and just works!
+BOOST_EXTENSION_TYPE_MAP_FUNCTION {
+ types.get<std::map<std::string, factory<vehicle> > >()
+ ["A car of the future exported as a vehicle"].set<car_of_the_future>();
+ types.get<std::map<std::string, factory<car> > >()
+ ["A car of the future exported as a car"].set<car_of_the_future>();
+ types.get<std::map<std::string, factory<plane> > >()
+ ["A car of the future exported as a plane"].set<car_of_the_future>();
+ types.get<std::map<std::string, factory<flying_car> > >()
+ ["A car of the future exported as a flying car"].set<car_of_the_future>();
+ types.get<std::map<std::string, factory<boat> > >()
+ ["A car of the future exported as a boat"].set<car_of_the_future>();
+ types.get<std::map<std::string, factory<computer> > >()
+ ["A car of the future exported as a computer"].set<car_of_the_future>();
+ types.get<std::map<std::string, factory<car_of_the_future> > >()
+ ["A car of the future exported as a car of the future"].set<car_of_the_future>();
+}
+``

-\n
+The main executable is relatively straightforward, but does introduce a new
+function: `load_single_library`, which takes a _type_map_ and the location
+of the shared library, and loads the library and calls the function declared
+as `BOOST_EXTENSION_TYPE_MAP_FUNCTION`.

-It is expected that at this point you can create your own classes with
-multi-argument constructors and use them via Boost.extensions without problems.
+Now, place all of the compiled libraries and the main executable in a directory together,
+and run the executable.

[endsect]
\ No newline at end of file

Modified: sandbox/libs/extension/doc/tutorials.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorials.qbk (original)
+++ sandbox/libs/extension/doc/tutorials.qbk 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -12,21 +12,4 @@
[include tutorial4.qbk]
[include tutorial5.qbk]

-There are currently five tutorials.
-
-The first tutorial is a basic hello world example.
-
-The second tutorial is a more complex example involving multiple inheritance,
-virtual inheritance, and inheritance across shared libraries.
-
-The third tutorial shows how to register classes with multi parameter
-constructors.
-
-The fourth tutorial is a about multiple library loading, with some strange cases
-like loading the same library many times and loading very similar classes.
-
-The fifth tutorial is an advanced example of using the Info template parameter.
-There is a simpler usage of this parameter in the examples/info folder as well.
-
-The tutorial code can be found in the examples folder. They all share the same Jamfile, but the Jamfile contents are separated out for each tutorial.
[endsect]
\ No newline at end of file

Modified: sandbox/libs/extension/examples/Jamfile.v2
==============================================================================
--- sandbox/libs/extension/examples/Jamfile.v2 (original)
+++ sandbox/libs/extension/examples/Jamfile.v2 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -56,8 +56,12 @@
lib tutorial_1 : tutorial_1/hello_world.cpp : <link>shared ;
exe tutorial_1_bin : tutorial_1/main.cpp ;

+lib tutorial_2 : tutorial_2/factories_lib.cpp : <link>shared ;
+exe tutorial_2_bin : tutorial_2/factories_main.cpp ;
+
install ../test/ :
 tutorial_1 tutorial_1_bin
+ tutorial_2 tutorial_2_bin
 Parameters ParametersLib
 MultilanguageWord MultilanguageHelloWorld
 IM IMPlugins

Modified: sandbox/libs/extension/examples/multiple_inheritance/boat.cpp
==============================================================================
--- sandbox/libs/extension/examples/multiple_inheritance/boat.cpp (original)
+++ sandbox/libs/extension/examples/multiple_inheritance/boat.cpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -22,7 +22,8 @@
#include <boost/extension/extension.hpp>
#define BOOST_EXTENSION_BOAT_DECL BOOST_EXTENSION_EXPORT_DECL
#include "boat.hpp"
-#include <boost/extension/factory_map.hpp>
+#include <boost/extension/type_map.hpp>
+#include <boost/extension/factory.hpp>

std::string boat::list_capabilities()
@@ -30,9 +31,11 @@
return "\nIt floats on water.";
}

-extern "C" void BOOST_EXTENSION_EXPORT_DECL
-extension_export(boost::extensions::factory_map & z)
-{
- z.get<vehicle, std::string>()["A boat exported as a vehicle"].set<boat>();
- z.get<boat, std::string>()["A boat exported as a boat"].set<boat>();
+using boost::extensions::factory;
+
+BOOST_EXTENSION_TYPE_MAP_FUNCTION {
+ types.get<std::map<std::string, factory<vehicle> > >()
+ ["A boat exported as a vehicle"].set<boat>();
+ types.get<std::map<std::string, factory<boat> > >()
+ ["A boat exported as a boat"].set<boat>();
}

Modified: sandbox/libs/extension/examples/multiple_inheritance/car.cpp
==============================================================================
--- sandbox/libs/extension/examples/multiple_inheritance/car.cpp (original)
+++ sandbox/libs/extension/examples/multiple_inheritance/car.cpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -25,15 +25,18 @@

#include "car.hpp"
-#include <boost/extension/factory_map.hpp>
+#include <boost/extension/type_map.hpp>
+#include <boost/extension/factory.hpp>
std::string car::list_capabilities()
{
return "\nIt travels on roads.";
}

-extern "C" void BOOST_EXTENSION_EXPORT_DECL
-extension_export(boost::extensions::factory_map & z)
-{
- z.get<vehicle, std::string>()["A car exported as a vehicle"].set<car>();
- z.get<car, std::string>()["A car exported as a car"].set<car>();
+using boost::extensions::factory;
+
+BOOST_EXTENSION_TYPE_MAP_FUNCTION {
+ types.get<std::map<std::string, factory<vehicle> > >()
+ ["A car exported as a vehicle"].set<car>();
+ types.get<std::map<std::string, factory<car> > >()
+ ["A car exported as a car"].set<car>();
}

Modified: sandbox/libs/extension/examples/multiple_inheritance/car_of_the_future.cpp
==============================================================================
--- sandbox/libs/extension/examples/multiple_inheritance/car_of_the_future.cpp (original)
+++ sandbox/libs/extension/examples/multiple_inheritance/car_of_the_future.cpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -23,30 +23,30 @@
#define BOOST_EXTENSION_CAR_OF_THE_FUTURE_DECL BOOST_EXTENSION_EXPORT_DECL

#include "car_of_the_future.hpp"
-#include <boost/extension/factory_map.hpp>
+#include <boost/extension/type_map.hpp>
+#include <boost/extension/factory.hpp>
#include <string>

-std::string car_of_the_future::list_capabilities()
-{
+std::string car_of_the_future::list_capabilities() {
 return boat::list_capabilities() + flying_car::list_capabilities() +
 computer::list_capabilities() + "\nCosts an arm and a leg";
}

-extern "C" void BOOST_EXTENSION_EXPORT_DECL
-extension_export(boost::extensions::factory_map & z)
-{
- z.get<vehicle, std::string>()
+using boost::extensions::factory;
+
+BOOST_EXTENSION_TYPE_MAP_FUNCTION {
+ types.get<std::map<std::string, factory<vehicle> > >()
 ["A car of the future exported as a vehicle"].set<car_of_the_future>();
- z.get<car, std::string>()
+ types.get<std::map<std::string, factory<car> > >()
 ["A car of the future exported as a car"].set<car_of_the_future>();
- z.get<plane, std::string>()
+ types.get<std::map<std::string, factory<plane> > >()
 ["A car of the future exported as a plane"].set<car_of_the_future>();
- z.get<flying_car, std::string>()
+ types.get<std::map<std::string, factory<flying_car> > >()
 ["A car of the future exported as a flying car"].set<car_of_the_future>();
- z.get<boat, std::string>()
+ types.get<std::map<std::string, factory<boat> > >()
 ["A car of the future exported as a boat"].set<car_of_the_future>();
- z.get<computer, std::string>()
+ types.get<std::map<std::string, factory<computer> > >()
 ["A car of the future exported as a computer"].set<car_of_the_future>();
- z.get<car_of_the_future, std::string>()
+ types.get<std::map<std::string, factory<car_of_the_future> > >()
 ["A car of the future exported as a car of the future"].set<car_of_the_future>();
}

Modified: sandbox/libs/extension/examples/multiple_inheritance/computer.cpp
==============================================================================
--- sandbox/libs/extension/examples/multiple_inheritance/computer.cpp (original)
+++ sandbox/libs/extension/examples/multiple_inheritance/computer.cpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -23,17 +23,17 @@

#include "computer.hpp"
-#include <boost/extension/factory_map.hpp>
+#include <boost/extension/type_map.hpp>
+#include <boost/extension/factory.hpp>

std::string computer::list_capabilities()
{
return "\nIt computes.";
}

-extern "C" void BOOST_EXTENSION_EXPORT_DECL
-extension_export(boost::extensions::factory_map & z)
-{
- z.get<computer,
- std::string>()["\nA computer exported as a computer"]
- .set<computer>();
+using boost::extensions::factory;
+
+BOOST_EXTENSION_TYPE_MAP_FUNCTION {
+ types.get<std::map<std::string, factory<computer> > >()
+ ["\nA computer exported as a computer"].set<computer>();
}

Modified: sandbox/libs/extension/examples/multiple_inheritance/flying_car.cpp
==============================================================================
--- sandbox/libs/extension/examples/multiple_inheritance/flying_car.cpp (original)
+++ sandbox/libs/extension/examples/multiple_inheritance/flying_car.cpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -25,7 +25,8 @@

#include "flying_car.hpp"
-#include <boost/extension/factory_map.hpp>
+#include <boost/extension/type_map.hpp>
+#include <boost/extension/factory.hpp>

std::string flying_car::list_capabilities()
{
@@ -33,14 +34,15 @@
+ "\nIt takes off from your driveway";
}

-extern "C" void BOOST_EXTENSION_EXPORT_DECL
-extension_export(boost::extensions::factory_map & z)
-{
- z.get<vehicle,
- std::string>()["A flying car exported as a vehicle"].set<flying_car>();
- z.get<plane, std::string>()["A flying car exported as a plane"]
- .set<flying_car>();
- z.get<car, std::string>()["A flying car exported as a car"].set<flying_car>();
- z.get<flying_car,
- std::string>()["A flying car exported as a flying car"].set<flying_car>();
+using boost::extensions::factory;
+
+BOOST_EXTENSION_TYPE_MAP_FUNCTION {
+ types.get<std::map<std::string, factory<vehicle> > >()
+ ["A flying car exported as a vehicle"].set<flying_car>();
+ types.get<std::map<std::string, factory<plane> > >()
+ ["A flying car exported as a plane"].set<flying_car>();
+ types.get<std::map<std::string, factory<car> > >()
+ ["A flying car exported as a car"].set<flying_car>();
+ types.get<std::map<std::string, factory<flying_car> > >()
+ ["A flying car exported as a flying car"].set<flying_car>();
}

Modified: sandbox/libs/extension/examples/multiple_inheritance/main_mi.cpp
==============================================================================
--- sandbox/libs/extension/examples/multiple_inheritance/main_mi.cpp (original)
+++ sandbox/libs/extension/examples/multiple_inheritance/main_mi.cpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -9,7 +9,7 @@
 * See http://www.boost.org/ for latest version.
 */

-#include <boost/extension/factory_map.hpp>
+#include <boost/extension/type_map.hpp>
#include <boost/extension/shared_library.hpp>
// See the FAQ for info about why the following is necessary
// here, but usually isn't.
@@ -18,71 +18,67 @@
#include "vehicle.hpp"
#include "computer.hpp"
#include <iostream>
-#include <memory>
+#include <boost/scoped_ptr.hpp>
#include <boost/extension/convenience.hpp>
-// #include <boost/extension/filesystem.hpp>

-
-int main()
-{
+int main() {
 using namespace boost::extensions;
- // Create the factory_map object - it will hold all of the available
- // constructors. Multiple zones can be constructed.
- factory_map twilight;
+ // Create the type_map object - it will hold all of the available
+ // constructors.
+ type_map types;
 // Load the constructors and information into the factory_map.
- load_single_library(twilight, "libVehicle.extension", "extension_export");
- load_single_library(twilight, "libCar.extension", "extension_export");
- load_single_library(twilight, "libComputer.extension", "extension_export");
- load_single_library(twilight, "libBoat.extension", "extension_export");
- load_single_library(twilight, "libFlyingCar.extension", "extension_export");
- load_single_library(twilight, "libCarOfTheFuture.extension",
- "extension_export");
- load_single_library(twilight, "libPlane.extension", "extension_export");
- // load_all_libraries(twilight, "./", "extension_export_word");
+ load_single_library(types, "libVehicle.extension");
+ load_single_library(types, "libCar.extension");
+ load_single_library(types, "libComputer.extension");
+ load_single_library(types, "libBoat.extension");
+ load_single_library(types, "libFlyingCar.extension");
+ load_single_library(types, "libCarOfTheFuture.extension");
+ load_single_library(types, "libPlane.extension");
+
 // Get a reference to the list of constructors.
 // Note that the factories can be copied just fine - meaning that the
- // factory list
- // can be copied from the factory_map object into a different data
- // structure, and the factory_map can be destroyed.
+ // map of factories can be copied from the type_map object into a
+ // different data structure, and the type_map can be destroyed.
+ // Here, we just use the efficient std::map::swap function.
 std::cout << "\n>>>>>>>>>>>>\nComputers:\n>>>>>>>>>>>>>>>>>>>";
- std::map<std::string, factory<computer> > & factory_list =
- twilight.get<computer, std::string>();
- if (factory_list.size() < 1)
+ std::map<std::string, factory<computer> > computers;
+ computers.swap(types.get());
+ if (computers.empty()) {
 std::cout << "Error - no computers were found.";
+ return 1;
+ }
 for (std::map<std::string, factory<computer> >::iterator comp =
- factory_list.begin(); comp != factory_list.end(); ++comp)
- {
- // Using auto_ptr to avoid needing delete. Using smart_ptrs is
+ computers.begin(); comp != computers.end(); ++comp) {
+ // Using scoped_ptr to avoid needing delete. Using smart_ptrs is
 // recommended.
 // Note that this has a zero argument constructor - currently constructors
 // with up to six arguments can be used.
- std::auto_ptr<computer> computer_ptr(comp->second.create());
+ boost::scoped_ptr<computer> computer_ptr(comp->second.create());
 std::cout << "\n--------\nLoaded the class described as: ";
 std::cout << comp->first;
 std::cout << "\n\nIt claims the following capabilities: ";
- std::cout << computer_ptr->list_capabilities() << "\n";
+ std::cout << computer_ptr->list_capabilities() << std::endl;
 }
 std::cout << "\n\n";
-
-
-
- std::cout << "\n>>>>>>>>>>>>\nVehicles:\n>>>>>>>>>>>>>>>>>>>";
- std::map<std::string, factory<vehicle> > & factory_list2 =
- twilight.get<vehicle, std::string>();
- if (factory_list2.size() < 1)
+
+ std::cout << "\n>>>>>>>>>>>>\nVehicles:\n>>>>>>>>>>>>>>>>>>>" << std::endl;
+ std::map<std::string, factory<vehicle> > vehicles;
+ vehicles.swap(types.get());
+ if (vehicles.empty()) {
 std::cout << "Error - no vehicles were found.";
- for (std::map<std::string, factory<vehicle> >::iterator comp =
- factory_list2.begin(); comp != factory_list2.end(); ++comp)
- {
+ return 1;
+ }
+ for (std::map<std::string, factory<vehicle> >::iterator v =
+ vehicles.begin(); v != vehicles.end(); ++v) {
 // Using auto_ptr to avoid needing delete. Using smart_ptrs is
 // recommended.
 // Note that this has a zero argument constructor - currently constructors
 // with up to six arguments can be used.
- std::auto_ptr<vehicle> computer_ptr(comp->second.create());
+ std::auto_ptr<vehicle> vehicle_ptr(v->second.create());
 std::cout << "\n--------\nLoaded the class described as: ";
- std::cout << comp->first;
+ std::cout << v->first;
 std::cout << "\n\nIt claims the following capabilities: ";
- std::cout << computer_ptr->list_capabilities() << "\n";
+ std::cout << vehicle_ptr->list_capabilities() << std::endl;
 }
 std::cout << "\n\n";
 return 0;

Modified: sandbox/libs/extension/examples/multiple_inheritance/plane.cpp
==============================================================================
--- sandbox/libs/extension/examples/multiple_inheritance/plane.cpp (original)
+++ sandbox/libs/extension/examples/multiple_inheritance/plane.cpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -23,18 +23,18 @@

#include "plane.hpp"
-#include <boost/extension/factory_map.hpp>
+#include <boost/extension/type_map.hpp>
+#include <boost/extension/factory.hpp>

-std::string plane::list_capabilities()
-{
+std::string plane::list_capabilities() {
return "\nIt flies in the air.";
}

-extern "C" void BOOST_EXTENSION_EXPORT_DECL
-extension_export(boost::extensions::factory_map & z)
-{
- z.get<vehicle, std::string>()["A plane exported as a vehicle"]
- .set<plane>();
- z.get<plane, std::string>()["A plane exported as a plane"]
- .set<plane>();
+using boost::extensions::factory;
+
+BOOST_EXTENSION_TYPE_MAP_FUNCTION {
+ types.get<std::map<std::string, factory<vehicle> > >()
+ ["A plane exported as a vehicle"].set<plane>();
+ types.get<std::map<std::string, factory<plane> > >()
+ ["A plane exported as a plane"].set<plane>();
}

Modified: sandbox/libs/extension/examples/multiple_inheritance/vehicle.cpp
==============================================================================
--- sandbox/libs/extension/examples/multiple_inheritance/vehicle.cpp (original)
+++ sandbox/libs/extension/examples/multiple_inheritance/vehicle.cpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -22,16 +22,17 @@
#define BOOST_EXTENSION_VEHICLE_DECL BOOST_EXTENSION_EXPORT_DECL

#include "vehicle.hpp"
-#include <boost/extension/factory_map.hpp>
+#include <boost/extension/type_map.hpp>
+#include <boost/extension/factory.hpp>

std::string vehicle::list_capabilities()
{
return "\nIt is some sort of vehicle.";
}

-extern "C" void BOOST_EXTENSION_EXPORT_DECL
-extension_export(boost::extensions::factory_map & z)
-{
- z.get<vehicle, std::string>()["A vehicle exported as a vehicle"]
- .set<vehicle>();
+using boost::extensions::factory;
+
+BOOST_EXTENSION_TYPE_MAP_FUNCTION {
+ types.get<std::map<std::string, factory<vehicle> > >()
+ ["A vehicle exported as a vehicle"].set<vehicle>();
}

Added: sandbox/libs/extension/examples/tutorial_1/hello_world.cpp
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/examples/tutorial_1/hello_world.cpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,28 @@
+/*
+ * Boost.Extension / hello world implementations
+ *
+ * (C) Copyright Jeremy Pack 2007-2008
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE_1_0.txt or copy at
+ * http://www.boost.org/LICENSE_1_0.txt)
+ *
+ * See http://www.boost.org/ for latest version.
+ */
+
+#include <iostream>
+
+#include <boost/extension/extension.hpp>
+
+// Any exported function or variable must be declared
+// extern "C" to avoid C++ name mangling.
+extern "C"
+// Depending on the compiler and settings,
+// it may be necessary to add a specific export
+// declaration. The BOOST_EXTENSION_EXPORT_DECL
+// adds this if necessary.
+void BOOST_EXTENSION_EXPORT_DECL
+boost_extension_hello_world(int repetitions) {
+ for (int i = 0; i < repetitions; ++i) {
+ std::cout << "Hello World" << std::endl;
+ }
+}

Added: sandbox/libs/extension/examples/tutorial_1/main.cpp
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/examples/tutorial_1/main.cpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,54 @@
+/*
+ * Boost.Extension / hello world example main
+ *
+ * (C) Copyright Jeremy Pack 2008
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE_1_0.txt or copy at
+ * http://www.boost.org/LICENSE_1_0.txt)
+ *
+ * See http://www.boost.org/ for latest version.
+ */
+
+#include <iostream>
+
+#include <boost/extension/shared_library.hpp>
+#include <boost/function.hpp>
+
+int main() {
+ using namespace boost::extensions;
+
+ // In the Jamfile, shared libraries are set to have the same
+ // prefix and extension, even on different operating systems.
+ // This is for convenience in writing cross-platform code, but
+ // is not required. All shared libraries are set to start with
+ // "lib" and end with "extension".
+ std::string library_path = "libtutorial_1.extension";
+
+ // Create shared_library object with the relative or absolute
+ // path to the shared library.
+ shared_library lib(library_path);
+
+ // Attempt to open the shared library.
+ if (!lib.open()) {
+ std::cerr << "Library failed to open: " << library_path << std::endl;
+ return 1;
+ }
+
+ // Retrieve a function from the library, and store it in a Boost.Function
+ // object. It is also possible to use function pointers, but the syntax
+ // for Boost.Function is easier to understand. This retrieves a function
+ // called "boost_extension_hello_world" with a void return type and a single
+ // parameter of type int.
+ boost::function<void (int)>
+ f(lib.get<void, int>("boost_extension_hello_world"));
+
+ // Check that the function was found.
+ if (!f) {
+ std::cerr << "Function not found!" << std::endl;
+ return 1;
+ }
+
+ // Call the function from the shared library with
+ // an integer parameter.
+ f(4);
+}

Added: sandbox/libs/extension/examples/tutorial_2/animal.hpp
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/examples/tutorial_2/animal.hpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,32 @@
+/*
+ * Boost.Extension / factory example (car)
+ *
+ * (C) Copyright Jeremy Pack 2007
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE_1_0.txt or copy at
+ * http://www.boost.org/LICENSE_1_0.txt)
+ *
+ * See http://www.boost.org/ for latest version.
+ */
+
+#ifndef BOOST_EXTENSION_ANIMAL_HPP
+#define BOOST_EXTENSION_ANIMAL_HPP
+
+#include <iostream>
+class animal {
+public:
+ animal(int age) : age_(age) {
+ }
+ virtual ~animal(void) {
+ }
+ virtual std::string get_name(void) {
+ return "A generic animal";
+ }
+ int get_age(void) {
+ return age_;
+ }
+protected:
+ int age_;
+};
+
+#endif

Added: sandbox/libs/extension/examples/tutorial_2/factories_lib.cpp
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/examples/tutorial_2/factories_lib.cpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,62 @@
+/*
+ * Boost.Extension / hello world implementations
+ *
+ * (C) Copyright Jeremy Pack 2007-2008
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE_1_0.txt or copy at
+ * http://www.boost.org/LICENSE_1_0.txt)
+ *
+ * See http://www.boost.org/ for latest version.
+ */
+
+#include <iostream>
+#include <map>
+
+#include <boost/extension/extension.hpp>
+#include <boost/extension/factory.hpp>
+#include <boost/extension/type_map.hpp>
+
+#include "animal.hpp"
+
+class puma : public animal {
+ public:
+ puma(int age) : animal(age) {}
+ virtual std::string get_name() {
+ return "puma";
+ }
+};
+
+class leopard : public animal {
+ public:
+ leopard(int age) : animal(age) {}
+ virtual std::string get_name() {
+ return "leopard";
+ }
+};
+
+class wildcat : public animal {
+ public:
+ wildcat(int age) : animal(age) {}
+ virtual std::string get_name() {
+ return "wildcat";
+ }
+};
+
+class cougar : public animal {
+ public:
+ cougar(int age) : animal(age) {}
+ virtual std::string get_name() {
+ return "cougar";
+ }
+};
+
+
+BOOST_EXTENSION_TYPE_MAP_FUNCTION {
+ using namespace boost::extensions;
+ std::map<std::string, factory<animal, int> >&
+ animal_factories(types.get());
+ animal_factories["Puma factory"].set<puma>();
+ animal_factories["Leopard factory"].set<leopard>();
+ animal_factories["Wildcat factory"].set<wildcat>();
+ animal_factories["Cougar factory"].set<cougar>();
+}

Added: sandbox/libs/extension/examples/tutorial_2/factories_main.cpp
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/examples/tutorial_2/factories_main.cpp 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -0,0 +1,71 @@
+/*
+ * Boost.Extension / hello world example main
+ *
+ * (C) Copyright Jeremy Pack 2008
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE_1_0.txt or copy at
+ * http://www.boost.org/LICENSE_1_0.txt)
+ *
+ * See http://www.boost.org/ for latest version.
+ */
+
+#include <iostream>
+#include <map>
+
+#include <boost/extension/factory.hpp>
+#include <boost/extension/shared_library.hpp>
+#include <boost/extension/type_map.hpp>
+#include <boost/function.hpp>
+#include <boost/scoped_ptr.hpp>
+
+#include "animal.hpp"
+
+int main() {
+ using namespace boost::extensions;
+
+ // In the Jamfile, shared libraries are set to have the same
+ // prefix and extension, even on different operating systems.
+ // This is for convenience in writing cross-platform code, but
+ // is not required. All shared libraries are set to start with
+ // "lib" and end with "extension".
+ std::string library_path = "libtutorial_2.extension";
+
+ // Create shared_library object with the relative or absolute
+ // path to the shared library.
+ shared_library lib(library_path);
+
+ // Attempt to open the shared library.
+ if (!lib.open()) {
+ std::cerr << "Library failed to open: " << library_path << std::endl;
+ return 1;
+ }
+
+ // Use the shared_library::call to automatically call an
+ // Extension-specific function in the shared library,
+ // which takes a type_map.
+ type_map types;
+ if (!lib.call(types)) {
+ std::cerr << "Function not found!" << std::endl;
+ return 1;
+ }
+
+ // Retrieve a map of all animal factories taking an int and indexed
+ // by a string from the type_map.
+ std::map<std::string, factory<animal, int> >& factories(types.get());
+ if (factories.empty()) {
+ std::cerr << "Animals not found!" << std::endl;
+ return 1;
+ }
+
+ // Create each animal.
+ int age = 1;
+ for (std::map<std::string, factory<animal, int> >::iterator it
+ = factories.begin();
+ it != factories.end(); ++it) {
+ ++age;
+ std::cout << "Creating an animal using factory: " << it->first << std::endl;
+ boost::scoped_ptr<animal> current_animal(it->second.create(age));
+ std::cout << "Created an animal: " << current_animal->get_name()
+ << " Age: " << current_animal->get_age() << std::endl;
+ }
+}

Modified: sandbox/libs/extension/test/Jamfile.v2
==============================================================================
--- sandbox/libs/extension/test/Jamfile.v2 (original)
+++ sandbox/libs/extension/test/Jamfile.v2 2008-07-25 20:02:26 EDT (Fri, 25 Jul 2008)
@@ -38,7 +38,8 @@
   # [ run lib_caching_test.cpp ]
   # [ run versions_test.cpp ]
   [ run parameters_test.cpp ]
- [ run multiple_inheritance_test.cpp ]
+ [ run executables_test.cpp ]
+ # [ run multiple_inheritance_test.cpp ] # redundant
   [ run extension_test.cpp ]
   # [ run counted_factory_test.cpp ]
   # [ run registry_test.cpp ]

Next message: oryol_at_[hidden]: "[Boost-commit] svn:boost r47823 - sandbox/boost/extension"
Previous message: daniel_james_at_[hidden]: "[Boost-commit] svn:boost r47821 - in branches/release: . tools/boostbook/xsl"

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