Boost-Commit :

Date view	Thread view	Subject view	Author view

From: mconsoni_at_[hidden]
Date: 2007-06-26 18:24:44

Next message: mconsoni_at_[hidden]: "[Boost-commit] svn:boost r7182"
Previous message: mconsoni_at_[hidden]: "[Boost-commit] svn:boost r7180"

Author: mconsoni
Date: 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
New Revision: 7181
URL: http://svn.boost.org/trac/boost/changeset/7181

Log:

- added header with file description, license and "latest version" notice.

Text files modified:
   sandbox/libs/extension/doc/Jamfile.v2 | 10 +
   sandbox/libs/extension/doc/appendices.qbk | 7 +
   sandbox/libs/extension/doc/appendix_a.qbk | 7 +
   sandbox/libs/extension/doc/extension.qbk | 7 +
   sandbox/libs/extension/doc/factories.qbk | 7 +
   sandbox/libs/extension/doc/faq.qbk | 7 +
   sandbox/libs/extension/doc/html/HTML.manifest | 1
   sandbox/libs/extension/doc/html/boost_extension/appendices.html | 2
   sandbox/libs/extension/doc/html/boost_extension/factories.html | 2
   sandbox/libs/extension/doc/html/boost_extension/introduction.html | 2
   sandbox/libs/extension/doc/html/boost_extension/performance_analysis.html | 8
   sandbox/libs/extension/doc/html/boost_extension/shared_libraries.html | 8
   sandbox/libs/extension/doc/html/boost_extension/tutorials.html | 2
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial01.html | 2
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial02.html | 2
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial03.html | 8
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial04.html | 234 +++++++++++++++++++++++++++++++++++++++
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial05.html | 229 ++++++++++++++++++++++++++++++++++++++
   sandbox/libs/extension/doc/html/boost_extension/tutorials/tutorial06.html | 2
   sandbox/libs/extension/doc/html/index.html | 3
   sandbox/libs/extension/doc/info.qbk | 7 +
   sandbox/libs/extension/doc/introduction.qbk | 7 +
   sandbox/libs/extension/doc/performance_analysis.qbk | 7 +
   sandbox/libs/extension/doc/quick_start.qbk | 7 +
   sandbox/libs/extension/doc/shared_libraries.qbk | 7 +
   sandbox/libs/extension/doc/tutorial1.qbk | 8 +
   sandbox/libs/extension/doc/tutorial2.qbk | 7 +
   sandbox/libs/extension/doc/tutorial3.qbk | 8 +
   sandbox/libs/extension/doc/tutorial4.qbk | 7 +
   sandbox/libs/extension/doc/tutorial5.qbk | 7 +
   sandbox/libs/extension/doc/tutorial6.qbk | 7 +
   sandbox/libs/extension/doc/tutorials.qbk | 7 +
   32 files changed, 612 insertions(+), 24 deletions(-)

Modified: sandbox/libs/extension/doc/Jamfile.v2
==============================================================================
--- sandbox/libs/extension/doc/Jamfile.v2 (original)
+++ sandbox/libs/extension/doc/Jamfile.v2 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,13 @@
+# Boost.Extension - documentation Jamfile
+#
+# Copyright 2007 Jeremy Pack
+# Distributed under the Boost Software License, Version 1.0. (See
+# accompanying file LICENSE_1_0.txt or copy at
+# http://www.boost.org/LICENSE_1_0.txt)
+#
+# See http://www.boost.org/ for latest version.
+#
+
using quickbook ;
xml extension : extension.qbk : : :
<xsl:param>toc.max.depth=5

Modified: sandbox/libs/extension/doc/appendices.qbk
==============================================================================
--- sandbox/libs/extension/doc/appendices.qbk (original)
+++ sandbox/libs/extension/doc/appendices.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - appendices ]
+[/ Copyright 2007 Jeremy Pack ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:appendices Appendices]
[include appendix_a.qbk]
[endsect]
\ No newline at end of file

Modified: sandbox/libs/extension/doc/appendix_a.qbk
==============================================================================
--- sandbox/libs/extension/doc/appendix_a.qbk (original)
+++ sandbox/libs/extension/doc/appendix_a.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - windows export and import decs ]
+[/ Copyright 2007 Jeremy Pack ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:appendix_a Appendix A - Windows Export and Import Declarations]
On the Windows platform, special export declarations are required to make
functions or classes in a .dll file accessible to the outside world. For

Modified: sandbox/libs/extension/doc/extension.qbk
==============================================================================
--- sandbox/libs/extension/doc/extension.qbk (original)
+++ sandbox/libs/extension/doc/extension.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - main doc ]
+[/ Copyright 2007 Jeremy Pack ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[library Boost.Extension
[quickbook 1.3]
[version 1.0]

Modified: sandbox/libs/extension/doc/factories.qbk
==============================================================================
--- sandbox/libs/extension/doc/factories.qbk (original)
+++ sandbox/libs/extension/doc/factories.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - factories doc ]
+[/ Copyright 2007 Jeremy Pack ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:factories Factories]

Insert content here.

Modified: sandbox/libs/extension/doc/faq.qbk
==============================================================================
--- sandbox/libs/extension/doc/faq.qbk (original)
+++ sandbox/libs/extension/doc/faq.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - faq ]
+[/ Copyright 2007 Jeremy Pack ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:faq FAQ]

Question: What if I have multiple versions of the same interface (I've added new

Modified: sandbox/libs/extension/doc/html/HTML.manifest
==============================================================================
--- sandbox/libs/extension/doc/html/HTML.manifest (original)
+++ sandbox/libs/extension/doc/html/HTML.manifest 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -9,6 +9,7 @@
boost_extension/tutorials/tutorial06.html
boost_extension/factories.html
boost_extension/shared_libraries.html
+boost_extension/info.html
boost_extension/performance_analysis.html
boost_extension/appendices.html
boost_extension/appendices/appendix_a.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-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -29,7 +29,7 @@
</div>
<table width="100%"><tr>
<td align="left"></td>
-<td align="right">Copyright © 2007 Jeremy Pack</td>
+<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>
<hr>
<div class="spirit-nav">

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-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -31,7 +31,7 @@
</div>
<table width="100%"><tr>
<td align="left"></td>
-<td align="right">Copyright © 2007 Jeremy Pack</td>
+<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>
<hr>
<div class="spirit-nav">

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-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -62,7 +62,7 @@
</div>
<table width="100%"><tr>
<td align="left"></td>
-<td align="right">Copyright © 2007 Jeremy Pack</td>
+<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>
<hr>
<div class="spirit-nav">

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-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<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">
+<link rel="prev" href="info.html" title=" Info Classes">
<link rel="next" href="appendices.html" title=" Appendices">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -20,7 +20,7 @@
</table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="shared_libraries.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="appendices.html"><img src="../images/next.png" alt="Next"></a>
+<a accesskey="p" href="info.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="appendices.html"><img src="../images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
@@ -31,11 +31,11 @@
</div>
<table width="100%"><tr>
<td align="left"></td>
-<td align="right">Copyright © 2007 Jeremy Pack</td>
+<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="shared_libraries.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="appendices.html"><img src="../images/next.png" alt="Next"></a>
+<a accesskey="p" href="info.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="appendices.html"><img src="../images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost_extension/shared_libraries.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/shared_libraries.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/shared_libraries.html 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -7,7 +7,7 @@
<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">
-<link rel="next" href="performance_analysis.html" title=" Performance Analysis">
+<link rel="next" href="info.html" title=" Info Classes">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%">
@@ -20,7 +20,7 @@
</table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="factories.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="performance_analysis.html"><img src="../images/next.png" alt="Next"></a>
+<a accesskey="p" href="factories.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="info.html"><img src="../images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
@@ -31,11 +31,11 @@
</div>
<table width="100%"><tr>
<td align="left"></td>
-<td align="right">Copyright © 2007 Jeremy Pack</td>
+<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="factories.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="performance_analysis.html"><img src="../images/next.png" alt="Next"></a>
+<a accesskey="p" href="factories.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="info.html"><img src="../images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/libs/extension/doc/html/boost_extension/tutorials.html
==============================================================================
--- sandbox/libs/extension/doc/html/boost_extension/tutorials.html (original)
+++ sandbox/libs/extension/doc/html/boost_extension/tutorials.html 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -44,7 +44,7 @@
</div>
<table width="100%"><tr>
<td align="left"></td>
-<td align="right">Copyright © 2007 Jeremy Pack</td>
+<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>
<hr>
<div class="spirit-nav">

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-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -163,7 +163,7 @@
</div>
<table width="100%"><tr>
<td align="left"></td>
-<td align="right">Copyright © 2007 Jeremy Pack</td>
+<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>
<hr>
<div class="spirit-nav">

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-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -165,7 +165,7 @@
</div>
<table width="100%"><tr>
<td align="left"></td>
-<td align="right">Copyright © 2007 Jeremy Pack</td>
+<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>
<hr>
<div class="spirit-nav">

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-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -28,9 +28,9 @@

 This tutorial shows how to register and instance classes that have multi-argument
 constructors (not default constructors) in Boost.Extensions. In the example
- that we will describe in this tutorial 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.
+ 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
@@ -164,7 +164,7 @@
</div>
<table width="100%"><tr>
<td align="left"></td>
-<td align="right">Copyright © 2007 Jeremy Pack</td>
+<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>
<hr>
<div class="spirit-nav">

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-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -26,12 +26,242 @@
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_extension.tutorials.tutorial04"></a> Tutorial 4</h3></div></div></div>

- Insert content here.
+ In this tutorial we will see different features of the library related to
+ multiple loading of the same library, instance or interface.
+ 
+
+ We will follow some parts of versions example (<code class="literal">examples/versioning</code>).
+ As we expect that at this point you've gone through the first tutorials we
+ will not enter into specific details of the use of the library.
+ 
+
+ First, we want to show that it is possible to load several libraries into
+ one factory map. We'll create a new HelloWorld library very similar to the
+ one that we have described in the first tutorial.
+ 
+
+ Let's remember the classes that we have implemented (in <code class="literal">hello_world.cpp</code>)
+ for the "hello world" example:
+ 
+
+
+
+<pre class="programlisting">
+class world : public word
+{
+public:
+ virtual const char * get_val(){return "world!";}
+};
+
+class hello : public word
+{
+public:
+ virtual const char * get_val(){return "hello";}
+};
+
+extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_word(boost::extensions::factory_map & fm)
+{
+ fm.add<hello, word, int>(1);
+ fm.add<world, word, int>(2);
+}
+</pre>
+
+ 
+
+ And now let's see the new version that we've implemented for this example
+ (as defined in <code class="literal">hello_world_versions.cpp</code>). The classes
+ have the same name and methods, both implement the same interface, but the
+ <code class="computeroutput">get_val()</code>
+ methods differ in the returned string (to be able to recognize each one after
+ loading them).
+ 
+
+
+
+<pre class="programlisting">
+class world : public word
+{
+public:
+ virtual const char * get_val(){return "world! v2";}
+};
+
+class hello : public word
+{
+public:
+ virtual const char * get_val(){return "| v2 hello";}
+};
+
+extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_word(boost::extensions::factory_map & fm)
+{
+ fm.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)
+}
+</pre>
+
+ 
+
+ Also note that we are using the Info int to store some kind of "version",
+ and then we could diferrentiate the classes by its int (see Info class tutorial
+ for more information on this).
+ 
+
+
+
+<pre class="programlisting">
+factory_map fm;
+
+// load hello world first version
+load_single_library(fm, "libHelloWorldLib.extension", "extension_export_word");
+
+// load hello world second version
+load_single_library(fm, "libHelloWorldLibv2.extension", "extension_export_word");
+
+// load hello world second version again
+load_single_library(fm, "libHelloWorldLibv2.extension", "extension_export_word");
+</pre>
+
+ 
+
+ We can see here that loading multiple libraries is as easy as calling <code class="computeroutput">load_single_library</code> for each one and using
+ the same factory map.
+ 
+
+ Then you can access them as any other factory_map:
+ 
+
+
+
+<pre class="programlisting">
+for(std::list<factory<word, int> >::iterator current_word = factory_list.begin();
+ current_word != factory_list.end(); ++current_word)
+{
+ std::auto_ptr<word> word_ptr(current_word->create());
+ std::cout << word_ptr->get_val() << " ";
+}
+std::cout << std::endl << std::endl;
+</pre>
+
+ 
+
+ We get the following output:
+ 
+<div class="informaltable">
+<h4>
+<a name="id2568197"></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>
+
+ The first "hello world" is returned by the first version of the
+ library, and the second and third retruned by the second version.
+ 
+
+ Finally, we will show another example similar to the former but in this case
+ we implement a different interface, same class name ('hello') but with different
+ interface ('salute').
+ 
+
+ Let's see the interface:
+ 
+
+
+
+<pre class="programlisting">
+class salute
+{
+public:
+ virtual ~salute(){}
+ virtual const char * say(){return "";}
+};
+</pre>
+
+ 
+
+ And the implementations:
+ 
+
+
+
+<pre class="programlisting">
+class hello : public salute
+{
+public:
+ virtual const char *say(void) {return "hello";}
+};
+
+class bye : public salute
+{
+public:
+ virtual const char *say(void) {return "bye!";}
+};
+
+
+extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_salute(boost::extensions::factory_map & fm)
+{
+ fm.add<hello, salute, int>(1);
+ fm.add<bye, salute, int>(2);
+}
+</pre>
+
+ 
+
+ Note that we are adding a new class called 'hello' too but that implements
+ 'salute' interface.
+ 
+
+ 
+ 
+
+ Finally in the main function we get the factory list specifying that we want
+ the 'salute' factory. We iterate it getting each of the salutes, including
+ hello.
+ 
+
+
+
+<pre class="programlisting">
+std::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;
+</pre>
+
+ 
+
+ The output is:
+ 
+<div class="informaltable">
+<h4>
+<a name="id2569302"></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>
+
+ 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>
<td align="left"></td>
-<td align="right">Copyright © 2007 Jeremy Pack</td>
+<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>
<hr>
<div class="spirit-nav">

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-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -26,12 +26,237 @@
<div class="titlepage"><div><div><h3 class="title">
<a name="boost_extension.tutorials.tutorial05"></a> Tutorial 5</h3></div></div></div>

- Insert content here.
+ In this tutorial we will describe an advanced example using the Info class.
+ The basics of Info classes are explained in the specific section. We expect
+ that you've gone through that section before following this example.
+ 
+
+ Let's imagine that we are implementing an multi-protocol instant messaging
+ client. Of course we want to support the maximum quantity of protocols, and
+ it would be great if 3rd party programmers can implement new protocols and
+ can add them dynamically.
+ 
+
+ So let's define an interface for the protocols, with the expected operations:
+ 
+
+
+
+<pre class="programlisting">
+class protocol
+{
+ public:
+
+ virtual void login(const std::string &user, const std::string &pass) {}
+ virtual void send(const std::string &msg) {}
+ virtual std::string receive(void) { return std::string(""); }
+ virtual void change_status(const std::string &new_status) {}
+
+ virtual ~protocol(void) {}
+};
+</pre>
+
+ 
+
+ Now we will implement some example protocols:
+ 
+
+
+
+<pre class="programlisting">
+// MSN protocol implementation
+class MSN : public protocol
+{
+public:
+ virtual void login(const std::string &user, const std::string &pass) { std::cout << "MSN: Logged In" << std::endl; }
+ virtual void send(const std::string &msg) { std::cout << "MSN: message [" << msg << "] sent" << std::endl; }
+ virtual std::string receive(void) { return std::string("MSN: hello! msg received"); }
+ virtual void change_status(const std::string &new_status)
+ {
+ std::cout << "MSN: Status changed to [" << new_status << "]" << std::endl;
+ }
+
+ virtual ~MSN(void) {}
+};
+
+// Jabber protocol implementation
+class Jabber : public protocol
+{
+public:
+ virtual void login(const std::string &user, const std::string &pass) { std::cout << "Jabber: Logged In" << std::endl; }
+ virtual void send(const std::string &msg) { std::cout << "Jabber: message [" << msg << "] sent" << std::endl; }
+ virtual std::string receive(void) { return std::string("Jabber: hello! msg received"); }
+ virtual void change_status(const std::string &new_status)
+ {
+ std::cout << "Jabber: Status changed to [" << new_status << "]" << std::endl;
+ }
+
+ virtual ~Jabber(void) {}
+};
+</pre>
+
+ 
+
+ Apart from that we need some protocol information like the server address,
+ port or modes. This data is needed for each protocol and each protocol maybe
+ could have differente implementations with different servers or ports.
+ 
+
+ Of course our Info class is a perfect solution to store this data. But in
+ this case as the information is needed for each protocol we could define
+ a base class as the info class and then implement specific versions for each
+ protocol (at least one, could be more for each protocol).
+ 
+
+ So let's define the base class:
+ 
+
+
+
+<pre class="programlisting">
+// interface for the parameters of each plugin
+class network_parameters
+{
+ public:
+ virtual std::string hostname(void) = 0;
+ virtual std::string port(void) = 0;
+ virtual void set_http_mode(void)= 0;
+
+ virtual ~network_parameters(void) {};
+};
+</pre>
+
+ 
+
+ And the implementation for each of the defined plugins (protocols):
+ 
+
+
+
+<pre class="programlisting">
+// MSN implementation
+class MSN_network_parameters : public network_parameters
+{
+ public:
+ virtual std::string hostname(void) { return "msn.messenger.com"; }
+ virtual std::string port(void) { return "1863"; }
+
+ virtual void set_http_mode(void) { std::cout << "http mode set" << std::endl; }
+
+ virtual ~MSN_network_parameters() {}
+};
+
+
+// Jabber implementation
+class Jabber_network_parameters : public network_parameters
+{
+ public:
+ virtual std::string hostname(void) { return "jabber.org"; }
+ virtual std::string port(void) { return "7063"; }
+
+ virtual void set_http_mode(void) { std::cout << "http mode not supported" << std::endl; }
+
+ virtual ~Jabber_network_parameters() {}
+};
+</pre>
+
+ 
+
+ 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:
+ 
+
+
+
+<pre class="programlisting">
+extern "C" void BOOST_EXTENSION_EXPORT_DECL extension_export_plugins(boost::extensions::factory_map & fm)
+{
+ fm.add< MSN, protocol, boost::shared_ptr<network_parameters> >
+ (boost::shared_ptr<network_parameters>(new MSN_network_parameters));
+ fm.add< Jabber, protocol, boost::shared_ptr<network_parameters> >
+ (boost::shared_ptr<network_parameters>(new Jabber_network_parameters));
+}
+</pre>
+
+ 
+
+ Finally let's use our implementation for an hypotetical connection:
+ 
+
+
+
+<pre class="programlisting">
+std::list<factory< protocol, boost::shared_ptr<network_parameters> > >::iterator current_plugin = factory_list.begin();
+
+// 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">
+<h4>
+<a name="id2573510"></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>
+
+ The complete code is in the <code class="literal">examples/info/im</code> directory.

</div>
<table width="100%"><tr>
<td align="left"></td>
-<td align="right">Copyright © 2007 Jeremy Pack</td>
+<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>
<hr>
<div class="spirit-nav">

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-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -31,7 +31,7 @@
</div>
<table width="100%"><tr>
<td align="left"></td>
-<td align="right">Copyright © 2007 Jeremy Pack</td>
+<td align="right">Copyright © 2007 Jeremy Pack, Mariano G. Consoni</td>
</tr></table>
<hr>
<div class="spirit-nav">

Modified: sandbox/libs/extension/doc/html/index.html
==============================================================================
--- sandbox/libs/extension/doc/html/index.html (original)
+++ sandbox/libs/extension/doc/html/index.html 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -22,7 +22,7 @@
<div class="titlepage"><div>
<div><h2 class="title">
<a name="boost_extension"></a>Chapter 1. Boost.Extension 1.0</h2></div>
-<div>Copyright © 2007 Jeremy Pack</div>
+<div>Copyright © 2007 Jeremy Pack, Mariano G. Consoni</div>
<div><div class="legalnotice">
<a name="id2552220"></a>
Distributed under the Boost Software License, Version 1.0. (See accompanying
@@ -45,6 +45,7 @@
</dl></dd>
<dt> Factories</dt>
<dt> Shared Libraries</dt>
+<dt> Info Classes</dt>
<dt> Performance Analysis</dt>
<dt> Appendices</dt>
<dd><dl><dt> Appendix A - Windows Export and Import Declarations</dt></dl></dd>

Modified: sandbox/libs/extension/doc/info.qbk
==============================================================================
--- sandbox/libs/extension/doc/info.qbk (original)
+++ sandbox/libs/extension/doc/info.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - info class doc ]
+[/ Copyright 2007 Marano G. Consoni ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:info Info Classes]

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

Modified: sandbox/libs/extension/doc/introduction.qbk
==============================================================================
--- sandbox/libs/extension/doc/introduction.qbk (original)
+++ sandbox/libs/extension/doc/introduction.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - intro ]
+[/ Copyright 2007 Jeremy Pack ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:introduction Introduction]
Wrappers for loading classes from linked libraries to extend the functionality
of a program. Created to ease the creation of plugins.

Modified: sandbox/libs/extension/doc/performance_analysis.qbk
==============================================================================
--- sandbox/libs/extension/doc/performance_analysis.qbk (original)
+++ sandbox/libs/extension/doc/performance_analysis.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - performance analysis ]
+[/ Copyright 2007 Jeremy Pack ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:performance_analysis Performance Analysis]

Insert content here.

Modified: sandbox/libs/extension/doc/quick_start.qbk
==============================================================================
--- sandbox/libs/extension/doc/quick_start.qbk (original)
+++ sandbox/libs/extension/doc/quick_start.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - quick start ]
+[/ Copyright 2007 Jeremy Pack ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:quick_start Quick Start]

For basic usage of the library, the tutorials

Modified: sandbox/libs/extension/doc/shared_libraries.qbk
==============================================================================
--- sandbox/libs/extension/doc/shared_libraries.qbk (original)
+++ sandbox/libs/extension/doc/shared_libraries.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - shared libraries ]
+[/ Copyright 2007 Jeremy Pack ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:shared_libraries Shared Libraries]

Insert content here.

Modified: sandbox/libs/extension/doc/tutorial1.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial1.qbk (original)
+++ sandbox/libs/extension/doc/tutorial1.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,11 @@
+[/ Boost.Extension - first tutorial ]
+[/ Copyright 2007 Jeremy Pack ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
+
[section:tutorial01 Tutorial 1]

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

Modified: sandbox/libs/extension/doc/tutorial2.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial2.qbk (original)
+++ sandbox/libs/extension/doc/tutorial2.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - second tutorial ]
+[/ Copyright 2007 Jeremy Pack ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:tutorial02 Tutorial 2]

This tutorial shows more advanced class loading. The example described here is

Modified: sandbox/libs/extension/doc/tutorial3.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial3.qbk (original)
+++ sandbox/libs/extension/doc/tutorial3.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,11 @@
+[/ Boost.Extension - third tutorial ]
+[/ Copyright 2007 Mariano G. Consoni ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
+
[section:tutorial03 Tutorial 3]

This tutorial shows how to register and instance classes that have multi-argument constructors (not default constructors)

Modified: sandbox/libs/extension/doc/tutorial4.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial4.qbk (original)
+++ sandbox/libs/extension/doc/tutorial4.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - fourth tutorial ]
+[/ Copyright 2007 Mariano G. Consoni ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:tutorial04 Tutorial 4]

Modified: sandbox/libs/extension/doc/tutorial5.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial5.qbk (original)
+++ sandbox/libs/extension/doc/tutorial5.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - fifth tutorial ]
+[/ Copyright 2007 Mariano G. Consoni ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:tutorial05 Tutorial 5]

In this tutorial we will describe an advanced example using the Info class. The basics of Info classes are explained

Modified: sandbox/libs/extension/doc/tutorial6.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorial6.qbk (original)
+++ sandbox/libs/extension/doc/tutorial6.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - sixth tutorial ]
+[/ Copyright 2007 Mariano G. Consoni ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section:tutorial06 Tutorial 6]

Insert content here.

Modified: sandbox/libs/extension/doc/tutorials.qbk
==============================================================================
--- sandbox/libs/extension/doc/tutorials.qbk (original)
+++ sandbox/libs/extension/doc/tutorials.qbk 2007-06-26 18:24:40 EDT (Tue, 26 Jun 2007)
@@ -1,3 +1,10 @@
+[/ Boost.Extension - tutorials ]
+[/ Copyright 2007 Mariano G. Consoni ]
+[/ Distributed under the Boost Software License, Version 1.0. (See]
+[/ accompanying file LICENSE_1_0.txt or copy at ]
+[/ http://www.boost.org/LICENSE_1_0.txt) ]
+[/ See http://www.boost.org/ for latest version. ]
+
[section Tutorials]
[include tutorial1.qbk]
[include tutorial2.qbk]

Next message: mconsoni_at_[hidden]: "[Boost-commit] svn:boost r7182"
Previous message: mconsoni_at_[hidden]: "[Boost-commit] svn:boost r7180"

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