|author||Remko Tronçon <firstname.lastname@example.org>||2010-11-29 18:54:56 (GMT)|
|committer||Remko Tronçon <email@example.com>||2010-11-29 18:57:45 (GMT)|
Added some more documentation.
Diffstat (limited to 'Documentation')
|-rw-r--r--||Documentation/SwiftenDevelopersGuide/Swiften Developers Guide.xml||45|
1 files changed, 38 insertions, 7 deletions
diff --git a/Documentation/SwiftenDevelopersGuide/Swiften Developers Guide.xml b/Documentation/SwiftenDevelopersGuide/Swiften Developers Guide.xml
index ab1b796..52af24e 100644
--- a/Documentation/SwiftenDevelopersGuide/Swiften Developers Guide.xml
+++ b/Documentation/SwiftenDevelopersGuide/Swiften Developers Guide.xml
@@ -24,8 +24,7 @@
<emphasis>Bind</emphasis>, <emphasis>Optional</emphasis>, and
<emphasis>Smart Pointers</emphasis>. We
introduce the basic usage of these libraries in our API throughout
- this manual. For detailed documentation, we refer to the Boost
+ this manual. For detailed documentation, we refer to the <ulink url="http://boost.org">Boost</ulink> website.
@@ -72,9 +71,19 @@
so we use Swiften's own <literal>SimpleEventLoop</literal>. This
class is used by simply instantiating it at the beginning of the
application, and calling <literal>run()</literal> after everything
- is set up, which will go into an infinite loop. Apart from constructing
- and (if necessary) starting the event loop, you will probably have
- no other contact with it in the rest of the application.
+ is set up, which will go into an infinite loop. Apart from constructing,
+ passing, and (if necessary) starting the event loop, you will probably
+ have no other contact with it in the rest of the application.
+ Another prerequisite of Swiften's classes is an implementation of
+ network interaction, provided through the
+ <literal>NetworkFactories</literal> class. Swiften comes with a
+ Boost-based network implementation, implemented in
+ <literal>BoostNetworkFactories</literal>. As with the event loop,
+ you probably will have no need to interact with this class apart
+ from constructing it.
@@ -91,7 +100,18 @@
- <remark>TODO: Explain linking against the static library.</remark>
+ To build your application, you will need to set up your build
+ environment to use the correct include and library paths for
+ Swiften, and link against the Swiften library. This depends
+ on both the compiler you are using, and the flags you used to build
+ Swiften. To get the list of compiler options, Swiften comes with
+ a program <literal>swiften-config</literal> (located in
+ <literal>Swiften/Config</literal> in the Swiften tree). Calling this
+ with the <literal>--libs</literal> option will return the list of link flags,
+ whereas calling it with the <literal>--cflags</literal> option will return the
+ list of C(++) compiler flags.
@@ -291,7 +311,18 @@
<title>Using Swiften's convenience classes</title>
+ Swiften comes with flavors of the Client class: <literal>CoreClient</literal>, which
+ implements only the basics of connecting to the XMPP server, without any built-in
+ responders. If you want to build a client from scratch, this class is probably your
+ preferred Swiften interface. However, most users of Swiften will not want to bother with
+ explicitly instantiating responders to basic functionality such as software version
+ information etc., and will want to have the convenience of built-in responders and
+ utility classes. In this case, you can use the <literal>Client</literal> class (a
+ subclass of <literal>CoreClient</literal>, which
+ implements most of the common XMPP client functionality, including roster and subscription
+ management, VCards, Avatars, Service Discovery, Multi-User Chats, ...