Boost-Commit :

Date view	Thread view	Subject view	Author view

From: oryol_at_[hidden]
Date: 2008-07-19 22:35:04

Next message: oryol_at_[hidden]: "[Boost-commit] svn:boost r47616 - in sandbox/libs/reflection: doc doc/html doc/html/boost_reflection test"
Previous message: oryol_at_[hidden]: "[Boost-commit] svn:boost r47614 - sandbox/libs/extension/test"

Author: jeremypack
Date: 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
New Revision: 47615
URL: http://svn.boost.org/trac/boost/changeset/47615

Log:
Doc updates.

Added:
   sandbox/libs/extension/doc/appendix_c.qbk (contents, props changed)
   sandbox/libs/extension/doc/extension-reflection.qbk (contents, props changed)
   sandbox/libs/extension/doc/extension_reflection.qbk (contents, props changed)
   sandbox/libs/extension/doc/html/BOOST_EXTENSION_EXPORT_DECL.html (contents, props changed)
   sandbox/libs/extension/doc/html/BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html (contents, props changed)
   sandbox/libs/extension/doc/html/N.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/faq.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/motivation.html (contents, props changed)
   sandbox/libs/extension/doc/motivation.qbk (contents, props changed)
Properties modified:
   sandbox/libs/extension/doc/html/boost_extension/appendices.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/factories.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/info.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/introduction.html (props changed)
   sandbox/libs/extension/doc/html/boost_extension/performance_analysis.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/quick_start.html (props changed)
   sandbox/libs/extension/doc/html/boost_extension/quickstart.html (props changed)
   sandbox/libs/extension/doc/html/boost_extension/shared_libraries.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/tutorial_1.html (props changed)
   sandbox/libs/extension/doc/html/boost_extension/tutorial_2.html (props changed)
   sandbox/libs/extension/doc/html/boost_extension/tutorial_3.html (props changed)
   sandbox/libs/extension/doc/html/boost_extension/tutorial_4.html (props changed)
   sandbox/libs/extension/doc/html/boost_extension/tutorial_5.html (props changed)
   sandbox/libs/extension/doc/html/boost_extension/tutorial_6.html (props changed)
   sandbox/libs/extension/doc/html/boost_extension/tutorials.html (contents, props changed)
   sandbox/libs/extension/doc/html/index.html (contents, props changed)
Binary files modified:
   sandbox/libs/extension/doc/html/boost_extension/appendices.html
Text files modified:
   sandbox/libs/extension/doc/Jamfile.v2 | 27 +
   sandbox/libs/extension/doc/extension.qbk | 15
   sandbox/libs/extension/doc/html/boost/extensions/basic_factory_map.html | 32
   sandbox/libs/extension/doc/html/boost/extensions/factory.html | 48 +-
   sandbox/libs/extension/doc/html/boost/extensions/factory_map.html | 12
   sandbox/libs/extension/doc/html/boost/extensions/load_single_library.html | 14
   sandbox/libs/extension/doc/html/boost/extensions/shared_library.html | 48 +-
   sandbox/libs/extension/doc/html/boost_extension/appendices/appendix_b.html | 2
   sandbox/libs/extension/doc/html/boost_extension/factories.html | 14
   sandbox/libs/extension/doc/html/boost_extension/info.html | 8
   sandbox/libs/extension/doc/html/boost_extension/performance_analysis.html | 8
   sandbox/libs/extension/doc/html/boost_extension/reference.html | 161 +++++++
   sandbox/libs/extension/doc/html/boost_extension/shared_libraries.html | 202 ++++++---
   sandbox/libs/extension/doc/html/boost_extension/tutorials.html | 820 +++++++++++++++++++++++++++++++++++++++
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial02.html | 2
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial03.html | 2
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial04.html | 2
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial05.html | 2
   sandbox/libs/extension/doc/html/index.html | 71 ++
   sandbox/libs/extension/doc/shared_libraries.qbk | 114 +++-
   20 files changed, 1350 insertions(+), 254 deletions(-)

Modified: sandbox/libs/extension/doc/Jamfile.v2
==============================================================================
--- sandbox/libs/extension/doc/Jamfile.v2 (original)
+++ sandbox/libs/extension/doc/Jamfile.v2 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -14,7 +14,7 @@
import os ;
local BOOST_ROOT = [ os.environ BOOST_ROOT ] ;

-doxygen autodoc
+doxygen autodoc_extension
 :
 [ glob ../../../boost/extension/*.hpp ]
 :
@@ -29,6 +29,22 @@
 <doxygen:param>SEARCH_INCLUDES=YES
 <doxygen:param>INCLUDE_PATH=$(BOOST_ROOT)
 ;
+
+doxygen autodoc_reflection
+ :
+ [ glob ../../../boost/reflection/*.hpp ]
+ :
+ <doxygen:param>EXTRACT_ALL=NO
+ <doxygen:param>"PREDEFINED=\"BOOST_REFLECTION_DOXYGEN_INVOKED\" \\
+ \"U_EXPORT2=\""
+ <doxygen:param>HIDE_UNDOC_MEMBERS=NO
+ <doxygen:param>EXTRACT_PRIVATE=NO
+ <doxygen:param>ENABLE_PREPROCESSING=YES
+ <doxygen:param>MACRO_EXPANSION=YES
+ <doxygen:param>EXPAND_ONLY_PREDEF=YES
+ <doxygen:param>SEARCH_INCLUDES=YES
+ <doxygen:param>INCLUDE_PATH=$(BOOST_ROOT)
+ ;

xml extension : extension.qbk ;

@@ -36,10 +52,11 @@
 :
 extension
 :
- <xsl:param>toc.max.depth=3
- <xsl:param>toc.section.depth=3
- <xsl:param>chunk.section.depth=3
- <dependency>autodoc
+ <xsl:param>toc.max.depth=2
+ <xsl:param>toc.section.depth=2
+ <xsl:param>chunk.section.depth=1
+ <dependency>autodoc_extension
+ <dependency>autodoc_reflection
 ;

install css : [ glob $(BOOST_ROOT)/doc/src/*.css ]

Added: sandbox/libs/extension/doc/appendix_c.qbk
==============================================================================

Added: sandbox/libs/extension/doc/extension-reflection.qbk
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/extension-reflection.qbk 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -0,0 +1,138 @@
+[/ Boost.Reflection - main doc ]
+[/ 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:extension-reflection Boost.Reflection/Boost.Extension Interoperability]
+Reflections are designed to work with Boost.Extension, or with
+shared libraries in general. A simple example is included in
+examples/extension/.
+
+Declaring the reflected class itself is similar to the
+process for doing the same in Boost.Extension.
+
+Here's how the Jamfile for these libraries is defined. Note
+that, like in Boost.Extension, one can rename the shared library
+extensions, for consistency across platforms. Here, we use the
+.reflection suffix for each shared library.
+``
+import type : change-generated-target-suffix ;
+import type : change-generated-target-prefix ;
+type.change-generated-target-suffix SHARED_LIB : : reflection ;
+type.change-generated-target-prefix SHARED_LIB : : lib ;
+exe extension-reflection : extension/extension.cpp ;
+lib car_lib : extension/car_lib.cpp : <link>shared ;
+``
+
+The code in the shared library is defined in
+libs/reflection/examples/extension/car_lib.cpp.
+
+We define two classes to export as reflections.
+Note that they are not derived from the same base class.
+If we were using Boost.Extension factories, this would be required.
+``
+class suv
+{
+public:
+ suv(const char * name) : car(name) {}
+ const char * get_type(void) { return "It's an SUV."; }
+ ~suv(void) {}
+};
+
+class compact
+{
+public:
+ compact(const char * name) : car(name) {}
+ const char * get_type(void) { return "It's a compact."; }
+ ~compact(void) {}
+};
+``
+
+Just like Boost.Extension, an external function needs to be
+defined that will be called by the main module.
+
+extern "C"
+void BOOST_EXTENSION_EXPORT_DECL
+extension_export_car(std::map<std::string, reflection> reflection_map) {
+ reflection_map["suv"]
+ .reflect<suv>()
+ .constructor<const char*>()
+ .function(&suv::get_type, "get_type");
+ reflection_map["suv"]
+ .reflect<compact>()
+ .constructor<const char*>()
+ .function(&compact::get_type, "get_type");
+}
+
+This is all that is necessary to export one constructor and one
+function for each class.
+
+Now, in extension.cpp, we combine Boost.Extension and
+Boost.Reflection code to load and use the reflections declared
+in the shared library.
+
+Create a mapping of reflections to strings that
+will be populated inside the shared library.
+``
+std::map<std::string, reflection> reflection_map;
+``
+Load the shared library using Boost.Extension.
+``
+boost::extensions::shared_library lib
+ ((std::string(BOOST_EXTENSION_DIR_START) +
+ "libcar_lib.extension").c_str());
+lib.open();
+``
+Call an exported function to populate
+reflection_map.
+``
+lib.get<void, std::map<std::string,
+ reflection> &>
+ ("extension_export_car")(reflection_map);
+if (reflection_map.size() != size_t(2)) {
+ std::cout << "Could not load reflections!";
+ return 1;
+}
+``
+Pull out two reflections that were named "suv" and
+"compact" respectively.
+``
+reflection & first_reflection =
+ reflection_map["suv"];
+reflection & second_reflection =
+ reflection_map["compact"];
+``
+Use the get_constructor function to find a constructor
+that takes one argument, a const char*.
+``
+instance_constructor<const char *> first_constructor =
+ first_reflection.get_constructor<const char *>();
+``
+Use the constructor retrieved to create an instance.
+Warning! instances should only be used with functions
+and constructors generated by a single reflection object.
+``
+instance first_instance =
+ first_constructor("First Instance");
+``
+Get a function to call on this instance.
+``
+boost::reflections::function<const char *> first_function =
+ first_reflection.get_function<const char *>("get_type");
+std::cout << "First reflection: " << first_function(first_instance)
+ << std::endl;
+ ``
+Repeat the steps for the second reflection.
+``
+instance_constructor<const char *> second_constructor =
+ second_reflection.get_constructor<const char *>();
+instance second_instance =
+ second_constructor("Second Instance");
+boost::reflections::function<const char *> second_function =
+ second_reflection.get_function<const char *>("get_type");
+std::cout << "Second reflection: " << second_function(second_instance)
+ << std::endl;
+``
+[endsect]
\ No newline at end of file

Modified: sandbox/libs/extension/doc/extension.qbk
==============================================================================
--- sandbox/libs/extension/doc/extension.qbk (original)
+++ sandbox/libs/extension/doc/extension.qbk 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -7,8 +7,10 @@

[library Boost.Extension
     [quickbook 1.4]
- [copyright 2008 Jeremy Pack, Mariano G. Consoni]
- [purpose Factory management and facilities for using shared libraries]
+ [copyright 2008 Jeremy Pack]
+ [authors [Pack, Jeremy]]
+ [purpose
+ Factory management and facilities for using shared libraries]
     [license
         Distributed under the Boost Software License, Version 1.0.
         (See accompanying file LICENSE_1_0.txt or copy at
@@ -24,10 +26,13 @@
[def _factory_ [^[classref boost::extensions::factory factory]]]

[include introduction.qbk]
-[include tutorials.qbk]
-[include factories.qbk]
+[include motivation.qbk]
[include shared_libraries.qbk]
-[xinclude autodoc.xml]
+[include factories.qbk]
+[include tutorials.qbk]
+[xinclude autodoc_extension.xml]
+[include extension_reflection.qbk]
+[xinclude autodoc_reflection.xml]
[include info.qbk]
[include performance_analysis.qbk]
[include faq.qbk]

Added: sandbox/libs/extension/doc/extension_reflection.qbk
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/extension_reflection.qbk 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -0,0 +1,138 @@
+[/ Boost.Reflection - main doc ]
+[/ 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:extension_reflection Boost.Reflection/Boost.Extension Interoperability]
+Reflections are designed to work with Boost.Extension, or with
+shared libraries in general. A simple example is included in
+examples/extension/.
+
+Declaring the reflected class itself is similar to the
+process for doing the same in Boost.Extension.
+
+Here's how the Jamfile for these libraries is defined. Note
+that, like in Boost.Extension, one can rename the shared library
+extensions, for consistency across platforms. Here, we use the
+.reflection suffix for each shared library.
+``
+import type : change-generated-target-suffix ;
+import type : change-generated-target-prefix ;
+type.change-generated-target-suffix SHARED_LIB : : reflection ;
+type.change-generated-target-prefix SHARED_LIB : : lib ;
+exe extension-reflection : extension/extension.cpp ;
+lib car_lib : extension/car_lib.cpp : <link>shared ;
+``
+
+The code in the shared library is defined in
+libs/reflection/examples/extension/car_lib.cpp.
+
+We define two classes to export as reflections.
+Note that they are not derived from the same base class.
+If we were using Boost.Extension factories, this would be required.
+``
+class suv
+{
+public:
+ suv(const char * name) : car(name) {}
+ const char * get_type(void) { return "It's an SUV."; }
+ ~suv(void) {}
+};
+
+class compact
+{
+public:
+ compact(const char * name) : car(name) {}
+ const char * get_type(void) { return "It's a compact."; }
+ ~compact(void) {}
+};
+``
+
+Just like Boost.Extension, an external function needs to be
+defined that will be called by the main module.
+
+extern "C"
+void BOOST_EXTENSION_EXPORT_DECL
+extension_export_car(std::map<std::string, reflection> reflection_map) {
+ reflection_map["suv"]
+ .reflect<suv>()
+ .constructor<const char*>()
+ .function(&suv::get_type, "get_type");
+ reflection_map["suv"]
+ .reflect<compact>()
+ .constructor<const char*>()
+ .function(&compact::get_type, "get_type");
+}
+
+This is all that is necessary to export one constructor and one
+function for each class.
+
+Now, in extension.cpp, we combine Boost.Extension and
+Boost.Reflection code to load and use the reflections declared
+in the shared library.
+
+Create a mapping of reflections to strings that
+will be populated inside the shared library.
+``
+std::map<std::string, reflection> reflection_map;
+``
+Load the shared library using Boost.Extension.
+``
+boost::extensions::shared_library lib
+ ((std::string(BOOST_EXTENSION_DIR_START) +
+ "libcar_lib.extension").c_str());
+lib.open();
+``
+Call an exported function to populate
+reflection_map.
+``
+lib.get<void, std::map<std::string,
+ reflection> &>
+ ("extension_export_car")(reflection_map);
+if (reflection_map.size() != size_t(2)) {
+ std::cout << "Could not load reflections!";
+ return 1;
+}
+``
+Pull out two reflections that were named "suv" and
+"compact" respectively.
+``
+reflection & first_reflection =
+ reflection_map["suv"];
+reflection & second_reflection =
+ reflection_map["compact"];
+``
+Use the get_constructor function to find a constructor
+that takes one argument, a const char*.
+``
+instance_constructor<const char *> first_constructor =
+ first_reflection.get_constructor<const char *>();
+``
+Use the constructor retrieved to create an instance.
+Warning! instances should only be used with functions
+and constructors generated by a single reflection object.
+``
+instance first_instance =
+ first_constructor("First Instance");
+``
+Get a function to call on this instance.
+``
+boost::reflections::function<const char *> first_function =
+ first_reflection.get_function<const char *>("get_type");
+std::cout << "First reflection: " << first_function(first_instance)
+ << std::endl;
+ ``
+Repeat the steps for the second reflection.
+``
+instance_constructor<const char *> second_constructor =
+ second_reflection.get_constructor<const char *>();
+instance second_instance =
+ second_constructor("Second Instance");
+boost::reflections::function<const char *> second_function =
+ second_reflection.get_function<const char *>("get_type");
+std::cout << "Second reflection: " << second_function(second_instance)
+ << std::endl;
+``
+[endsect]
\ No newline at end of file

Added: sandbox/libs/extension/doc/html/BOOST_EXTENSION_EXPORT_DECL.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/BOOST_EXTENSION_EXPORT_DECL.html 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -0,0 +1,51 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Macro BOOST_EXTENSION_EXPORT_DECL</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#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">
+</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#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>
+</div>
+<div class="refentry" lang="en">
+<a name="BOOST_EXTENSION_EXPORT_DECL"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_EXTENSION_EXPORT_DECL</h2>
+BOOST_EXTENSION_EXPORT_DECL — 
+</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">BOOST_EXTENSION_EXPORT_DECL</pre></div>
+<div class="refsect1" lang="en">
+<a name="id449932"></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>
+<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#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>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -0,0 +1,51 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Macro BOOST_EXTENSION_MAX_FUNCTOR_PARAMS</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#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">
+</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/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>
+</div>
+<div class="refentry" lang="en">
+<a name="BOOST_EXTENSION_MAX_FUNCTOR_PARAMS"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_EXTENSION_MAX_FUNCTOR_PARAMS</h2>
+BOOST_EXTENSION_MAX_FUNCTOR_PARAMS — 
+</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">BOOST_EXTENSION_MAX_FUNCTOR_PARAMS</pre></div>
+<div class="refsect1" lang="en">
+<a name="id449650"></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>
+<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/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>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/N.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/N.html 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -0,0 +1,47 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Macro N</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="header/boost/extension/factory/hpp.html" title="Header <boost/extension/factory.hpp>">
+<link rel="prev" href="header/boost/extension/factory/hpp.html" title="Header <boost/extension/factory.hpp>">
+<link rel="next" href="BOOST_PP_ITERATION_LIMITS_id86926.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="header/boost/extension/factory/hpp.html"><img src="../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="header/boost/extension/factory/hpp.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_id86926.html"><img src="../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry" lang="en">
+<a name="N"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro N</h2>
+N — 
+</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">N</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, Mariano G. Consoni
+ 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="header/boost/extension/factory/hpp.html"><img src="../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="header/boost/extension/factory/hpp.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_id86926.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-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -5,8 +5,8 @@
<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="../../header/boost/extension/factory_map/hpp.html" title="Header <boost/extension/factory_map.hpp>">
-<link rel="prev" href="../../header/boost/extension/factory_map/hpp.html" title="Header <boost/extension/factory_map.hpp>">
+<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="factory.html" title="Class template factory">
<link rel="next" href="factory_map.html" title="Type definition factory_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="../../header/boost/extension/factory_map/hpp.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../header/boost/extension/factory_map/hpp.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="factory_map.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="factory.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="factory_map.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="boost.extensions.basic_factory_map"></a><div class="titlepage"></div>
@@ -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="id450849"></a><h2>Description</h2>
+<a name="id450769"></a><h2>Description</h2>


<div class="refsect2" lang="en">
-<a name="id450856"></a><h3>
+<a name="id450777"></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="id288577-bb"></a>~basic_factory_map();</pre></li></ol></div>
+<div class="orderedlist"><ol type="1"><li><pre class="literallayout"><a name="id290381-bb"></a>~basic_factory_map();</pre></li></ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id450897"></a><h3>
-<a name="id288517-bb"></a><code class="computeroutput">basic_factory_map</code> public member functions</h3>
+<a name="id450817"></a><h3>
+<a name="id290321-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="id288519-bb"></a>get() ;</pre>
+ std::map< Info, factory< Interface, Params...> > & <a name="id290323-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="id288551-bb"></a>operator std::map< Info, factory< Interface, Params...> >() ;</pre>
+ <a name="id290355-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>
@@ -82,7 +82,7 @@
</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, Mariano G. Consoni
+<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)
 
@@ -90,7 +90,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../../header/boost/extension/factory_map/hpp.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../header/boost/extension/factory_map/hpp.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="factory_map.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="factory.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="factory_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-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -5,9 +5,9 @@
<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="../../header/boost/extension/factory/hpp.html" title="Header <boost/extension/factory.hpp>">
-<link rel="prev" href="../../header/boost/extension/factory/hpp.html" title="Header <boost/extension/factory.hpp>">
-<link rel="next" href="../../header/boost/extension/factory_map/hpp.html" title="Header <boost/extension/factory_map.hpp>">
+<link rel="up" href="../../boost_extension/reference.html#header.boost.extension.factory.hpp" title="Header <boost/extension/factory.hpp>">
+<link rel="prev" href="../../BOOST_EXTENSION_EXPORT_DECL.html" title="Macro BOOST_EXTENSION_EXPORT_DECL">
+<link rel="next" href="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="../../header/boost/extension/factory/hpp.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../header/boost/extension/factory/hpp.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="../../header/boost/extension/factory_map/hpp.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<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#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="basic_factory_map.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() ;
- T * create(Params...) ;
+ 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="id450310"></a><h2>Description</h2>
+<a name="id450219"></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="id450320"></a><h3>
+<a name="id450229"></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="id288474-bb"></a>factory();</pre></li>
-<li><pre class="literallayout"><a name="id288478-bb"></a>factory(factory< T > const & first);</pre></li>
-<li><pre class="literallayout">factory& <a name="id288488-bb"></a>operator=(factory< T > const & first);</pre></li>
+<li><pre class="literallayout"><a name="id290278-bb"></a>factory();</pre></li>
+<li><pre class="literallayout"><a name="id290283-bb"></a>factory(factory< T > const & first);</pre></li>
+<li><pre class="literallayout">factory& <a name="id290292-bb"></a>operator=(factory< T > const & first);</pre></li>
</ol></div>
</div>
<div class="refsect2" lang="en">
-<a name="id450426"></a><h3>
-<a name="id93876-bb"></a><code class="computeroutput">factory</code> public member functions</h3>
+<a name="id450335"></a><h3>
+<a name="id92772-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="id93878-bb"></a>set() ;</pre>
+<pre class="literallayout">template<typename D> void <a name="id91786-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="id89970-bb"></a>is_valid() ;</pre>
+<pre class="literallayout">bool <a name="id81090-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="id288450-bb"></a>create(Params...) ;</pre>
+<pre class="literallayout">T * <a name="id290255-bb"></a>create(Params...) const;</pre>
Returns an instance of T (but does NOT retain ownership of the instance).

@@ -125,7 +125,7 @@
</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, Mariano G. Consoni
+<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)
 
@@ -133,7 +133,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../../header/boost/extension/factory/hpp.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../header/boost/extension/factory/hpp.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="../../header/boost/extension/factory_map/hpp.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<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#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="basic_factory_map.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-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -5,9 +5,9 @@
<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="../../header/boost/extension/factory_map/hpp.html" title="Header <boost/extension/factory_map.hpp>">
+<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="../../header/boost/extension/filesystem/hpp.html" title="Header <boost/extension/filesystem.hpp>">
+<link rel="next" href="../../BOOST_PP_ITERATION_LIMITS_id290432.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="../../header/boost/extension/factory_map/hpp.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="../../header/boost/extension/filesystem/hpp.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_id290432.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,13 +32,13 @@
<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="id451075"></a><h2>Description</h2>
+<a name="id450994"></a><h2>Description</h2>
A typedef for convenience - provides the most common type of basic_factory_map. 
</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, Mariano G. Consoni
+<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)
 
@@ -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="../../header/boost/extension/factory_map/hpp.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="../../header/boost/extension/filesystem/hpp.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_id290432.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost/extensions/load_single_library.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost/extensions/load_single_library.html (original)
+++ sandbox/libs/extension/doc/html/boost/extensions/load_single_library.html 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -5,9 +5,9 @@
<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="../../header/boost/extension/convenience/hpp.html" title="Header <boost/extension/convenience.hpp>">
-<link rel="prev" href="../../header/boost/extension/convenience/hpp.html" title="Header <boost/extension/convenience.hpp>">
-<link rel="next" href="../../header/boost/extension/extension/hpp.html" title="Header <boost/extension/extension.hpp>">
+<link rel="up" href="../../boost_extension/reference.html#header.boost.extension.convenience.hpp" title="Header <boost/extension/convenience.hpp>">
+<link rel="prev" href="../../BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html" title="Macro BOOST_EXTENSION_MAX_FUNCTOR_PARAMS">
+<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>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../../header/boost/extension/convenience/hpp.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../header/boost/extension/convenience/hpp.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="../../header/boost/extension/extension/hpp.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<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#header.boost.extension.convenience.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_EXTENSION_EXPORT_DECL.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" lang="en">
<a name="boost.extensions.load_single_library"></a><div class="titlepage"></div>
@@ -34,7 +34,7 @@
 const std::string & library_path,
 const std::string & external_function_name);</pre></div>
<div class="refsect1" lang="en">
-<a name="id449893"></a><h2>Description</h2>
+<a name="id449790"></a><h2>Description</h2>
Add any exported factories from the given library with the given function name. This uses shared_library::get internally. The function must have the signature void (factory_map&). For more general loading of shared libraries, use the shared_library class directly. If the function is not found, false is returned.


@@ -89,7 +89,7 @@
</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, Mariano G. Consoni
+<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)
 
@@ -97,7 +97,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../../header/boost/extension/convenience/hpp.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../header/boost/extension/convenience/hpp.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="../../header/boost/extension/extension/hpp.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<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#header.boost.extension.convenience.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_EXTENSION_EXPORT_DECL.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-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -5,9 +5,10 @@
<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="../../header/boost/extension/shared_library/hpp.html" title="Header <boost/extension/shared_library.hpp>">
-<link rel="prev" href="../../header/boost/extension/shared_library/hpp.html" title="Header <boost/extension/shared_library.hpp>">
-<link rel="next" href="../../boost_extension/info.html" title=" Info Classes">
+<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_id290436.html" title="Macro BOOST_PP_FILENAME_1">
+<link rel="next" href="../../boost_extension/extension_reflection.html" title=" Boost.Reflection/Boost.Extension
+ Interoperability">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,7 +21,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../../header/boost/extension/shared_library/hpp.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../header/boost/extension/shared_library/hpp.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/info.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../../BOOST_PP_FILENAME_1_id290436.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="../../boost_extension/extension_reflection.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,29 +34,28 @@
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() ;
- bool open() ;
- bool close() ;
+ // public member functions
+ bool is_open() const;
+ bool open() ;
+ bool close() ;
 template<typename RetValue, typename Params...>
- FunctionPtr< ReturnValue(Params...)> get(const std::string &) ;
+ FunctionPtr< ReturnValue(Params...)> get(const std::string &) const;
};</pre></div>
<div class="refsect1" lang="en">
-<a name="id451490"></a><h2>Description</h2>
-This class is inherently not type-safe. Carefully check the signature of the function or type in the shared library against the template arguments of the get functions. 
+<a name="id451422"></a><h2>Description</h2>


<div class="refsect2" lang="en">
-<a name="id451502"></a><h3>
+<a name="id451429"></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="id288778-bb"></a>shared_library(const std::string & location, bool auto_close = false);</pre>
+<pre class="literallayout"><a name="id290571-bb"></a>shared_library(const std::string & location, bool auto_close = false);</pre>
shared_library constructor

<div class="variablelist"><table border="0">
@@ -82,17 +82,17 @@
</table></div>
</li>
<li>
-<pre class="literallayout"><a name="id288771-bb"></a>~shared_library();</pre>
+<pre class="literallayout"><a name="id290595-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="id451617"></a><h3>
-<a name="id288656-bb"></a><code class="computeroutput">shared_library</code> public member functions</h3>
+<a name="id451545"></a><h3>
+<a name="id290455-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="id288658-bb"></a>is_open() ;</pre>
+<pre class="literallayout">bool <a name="id290457-bb"></a>is_open() const;</pre>


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


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


@@ -174,7 +174,7 @@
</li>
<li>
<pre class="literallayout">template<typename RetValue, typename Params...>
- FunctionPtr< ReturnValue(Params...)> <a name="id288725-bb"></a>get(const std::string & name) ;</pre>
+ FunctionPtr< ReturnValue(Params...)> <a name="id290524-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.
@@ -205,7 +205,7 @@
</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, Mariano G. Consoni
+<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)
 
@@ -213,7 +213,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../../header/boost/extension/shared_library/hpp.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../header/boost/extension/shared_library/hpp.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/info.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../../BOOST_PP_FILENAME_1_id290436.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="../../boost_extension/extension_reflection.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost_extension/appendices.html
==============================================================================
Binary files. No diff available.

Modified: sandbox/libs/extension/doc/html/boost_extension/appendices/appendix_b.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/appendices/appendix_b.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/appendices/appendix_b.html 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -46,7 +46,7 @@
</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, Mariano G. Consoni
+<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)

Modified: sandbox/libs/extension/doc/html/boost_extension/factories.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/factories.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/factories.html 2008-07-19 22:35:01 EDT (Sat, 19 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="../index.html" title="Chapter 1. Boost.Extension">
-<link rel="prev" href="tutorials/tutorial05.html" title=" Tutorial 5">
-<link rel="next" href="shared_libraries.html" title=" Shared Libraries">
+<link rel="prev" href="shared_libraries.html" title=" Shared Libraries">
+<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>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="tutorials/tutorial05.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="shared_libraries.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="shared_libraries.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.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">
@@ -50,7 +50,7 @@
 are:
 
<a name="boost_extension.factories.void_set_lt_d_gt___"></a><h3>
-<a name="id448963"></a>
+<a name="id435884"></a>
 <a href="factories.html#boost_extension.factories.void_set_lt_d_gt___">void set<D>()</a>
 </h3>

@@ -60,7 +60,7 @@
 This function may be called multiple times, to change the factory function.
 
<a name="boost_extension.factories.bool_is_valid__"></a><h3>
-<a name="id449012"></a>
+<a name="id435933"></a>
 <a href="factories.html#boost_extension.factories.bool_is_valid__">bool is_valid()</a>
 </h3>

@@ -69,7 +69,7 @@
</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, Mariano G. Consoni
+<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)
 
@@ -77,7 +77,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="tutorials/tutorial05.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="shared_libraries.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="shared_libraries.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.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Added: sandbox/libs/extension/doc/html/boost_extension/faq.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/boost_extension/faq.html 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -0,0 +1,70 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title> FAQ</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="../index.html" title="Chapter 1. Boost.Extension">
+<link rel="prev" href="performance_analysis.html" title=" Performance Analysis">
+<link rel="next" href="appendices.html" title=" Appendices">
+</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="performance_analysis.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="appendices.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.faq"></a> FAQ</h2></div></div></div>
+
+ Question: What if I have multiple versions of the same interface (I've added
+ new member functions as they've become necessary), and I want to keep track
+ of which version is implemented by different plugins?
+ 
+
+ Answer: The simplest way is to change the name of your interface (or the namespace
+ it is in) each time its contents change. This is actually what I would recommend.
+ However, it is also possible to include such information as part of the <code class="literal"><code class="computeroutput">factory</code></code>. A <code class="literal"><code class="computeroutput">factory</code></code> can contain
+ arbitrary information about the plugin that it loads through the Info type.
+ In the <code class="computeroutput">hello_world</code> sample,
+ the <code class="computeroutput">Info</code> type is an <code class="computeroutput">int</code>, and the <code class="computeroutput">hello</code>
+ class has a number (it could be a version) of 1, and the <code class="computeroutput">world</code>
+ class has a version of 2. In the multiple_inheritance sample, this type is
+ a string. This will be detailed in greater detail in this documentation.
+ 
+
+ Question: What if I want to have a library close automatically when I've destroyed
+ all of the plugins in it?
+ 
+
+ Answer: I have not yet found a general enough way to do this that doesn't introduce
+ too many constraints for programmers. I recommend developing a specific solution
+ for your use case for now if you really need this.
+ 
+
+ Question:
+ 
+</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="performance_analysis.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="appendices.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Modified: sandbox/libs/extension/doc/html/boost_extension/info.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/info.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/info.html 2008-07-19 22:35:01 EDT (Sat, 19 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="../index.html" title="Chapter 1. Boost.Extension">
-<link rel="prev" href="../boost/extensions/shared_library.html" title="Class shared_library">
+<link rel="prev" href="../boost/reflections/basic_reflection/reflector.html" title="Class template reflector">
<link rel="next" href="performance_analysis.html" title=" Performance Analysis">
</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/extensions/shared_library.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="performance_analysis.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../boost/reflections/basic_reflection/reflector.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="performance_analysis.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">
@@ -236,7 +236,7 @@
</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, Mariano G. Consoni
+<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)
 
@@ -244,7 +244,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../boost/extensions/shared_library.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="performance_analysis.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../boost/reflections/basic_reflection/reflector.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="performance_analysis.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Added: sandbox/libs/extension/doc/html/boost_extension/motivation.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/boost_extension/motivation.html 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -0,0 +1,92 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title> Motivation</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="../index.html" title="Chapter 1. Boost.Extension">
+<link rel="prev" href="../index.html" title="Chapter 1. Boost.Extension">
+<link rel="next" href="shared_libraries.html" title=" Shared Libraries">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../index.html"><img src="../../../doc/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="shared_libraries.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.motivation"></a> Motivation</h2></div></div></div>
+
+ The original motivation for Boost.Extension was a moving-object-tracking application.
+ This application was to be used for both real-time and post-processing analysis
+ of a series of images. The types of cameras used for tracking were anything
+ from low-speed, low-resolution IR cameras, to medium-speed color camcorders
+ to high-speed, multi-spectral IR cameras.
+ 
+
+ Each client or potential client of the application had different input types,
+ and different types of data they needed at the end. There were, in general,
+ the following major problems:
+ 
+<div class="itemizedlist"><ul type="disc">
+<li>
+ Some clients had proprietary image formats that needed to be input, or proprietary
+ algorithms they wished to use for the data. We could not give these algorithms
+ to other clients.
+ </li>
+<li>
+ Clients wanted to be able to adapt the software to work with new requirements,
+ such as a new camera type, in the future. To do this, one client in particular
+ wanted full ownership of the source code.
+ </li>
+<li>
+ Our code had become very entangled, and our application had become a mess
+ of menus covering the various bits of functionality.
+ </li>
+</ul></div>
+
+ Initially, we just delivered different builds to each customer. This was tedious,
+ and only solved the first problem.
+ 
+
+ For this reason, work was begun on using shared libraries which would each
+ contain a related set of modules. Each customer would be given two sets of
+ files:
+ 
+<div class="itemizedlist"><ul type="disc">
+<li>
+ Shared libraries for their specific data types, UI needs, algorithms, etc.
+ </li>
+<li>
+ An SDK to develop plugins in the future to handle any new requirements for
+ the software.
+ </li>
+</ul></div>
+
+ Boost.Extension is designed to make this type of solution simple, portable,
+ and easily extensible.
+ 
+</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="../index.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="shared_libraries.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

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-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -41,7 +41,7 @@
 Boost) more optimization will be performed.
 
<a name="boost_extension.performance_analysis.first_comparison"></a><h1>
-<a name="id454829"></a>
+<a name="id463328"></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="id454916"></a>
+<a name="id463415"></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="id454923"></a>
+<a name="id463422"></a>
 <a href="performance_analysis.html#boost_extension.performance_analysis.boost__function_overhead">boost::function
 overhead</a>
 </h1>
@@ -148,7 +148,7 @@
</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, Mariano G. Consoni
+<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)

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-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -6,8 +6,9 @@
<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="shared_libraries.html" title=" Shared Libraries">
-<link rel="next" href="../BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html" title="Macro BOOST_EXTENSION_MAX_FUNCTOR_PARAMS">
+<link rel="prev" href="extension_reflection.html" title=" Boost.Reflection/Boost.Extension
+ Interoperability">
+<link rel="next" href="../boost/reflections/parameter_unavailable_exception.html" title="Class parameter_unavailable_exception">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,32 +21,162 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="shared_libraries.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="../BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="extension_reflection.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="../boost/reflections/parameter_unavailable_exception.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.reference"></a>Reference</h2></div></div></div>
<div class="toc"><dl>
-<dt>Header <boost/extension/common.hpp></dt>
-<dt>Header <boost/extension/convenience.hpp></dt>
-<dt>Header <boost/extension/extension.hpp></dt>
-<dt>Header <boost/extension/factory.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/reflection/adapter.hpp></dt>
+<dt>Header <boost/reflection/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/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><h3 class="title">
-<a name="header.boost.extension.common.hpp"></a>Header <boost/extension/common.hpp></h3></div></div></div>
+<a name="header.boost.reflection.adapter.hpp"></a>Header <boost/reflection/adapter.hpp></h3></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><h3 class="title">
+<a name="header.boost.reflection.common.hpp"></a>Header <boost/reflection/common.hpp></h3></div></div></div>
+<pre class="synopsis">
+
+BOOST_REFLECTION_MAX_FUNCTOR_PARAMS</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.reflection.constructor.hpp"></a>Header <boost/reflection/constructor.hpp></h3></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><h3 class="title">
+<a name="header.boost.reflection.constructor_info.hpp"></a>Header <boost/reflection/constructor_info.hpp></h3></div></div></div></div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.reflection.data.hpp"></a>Header <boost/reflection/data.hpp></h3></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><h3 class="title">
+<a name="header.boost.reflection.data_info.hpp"></a>Header <boost/reflection/data_info.hpp></h3></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><h3 class="title">
+<a name="header.boost.reflection.factory.hpp"></a>Header <boost/reflection/factory.hpp></h3></div></div></div>
<pre class="synopsis">

-BOOST_EXTENSION_MAX_FUNCTOR_PARAMS</pre>
+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><h3 class="title">
+<a name="header.boost.reflection.function.hpp"></a>Header <boost/reflection/function.hpp></h3></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><h3 class="title">
+<a name="header.boost.reflection.function_info.hpp"></a>Header <boost/reflection/function_info.hpp></h3></div></div></div></div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.reflection.generic_constructor.hpp"></a>Header <boost/reflection/generic_constructor.hpp></h3></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><h3 class="title">
+<a name="header.boost.reflection.instance.hpp"></a>Header <boost/reflection/instance.hpp></h3></div></div></div>
+<pre class="synopsis">namespace boost {
+ namespace reflections {
+ class instance;
+ }
+}</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.reflection.parameter.hpp"></a>Header <boost/reflection/parameter.hpp></h3></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><h3 class="title">
+<a name="header.boost.reflection.parameter_map.hpp"></a>Header <boost/reflection/parameter_map.hpp></h3></div></div></div></div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="header.boost.reflection.reflection.hpp"></a>Header <boost/reflection/reflection.hpp></h3></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, Mariano G. Consoni
+<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)
 
@@ -53,7 +184,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="shared_libraries.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="../BOOST_EXTENSION_MAX_FUNCTOR_PARAMS.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="extension_reflection.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="../boost/reflections/parameter_unavailable_exception.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost_extension/shared_libraries.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/shared_libraries.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/shared_libraries.html 2008-07-19 22:35:01 EDT (Sat, 19 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="../index.html" title="Chapter 1. Boost.Extension">
-<link rel="prev" href="factories.html" title=" Factories">
-<link rel="next" href="reference.html" title="Reference">
+<link rel="prev" href="motivation.html" title=" Motivation">
+<link rel="next" href="factories.html" title=" Factories">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,14 +20,24 @@
</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="reference.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="motivation.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="factories.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.shared_libraries"></a> Shared Libraries</h2></div></div></div>
+<div class="toc"><dl>
+<dt><a href="shared_libraries.html#boost_extension.shared_libraries.name_resolution"> Name
+ Resolution</a></dt>
+<dt><a href="shared_libraries.html#boost_extension.shared_libraries.shared_library_issues">
+ Other Issues with Shared Libraries</a></dt>
+<dt><a href="shared_libraries.html#boost_extension.shared_libraries.shared_library_inefficiencies">
+ Possible Inefficiencies in Shared Libraries</a></dt>
+<dt><a href="shared_libraries.html#boost_extension.shared_libraries.shared_library_class">shared_library
+ class</a></dt>
+</dl></div>

- A <code class="computeroutput">shared_library</code> refers to
- a loadable module, the type of which depends on the platform:
+ A <code class="literal"><code class="computeroutput">shared_library</code></code>
+ refers to a loadable module, the type of which depends on the platform:
 
<div class="itemizedlist"><ul type="disc">
<li>
@@ -40,80 +50,136 @@
 Mac OS X: .dylib or .bundle (See Appendix C)
 </li>
</ul></div>
-<a name="boost_extension.shared_libraries._code__phrase_role__identifier__shared_library__phrase__phrase_role__special_____phrase__phrase_role__keyword__const__phrase___phrase_role__keyword__char__phrase___phrase_role__special_____phrase___phrase_role__identifier__location__phrase__phrase_role__special_____phrase___phrase_role__keyword__bool__phrase___phrase_role__identifier__auto_close__phrase___phrase_role__special_____phrase___phrase_role__keyword__false__phrase__phrase_role__special_____phrase___code_"></a><h4>
-<a name="id449093"></a>
- <a href="shared_libraries.html#boost_extension.shared_libraries._code__phrase_role__identifier__shared_library__phrase__phrase_role__special_____phrase__phrase_role__keyword__const__phrase___phrase_role__keyword__char__phrase___phrase_role__special_____phrase___phrase_role__identifier__location__phrase__phrase_role__special_____phrase___phrase_role__keyword__bool__phrase___phrase_role__identifier__auto_close__phrase___phrase_role__special_____phrase___phrase_role__keyword__false__phrase__phrase_role__special_____phrase___code_"><code class="computeroutput">shared_library(const char * location, bool auto_close
- = false)</code></a>
- </h4>
-
- <code class="computeroutput">location</code> is the relative path
- of the shared library to laod, and <code class="computeroutput">auto_close</code>
- sets whether or not the library will be automatically closed when the <code class="computeroutput">shared_library</code> is destroyed. This function
- does not open the library.
- 
-<a name="boost_extension.shared_libraries._code__phrase_role__keyword__bool__phrase___phrase_role__identifier__open__phrase__phrase_role__special______phrase___code_"></a><h4>
-<a name="id449221"></a>
- bool open()
- </h4>

- Returns true if the library is opened successfully.
+ Normally, shared libraries are loaded by an application when it starts. This
+ is commonly used by Boost libraries that can be built as shared libraries,
+ such as Boost.Thread or Boost.Filesystem.
 
-<a name="boost_extension.shared_libraries._code__phrase_role__keyword__bool__phrase___phrase_role__identifier__is_open__phrase__phrase_role__special______phrase___code_"></a><h4>
-<a name="id449276"></a>
- bool is_open()
- </h4>

- Returns true if the library is open.
+ Shared libraries can also be loaded at will, during program execution.
 
-<a name="boost_extension.shared_libraries._code__phrase_role__keyword__void__phrase___phrase_role__identifier__close__phrase__phrase_role__special______phrase___code_"></a><h4>
-<a name="id449331"></a>
- void close()
- </h4>
-
- Close the library. Note that an OS specific shared library usually keeps a
- reference count, meaning that calling this function will just decrease the
- reference count. If the reference count drops to 0, the library will be ready
- to actually closed - though the platform is not required to actually close
- the library even then. As such, this function can sometimes give a performance
- boost, by freeing up RAM, but will often do nothing.
+
+ Whenever a shared library is loaded, either at load time or later during a
+ program's execution, the function and variable locations in the library are
+ resolved.
 
-<a name="boost_extension.shared_libraries._code__phrase_role__identifier__returnvalue__phrase___phrase_role__special______phrase__phrase_role__identifier__get__phrase__phrase_role__special_____phrase__phrase_role__keyword__const__phrase___phrase_role__keyword__char__phrase___phrase_role__special_____phrase___phrase_role__identifier__name__phrase__phrase_role__special_______phrase__phrase_role__identifier__args__phrase__phrase_role__special_____phrase___code_"></a><h4>
-<a name="id449389"></a>
- <a href="shared_libraries.html#boost_extension.shared_libraries._code__phrase_role__identifier__returnvalue__phrase___phrase_role__special______phrase__phrase_role__identifier__get__phrase__phrase_role__special_____phrase__phrase_role__keyword__const__phrase___phrase_role__keyword__char__phrase___phrase_role__special_____phrase___phrase_role__identifier__name__phrase__phrase_role__special_______phrase__phrase_role__identifier__args__phrase__phrase_role__special_____phrase___code_"><code class="computeroutput">ReturnValue (*get(const
- char * name))(ARGS)</code></a>
- </h4>
-
- This function returns a pointer to a function in a dll with <code class="computeroutput">name</code>.
- Note that a C++ function needs to have <code class="computeroutput">extern
- "C"</code> before it in order for
- this to work. To get a function like this:
-
-<pre class="programlisting">extern "C"
-int get_value(const char * name) {
- return 0;
-}
-</pre>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_extension.shared_libraries.name_resolution"></a><a href="shared_libraries.html#boost_extension.shared_libraries.name_resolution" title=" Name
+ Resolution"> Name
+ Resolution</a></h3></div></div></div>
+
+ A loaded shared library can be searched for functions or data. In C++, this
+ requires that the function be marked as follows:
+ 
+
+ \code extern "C" void MyFunction() { // do stuff } \endcode
+ 

- You would call:
+ The reason for this is the name-mangling that C++ performs, to give different
+ names to, for instance, multiple overloads with the same function name.
+ 
+
+ Because different compilers mangle names differently (and in ways that are
+ often undocumented), it would be very difficult to create a cross-platform
+ solution to avoid the use of extern "C" declarations. This is the
+ primary cause of the inherent lack of type-safety with calls in the <code class="literal"><code class="computeroutput">shared_library</code></code>
+ class.
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_extension.shared_libraries.shared_library_issues"></a><a href="shared_libraries.html#boost_extension.shared_libraries.shared_library_issues" title="
+ Other Issues with Shared Libraries">
+ Other Issues with Shared Libraries</a></h3></div></div></div>
+<div class="itemizedlist"><ul type="disc">
+<li>
+ Separate symbol tables are required in each shared library.
+ </li>
+<li>
+ RTTI merging: Some compilers do it. Some don't.
+ </li>
+<li>
+ Optimizations are harder because the code must be position independent.
+ </li>
+<li>
+ The following may break binary compatibility between an application and
+ a shared library (among other things):
+ <div class="itemizedlist"><ul type="circle">
+<li>
+ Any part of shared class changes. Variable ordering, publicprivate
+ protected, virtual function implementations, addremove variables
+ functions etc.
+ </li>
+<li>
+ Different compiler or compiler options used, or headers included differently.
+ </li>
+</ul></div>
+</li>
+</ul></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_extension.shared_libraries.shared_library_inefficiencies"></a><a href="shared_libraries.html#boost_extension.shared_libraries.shared_library_inefficiencies" title="
+ Possible Inefficiencies in Shared Libraries">
+ Possible Inefficiencies in Shared Libraries</a></h3></div></div></div>
+<div class="itemizedlist"><ul type="disc">
+<li>
+ Position Independent Code:
+ <div class="itemizedlist"><ul type="circle">
+<li>
+ Since the shared library could be loaded to any part of the address
+ space, it cannot hard code addresses of its functions and data. This
+ must be resolved when the library is loaded.
+ </li>
+<li>
+ They can take a really long time to load.
+ </li>
+<li>
+ OS's attempt to mitigate this in various ways.
+ </li>
+</ul></div>
+</li>
+<li>
+ Extra levels of indirection in non-virtual function calls.
+ <div class="itemizedlist"><ul type="circle"><li>
+ No inlining across library boundaries.
+ </li></ul></div>
+</li>
+</ul></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_extension.shared_libraries.shared_library_class"></a><a href="shared_libraries.html#boost_extension.shared_libraries.shared_library_class" title="shared_library
+ class">shared_library
+ class</a></h3></div></div></div>
+
+ Provides for automatic loading of named modules, and retrieval of functions
+ in those modules:
+ 
+
+

-<pre class="programlisting">mySharedLibrary.get<int, const char *>("get_value");
+<pre class="programlisting">shared_library m("my_module_name");
+// Call a function that returns an int and takes a float parameter.
+int result = m.get<int, float>("function_name")(5.0f);
+m.close();
</pre>

- 
-<div class="note"><table border="0" summary="Note">
-<tr>
-<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../doc/html/images/note.png"></td>
-<th align="left">Note</th>
-</tr>
-<tr><td colspan="2" align="left" valign="top">
- It is recommended that you use Boost.Function to capture the return values
- of <code class="computeroutput">get</code>, but not required.
- </td></tr>
-</table></div>
+ 
+
+ The <code class="computeroutput">get()</code>
+ function returns a function pointer that can be wrapped in Boost.Function
+ objects or used by itself.
+ 
+
+ Reference: <code class="literal"><code class="computeroutput">shared_library</code></code>
+ 
+</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
-<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack, Mariano G. Consoni
+<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)
 
@@ -121,7 +187,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="reference.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="motivation.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="factories.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-19 22:35:01 EDT (Sat, 19 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="../index.html" title="Chapter 1. Boost.Extension">
-<link rel="prev" href="../index.html" title="Chapter 1. Boost.Extension">
-<link rel="next" href="tutorials/tutorial02.html" title=" Tutorial 2">
+<link rel="prev" href="factories.html" title=" Factories">
+<link rel="next" href="reference.html" title="Reference">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,17 +20,17 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../index.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="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="reference.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> Tutorial 1</dt>
-<dt> Tutorial 2</dt>
-<dt> Tutorial 3</dt>
-<dt> Tutorial 4</dt>
-<dt> Tutorial 5</dt>
+<dt> Tutorial 2</dt>
+<dt> Tutorial 3</dt>
+<dt> Tutorial 4</dt>
+<dt> Tutorial 5</dt>
</dl></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
@@ -174,6 +174,808 @@
 shared library (dll, so, dylib etc.) is renamed correctly.
 
</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>
+
+ 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:
+ 
+<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">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>
+
+ 
+
+ First we must rename the generated libraries (this is required for cross-platform
+ use - but the prefix and suffix are arbitrary).
+ 
+
+
+
+<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 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.
+ 
+
+
+
+<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
+;
+
+install ../bin :
+ HelloWorld HelloWorldLib Vehicle Boat FlyingCar
+ CarOfTheFuture MultipleInheritance
+ :
+ ;
+</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.
+ 
+
+ 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">#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>
+
+ 
+</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>
+
+ 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.
+ 
+
+ 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 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.
+ 
+
+
+
+<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>
+
+ The interface that we are inheriting is just the bare minimum needed
+ to make it compile:
+ 
+
+
+
+<pre class="programlisting">class A
+{
+ public:
+ A(unsigned int i) : i(i) {}
+ int i;
+};
+
+
+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) {}
+};
+</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.
+ 
+
+
+
+<pre class="programlisting">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>();
+}
+</pre>
+
+ Finally, let's see how it is used in the main file.
+ 
+
+
+
+<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;
+ }
+
+ 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))));
+
+ return 0;
+}
+</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>
+
+ 
+ 
+
+ 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.
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_extension.tutorials.tutorial04"></a> Tutorial 4</h3></div></div></div>
+
+ In this tutorial we will see different features of the library related to
+ multiple loading of the same library, instance or interface.
+ 
+
+ We will follow some parts of versions example (<code class="literal">examples/versioning</code>).
+ As we expect that at this point you've gone through the first tutorials we
+ will not enter into specific details of the use of the library.
+ 
+
+ First, we want to show that it is possible to load several libraries into
+ one factory map. We'll create a new HelloWorld library very similar to the
+ one that we have described in the first tutorial.
+ 
+
+ Let's remember the classes that we have implemented (in <code class="literal">hello_world.cpp</code>)
+ for the "hello world" example:
+ 
+
+
+
+<pre class="programlisting">class world : public word
+{
+public:
+ virtual const char * get_val(){return "world!";}
+};
+
+class hello : public word
+{
+public:
+ virtual const char * get_val(){return "hello";}
+};
+
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_word(boost::extensions::factory_map & fm)
+{
+ fm.get<word, int>()[1].set<hello>();
+ fm.get<word, int>()[2].set<world>();
+}
+</pre>
+
+ 
+
+ And now let's see the new version that we've implemented for this example
+ (as defined in <code class="literal">hello_world_versions.cpp</code>). The classes
+ have the same name and methods, both implement the same interface, but the
+ <code class="computeroutput">get_val()</code>
+ methods differ in the returned string (to be able to recognize each one after
+ loading them).
+ 
+
+
+
+<pre class="programlisting">class world : public word
+{
+public:
+ virtual const char * get_val(){return "world! v2";}
+};
+
+class hello : public word
+{
+public:
+ virtual const char * get_val(){return "| v2 hello";}
+};
+
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_word(boost::extensions::factory_map & fm)
+{
+ fm.get<word, int>()[22].set<world>();
+ // int could be used as version (v2 word 2)
+ fm.get<word, int>()[21].set<hello>();
+ // int could be used as version (v2 word 1)
+}
+</pre>
+
+ 
+
+ Also note that we are using the Info int to store some kind of "version",
+ and then we could differentiate the classes by its int (see Info class tutorial
+ for more information on this).
+ 
+
+
+
+<pre class="programlisting">factory_map fm;
+
+// load hello world first version
+load_single_library(fm, "libHelloWorldLib.extension",
+ "extension_export_word");
+
+// load hello world second version
+load_single_library(fm, "libHelloWorldLibv2.extension",
+ "extension_export_word");
+
+// load hello world second version again
+load_single_library(fm, "libHelloWorldLibv2.extension",
+ "extension_export_word");
+</pre>
+
+ 
+
+ We can see here that loading multiple libraries is as easy as calling <code class="computeroutput">load_single_library</code> for each one and using
+ the same factory map.
+ 
+
+ Then you can access them as any other factory_map:
+ 
+
+
+
+<pre class="programlisting">for(std::list<factory<word, int> >::iterator current_word =
+ factory_list.begin(); current_word != factory_list.end();
+ ++current_word) {
+ std::auto_ptr<word> word_ptr(current_word->create());
+ std::cout << word_ptr->get_val() << " ";
+}
+std::cout << std::endl << std::endl;
+</pre>
+
+ 
+
+ We get the following output:
+ 
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<tbody><tr><td>
+ 
+ <code class="literal">words:</code> <code class="literal">hello world! | v2 hello
+ world! v2 | v2 hello world! v2</code>
+ 
+ </td></tr></tbody>
+</table></div>
+
+ The first "hello world" is returned by the first version of the
+ library, and the second and third returned by the second version.
+ 
+
+ Finally, we will show another example similar to the former but in this case
+ we implement a different interface, same class name ('hello') but with different
+ interface ('salute').
+ 
+
+ Let's see the interface:
+ 
+
+
+
+<pre class="programlisting">class salute
+{
+public:
+ virtual ~salute(){}
+ virtual const char * say(){return "";}
+};
+</pre>
+
+ 
+
+ And the implementations:
+ 
+
+
+
+<pre class="programlisting">class hello : public salute
+{
+public:
+ virtual const char *say(void) {return "hello";}
+};
+
+class bye : public salute
+{
+public:
+ virtual const char *say(void) {return "bye!";}
+};
+
+
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_salute(boost::extensions::factory_map & fm)
+{
+ fm.get<salute, int>()[1].set<hello>();
+ fm.get<salute, int>()[2].set<bye>();
+}
+</pre>
+
+ 
+
+ Note that we are adding a new class called 'hello' too but that implements
+ 'salute' interface.
+ 
+
+ 
+ 
+
+ Finally in the main function we get the factory list specifying that we want
+ the 'salute' factory. We iterate it getting each of the salutes, including
+ hello.
+ 
+
+
+
+<pre class="programlisting">std::map<int, factory<salute> > & salute_factory_list =
+ fm.get<salute, int>();
+
+std::cout << "salutes: " << std::endl;
+for (std::map<int, factory<salute> >::iterator current_salute =
+ salute_factory_list.begin();
+ current_salute != salute_factory_list.end();
+ ++current_salute) {
+ std::auto_ptr<salute> salute_ptr(current_salute->second.create());
+ std::cout << salute_ptr->say() << " ";
+}
+std::cout << std::endl;
+</pre>
+
+ 
+
+ The output is:
+ 
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<tbody><tr><td>
+ 
+ <code class="literal">salutes:</code> <code class="literal">hello bye!</code>
+ 
+ </td></tr></tbody>
+</table></div>
+
+ In conclusion, with Boost.Extension we can implement the same class in different
+ libraries, the same class for different interfaces and load multiple libraries
+ into the same factory.
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_extension.tutorials.tutorial05"></a> Tutorial 5</h3></div></div></div>
+
+ In this tutorial we will describe an advanced example using the Info class.
+ The basics of Info classes are explained in the specific section. We expect
+ that you've gone through that section before following this example.
+ 
+
+ Let's imagine that we are implementing an multi-protocol instant messaging
+ client. Of course we want to support the maximum quantity of protocols, and
+ it would be great if 3rd party programmers can implement new protocols and
+ can add them dynamically.
+ 
+
+ So let's define an interface for the protocols, with the expected operations:
+ 
+
+
+
+<pre class="programlisting">class protocol
+{
+ public:
+
+ virtual void login(const std::string &user, const std::string &pass) {}
+ virtual void send(const std::string &msg) {}
+ virtual std::string receive(void) { return std::string(""); }
+ virtual void change_status(const std::string &new_status) {}
+
+ virtual ~protocol(void) {}
+};
+</pre>
+
+ 
+
+ Now we will implement some example protocols:
+ 
+
+
+
+<pre class="programlisting">// MSN protocol implementation
+class MSN : public protocol
+{
+public:
+ virtual void login(const std::string &user, const std::string &pass) {
+ std::cout << "MSN: Logged In" << std::endl;
+ }
+ virtual void send(const std::string &msg) {
+ std::cout << "MSN: message [" << msg << "] sent" << std::endl;
+ }
+ virtual std::string receive(void) {
+ return std::string("MSN: hello! msg received");
+ }
+ virtual void change_status(const std::string &new_status) {
+ std::cout << "MSN: Status changed to [" << new_status << "]"
+ << std::endl;
+ }
+
+ virtual ~MSN(void) {}
+};
+
+// Jabber protocol implementation
+class Jabber : public protocol
+{
+public:
+ virtual void login(const std::string &user, const std::string &pass) {
+ std::cout << "Jabber: Logged In" << std::endl;
+ }
+ virtual void send(const std::string &msg) {
+ std::cout << "Jabber: message [" << msg << "] sent" << std::endl;
+ }
+ virtual std::string receive(void) {
+ return std::string("Jabber: hello! msg received");
+ }
+ virtual void change_status(const std::string &new_status) {
+ std::cout << "Jabber: Status changed to [" << new_status << "]"
+ << std::endl;
+ }
+
+ virtual ~Jabber(void) {}
+};
+</pre>
+
+ 
+
+ Apart from that we need some protocol information like the server address,
+ port or modes. This data is needed for each protocol and each protocol maybe
+ could have different implementations with different servers or ports.
+ 
+
+ Of course our Info class is a perfect solution to store this data. But in
+ this case as the information is needed for each protocol we could define
+ a base class as the info class and then implement specific versions for each
+ protocol (at least one, could be more for each protocol).
+ 
+
+ So let's define the base class:
+ 
+
+
+
+<pre class="programlisting">// interface for the parameters of each plugin
+class network_parameters
+{
+ public:
+ virtual std::string hostname(void) = 0;
+ virtual std::string port(void) = 0;
+ virtual void set_http_mode(void)= 0;
+
+ virtual ~network_parameters(void) {};
+};
+</pre>
+
+ 
+
+ And the implementation for each of the defined plugins (protocols):
+ 
+
+
+
+<pre class="programlisting">// MSN implementation
+class MSN_network_parameters : public network_parameters
+{
+ public:
+ virtual std::string hostname(void) { return "msn.messenger.com"; }
+ virtual std::string port(void) { return "1863"; }
+
+ virtual void set_http_mode(void) { std::cout << "http mode set"
+ << std::endl; }
+
+ virtual ~MSN_network_parameters() {}
+};
+
+
+// Jabber implementation
+class Jabber_network_parameters : public network_parameters
+{
+ public:
+ virtual std::string hostname(void) { return "jabber.org"; }
+ virtual std::string port(void) { return "7063"; }
+
+ virtual void set_http_mode(void) { std::cout << "http mode not supported"
+ << std::endl; }
+
+ virtual ~Jabber_network_parameters() {}
+};
+</pre>
+
+ We want to be able to compare smart pointers to <code class="computeroutput">network_parameters</code>:
+
+
+<pre class="programlisting">inline bool operator<(const boost::shared_ptr<network_parameters> & first,
+ const boost::shared_ptr<network_parameters> & second) {
+ int comp = strcmp(first->hostname(), second->hostname());
+ if (!comp) {
+ return strcmp(first->port(), second->port()) < 0;
+ }
+ else return comp < 0;
+}
+</pre>
+
+ Now we can define our Info class as a smart pointer to the <code class="computeroutput">network_parameters</code> class and register it
+ in the factory map:
+ 
+
+
+
+<pre class="programlisting">extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_plugins(boost::extensions::factory_map & fm)
+{
+ fm.add< MSN, protocol, boost::shared_ptr<network_parameters> >
+ (boost::shared_ptr<network_parameters>(new MSN_network_parameters));
+ fm.add< Jabber, protocol, boost::shared_ptr<network_parameters> >
+ (boost::shared_ptr<network_parameters>(new Jabber_network_parameters));
+}
+</pre>
+
+ 
+
+ Finally let's use our implementation for an hypothetical connection:
+ 
+
+
+
+<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, "libIMPlugins.extension",
+ "extension_export_plugins");
+
+ // get a reference to the list of constructors for protocols
+ std::map<boost::shared_ptr<network_parameters>, factory<protocol> > &
+ factory_list = fm.get<protocol, boost::shared_ptr<network_parameters> >();
+
+ if (factory_list.size() < 2) {
+ std::cout << "Error - the classes were not found.";
+ return 1;
+ }
+
+ std::map<boost::shared_ptr<network_parameters>, factory<protocol> >
+ ::iterator current_plugin = factory_list.begin();
+
+ // MSN plugin
+ std::auto_ptr<protocol> MSN_ptr(current_plugin->second.create());
+ boost::shared_ptr<network_parameters> msn_parameters =
+ current_plugin->first;
+ current_plugin++;
+
+ // Jabber plugin
+ std::auto_ptr<protocol> Jabber_ptr(current_plugin->second.create());
+ boost::shared_ptr<network_parameters> jabber_parameters =
+ current_plugin->first;
+
+ // server
+ std::cout << "MSN hostname: " << msn_parameters->hostname() << std::endl;
+ std::cout << "Jabber hostname: " << jabber_parameters->hostname()
+ << std::endl;
+ std::cout << std::endl;
+
+ // http_mode: note that one of the implementations doesn't support it,
+ // having a base class
+ // and different specific concrete network parameters allow us to handle this
+ std::cout << "MSN: ";
+ msn_parameters->set_http_mode();
+ std::cout << "Jabber: ";
+ jabber_parameters->set_http_mode();
+ std::cout << std::endl;
+
+ // login
+ MSN_ptr->login("testuser", "testpass");
+ Jabber_ptr->login("testuser", "testpass");
+ std::cout << std::endl;
+
+ // send message
+ MSN_ptr->send("hi");
+ Jabber_ptr->send("hi");
+ std::cout << std::endl;
+
+ // change status
+ MSN_ptr->change_status("away");
+ Jabber_ptr->change_status("away");
+ std::cout << std::endl;
+
+ // wait for message
+ std::cout << MSN_ptr->receive() << std::endl;
+ std::cout << Jabber_ptr->receive() << std::endl;
+ std::cout << std::endl;
+
+ return 0;
+}
+
+</pre>
+
+ 
+
+ And we get the following output:
+ 
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<tbody><tr><td>
+ 
+ <code class="literal">MSN hostname: msn.messenger.com Jabber hostname: jabber.org 
+ MSN: http mode set Jabber: http mode not supported 
+ MSN: Logged In Jabber: Logged In MSN: message
+ [hi] sent Jabber: message [hi] sent MSN: Status
+ changed to [away] Jabber: Status changed to [away] 
+ MSN: hello! msg received Jabber: hello! msg received 
+ </code>
+ 
+ </td></tr></tbody>
+</table></div>
+
+ The complete code is in the <code class="literal">examples/info/im</code> directory.
+ 
+</div>

 There are currently five tutorials.
 
@@ -202,7 +1004,7 @@
</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, Mariano G. Consoni
+<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)
 
@@ -210,7 +1012,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../index.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="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="reference.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-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -162,7 +162,7 @@
</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, Mariano G. Consoni
+<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)

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-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -173,7 +173,7 @@
</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, Mariano G. Consoni
+<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)

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-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -258,7 +258,7 @@
</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, Mariano G. Consoni
+<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)

Modified: sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial05.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial05.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial05.html 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -305,7 +305,7 @@
</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, Mariano G. Consoni
+<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)

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-19 22:35:01 EDT (Sat, 19 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="next" href="boost_extension/tutorials.html" title="Tutorials">
+<link rel="next" href="boost_extension/motivation.html" title=" Motivation">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -17,14 +17,17 @@
<td align="center">More</td>
</tr></table>
<hr>
-<div class="spirit-nav"><a accesskey="n" href="boost_extension/tutorials.html"><img src="../../doc/html/images/next.png" alt="Next"></a></div>
+<div class="spirit-nav"><a accesskey="n" href="boost_extension/motivation.html"><img src="../../doc/html/images/next.png" alt="Next"></a></div>
<div class="chapter" lang="en">
<div class="titlepage"><div>
<div><h2 class="title">
<a name="boost_extension"></a>Chapter 1. Boost.Extension</h2></div>
-<div>Copyright © 2008 Jeremy Pack, Mariano G. Consoni</div>
+<div><div class="author"><h3 class="author">
+Jeremy Pack
+</h3></div></div>
+<div>Copyright © 2008 Jeremy Pack</div>
<div><div class="legalnotice">
-<a name="id435092"></a>
+<a name="id435100"></a>
 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)
 
@@ -34,26 +37,56 @@
Table of Contents
<dl>
<dt> Introduction</dt>
+<dt> Motivation</dt>
+<dt> Shared Libraries</dt>
+<dd><dl>
+<dt><a href="boost_extension/shared_libraries.html#boost_extension.shared_libraries.name_resolution"> Name
+ Resolution</a></dt>
+<dt><a href="boost_extension/shared_libraries.html#boost_extension.shared_libraries.shared_library_issues">
+ Other Issues with Shared Libraries</a></dt>
+<dt><a href="boost_extension/shared_libraries.html#boost_extension.shared_libraries.shared_library_inefficiencies">
+ Possible Inefficiencies in Shared Libraries</a></dt>
+<dt><a href="boost_extension/shared_libraries.html#boost_extension.shared_libraries.shared_library_class">shared_library
+ class</a></dt>
+</dl></dd>
+<dt> Factories</dt>
<dt>Tutorials</dt>
<dd><dl>
<dt> Tutorial 1</dt>
-<dt> Tutorial 2</dt>
-<dt> Tutorial 3</dt>
-<dt> Tutorial 4</dt>
-<dt> Tutorial 5</dt>
+<dt> Tutorial 2</dt>
+<dt> Tutorial 3</dt>
+<dt> Tutorial 4</dt>
+<dt> Tutorial 5</dt>
</dl></dd>
-<dt> Factories</dt>
-<dt> Shared Libraries</dt>
<dt>Reference</dt>
<dd><dl>
<dt>Header <boost/extension/common.hpp></dt>
-<dt>Header <boost/extension/convenience.hpp></dt>
-<dt>Header <boost/extension/extension.hpp></dt>
-<dt>Header <boost/extension/factory.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/convenience.hpp></dt>
+<dt>Header <boost/extension/extension.hpp></dt>
+<dt>Header <boost/extension/factory.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>
+</dl></dd>
+<dt><a href="boost_extension/extension_reflection.html"> Boost.Reflection/Boost.Extension
+ Interoperability</a></dt>
+<dt>Reference</dt>
+<dd><dl>
+<dt>Header <boost/reflection/adapter.hpp></dt>
+<dt>Header <boost/reflection/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/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></dd>
<dt> Info Classes</dt>
<dt> Performance Analysis</dt>
@@ -62,7 +95,7 @@
<dd><dl>
<dt><a href="boost_extension/appendices.html#boost_extension.appendices.appendix_a"> Appendix A -
 Windows Export and Import Declarations</a></dt>
-<dt><a href="boost_extension/appendices/appendix_b.html"> Appendix B -
+<dt><a href="boost_extension/appendices.html#boost_extension.appendices.appendix_b"> Appendix B -
 Optional Dependencies</a></dt>
</dl></dd>
</dl>
@@ -108,6 +141,6 @@
<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
-<div class="spirit-nav"><a accesskey="n" href="boost_extension/tutorials.html"><img src="../../doc/html/images/next.png" alt="Next"></a></div>
+<div class="spirit-nav"><a accesskey="n" href="boost_extension/motivation.html"><img src="../../doc/html/images/next.png" alt="Next"></a></div>
</body>
</html>

Added: sandbox/libs/extension/doc/motivation.qbk
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/motivation.qbk 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -0,0 +1,42 @@
+[/ Boost.Extension - Original Motivation ]
+[/ 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:motivation Motivation]
+
+The original motivation for Boost.Extension was a moving-object-tracking application.
+This application was to be used for both real-time and post-processing analysis
+of a series of images. The types of cameras used for tracking were anything from
+low-speed, low-resolution IR cameras, to medium-speed color camcorders to high-speed,
+multi-spectral IR cameras.
+
+Each client or potential client of the application had different input types, and
+different types of data they needed at the end. There were, in general, the following
+major problems:
+
+* Some clients had proprietary image formats that needed to be input, or proprietary
+algorithms they wished to use for the data. We could not give these algorithms to
+other clients.
+* Clients wanted to be able to adapt the software to work with new requirements,
+such as a new camera type, in the future. To do this, one client in particular
+wanted full ownership of the source code.
+* Our code had become very entangled, and our application had become a mess of
+menus covering the various bits of functionality.
+
+Initially, we just delivered different builds to each customer. This was tedious,
+and only solved the first problem.
+
+For this reason, work was begun on using shared libraries which would each contain
+a related set of modules. Each customer would be given two sets of files:
+
+* Shared libraries for their specific data types, UI needs, algorithms, etc.
+* An SDK to develop plugins in the future to handle any new requirements for
+the software.
+
+Boost.Extension is designed to make this type of solution simple, portable,
+and easily extensible.
+
+[endsect]
\ No newline at end of file

Modified: sandbox/libs/extension/doc/shared_libraries.qbk
==============================================================================
--- sandbox/libs/extension/doc/shared_libraries.qbk (original)
+++ sandbox/libs/extension/doc/shared_libraries.qbk 2008-07-19 22:35:01 EDT (Sat, 19 Jul 2008)
@@ -7,49 +7,91 @@

[section:shared_libraries Shared Libraries]

-A `shared_library` refers to a loadable module, the type of which depends
+A _shared_library_ refers to a loadable module, the type of which depends
on the platform:

* Windows: .dll
* Most Linux or Unix: .so
* Mac OS X: .dylib or .bundle (See [link appendix_c Appendix C])

+Normally, shared libraries are loaded by an application when it starts.
+This is commonly used by Boost libraries that can be built as shared libraries,
+such as Boost.Thread or Boost.Filesystem.

-[h4 `shared_library(const char * location, bool auto_close = false)`]
-`location` is the relative path of the shared library to laod, and
-`auto_close` sets whether or not the library will be automatically
-closed when the `shared_library` is destroyed. This function does
-not open the library.
-
-[h4 `bool open()`]
-Returns true if the library is opened successfully.
-
-[h4 `bool is_open()`]
-Returns true if the library is open.
-
-[h4 `void close()`]
-Close the library. Note that an OS specific shared library usually keeps a
-reference count, meaning that calling this function will just decrease the
-reference count. If the reference count drops to 0, the library will be
-ready to actually closed - though the platform is not required to actually
-close the library even then. As such, this function can sometimes give a
-performance boost, by freeing up RAM, but will often do nothing.
-[h4 `ReturnValue (*get(const char * name))(ARGS)`]
-This function returns a pointer to a function in a dll with `name`. Note
-that a C++ function needs to have `extern "C"` before it in order for this
-to work. To get a function like this:
-``
-extern "C"
-int get_value(const char * name) {
- return 0;
+Shared libraries can also be loaded at will, during program execution.
+
+Whenever a shared library is loaded, either at load time or later during
+a program's execution, the function and variable locations in the library
+are resolved.
+
+[section:name_resolution Name Resolution]
+
+A loaded shared library can be searched for functions or data. In C++,
+this requires that the function be marked as follows:
+
+\code extern "C" void MyFunction() {
+ // do stuff
}
-``
-You would call:
-``
-mySharedLibrary.get<int, const char *>("get_value");
-``
-[note
-It is recommended that you use Boost.Function to capture the return values
-of `get`, but not required.]
+\endcode
+
+The reason for this is the name-mangling that C++ performs, to give
+different names to, for instance, multiple overloads with the same
+function name.
+
+Because different compilers mangle names differently (and in ways
+that are often undocumented), it would be very difficult to create
+a cross-platform solution to avoid the use of extern "C" declarations.
+This is the primary cause of the inherent lack of type-safety with
+calls in the _shared_library_ class.
+
+[endsect]
+
+[section:shared_library_issues Other Issues with Shared Libraries]
+
+* Separate symbol tables are required in each shared library.
+* RTTI merging: Some compilers do it. Some don't.
+* Optimizations are harder because the code must be position
+independent.
+* The following may break binary compatibility between an application and
+a shared library (among other things):
+ * Any part of shared class changes. Variable ordering, public/private/
+protected, virtual function implementations, add/remove variables/
+functions etc.
+ * Different compiler or compiler options used, or headers included
+differently.
+
+[endsect]
+
+[section:shared_library_inefficiencies Possible Inefficiencies in Shared Libraries]
+
+* Position Independent Code:
+ * Since the shared library could be loaded to any part of the address space, it
+cannot hard code addresses of its functions and data. This must be resolved
+when the library is loaded.
+ * They can take a really long time to load.
+ * OS's attempt to mitigate this in various ways.
+* Extra levels of indirection in non-virtual function calls.
+ * No inlining across library boundaries.
+
+[endsect]
+
+[section shared_library class]
+
+Provides for automatic loading of named modules, and retrieval of functions
+in those modules:
+
+```
+shared_library m("my_module_name");
+// Call a function that returns an int and takes a float parameter.
+int result = m.get<int, float>("function_name")(5.0f);
+m.close();
+```
+
+The `get()` function returns a function
+pointer that can be wrapped in Boost.Function objects or used by itself.
+
+Reference: _shared_library_
+
+[endsect]

[endsect]
\ No newline at end of file

Next message: oryol_at_[hidden]: "[Boost-commit] svn:boost r47616 - in sandbox/libs/reflection: doc doc/html doc/html/boost_reflection test"
Previous message: oryol_at_[hidden]: "[Boost-commit] svn:boost r47614 - sandbox/libs/extension/test"

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