Boost-Commit :

Date view	Thread view	Subject view	Author view

From: oryol_at_[hidden]
Date: 2007-09-15 12:24:03

Next message: oryol_at_[hidden]: "[Boost-commit] svn:boost r39301 - sandbox/boost/reflection"
Previous message: pbristow_at_[hidden]: "[Boost-commit] svn:boost r39299 - sandbox/math_toolkit/boost/math/distributions"

Author: jeremypack
Date: 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
New Revision: 39300
URL: http://svn.boost.org/trac/boost/changeset/39300

Log:
Documentation work for new API

Text files modified:
   sandbox/libs/extension/doc/Jamfile.v2 | 4
   sandbox/libs/extension/doc/appendices.qbk | 1
   sandbox/libs/extension/doc/appendix_b.qbk | 26 +--
   sandbox/libs/extension/doc/extension.qbk | 3
   sandbox/libs/extension/doc/factories.qbk | 21 ++
   sandbox/libs/extension/doc/html/HTML.manifest | 1
   sandbox/libs/extension/doc/html/boost_extension/appendices.html | 16 +-
   sandbox/libs/extension/doc/html/boost_extension/appendices/appendix_a.html | 18 +-
   sandbox/libs/extension/doc/html/boost_extension/factories.html | 46 ++++++
   sandbox/libs/extension/doc/html/boost_extension/info.html | 145 ++++++++++++---------
   sandbox/libs/extension/doc/html/boost_extension/introduction.html | 27 +--
   sandbox/libs/extension/doc/html/boost_extension/performance_analysis.html | 21 +-
   sandbox/libs/extension/doc/html/boost_extension/shared_libraries.html | 81 +++++++++++
   sandbox/libs/extension/doc/html/boost_extension/tutorials.html | 6
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial01.html | 111 ++++++++-------
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial02.html | 65 ++++----
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial03.html | 93 +++++++-----
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial04.html | 132 +++++++++++--------
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial05.html | 268 ++++++++++++++++++++++++---------------
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial06.html | 6
   sandbox/libs/extension/doc/html/index.html | 15 +-
   sandbox/libs/extension/doc/info.qbk | 86 ++++++++----
   sandbox/libs/extension/doc/introduction.qbk | 20 +-
   sandbox/libs/extension/doc/shared_libraries.qbk | 45 ++++++
   sandbox/libs/extension/doc/tutorial1.qbk | 56 +++++--
   sandbox/libs/extension/doc/tutorial2.qbk | 47 +++---
   sandbox/libs/extension/doc/tutorial3.qbk | 72 ++++++---
   sandbox/libs/extension/doc/tutorial4.qbk | 114 ++++++++++------
   sandbox/libs/extension/doc/tutorial5.qbk | 208 ++++++++++++++++++++-----------
   sandbox/libs/extension/doc/tutorials.qbk | 11
   sandbox/libs/extension/examples/info/im/network_parameters.hpp | 10 +
   sandbox/libs/extension/examples/info/im/plugins.cpp | 8 -
   sandbox/libs/extension/examples/info/im/protocol.hpp | 2
   sandbox/libs/extension/examples/info/multilanguage_main.cpp | 4
   34 files changed, 1104 insertions(+), 685 deletions(-)

Modified: sandbox/libs/extension/doc/Jamfile.v2
==============================================================================
--- sandbox/libs/extension/doc/Jamfile.v2 (original)
+++ sandbox/libs/extension/doc/Jamfile.v2 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -23,5 +23,5 @@

;

-install html : ../../../doc/html/boostbook.css ;
-install ../ : ../../../boost.png ;
+install html : $(BOOST_ROOT)/doc/html/boostbook.css ;
+install ../ : $(BOOST_ROOT)/boost.png ;

Modified: sandbox/libs/extension/doc/appendices.qbk
==============================================================================
--- sandbox/libs/extension/doc/appendices.qbk (original)
+++ sandbox/libs/extension/doc/appendices.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -8,4 +8,5 @@
[section:appendices Appendices]
[include appendix_a.qbk]
[include appendix_b.qbk]
+[include appendix_c.qbk]
[endsect]
\ No newline at end of file

Modified: sandbox/libs/extension/doc/appendix_b.qbk
==============================================================================
--- sandbox/libs/extension/doc/appendix_b.qbk (original)
+++ sandbox/libs/extension/doc/appendix_b.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -7,19 +7,17 @@

[section:appendix_b Appendix B - Optional Dependencies]

-As suggested by Boost guidelines and our thoughts, we tried to keep the number of dependencies of Boost.Extension
-at the minimum. But we also wanted to take advantage of several boost libraries that have additional features
-and are easy to use.
-
-Then, we give the option to the user. Currently we have two different flags that change the implementation
-of the library:
-
-# BOOST_EXTENSION_USE_PP: enables the use of Boost.Preprocessor to implement some repetitive code.
-
-# BOOST_EXTENSION_USE_BOOST_FUNCTION: enables the use of Boost.Function to implement the functors pointing
-to the plugin implementations.
-
-You should define the variables at your convenience with any value to enable the use of each library.
-
+As suggested by Boost guidelines and our thoughts, we tried to keep the number
+of dependencies of Boost.Extension at the minimum. But we also wanted to take
+advantage of several boost libraries that have additional features and are easy
+to use.
+
+For basic use of the library, currently only Boost.Preprocessor is required.
+There are certain convenience headers that rely on other libraries, such
+as Boost.Filesystem.
+
+Also, the `shared_library` class has been designed to be easy to use with
+Boost.Function. It returns function pointers that can be loaded directly
+into Boost.Function objects.

[endsect]

Modified: sandbox/libs/extension/doc/extension.qbk
==============================================================================
--- sandbox/libs/extension/doc/extension.qbk (original)
+++ sandbox/libs/extension/doc/extension.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -16,7 +16,7 @@
         [@http://www.boost.org/LICENSE_1_0.txt http://www.boost.org/LICENSE_1_0.txt])
     ]
     [category Programming Interfaces]
- [last-revision $Date: 2007/4/30 12:00:00 $]
+ [last-revision $Date: 2007/9/15 9:05:00 $]
]

@@ -31,4 +31,3 @@
[include info.qbk]
[include performance_analysis.qbk]
[include appendices.qbk]
-

Modified: sandbox/libs/extension/doc/factories.qbk
==============================================================================
--- sandbox/libs/extension/doc/factories.qbk (original)
+++ sandbox/libs/extension/doc/factories.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -7,7 +7,24 @@

[section:factories Factories]

-Factories are generated automatically. In the future, this section will contain
-more information about methods.
+In normal usage, a `factory` is initialized in a shared library, then returned
+to an application with a reference to a function that can be used to create
+the given implementation of the `factory` interface.

+A factory has the following template options:
+
+`factory<class T, ARGS>`
+
+Where `T` is the interface that it returns, and `ARGS` is a variable length
+list of the argument types to the factory function. The maximum possible
+length of the arglist is set by `BOOST_EXTENSION_MAX_FUNCTOR_PARAMS`, which
+defaults to six.
+
+The functions available in `factory` are:
+[h3 void set<D>()]
+The `set` function takes a template argument describing the class that will
+be created by this factory, and that implements the `T` interface. This
+function may be called multiple times, to change the factory function.
+[h3 bool is_valid()]
+If set has been called, this returns true. Otherwise, it returns false.
[endsect]
\ No newline at end of file

Modified: sandbox/libs/extension/doc/html/HTML.manifest
==============================================================================
--- sandbox/libs/extension/doc/html/HTML.manifest (original)
+++ sandbox/libs/extension/doc/html/HTML.manifest 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -14,3 +14,4 @@
boost_extension/appendices.html
boost_extension/appendices/appendix_a.html
boost_extension/appendices/appendix_b.html
+boost_extension/appendices/appendix_c.html

Modified: sandbox/libs/extension/doc/html/boost_extension/appendices.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/appendices.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/appendices.html 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,12 +3,11 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Appendices</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="prev" href="performance_analysis.html" title=" Performance Analysis">
-<link rel="next" href="appendices/appendix_a.html" title=" Appendix A -
- Windows Export and Import Declarations">
+<link rel="next" href="appendices/appendix_a.html" title=" Appendix A - Windows Export and Import Declarations">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -25,15 +24,14 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="boost_extension.appendices"></a> Appendices</h2></div></div></div>
+<a name="boost_extension.appendices"></a> Appendices</h2></div></div></div>
<div class="toc"><dl>
-<dt><a href="appendices/appendix_a.html"> Appendix A -
- Windows Export and Import Declarations</a></dt>
-<dt><a href="appendices/appendix_b.html"> Appendix B -
- Optional Dependencies</a></dt>
+<dt> Appendix A - Windows Export and Import Declarations</dt>
+<dt> Appendix B - Optional Dependencies</dt>
+<dt> Appendix C - OS X Shared Libraries</dt>
</dl></div>
</div>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

Modified: sandbox/libs/extension/doc/html/boost_extension/appendices/appendix_a.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/appendices/appendix_a.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/appendices/appendix_a.html 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -1,15 +1,13 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title> Appendix A -
- Windows Export and Import Declarations</title>
+<title> Appendix A - Windows Export and Import Declarations</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../appendices.html" title=" Appendices">
<link rel="prev" href="../appendices.html" title=" Appendices">
-<link rel="next" href="appendix_b.html" title=" Appendix B -
- Optional Dependencies">
+<link rel="next" href="appendix_b.html" title=" Appendix B - Optional Dependencies">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -26,9 +24,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="boost_extension.appendices.appendix_a"></a><a href="appendix_a.html" title=" Appendix A -
- Windows Export and Import Declarations"> Appendix A -
- Windows Export and Import Declarations</a></h3></div></div></div>
+<a name="boost_extension.appendices.appendix_a"></a> Appendix A - Windows Export and Import Declarations</h3></div></div></div>

 On the Windows platform, special export declarations are required to make
 functions or classes in a .dll file accessible to the outside world. For
@@ -45,8 +41,8 @@
 how this is done.
 
<a name="boost_extension.appendices.appendix_a.warning"></a><h3>
-<a name="id2579210"></a>
- Warning
+<a name="id937980"></a>
+ Warning
 </h3>

 Now for a word of warning that many of you will ignore: In the great majority
@@ -68,7 +64,7 @@
 </li>
</ul></div>
</div>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

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 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Factories</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="prev" href="tutorials/tutorial06.html" title=" Tutorial 6">
@@ -24,13 +24,49 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="boost_extension.factories"></a> Factories</h2></div></div></div>
+<a name="boost_extension.factories"></a> Factories</h2></div></div></div>

- Factories are generated automatically. In the future, this section will contain
- more information about methods.
+ In normal usage, a <code class="computeroutput">factory</code>
+ is initialized in a shared library, then returned to an application with a
+ reference to a function that can be used to create the given implementation
+ of the <code class="computeroutput">factory</code> interface.
+ 
+
+ A factory has the following template options:
+ 
+
+ <code class="computeroutput">factory<class T, ARGS></code>
+ 
+
+ Where <code class="computeroutput">T</code> is the interface that
+ it returns, and <code class="computeroutput">ARGS</code> is a variable
+ length list of the argument types to the factory function. The maximum possible
+ length of the arglist is set by <code class="computeroutput">BOOST_EXTENSION_MAX_FUNCTOR_PARAMS</code>,
+ which defaults to six.
+ 
+
+ The functions available in <code class="computeroutput">factory</code>
+ are:
+ 
+<a name="boost_extension.factories.void_set_lt_d_gt___"></a><h3>
+<a name="id934360"></a>
+ void set<D>()
+ </h3>
+
+ The <code class="computeroutput">set</code> function takes a template
+ argument describing the class that will be created by this factory, and that
+ implements the <code class="computeroutput">T</code> interface.
+ This function may be called multiple times, to change the factory function.
+ 
+<a name="boost_extension.factories.bool_is_valid__"></a><h3>
+<a name="id934400"></a>
+ bool is_valid()
+ </h3>
+
+ If set has been called, this returns true. Otherwise, it returns false.

</div>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

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 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Info Classes</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="prev" href="shared_libraries.html" title=" Shared Libraries">
@@ -24,7 +24,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="boost_extension.info"></a> Info Classes</h2></div></div></div>
+<a name="boost_extension.info"></a> Info Classes</h2></div></div></div>

 In this section we explain how to use Info classes in Boost.Extension.
 
@@ -48,8 +48,8 @@

 First, we define an implementation of the <code class="literal">word</code> interface
 for each combination of word and language. Then we have for example the class
- <code class="literal">monde</code> that implements the <code class="literal">word</code> interface
- for the french language in this case.
+ <code class="literal">monde</code> that implements the <code class="computeroutput">word</code>
+ interface for the french language in this case.
 

 Let's see the code:
@@ -58,53 +58,53 @@


<pre class="programlisting">
-class world : public word
+class world : public word
{
public:
- virtual const char * get_val(){return "world!";}
+ virtual const char * get_val(){return "world!";}
};

-class mundo : public word
+class mundo : public word
{
public:
- virtual const char * get_val(){return "mundo!";}
+ virtual const char * get_val(){return "mundo!";}
};

-class monde : public word
+class monde : public word
{
public:
- virtual const char * get_val(){return "monde!";}
+ virtual const char * get_val(){return "monde!";}
};

-class mondo : public word
+class mondo : public word
{
public:
- virtual const char * get_val(){return "mondo!";}
+ virtual const char * get_val(){return "mondo!";}
};

-class hello : public word
+class hello : public word
{
public:
- virtual const char * get_val(){return "hello";}
+ virtual const char * get_val(){return "hello";}
};

-class hola : public word
+class hola : public word
{
public:
- virtual const char * get_val(){return "hola";}
+ virtual const char * get_val(){return "hola";}
};

-class bonjour : public word
+class bonjour : public word
{
public:
- virtual const char * get_val(){return "bonjour";}
+ virtual const char * get_val(){return "bonjour";}
};

-class buonasera : public word
+class buonasera : public word
{
public:
- virtual const char * get_val(){return "buonasera";}
+ virtual const char * get_val(){return "buonasera";}
};
</pre>

@@ -126,16 +126,28 @@


<pre class="programlisting">
-struct word_description
+struct word_description
{
- std::string language;
- std::string english_translation;
+ std::string language;
+ std::string english_translation;

- word_description(std::string language, std::string english_translation)
- : language(language), english_translation(english_translation) {}
+ word_description(std::string language, std::string english_translation)
+ : language(language), english_translation(english_translation) {}
};
</pre>

+ We also need a less-than operator for this class, so it can be used as a map
+ key.
+
+<pre class="programlisting">
+inline bool operator<(const word_description & first,
+ const word_description & second) {
+ return first.language < second.language ||
+ (first.language == second.language &&
+ first.english_translation < second.english_translation);
+}
+</pre>
+
 

 Finally, just store a <code class="literal">word_description</code> instance when adding
@@ -145,32 +157,36 @@


<pre class="programlisting">
-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_multilanguage_word(boost::extensions::factory_map & fm)
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_multilanguage_word(boost::extensions::factory_map & fm)
{
- fm.add<hola, word, word_description>(word_description("spanish", "hello"));
- fm.add<mundo, word, word_description>(word_description("spanish", "world!"));
-
- fm.add<bonjour, word, word_description>(word_description("french", "hello"));
- fm.add<monde, word, word_description>(word_description("french", "world!"));
-
- fm.add<buonasera, word, word_description>(word_description("italian", "hello"));
- fm.add<mondo, word, word_description>(word_description("italian", "world!"));
-
- fm.add<hello, word, word_description>(word_description("english", "hello"));
- fm.add<world, word, word_description>(word_description("english", "world!"));
+ fm.get<word, word_description>()[word_description("spanish", "hello")]
+ .set<hola>();
+ fm.get<word, word_description>()[word_description("spanish", "world!")]
+ .set<mundo>();
+
+ fm.get<word, word_description>()[word_description("french", "hello")]
+ .set<bonjour>();
+ fm.get<word, word_description>()[word_description("french", "world!")]
+ .set<monde>();
+ fm.get<word, word_description>()[word_description("italian", "hello")]
+ .set<buonasera>();
+ fm.get<word, word_description>()[word_description("italian", "world!")]
+ .set<mondo>();
+ fm.get<word, word_description>()[word_description("english", "hello")]
+ .set<hello>();
+ fm.get<word, word_description>()[word_description("english", "world!")]
+ .set<world>();
}
+
</pre>

 

- In the code we could see that add argument is a Info class instance. In this
- case is <code class="literal">word_description</code> which receives the language and
- word as arguments.
- 
-
- Now we could start using that information in the main code. Retrieving Info
- class is easy, you should just call <code class="literal">get_info()</code> method of
- the factory.
+ Now we could start using that information in the main code. Retrieving the
+ <code class="computeroutput">Info</code> instance for a factory
+ is simple, since it is part of the <code class="computeroutput">std::pair</code> in
+ the map of factories.
 

 Let's see some code using the multilanguage hello world words:
@@ -179,31 +195,34 @@


<pre class="programlisting">
-for (std::list<factory<word, word_description> >::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() << " is " << current_word->get_info().english_translation
- << " in " << current_word->get_info().language << std::endl;
+for (std::map<word_description, factory<word> >::iterator current_word =
+ factory_list.begin(); current_word != factory_list.end();
+ ++current_word) {
+ std::auto_ptr<word> word_ptr(current_word->second.create());
+ std::cout << word_ptr->get_val() << " is "
+ << current_word->first.english_translation
+ << " in " << current_word->first.language
+ << std::endl;
}
-std::cout << std::endl;
+std::cout << std::endl;
</pre>

 

 And we get the following output:
 
-<div class="informaltable"><table class="table">
+<div class="informaltable">
+<h4>
+<a name="id937578"></a>
+ </h4>
+<table class="table">
<colgroup><col></colgroup>
-<tbody><tr><td>
- 
- <code class="literal">hola is hello in spanish mundo! is world! in spanish 
- bonjour is hello in french monde! is world! in french buonasera
- is hello in italian mondo! is world! in italian hello is
- hello in english world! is world! in english </code>
- 
- </td></tr></tbody>
-</table></div>
+<tbody><tr><td><code class="literal">hola is hello in spanish mundo! is world! in spanish 
+ bonjour is hello in french monde! is world! in french buonasera
+ is hello in italian mondo! is world! in italian hello is
+ hello in english world! is world! in english </code></td></tr></tbody>
+</table>
+</div>

 Now that we have described our example the major parts could be summarized:
 
@@ -227,7 +246,7 @@
 Tutorial 5 describes a more complex example of the use of the Info class.
 
</div>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

Modified: sandbox/libs/extension/doc/html/boost_extension/introduction.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/introduction.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/introduction.html 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Introduction</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="prev" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
@@ -24,43 +24,38 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="boost_extension.introduction"></a> Introduction</h2></div></div></div>
-
- Wrappers for loading classes from linked libraries to extend the functionality
- of a program. Created to ease the creation of plugins.
- 
+<a name="boost_extension.introduction"></a> Introduction</h2></div></div></div>

 The Boost.Extension library has been developed to ease the development of plugins
- and similar extensions to software. Classes can be made available from linked
- libraries and loaded automatically by the application.
+ and similar extensions to software. Classes can be made available from shared
+ libraries and loaded by the application.
 

- The documentation is completely incomplete. Sorry. Look at tutorial #1 for
- examples of basic usage, and tutorial #2 for examples of advanced usage.
+ The documentation is mostly complete.
 

 Note the following:
 
-<div class="orderedlist"><ol type="1">
+<div class="itemizedlist"><ul type="disc">
<li>
 Multiple and virtual inheritance are supported
 </li>
<li>
- No macros are currently used (besides those required by Windows for exported
- functions)
+ Library users do not need to use any macros (besides those required by Windows
+ for exported functions)
 </li>
<li>
 Only one external function required per shared library to export classes
 </li>
<li>
- RTTI is used by default, but it is possible to use user-defined type identifications.
+ RTTI is used by default, but it is possible to use user-defined type identification
 </li>
<li>
 Classes do not need to be modified to be loadable
 </li>
-</ol></div>
+</ul></div>
</div>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

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 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Performance Analysis</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="prev" href="info.html" title=" Info Classes">
@@ -24,7 +24,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="boost_extension.performance_analysis"></a> Performance Analysis</h2></div></div></div>
+<a name="boost_extension.performance_analysis"></a> Performance Analysis</h2></div></div></div>

 In this section we will discuss the performance of the library. We'll focus
 on the overhead added in comparison with <code class="literal">dlopen/dlclose</code>
@@ -36,9 +36,8 @@
 using the optional boost::function.
 
<a name="boost_extension.performance_analysis.first_comparison"></a><h1>
-<a name="id2578892"></a>
- <a href="performance_analysis.html#boost_extension.performance_analysis.first_comparison">First
- comparison</a>
+<a name="id937711"></a>
+ First comparison
 </h1>

 The first benchmarks show how much overhead is incurred by using Boost.Extension
@@ -69,9 +68,8 @@
 So Boost.Extension is (aprox.) three times slower.
 
<a name="boost_extension.performance_analysis.multiple_calls_and_libraries"></a><h1>
-<a name="id2578976"></a>
- <a href="performance_analysis.html#boost_extension.performance_analysis.multiple_calls_and_libraries">Multiple
- calls and libraries</a>
+<a name="id937788"></a>
+ Multiple calls and libraries
 </h1>

 Having a first idea about the comparison we advanced with two new benchmarks.
@@ -119,9 +117,8 @@
 RTTI works across shared libraries.
 
<a name="boost_extension.performance_analysis.boost__function_overhead"></a><h1>
-<a name="id2579090"></a>
- <a href="performance_analysis.html#boost_extension.performance_analysis.boost__function_overhead">boost::function
- overhead</a>
+<a name="id937782"></a>
+ boost::function overhead
 </h1>

 Besides the comparison of Boost.Extension vs. direct system calls we evaluated
@@ -141,7 +138,7 @@
 how much of the rest of Boost would then be required for using Boost.Extension.
 
</div>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

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 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Shared Libraries</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="prev" href="factories.html" title=" Factories">
@@ -24,12 +24,85 @@
</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>
+<a name="boost_extension.shared_libraries"></a> Shared Libraries</h2></div></div></div>

- Content not yet created.
+ A <code class="computeroutput">shared_library</code> refers to
+ a loadable module, the type of which depends on the platform:
+ 
+<div class="itemizedlist"><ul type="disc">
+<li>
+ Windows: .dll
+ </li>
+<li>
+ Most Linux or Unix: .so
+ </li>
+<li>
+ 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__nbsp__phrase_role__keyword__char__phrase__nbsp__phrase_role__special_____phrase__nbsp__phrase_role__identifier__location__phrase__phrase_role__special_____phrase__nbsp__phrase_role__keyword__bool__phrase__nbsp__phrase_role__identifier__auto_close__phrase__nbsp__phrase_role__special_____phrase__nbsp__phrase_role__keyword__false__phrase__phrase_role__special_____phrase___code_"></a><h4>
+<a name="id934465"></a>
+ <code class="computeroutput">shared_library(const char * location, bool auto_close = false)</code>
+ </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__nbsp__phrase_role__identifier__open__phrase__phrase_role__special______phrase___code_"></a><h4>
+<a name="id934592"></a>
+ <code class="computeroutput">bool open()</code>
+ </h4>
+
+ Returns true if the library is opened successfully.
+ 
+<a name="boost_extension.shared_libraries._code__phrase_role__keyword__bool__phrase__nbsp__phrase_role__identifier__is_open__phrase__phrase_role__special______phrase___code_"></a><h4>
+<a name="id934636"></a>
+ <code class="computeroutput">bool is_open()</code>
+ </h4>
+
+ Returns true if the library is open.
+ 
+<a name="boost_extension.shared_libraries._code__phrase_role__keyword__void__phrase__nbsp__phrase_role__identifier__close__phrase__phrase_role__special______phrase___code_"></a><h4>
+<a name="id934679"></a>
+ <code class="computeroutput">void close()</code>
+ </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.
+ 
+<a name="boost_extension.shared_libraries._code__phrase_role__identifier__returnvalue__phrase__nbsp__phrase_role__special______phrase__phrase_role__identifier__get__phrase__phrase_role__special_____phrase__phrase_role__keyword__const__phrase__nbsp__phrase_role__keyword__char__phrase__nbsp__phrase_role__special_____phrase__nbsp__phrase_role__identifier__name__phrase__phrase_role__special_______phrase__phrase_role__identifier__args__phrase__phrase_role__special_____phrase___code_"></a><h4>
+<a name="id934725"></a>
+ <code class="computeroutput">ReturnValue (*get(const char * name))(ARGS)</code>
+ </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>
+
+ You would call:
+
+<pre class="programlisting">
+mySharedLibrary.get<int, const char *>("get_value");
+</pre>
+
+ [note It is recommended that you use Boost.Function to capture the return values
+ of <code class="computeroutput">get</code>, but not required.]

</div>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

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 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Tutorials</title>
<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="prev" href="introduction.html" title=" Introduction">
@@ -24,7 +24,7 @@
</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>
+<a name="boost_extension.tutorials"></a>Tutorials</h2></div></div></div>
<div class="toc"><dl>
<dt> Tutorial 1</dt>
<dt> Tutorial 2</dt>
@@ -59,7 +59,7 @@
Jamfile, but the Jamfile contents are separated out for each tutorial.

</div>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

Modified: sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial01.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial01.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial01.html 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Tutorial 1</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../tutorials.html" title="Tutorials">
<link rel="prev" href="../tutorials.html" title="Tutorials">
@@ -24,17 +24,17 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="boost_extension.tutorials.tutorial01"></a> Tutorial 1</h3></div></div></div>
+<a name="boost_extension.tutorials.tutorial01"></a> Tutorial 1</h3></div></div></div>

 Create a class that we will later subclass and put it into a header file
 called word.hpp.

<pre class="programlisting">
-class word
+class word
{
public:
- virtual ~word(){}
- virtual const char * get_val(){return "";}
+ virtual ~word(){}
+ virtual const char * get_val(){return "";}
};
</pre>

@@ -51,18 +51,18 @@


<pre class="programlisting">
-#include "word.hpp"
-#include <boost/extension/factory_map.hpp>
+#include "word.hpp"
+#include <boost/extension/factory_map.hpp>

-class world : public word
+class world : public word
{
public:
- virtual const char * get_val(){return "world!";}
+ virtual const char * get_val(){return "world!";}
};
-class hello : public word
+class hello : public word
{
public:
- virtual const char * get_val(){return "hello";}
+ virtual const char * get_val(){return "hello";}
};
</pre>

@@ -72,24 +72,30 @@
 all exportable classes in the library.

<pre class="programlisting">
-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_word(boost::extensions::factory_map & fm)
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_word(boost::extensions::factory_map & fm)
{
- fm.add<hello, word, int>(1);
- fm.add<world, word, int>(2);
+ fm.get<word, int>()[1].set<hello>();
+ fm.get<word, int>()[2].set<world>();
}
</pre>

- <code class="computeroutput">extern "C"</code>
+ <code class="computeroutput">extern "C"</code>
 is required to keep the function name from being mangled. <code class="computeroutput">BOOST_EXTENSION_EXPORT_DECL</code>
 is only necessary on Windows - on other platforms it does nothing. On Windows,
 it declares that the function should be exported. This is the default in
 shared libraries on other platforms.
 

- The <code class="computeroutput">factory_map::add</code> function takes three template arguments:
- the class to export, the interface that it is being exported as, and what
- type of info is used to identify it (which can be an arbitrary type). The
- argument is the value for that identification info.
+ The <code class="computeroutput">factory_map::get</code> function takes two template arguments:
+ the type of factory to get (the interface returned by it), and what type
+ of info is used to identify it (which can be an arbitrary type).
+ 
+
+ This returns a <code class="computeroutput">std::map</code>, in this case, <code class="computeroutput">std::map<int, factory<word> ></code>. We then index the map to find (and perhaps
+ create) the appropriate factory, and set the type of class it instantiates
+ to the template argument of the <code class="computeroutput">set</code>
+ function. The argument is the value for that identification info.
 

 Now we can write the executable.
@@ -98,34 +104,35 @@


<pre class="programlisting">
-#include <boost/extension/factory_map.hpp>
-#include <boost/extension/shared_library.hpp>
-#include <iostream>
-#include <boost/extension/convenience.hpp>
-#include "word.hpp"
-int main()
+#include <boost/extension/factory_map.hpp>
+#include <boost/extension/shared_library.hpp>
+#include <iostream>
+#include <boost/extension/convenience.hpp>
+#include "word.hpp"
+int main()
{
- using namespace boost::extensions;
+ 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;
+ // constructors. Multiple factory_maps can be constructed.
+ factory_map fm;
 // load the shared library with
- load_single_library(fm, "libHelloWorldLib.extension", "extension_export_word");
+ load_single_library(fm, "libHelloWorldLib.extension",
+ "extension_export_word");
 // Get a reference to the list of constructors for words.
- std::list<factory<word, int> > & factory_list = fm.get<word, int>();
- if (factory_list.size() < 2)
- std::cout << "Error - the classes were not found.";
- for (std::list<factory<word, int> >::iterator current_word = factory_list.begin();
- current_word != factory_list.end(); ++current_word)
- {
+ std::list<factory<word, int> > & factory_list = fm.get<word, int>();
+ if (factory_list.size() < 2)
+ std::cout << "Error - the classes were not found.";
+ for (std::list<factory<word, int> >::iterator current_word =
+ factory_list.begin(); current_word != factory_list.end();
+ ++current_word) {
 // Using auto_ptr to avoid needing delete. Using smart_ptrs is recommended.
- // Note that this has a zero argument constructor - currently constructors
- // with up to six arguments can be used.
- std::auto_ptr<word> word_ptr(current_word->create());
- std::cout << word_ptr->get_val() << " ";
+ // Note that this has a zero argument constructor - currently constructors
+ // with up to six arguments can be used.
+ std::auto_ptr<word> word_ptr(current_word->create());
+ std::cout << word_ptr->get_val() << " ";
 }
- std::cout << "\n";
- return 0;
+ std::cout << "\n";
+ return 0;
}
</pre>

@@ -138,30 +145,30 @@


<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 ;
-import os ;
+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 ;
+import os ;

-local BOOST_ROOT = [ os.environ BOOST_ROOT ] ;
+local BOOST_ROOT = [ os.environ BOOST_ROOT ] ;
project
- : requirements
+ : requirements
 <include>../../../
 <include>#(BOOST_ROOT)
 :
 ;

-exe HelloWorld : main.cpp ;
-lib HelloWorldLib : hello_world.cpp : <link>shared ;
-install ../bin : HelloWorld HelloWorldLib ;
+exe HelloWorld : main.cpp ;
+lib HelloWorldLib : hello_world.cpp : <link>shared ;
+install ../bin : HelloWorld HelloWorldLib ;
</pre>

 If you use another build system, you'll need to make sure that the output
 shared library (dll, so, dylib etc.) is renamed correctly.
 
</div>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

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 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Tutorial 2</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../tutorials.html" title="Tutorials">
<link rel="prev" href="tutorial01.html" title=" Tutorial 1">
@@ -24,7 +24,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="boost_extension.tutorials.tutorial02"></a> Tutorial 2</h3></div></div></div>
+<a name="boost_extension.tutorials.tutorial02"></a> 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
@@ -76,10 +76,10 @@


<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 ;
+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>

 
@@ -91,8 +91,8 @@


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

 
@@ -107,21 +107,22 @@


<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 :
+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
+ Plane Car Vehicle
+ FlyingCar Computer Boat
 :
 <link>shared
;

-install ../bin :
- HelloWorld HelloWorldLib Vehicle Boat FlyingCar
- CarOfTheFuture MultipleInheritance
+install ../bin :
+ HelloWorld HelloWorldLib Vehicle Boat FlyingCar
+ CarOfTheFuture MultipleInheritance
 :
 ;
</pre>
@@ -143,27 +144,27 @@


<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
+#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);
+ 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>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

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 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Tutorial 3</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../tutorials.html" title="Tutorials">
<link rel="prev" href="tutorial02.html" title=" Tutorial 2">
@@ -24,9 +24,9 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="boost_extension.tutorials.tutorial03"></a> Tutorial 3</h3></div></div></div>
+<a name="boost_extension.tutorials.tutorial03"></a> Tutorial 3</h3></div></div></div>

- This tutorial shows how to register and instance classes that have multi-argument
+ 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
@@ -34,11 +34,11 @@
 

 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
+ 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 current argument limit of the library),
+ 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.
@@ -47,24 +47,25 @@


<pre class="programlisting">
-class six_parameters : public lots_of_parameters_interface
+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)
+ 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;
+ 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) {}
+ virtual ~six_parameters(void) {}
};
</pre>

@@ -75,19 +76,21 @@


<pre class="programlisting">
-class A
+class A
{
 public:
- A(unsigned int i) : i(i) {}
- int i;
+ A(unsigned int i) : i(i) {}
+ int i;
};

-class lots_of_parameters_interface
+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) {}
+ 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>

@@ -100,9 +103,12 @@


<pre class="programlisting">
-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export(boost::extensions::factory_map & fm)
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export(boost::extensions::factory_map & fm)
{
- fm.add< six_parameters, lots_of_parameters_interface, int, bool, unsigned int, char, std::string, A, boost::shared_ptr<A> >(6);
+ fm.get<lots_of_parameters_interface, int, bool,
+ unsigned int, char, std::string, A,
+ boost::shared_ptr<A> >()[6].set<six_parameters>();
}
</pre>

@@ -112,28 +118,35 @@


<pre class="programlisting">
-int main(void)
+int main(void)
{
- using namespace boost::extensions;
+ 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;
+ // constructors. Multiple factory_maps can be constructed.
+ factory_map fm;

 // load the shared library with
- load_single_library(fm, "libParametersLib.extension", "extension_export");
+ load_single_library(fm, "libParametersLib.extension", "extension_export");

- std::list<factory<lots_of_parameters_interface, int, 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> > > &
+ 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::list< factory<lots_of_parameters_interface, int, 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>(</s
pan>new A(15))));
+ 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;
+ return 0;
}
</pre>

@@ -162,7 +175,7 @@
 constructors and use them via Boost.extensions without problems.
 
</div>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

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 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Tutorial 4</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../tutorials.html" title="Tutorials">
<link rel="prev" href="tutorial03.html" title=" Tutorial 3">
@@ -24,7 +24,7 @@
</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>
+<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.
@@ -47,22 +47,23 @@


<pre class="programlisting">
-class world : public word
+class world : public word
{
public:
- virtual const char * get_val(){return "world!";}
+ virtual const char * get_val(){return "world!";}
};

-class hello : public word
+class hello : public word
{
public:
- virtual const char * get_val(){return "hello";}
+ virtual const char * get_val(){return "hello";}
};

-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_word(boost::extensions::factory_map & fm)
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_word(boost::extensions::factory_map & fm)
{
- fm.add<hello, word, int>(1);
- fm.add<world, word, int>(2);
+ fm.get<word, int>()[1].set<hello>();
+ fm.get<word, int>()[2].set<world>();
}
</pre>

@@ -79,22 +80,25 @@


<pre class="programlisting">
-class world : public word
+class world : public word
{
public:
- virtual const char * get_val(){return "world! v2";}
+ virtual const char * get_val(){return "world! v2";}
};

-class hello : public word
+class hello : public word
{
public:
- virtual const char * get_val(){return "| v2 hello";}
+ virtual const char * get_val(){return "| v2 hello";}
};

-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_word(boost::extensions::factory_map & fm)
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_word(boost::extensions::factory_map & fm)
{
- fm.add<world, word, int>(22); // int could be used as version (v2 word 2)
- fm.add<hello, word, int>(21); // int could be used as version (v2 word 1)
+ 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>

@@ -108,16 +112,19 @@


<pre class="programlisting">
-factory_map fm;
+factory_map fm;

// load hello world first version
-load_single_library(fm, "libHelloWorldLib.extension", "extension_export_word");
+load_single_library(fm, "libHelloWorldLib.extension",
+ "extension_export_word");

// load hello world second version
-load_single_library(fm, "libHelloWorldLibv2.extension", "extension_export_word");
+load_single_library(fm, "libHelloWorldLibv2.extension",
+ "extension_export_word");

// load hello world second version again
-load_single_library(fm, "libHelloWorldLibv2.extension", "extension_export_word");
+load_single_library(fm, "libHelloWorldLibv2.extension",
+ "extension_export_word");
</pre>

 
@@ -132,28 +139,31 @@


<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() << " ";
+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;
+std::cout << std::endl << std::endl;
</pre>

 

 We get the following output:
 
-<div class="informaltable"><table class="table">
+<div class="informaltable">
+<h4>
+<a name="id928076"></a>
+ </h4>
+<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>
+<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.
@@ -170,11 +180,11 @@


<pre class="programlisting">
-class salute
+class salute
{
public:
- virtual ~salute(){}
- virtual const char * say(){return "";}
+ virtual ~salute(){}
+ virtual const char * say(){return "";}
};
</pre>

@@ -186,23 +196,24 @@


<pre class="programlisting">
-class hello : public salute
+class hello : public salute
{
public:
- virtual const char *say(void) {return "hello";}
+ virtual const char *say(void) {return "hello";}
};

-class bye : public salute
+class bye : public salute
{
public:
- virtual const char *say(void) {return "bye!";}
+ virtual const char *say(void) {return "bye!";}
};

-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_salute(boost::extensions::factory_map & fm)
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_salute(boost::extensions::factory_map & fm)
{
- fm.add<hello, salute, int>(1);
- fm.add<bye, salute, int>(2);
+ fm.get<salute, int>()[1].set<hello>();
+ fm.get<salute, int>()[2].set<bye>();
}
</pre>

@@ -223,37 +234,42 @@


<pre class="programlisting">
-std::list<factory<salute, int> > & salute_factory_list = fm.get<salute, int>();
+std::map<int, factory<salute> > & salute_factory_list =
+ fm.get<salute, int>();

-std::cout << "salutes: " << std::endl;
-for (std::list<factory<salute, int> >::iterator current_salute = salute_factory_list.begin();
- current_salute != salute_factory_list.end(); ++current_salute)
-{
- std::auto_ptr<salute> salute_ptr(current_salute->create());
- std::cout << salute_ptr->say() << " ";
+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;
+std::cout << std::endl;
</pre>

 

 The output is:
 
-<div class="informaltable"><table class="table">
+<div class="informaltable">
+<h4>
+<a name="id929180"></a>
+ </h4>
+<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>
+<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>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

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 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Tutorial 5</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../tutorials.html" title="Tutorials">
<link rel="prev" href="tutorial04.html" title=" Tutorial 4">
@@ -24,7 +24,7 @@
</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>
+<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
@@ -43,16 +43,16 @@


<pre class="programlisting">
-class protocol
+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 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) {}
+ virtual ~protocol(void) {}
};
</pre>

@@ -65,33 +65,45 @@

<pre class="programlisting">
// MSN protocol implementation
-class MSN : public protocol
+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 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) {}
+ virtual ~MSN(void) {}
};

// Jabber protocol implementation
-class Jabber : public protocol
+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 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) {}
+ virtual ~Jabber(void) {}
};
</pre>

@@ -115,14 +127,14 @@

<pre class="programlisting">
// interface for the parameters of each plugin
-class network_parameters
+class network_parameters
{
 public:
- virtual std::string hostname(void) = 0;
- virtual std::string port(void) = 0;
- virtual void set_http_mode(void)= 0;
+ virtual std::string hostname(void) = 0;
+ virtual std::string port(void) = 0;
+ virtual void set_http_mode(void)= 0;

- virtual ~network_parameters(void) {};
+ virtual ~network_parameters(void) {};
};
</pre>

@@ -135,46 +147,61 @@

<pre class="programlisting">
// MSN implementation
-class MSN_network_parameters : public network_parameters
+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 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 void set_http_mode(void) { std::cout << "http mode set"
+ << std::endl; }

- virtual ~MSN_network_parameters() {}
+ virtual ~MSN_network_parameters() {}
};

// Jabber implementation
-class Jabber_network_parameters : public network_parameters
+class Jabber_network_parameters : public network_parameters
{
 public:
- virtual std::string hostname(void) { return "jabber.org"; }
- virtual std::string port(void) { return "7063"; }
+ 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 void set_http_mode(void) { std::cout << "http mode not supported"
+ << std::endl; }

- virtual ~Jabber_network_parameters() {}
+ 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="literal">network_parameters</code>
- class and register it in the factory map:
+ 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)
+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));
+ 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>

@@ -186,74 +213,105 @@


<pre class="programlisting">
-std::list<factory< protocol, boost::shared_ptr<network_parameters> > >::iterator current_plugin = factory_list.begin();
+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;
+}

-// MSN plugin
-std::auto_ptr<protocol> MSN_ptr(current_plugin->create());
-boost::shared_ptr<network_parameters> msn_parameters = current_plugin->get_info();
-current_plugin++;
-
-// Jabber plugin
-std::auto_ptr<protocol> Jabber_ptr(current_plugin->create());
-boost::shared_ptr<network_parameters> jabber_parameters = current_plugin->get_info();
-
-// 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;
</pre>

 

 And we get the following output:
 
-<div class="informaltable"><table class="table">
+<div class="informaltable">
+<h4>
+<a name="id934080"></a>
+ </h4>
+<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>
+<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>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

Modified: sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial06.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial06.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial06.html 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Tutorial 6</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="../../index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="up" href="../tutorials.html" title="Tutorials">
<link rel="prev" href="tutorial05.html" title=" Tutorial 5">
@@ -24,12 +24,12 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="boost_extension.tutorials.tutorial06"></a> Tutorial 6</h3></div></div></div>
+<a name="boost_extension.tutorials.tutorial06"></a> Tutorial 6</h3></div></div></div>

Insert content here.

</div>
-<table width="100%"><tr>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>

Modified: sandbox/libs/extension/doc/html/index.html
==============================================================================
--- sandbox/libs/extension/doc/html/index.html (original)
+++ sandbox/libs/extension/doc/html/index.html 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Chapter 1. Boost.Extension 1.0</title>
<link rel="stylesheet" href="boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.67.2">
<link rel="start" href="index.html" title="Chapter 1. Boost.Extension 1.0">
<link rel="next" href="boost_extension/introduction.html" title=" Introduction">
</head>
@@ -24,7 +24,7 @@
<a name="boost_extension"></a>Chapter 1. Boost.Extension 1.0</h2></div>
<div>Copyright © 2007 Jeremy Pack, Mariano G. Consoni</div>
<div><div class="legalnotice">
-<a name="id2555061"></a>
+<a name="id903092"></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)
 
@@ -49,16 +49,15 @@
<dt> Performance Analysis</dt>
<dt> Appendices</dt>
<dd><dl>
-<dt><a href="boost_extension/appendices/appendix_a.html"> Appendix A -
- Windows Export and Import Declarations</a></dt>
-<dt><a href="boost_extension/appendices/appendix_b.html"> Appendix B -
- Optional Dependencies</a></dt>
+<dt> Appendix A - Windows Export and Import Declarations</dt>
+<dt> Appendix B - Optional Dependencies</dt>
+<dt> Appendix C - OS X Shared Libraries</dt>
</dl></dd>
</dl>
</div>
</div>
-<table width="100%"><tr>
-<td align="left">Last revised: April 30, 2007 at 12:00:00 GMT</td>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left">Last revised: September 15, 2007 at 9:05:00 GMT</td>
<td align="right"></td>
</tr></table>
<hr>

Modified: sandbox/libs/extension/doc/info.qbk
==============================================================================
--- sandbox/libs/extension/doc/info.qbk (original)
+++ sandbox/libs/extension/doc/info.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -9,18 +9,23 @@

In this section we explain how to use Info classes in Boost.Extension.

-Info classes is a mechanism that allows you to store important information of each implementation. The
-type and utility of this information is arbitrary as the Info class is a template argument of the factories where
-the user registers its own implementations, and for that reason any kind of information could be stored.
+Info classes is a mechanism that allows you to store important information of
+each implementation. The type and utility of this information is arbitrary as
+the Info class is a template argument of the factories where the user registers
+its own implementations, and for that reason any kind of information could be
+stored.

-Let's see how can we use it with an example first and then we will be able to summarize the concepts.
+Let's see how can we use it with an example first and then we will be able to
+summarize the concepts.

Surely you remember our very first example, that of course it's called
-HelloWorld. Well, let's imagine that we now want a multi-language Hello World. Of course there are better ways of
-designing it, but as we want to picture how the Info class could be used we'll take this approach.
-
-First, we define an implementation of the =word= interface for each combination of word and language. Then we
-have for example the class =monde= that implements the =word= interface for the french language in this case.
+HelloWorld. Well, let's imagine that we now want a multi-language Hello World.
+Of course there are better ways of designing it, but as we want to picture how
+the Info class could be used we'll take this approach.
+
+First, we define an implementation of the =word= interface for each combination
+of word and language. Then we have for example the class =monde= that implements
+the `word` interface for the french language in this case.

Let's see the code:

@@ -95,42 +100,59 @@
 : language(language), english_translation(english_translation) {}
};
``
+We also need a less-than operator for this class, so it can be used as a map key.
+``
+inline bool operator<(const word_description & first,
+ const word_description & second) {
+ return first.language < second.language ||
+ (first.language == second.language &&
+ first.english_translation < second.english_translation);
+}
+``

Finally, just store a =word_description= instance when adding the words to the factory map, describing the original
word and the language:

``
-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_multilanguage_word(boost::extensions::factory_map & fm)
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_multilanguage_word(boost::extensions::factory_map & fm)
{
- fm.add<hola, word, word_description>(word_description("spanish", "hello"));
- fm.add<mundo, word, word_description>(word_description("spanish", "world!"));
-
- fm.add<bonjour, word, word_description>(word_description("french", "hello"));
- fm.add<monde, word, word_description>(word_description("french", "world!"));
-
- fm.add<buonasera, word, word_description>(word_description("italian", "hello"));
- fm.add<mondo, word, word_description>(word_description("italian", "world!"));
-
- fm.add<hello, word, word_description>(word_description("english", "hello"));
- fm.add<world, word, word_description>(word_description("english", "world!"));
+ fm.get<word, word_description>()[word_description("spanish", "hello")]
+ .set<hola>();
+ fm.get<word, word_description>()[word_description("spanish", "world!")]
+ .set<mundo>();
+
+ fm.get<word, word_description>()[word_description("french", "hello")]
+ .set<bonjour>();
+ fm.get<word, word_description>()[word_description("french", "world!")]
+ .set<monde>();
+ fm.get<word, word_description>()[word_description("italian", "hello")]
+ .set<buonasera>();
+ fm.get<word, word_description>()[word_description("italian", "world!")]
+ .set<mondo>();
+ fm.get<word, word_description>()[word_description("english", "hello")]
+ .set<hello>();
+ fm.get<word, word_description>()[word_description("english", "world!")]
+ .set<world>();
}
-``

-In the code we could see that add argument is a Info class instance. In this case is =word_description=
-which receives the language and word as arguments.
+``

-Now we could start using that information in the main code. Retrieving Info class is easy, you should just call
-=get_info()= method of the factory.
+Now we could start using that information in the main code. Retrieving the `Info`
+instance for a factory is simple, since it is part of the `std::pair` in the
+map of factories.

Let's see some code using the multilanguage hello world words:

``
- for (std::list<factory<word, word_description> >::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() << " is " << current_word->get_info().english_translation
- << " in " << current_word->get_info().language << std::endl;
+ for (std::map<word_description, factory<word> >::iterator current_word =
+ factory_list.begin(); current_word != factory_list.end();
+ ++current_word) {
+ std::auto_ptr<word> word_ptr(current_word->second.create());
+ std::cout << word_ptr->get_val() << " is "
+ << current_word->first.english_translation
+ << " in " << current_word->first.language
+ << std::endl;
 }
 std::cout << std::endl;
``

Modified: sandbox/libs/extension/doc/introduction.qbk
==============================================================================
--- sandbox/libs/extension/doc/introduction.qbk (original)
+++ sandbox/libs/extension/doc/introduction.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -6,25 +6,19 @@
[/ See http://www.boost.org/ for latest version. ]

[section:introduction Introduction]
-Wrappers for loading classes from linked libraries to extend the functionality
-of a program. Created to ease the creation of plugins.

The Boost.Extension library has been developed to ease the development of
plugins and similar extensions to software. Classes can be made available from
-linked libraries and loaded automatically by the application.
+shared libraries and loaded by the application.

-The documentation is completely incomplete. Sorry. Look at tutorial #1 for
-examples of basic usage, and tutorial #2 for examples of advanced usage.
+The documentation is mostly complete.

Note the following:

-
-
-# Multiple and virtual inheritance are supported
-# No macros are currently used (besides those required by Windows for exported functions)
-# Only one external function required per shared library to export classes
-# RTTI is used by default, but it is possible to use user-defined type identifications.
-# Classes do not need to be modified to be loadable
-
+* Multiple and virtual inheritance are supported
+* Library users do not need to use any macros (besides those required by Windows for exported functions)
+* Only one external function required per shared library to export classes
+* RTTI is used by default, but it is possible to use user-defined type identification
+* Classes do not need to be modified to be loadable

[endsect]

Modified: sandbox/libs/extension/doc/shared_libraries.qbk
==============================================================================
--- sandbox/libs/extension/doc/shared_libraries.qbk (original)
+++ sandbox/libs/extension/doc/shared_libraries.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -7,6 +7,49 @@

[section:shared_libraries Shared Libraries]

-Content not yet created.
+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])
+
+
+[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;
+}
+``
+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.]

[endsect]
\ No newline at end of file

Modified: sandbox/libs/extension/doc/tutorial1.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial1.qbk (original)
+++ sandbox/libs/extension/doc/tutorial1.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -8,7 +8,8 @@

[section:tutorial01 Tutorial 1]

-Create a class that we will later subclass and put it into a header file called word.hpp.
+Create a class that we will later subclass and put it into a header file called
+word.hpp.
``
class word
{
@@ -17,9 +18,13 @@
 virtual const char * get_val(){return "";}
};
``
-This file will be included by both the shared library in which classes implement this interface, and in the executable that will load these implementations. The destructor ought to be virtual, just to ensure proper deletion. We create one virtual function. We could actually add data to this class as well.
+This file will be included by both the shared library in which classes implement
+this interface, and in the executable that will load these implementations. The
+destructor ought to be virtual, just to ensure proper deletion. We create one
+virtual function. We could actually add data to this class as well.

-Now create a file called hello_world.cpp. This will be compiled into a shared library:
+Now create a file called hello_world.cpp. This will be compiled into a shared
+library:

``
#include "word.hpp"
@@ -36,17 +41,31 @@
 virtual const char * get_val(){return "hello";}
};
``
-Now we have two classes that are derived from word, and that both implement the virtual function get_val. All that's left is to declare them for exporting. Normally, we just put one function in the entire shared library that exports all exportable classes in the library.
+Now we have two classes that are derived from word, and that both implement the
+virtual function get_val. All that's left is to declare them for exporting.
+Normally, we just put one function in the entire shared library that exports
+all exportable classes in the library.
``
-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_word(boost::extensions::factory_map & fm)
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_word(boost::extensions::factory_map & fm)
{
- fm.add<hello, word, int>(1);
- fm.add<world, word, int>(2);
+ fm.get<word, int>()[1].set<hello>();
+ fm.get<word, int>()[2].set<world>();
}
``
-`extern "C"` is required to keep the function name from being mangled. `BOOST_EXTENSION_EXPORT_DECL` is only necessary on Windows - on other platforms it does nothing. On Windows, it declares that the function should be exported. This is the default in shared libraries on other platforms.
-
-The `factory_map::add` function takes three template arguments: the class to export, the interface that it is being exported as, and what type of info is used to identify it (which can be an arbitrary type). The argument is the value for that identification info.
+`extern "C"` is required to keep the function name from being mangled.
+`BOOST_EXTENSION_EXPORT_DECL` is only necessary on Windows - on other platforms
+it does nothing. On Windows, it declares that the function should be exported.
+This is the default in shared libraries on other platforms.
+
+The `factory_map::get` function takes two template arguments: the type of
+factory to get (the interface returned by it), and what type of info is used
+to identify it (which can be an arbitrary type).
+
+This returns a `std::map`, in this case, `std::map<int, factory<word> >`.
+We then index the map to find (and perhaps create) the appropriate factory,
+and set the type of class it instantiates to the template argument of the
+`set` function. The argument is the value for that identification info.

Now we can write the executable.

@@ -63,14 +82,15 @@
 // constructors. Multiple factory_maps can be constructed.
 factory_map fm;
 // load the shared library with
- load_single_library(fm, "libHelloWorldLib.extension", "extension_export_word");
+ load_single_library(fm, "libHelloWorldLib.extension",
+ "extension_export_word");
 // Get a reference to the list of constructors for words.
 std::list<factory<word, int> > & factory_list = fm.get<word, int>();
 if (factory_list.size() < 2)
 std::cout << "Error - the classes were not found.";
- for (std::list<factory<word, int> >::iterator current_word = factory_list.begin();
- current_word != factory_list.end(); ++current_word)
- {
+ for (std::list<factory<word, int> >::iterator current_word =
+ factory_list.begin(); current_word != factory_list.end();
+ ++current_word) {
 // Using auto_ptr to avoid needing delete. Using smart_ptrs is recommended.
 // Note that this has a zero argument constructor - currently constructors
 // with up to six arguments can be used.
@@ -81,7 +101,10 @@
 return 0;
}
``
-Now we just need to write the build file. You may have noticed above that the name of the library is assumed to be libHelloWorld.extension - we'll need to rename whatever shared library is compiled to that. Boost.Build can do this automatically.
+Now we just need to write the build file. You may have noticed above that the
+name of the library is assumed to be libHelloWorld.extension - we'll need to
+rename whatever shared library is compiled to that. Boost.Build can do this
+automatically.

``
import type : change-generated-target-suffix ;
@@ -102,5 +125,6 @@
lib HelloWorldLib : hello_world.cpp : <link>shared ;
install ../bin : HelloWorld HelloWorldLib ;
``
-If you use another build system, you'll need to make sure that the output shared library (dll, so, dylib etc.) is renamed correctly.
+If you use another build system, you'll need to make sure that the output
+shared library (dll, so, dylib etc.) is renamed correctly.
[endsect]
\ No newline at end of file

Modified: sandbox/libs/extension/doc/tutorial2.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial2.qbk (original)
+++ sandbox/libs/extension/doc/tutorial2.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -8,8 +8,9 @@
[section:tutorial02 Tutorial 2]

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.
+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:

@@ -23,15 +24,16 @@
* A car_of_the_future is a flying_car, a boat, and a computer.

-In addition, we are not going to have any of these classes be interfaces. They will each
-have an implementation in a .cpp file. This will require multiple inheritance, as well
-as virtual inheritance (because otherwise a car_of_the_future would consist of three
-separate vehicle base classes!).
+In addition, 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.
+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:
@@ -45,8 +47,8 @@
``

-First we must rename the generated libraries (this is required for cross-platform use -
-but the prefix and suffix are arbitrary).
+First we must rename the generated libraries (this is required for
+cross-platform use - but the prefix and suffix are arbitrary).

``
@@ -55,17 +57,19 @@
``

-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.
+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.

``
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 FlyingCar : multiple_inheritance/flying_car.cpp Plane Car Vehicle
+ : <link>shared ;
lib CarOfTheFuture :
multiple_inheritance/car_of_the_future.cpp
Plane Car Vehicle
@@ -82,13 +86,14 @@
``

-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.
+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
+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.

Modified: sandbox/libs/extension/doc/tutorial3.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial3.qbk (original)
+++ sandbox/libs/extension/doc/tutorial3.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -8,25 +8,31 @@

[section:tutorial03 Tutorial 3]

-This tutorial shows how to register and instance 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 current 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.
+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.

``
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)
+ 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;
@@ -43,7 +49,8 @@
};
``
\n
-The interface that we are inheriting is just the bare minimum needed to make it compile:
+The interface that we are inheriting is just the bare minimum needed to make it
+compile:

``
class A
@@ -57,19 +64,25 @@
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) {}
+ lots_of_parameters_interface(bool b, unsigned int i, char c,
+ std::string s, A a,
+ boost::shared_ptr<A> ptr_a) {}
 virtual ~lots_of_parameters_interface(void) {}
};
``
\n
-Having the class defined, we should write the export function to register the class in the passed factory map. The point here
-is that the factory_map::add method must be set with the first type as the third argument, and with the second type as the fourth argument
-and so on.
+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.

``
-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export(boost::extensions::factory_map & fm)
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export(boost::extensions::factory_map & fm)
{
- fm.add< six_parameters, lots_of_parameters_interface, int, bool, unsigned int, char, std::string, A, boost::shared_ptr<A> >(6);
+ fm.get<lots_of_parameters_interface, int, bool,
+ unsigned int, char, std::string, A,
+ boost::shared_ptr<A> >()[6].set<six_parameters>();
}
``
\n
@@ -87,15 +100,22 @@
 // load the shared library with
 load_single_library(fm, "libParametersLib.extension", "extension_export");

- std::list<factory<lots_of_parameters_interface, int, 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> >();
+ 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::list< factory<lots_of_parameters_interface, int, 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))));
+ 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;
}
@@ -109,7 +129,7 @@

\n

-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.
+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.

[endsect]
\ No newline at end of file

Modified: sandbox/libs/extension/doc/tutorial4.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial4.qbk (original)
+++ sandbox/libs/extension/doc/tutorial4.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -8,15 +8,19 @@
[section:tutorial04 Tutorial 4]

-In this tutorial we will see different features of the library related to multiple loading of the same library, instance or interface.
+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 ([^examples\/versioning]). 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.
+We will follow some parts of versions example ([^examples\/versioning]).
+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.

-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 [^hello_world.cpp]) for the "hello world" example:
+Let's remember the classes that we have implemented (in [^hello_world.cpp])
+for the "hello world" example:

``
class world : public word
@@ -31,16 +35,19 @@
 virtual const char * get_val(){return "hello";}
};

-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_word(boost::extensions::factory_map & fm)
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_word(boost::extensions::factory_map & fm)
{
- fm.add<hello, word, int>(1);
- fm.add<world, word, int>(2);
+ fm.get<word, int>()[1].set<hello>();
+ fm.get<word, int>()[2].set<world>();
}
``

-And now let's see the new version that we've implemented for this example (as defined in [^hello_world_versions.cpp]). The
-classes have the same name and methods, both implement the same interface, but the `get_val()` methods differ in the
-returned string (to be able to recognize each one after loading them).
+And now let's see the new version that we've implemented for this example
+(as defined in [^hello_world_versions.cpp]). The classes have the same name
+and methods, both implement the same interface, but the `get_val()` methods
+differ in the returned string (to be able to recognize each one after loading
+them).

``
class world : public word
@@ -55,39 +62,46 @@
 virtual const char * get_val(){return "| v2 hello";}
};

-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_word(boost::extensions::factory_map & fm)
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_word(boost::extensions::factory_map & fm)
{
- fm.add<world, word, int>(22); // int could be used as version (v2 word 2)
- fm.add<hello, word, int>(21); // int could be used as version (v2 word 1)
+ 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)
}
``

-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).
+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).

``
 factory_map fm;

 // load hello world first version
- load_single_library(fm, "libHelloWorldLib.extension", "extension_export_word");
+ load_single_library(fm, "libHelloWorldLib.extension",
+ "extension_export_word");

 // load hello world second version
- load_single_library(fm, "libHelloWorldLibv2.extension", "extension_export_word");
+ load_single_library(fm, "libHelloWorldLibv2.extension",
+ "extension_export_word");

 // load hello world second version again
- load_single_library(fm, "libHelloWorldLibv2.extension", "extension_export_word");
+ load_single_library(fm, "libHelloWorldLibv2.extension",
+ "extension_export_word");
``

-We can see here that loading multiple libraries is as easy as calling `load_single_library` for each one and
-using the same factory map.
+We can see here that loading multiple libraries is as easy as calling
+`load_single_library` for each one and using the same factory map.

Then you can access them as any other factory_map:

``
- for(std::list<factory<word, int> >::iterator current_word = factory_list.begin();
- current_word != factory_list.end(); ++current_word)
- {
+ 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() << " ";
 }
@@ -100,10 +114,12 @@
[^hello world! | v2 hello world! v2 | v2 hello world! v2]]]]

-The first "hello world" is returned by the first version of the library, and the second and third returned by the second version.
+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').
+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:

@@ -132,31 +148,36 @@
};

-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_salute(boost::extensions::factory_map & fm)
+extern "C" void BOOST_EXTENSION_EXPORT_DECL
+extension_export_salute(boost::extensions::factory_map & fm)
{
- fm.add<hello, salute, int>(1);
- fm.add<bye, salute, int>(2);
+ fm.get<salute, int>()[1].set<hello>();
+ fm.get<salute, int>()[2].set<bye>();
}
``

-Note that we are adding a new class called 'hello' too but that implements 'salute' interface.
+Note that we are adding a new class called 'hello' too but that implements
+'salute' interface.

\n

-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.
+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.

``
- std::list<factory<salute, int> > & salute_factory_list = fm.get<salute, int>();
-
- std::cout << "salutes: " << std::endl;
- for (std::list<factory<salute, int> >::iterator current_salute = salute_factory_list.begin();
- current_salute != salute_factory_list.end(); ++current_salute)
- {
- std::auto_ptr<salute> salute_ptr(current_salute->create());
- std::cout << salute_ptr->say() << " ";
- }
- std::cout << std::endl;
+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;
``

The output is:
@@ -166,7 +187,8 @@
=hello bye!=]]]

-In conclusion, with Boost.Extension we can implement the same class in different libraries, the same class for different interfaces and
+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.

[endsect]
\ No newline at end of file

Modified: sandbox/libs/extension/doc/tutorial5.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial5.qbk (original)
+++ sandbox/libs/extension/doc/tutorial5.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -7,11 +7,13 @@

[section:tutorial05 Tutorial 5]

-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
+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:
@@ -37,38 +39,53 @@
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 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) {}
+ 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 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) {}
+ virtual ~Jabber(void) {}
};
``

-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).
+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:

@@ -95,7 +112,8 @@
 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 void set_http_mode(void) { std::cout << "http mode set"
+ << std::endl; }

 virtual ~MSN_network_parameters() {}
};
@@ -108,17 +126,29 @@
 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 void set_http_mode(void) { std::cout << "http mode not supported"
+ << std::endl; }

 virtual ~Jabber_network_parameters() {}
};
``
-
-Now we can define our Info class as a smart pointer to the =network_parameters= class and
-register it in the factory map:
+We want to be able to compare smart pointers to `network_parameters`:
+``
+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;
+}
+``
+Now we can define our Info class as a smart pointer to the `network_parameters`
+class and register it in the factory map:

``
-extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_plugins(boost::extensions::factory_map & fm)
+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));
@@ -130,49 +160,79 @@
Finally let's use our implementation for an hypothetical connection:

``
- std::list<factory< protocol, boost::shared_ptr<network_parameters> > >::iterator current_plugin = factory_list.begin();
+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;
+}

- // MSN plugin
- std::auto_ptr<protocol> MSN_ptr(current_plugin->create());
- boost::shared_ptr<network_parameters> msn_parameters = current_plugin->get_info();
- current_plugin++;
-
- // Jabber plugin
- std::auto_ptr<protocol> Jabber_ptr(current_plugin->create());
- boost::shared_ptr<network_parameters> jabber_parameters = current_plugin->get_info();
-
- // 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;
``

And we get the following output:

Modified: sandbox/libs/extension/doc/tutorials.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorials.qbk (original)
+++ sandbox/libs/extension/doc/tutorials.qbk 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -17,16 +17,17 @@

The first tutorial is a basic hello world example.

-The second tutorial is a more complex example involving multiple inheritance, virtual inheritance, and inheritance
-across shared libraries.
+The second tutorial is a more complex example involving multiple inheritance,
+virtual inheritance, and inheritance across shared libraries.

-The third tutorial shows how to register classes with multi parameter constructors.
+The third tutorial shows how to register classes with multi parameter
+constructors.

The fourth tutorial is a about multiple library loading, with some strange cases
like loading the same library many times and loading very similar classes.

-The fifth tutorial is an advanced example of using the Info template parameter. There is a simpler
-usage of this parameter in the examples/info folder as well.
+The fifth tutorial is an advanced example of using the Info template parameter.
+There is a simpler usage of this parameter in the examples/info folder as well.

The tutorial code can be found in the examples folder. They all share the same
Jamfile, but the Jamfile contents are separated out for each tutorial.

Modified: sandbox/libs/extension/examples/info/im/network_parameters.hpp
==============================================================================
--- sandbox/libs/extension/examples/info/im/network_parameters.hpp (original)
+++ sandbox/libs/extension/examples/info/im/network_parameters.hpp 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -11,6 +11,7 @@

#include <string>
#include <iostream>
+#include <boost/shared_ptr.hpp>

// interface for the parameters of each plugin
class network_parameters
@@ -53,3 +54,12 @@

virtual ~Jabber_network_parameters() {}
};
+
+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;
+}

Modified: sandbox/libs/extension/examples/info/im/plugins.cpp
==============================================================================
--- sandbox/libs/extension/examples/info/im/plugins.cpp (original)
+++ sandbox/libs/extension/examples/info/im/plugins.cpp 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -60,14 +60,6 @@
virtual ~Jabber(void) {}
};

-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;
-}

extern "C" void BOOST_EXTENSION_EXPORT_DECL
extension_export_plugins(boost::extensions::factory_map & fm)

Modified: sandbox/libs/extension/examples/info/im/protocol.hpp
==============================================================================
--- sandbox/libs/extension/examples/info/im/protocol.hpp (original)
+++ sandbox/libs/extension/examples/info/im/protocol.hpp 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -10,7 +10,6 @@
*/

#include <string>
-
// protocol for instant message communication
class protocol
{
@@ -23,3 +22,4 @@

virtual ~protocol(void) {}
};
+

Modified: sandbox/libs/extension/examples/info/multilanguage_main.cpp
==============================================================================
--- sandbox/libs/extension/examples/info/multilanguage_main.cpp (original)
+++ sandbox/libs/extension/examples/info/multilanguage_main.cpp 2007-09-15 12:23:59 EDT (Sat, 15 Sep 2007)
@@ -43,7 +43,9 @@
 // Using auto_ptr to avoid needing delete. Using smart_ptrs
 // is recommended.
 // Note that this has a zero argument constructor - currently
- // constructors with up to six arguments can be used.
+ // constructors with up to six arguments can be used by
+ // default - define BOOST_EXTENSION_MAX_FUNCTOR_PARAMS to a
+ // a larger value if needed.
 std::auto_ptr<word> word_ptr(current_word->second.create());
 std::cout << word_ptr->get_val() << " is "
 << current_word->first.english_translation

Next message: oryol_at_[hidden]: "[Boost-commit] svn:boost r39301 - sandbox/boost/reflection"
Previous message: pbristow_at_[hidden]: "[Boost-commit] svn:boost r39299 - sandbox/math_toolkit/boost/math/distributions"

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