Boost-Commit :

Date view	Thread view	Subject view	Author view

From: oryol_at_[hidden]
Date: 2008-07-20 00:40:12

Next message: eric_at_[hidden]: "[Boost-commit] svn:boost r47622 - trunk/libs/accumulators/doc"
Previous message: oryol_at_[hidden]: "[Boost-commit] svn:boost r47620 - sandbox/libs/extension/test"

Author: jeremypack
Date: 2008-07-20 00:40:09 EDT (Sun, 20 Jul 2008)
New Revision: 47621
URL: http://svn.boost.org/trac/boost/changeset/47621

Log:
Add new docs html and one header.

Added:
   sandbox/boost/extension/impl/adaptable_factory_set.hpp (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/extension_reflection.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/shared_libraries/
   sandbox/libs/extension/doc/html/boost_extension/shared_libraries/.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/shared_libraries/cheese.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_class.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_class_description.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_inefficiencies.html (contents, props changed)
   sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_issues.html (contents, props changed)

Added: sandbox/boost/extension/impl/adaptable_factory_set.hpp
==============================================================================
--- (empty file)
+++ sandbox/boost/extension/impl/adaptable_factory_set.hpp 2008-07-20 00:40:09 EDT (Sun, 20 Jul 2008)
@@ -0,0 +1,30 @@
+/*
+ * Copyright Jeremy Pack 2008
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE_1_0.txt or copy at
+ * http://www.boost.org/LICENSE_1_0.txt)
+ *
+ * See http://www.boost.org/ for latest version.
+ */
+
+// No header guard - this file is intended to be included multiple times.
+
+#define N BOOST_PP_ITERATION()
+template <class Derived
+ BOOST_PP_COMMA_IF(N) BOOST_PP_ENUM_PARAMS(N, class Param)>
+void set(BOOST_PP_ENUM_PARAMS(N, Info i)) {
+ parameter_names_.resize(0);
+#define BOOST_EXTENSION_ADD_TO_LIST(z, n, data) \
+parameter_names_.push_back(BOOST_PP_CAT(i, n));
+ BOOST_PP_REPEAT(N, BOOST_EXTENSION_ADD_TO_LIST, );
+#undef BOOST_EXTENSION_ADD_TO_LIST
+ func_ = &impl::create_func
+ <Interface, Derived, Info, TypeInfo
+ BOOST_PP_COMMA_IF(N)
+ BOOST_PP_ENUM_PARAMS(N, Param)>;
+ check_func_ = &impl::check_func
+ <Info, TypeInfo BOOST_PP_COMMA_IF(N)
+ BOOST_PP_ENUM_PARAMS(N, Param)>;
+}
+#undef N
+

Added: sandbox/libs/extension/doc/html/boost_extension/extension_reflection.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/boost_extension/extension_reflection.html 2008-07-20 00:40:09 EDT (Sun, 20 Jul 2008)
@@ -0,0 +1,183 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title> Boost.Reflection/Boost.Extension
+ Interoperability</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="../boost/extensions/shared_library.html" title="Class shared_library">
+<link rel="next" href="reference.html" title="Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../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="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.extension_reflection"></a><a href="extension_reflection.html" title=" Boost.Reflection/Boost.Extension
+ Interoperability"> Boost.Reflection/Boost.Extension
+ Interoperability</a></h2></div></div></div>
+
+ Reflections are designed to work with Boost.Extension, or with shared libraries
+ in general. A simple example is included in examplesextension.
+ 
+
+ 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.
+
+<pre class="programlisting">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 ;
+</pre>
+
+ 
+
+ 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.
+
+<pre class="programlisting">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) {}
+};
+</pre>
+
+ 
+
+ 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.
+
+<pre class="programlisting">std::map<std::string, reflection> reflection_map;
+</pre>
+
+ Load the shared library using Boost.Extension.
+
+<pre class="programlisting">boost::extensions::shared_library lib
+ ((std::string(BOOST_EXTENSION_DIR_START) +
+ "libcar_lib.extension").c_str());
+lib.open();
+</pre>
+
+ Call an exported function to populate reflection_map.
+
+<pre class="programlisting">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;
+}
+</pre>
+
+ Pull out two reflections that were named "suv" and "compact"
+ respectively.
+
+<pre class="programlisting">reflection & first_reflection =
+ reflection_map["suv"];
+reflection & second_reflection =
+ reflection_map["compact"];
+</pre>
+
+ Use the get_constructor function to find a constructor that takes one argument,
+ a const char*.
+
+<pre class="programlisting">instance_constructor<const char *> first_constructor =
+ first_reflection.get_constructor<const char *>();
+</pre>
+
+ Use the constructor retrieved to create an instance. Warning! instances should
+ only be used with functions and constructors generated by a single reflection
+ object.
+
+<pre class="programlisting">instance first_instance =
+ first_constructor("First Instance");
+</pre>
+
+ Get a function to call on this instance.
+
+<pre class="programlisting">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;
+ </pre>
+
+ Repeat the steps for the second reflection.
+
+<pre class="programlisting">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;
+</pre>
+
+ 
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../boost/extensions/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="reference.html"><img src="../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/boost_extension/shared_libraries/.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/boost_extension/shared_libraries/.html 2008-07-20 00:40:09 EDT (Sun, 20 Jul 2008)
@@ -0,0 +1,41 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title></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="../shared_libraries.html" title=" Shared Libraries">
+<link rel="prev" href="shared_library_class.html" title="shared_library
+ class">
+<link rel="next" href="../reference.html" title="Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="shared_library_class.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title">
+<a name="boost_extension.shared_libraries."></a>???</h3></div></div></div></div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack, 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="shared_library_class.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/boost_extension/shared_libraries/cheese.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/boost_extension/shared_libraries/cheese.html 2008-07-20 00:40:09 EDT (Sun, 20 Jul 2008)
@@ -0,0 +1,47 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title> Chees Section</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="../shared_libraries.html" title=" Shared Libraries">
+<link rel="prev" href="shared_library_issues.html" title="
+ Other Issues with Shared Libraries">
+<link rel="next" href="shared_library_inefficiencies.html" title="
+ Possible Inefficiencies in 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="shared_library_issues.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="shared_library_inefficiencies.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_extension.shared_libraries.cheese"></a> Chees Section</h3></div></div></div>
+
+ Some cheese.
+ 
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="shared_library_issues.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="shared_library_inefficiencies.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_class.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_class.html 2008-07-20 00:40:09 EDT (Sun, 20 Jul 2008)
@@ -0,0 +1,68 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>shared_library
+ class</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="../shared_libraries.html" title=" Shared Libraries">
+<link rel="prev" href="shared_library_inefficiencies.html" title="
+ Possible Inefficiencies in Shared Libraries">
+<link rel="next" href="../reference.html" title="Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="shared_library_inefficiencies.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_extension.shared_libraries.shared_library_class"></a><a href="shared_library_class.html" 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">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>
+
+ 
+
+ 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>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="shared_library_inefficiencies.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_class_description.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_class_description.html 2008-07-20 00:40:09 EDT (Sun, 20 Jul 2008)
@@ -0,0 +1,68 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>
+ shared_library class</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="../shared_libraries.html" title=" Shared Libraries">
+<link rel="prev" href="shared_library_inefficiencies.html" title="
+ Possible Inefficiencies in Shared Libraries">
+<link rel="next" href="../reference.html" title="Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="shared_library_inefficiencies.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_extension.shared_libraries.shared_library_class_description"></a><a href="shared_library_class_description.html" 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">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>
+
+ 
+
+ 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>
+<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="shared_library_inefficiencies.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_inefficiencies.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_inefficiencies.html 2008-07-20 00:40:09 EDT (Sun, 20 Jul 2008)
@@ -0,0 +1,70 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>
+ Possible Inefficiencies in Shared Libraries</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="../shared_libraries.html" title=" Shared Libraries">
+<link rel="prev" href="cheese.html" title=" Chees Section">
+<link rel="next" href="shared_library_class.html" title="shared_library
+ class">
+</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="cheese.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="shared_library_class.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_extension.shared_libraries.shared_library_inefficiencies"></a><a href="shared_library_inefficiencies.html" 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>
+<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="cheese.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="shared_library_class.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_issues.html
==============================================================================
--- (empty file)
+++ sandbox/libs/extension/doc/html/boost_extension/shared_libraries/shared_library_issues.html 2008-07-20 00:40:09 EDT (Sun, 20 Jul 2008)
@@ -0,0 +1,70 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>
+ Other Issues with Shared Libraries</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="../shared_libraries.html" title=" Shared Libraries">
+<link rel="prev" href="../shared_libraries.html" title=" Shared Libraries">
+<link rel="next" href="cheese.html" title=" Chees Section">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../shared_libraries.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="cheese.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_extension.shared_libraries.shared_library_issues"></a><a href="shared_library_issues.html" 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>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2008 Jeremy Pack
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../shared_libraries.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../shared_libraries.html"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="cheese.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Next message: eric_at_[hidden]: "[Boost-commit] svn:boost r47622 - trunk/libs/accumulators/doc"
Previous message: oryol_at_[hidden]: "[Boost-commit] svn:boost r47620 - 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