Merge gtkdoc-conversion soc.2013.gobjectification.plugins

Tue, 04 Feb 2014 02:32:01 +0530

author
Ankit Vani <a@nevitus.org>
date
Tue, 04 Feb 2014 02:32:01 +0530
branch
soc.2013.gobjectification.plugins
changeset 37061
77a5c789fff1
parent 37060
e5206d7698e5 (current diff)
parent 35443
54cc2cf05267 (diff)
child 37062
f9b1a70fb9d6

Merge gtkdoc-conversion

doc/reference/libpurple/Makefile.am file | annotate | diff | comparison | revisions
doc/reference/libpurple/libpurple-docs.xml file | annotate | diff | comparison | revisions
libpurple/purple-socket.h file | annotate | diff | comparison | revisions
libpurple/request-datasheet.h file | annotate | diff | comparison | revisions
libpurple/request.h file | annotate | diff | comparison | revisions
libpurple/roomlist.h file | annotate | diff | comparison | revisions
libpurple/savedstatuses.h file | annotate | diff | comparison | revisions
libpurple/server.h file | annotate | diff | comparison | revisions
libpurple/signals.h file | annotate | diff | comparison | revisions
libpurple/smiley.h file | annotate | diff | comparison | revisions
libpurple/sound-theme.h file | annotate | diff | comparison | revisions
libpurple/sound.h file | annotate | diff | comparison | revisions
libpurple/sslconn.h file | annotate | diff | comparison | revisions
libpurple/status.h file | annotate | diff | comparison | revisions
libpurple/stringref.h file | annotate | diff | comparison | revisions
libpurple/stun.h file | annotate | diff | comparison | revisions
libpurple/theme-loader.h file | annotate | diff | comparison | revisions
libpurple/theme-manager.h file | annotate | diff | comparison | revisions
libpurple/theme.h file | annotate | diff | comparison | revisions
libpurple/upnp.h file | annotate | diff | comparison | revisions
libpurple/util.h file | annotate | diff | comparison | revisions
libpurple/whiteboard.h file | annotate | diff | comparison | revisions
libpurple/xfer.h file | annotate | diff | comparison | revisions
libpurple/xmlnode.h file | annotate | diff | comparison | revisions
--- a/doc/reference/libpurple/Makefile.am	Tue Feb 04 01:44:42 2014 +0530
+++ b/doc/reference/libpurple/Makefile.am	Tue Feb 04 02:32:01 2014 +0530
@@ -72,6 +72,7 @@
 	dbus-types.h \
 	glibcompat.h \
 	internal.h \
+	marshallers.h \
 	purple-client.h \
 	purple-client-bindings.h
 	valgrind.h
--- a/doc/reference/libpurple/libpurple-docs.xml	Tue Feb 04 01:44:42 2014 +0530
+++ b/doc/reference/libpurple/libpurple-docs.xml	Tue Feb 04 02:32:01 2014 +0530
@@ -28,7 +28,6 @@
   <reference label="II">
     <title>API Reference</title>
 
-      <xi:include href="xml/purple.xml" />
       <xi:include href="xml/account.xml" />
       <xi:include href="xml/accountopt.xml" />
       <xi:include href="xml/accounts.xml" />
@@ -36,66 +35,66 @@
       <xi:include href="xml/blistnodetypes.xml" />
       <xi:include href="xml/buddylist.xml" />
       <xi:include href="xml/buddyicon.xml" />
-      <xi:include href="xml/certificate.xml" />
+      <xi:include href="xml/pounce.xml" />
+      <xi:include href="xml/circularbuffer.xml" />
       <xi:include href="xml/cipher.xml" />
-      <xi:include href="xml/circularbuffer.xml" />
       <xi:include href="xml/cmds.xml" />
       <xi:include href="xml/connection.xml" />
       <xi:include href="xml/conversation.xml" />
       <xi:include href="xml/conversationtypes.xml" />
       <xi:include href="xml/conversations.xml" />
-      <xi:include href="xml/core.xml" />
       <xi:include href="xml/dbus-maybe.xml" />
       <xi:include href="xml/debug.xml" />
-      <xi:include href="xml/desktopitem.xml" />
       <xi:include href="xml/dnsquery.xml" />
       <xi:include href="xml/dnssrv.xml" />
       <xi:include href="xml/e2ee.xml" />
       <xi:include href="xml/eventloop.xml" />
+      <xi:include href="xml/xfer.xml" />
+      <xi:include href="xml/purple-socket.xml" />
       <xi:include href="xml/http.xml" />
       <xi:include href="xml/idle.xml" />
       <xi:include href="xml/imgstore.xml" />
       <xi:include href="xml/keyring.xml" />
       <xi:include href="xml/log.xml" />
-      <xi:include href="xml/marshallers.xml" />
+      <xi:include href="xml/desktopitem.xml" />
       <xi:include href="xml/mime.xml" />
       <xi:include href="xml/nat-pmp.xml" />
       <xi:include href="xml/network.xml" />
       <xi:include href="xml/notify.xml" />
       <xi:include href="xml/ntlm.xml" />
+      <xi:include href="xml/plugins.xml" />
+      <xi:include href="xml/prefs.xml" />
       <xi:include href="xml/pluginpref.xml" />
-      <xi:include href="xml/plugins.xml" />
-      <xi:include href="xml/pounce.xml" />
-      <xi:include href="xml/prefs.xml" />
       <xi:include href="xml/presence.xml" />
       <xi:include href="xml/protocol.xml" />
       <xi:include href="xml/protocols.xml" />
       <xi:include href="xml/proxy.xml" />
-      <xi:include href="xml/purple-socket.xml" />
+      <xi:include href="xml/certificate.xml" />
+      <xi:include href="xml/signals.xml" />
+      <xi:include href="xml/stringref.xml" />
       <xi:include href="xml/request.xml" />
       <xi:include href="xml/request-datasheet.xml" />
       <xi:include href="xml/roomlist.xml" />
       <xi:include href="xml/savedstatuses.xml" />
       <xi:include href="xml/server.xml" />
-      <xi:include href="xml/signals.xml" />
       <xi:include href="xml/smiley.xml" />
-      <xi:include href="xml/sound-theme-loader.xml" />
-      <xi:include href="xml/sound-theme.xml" />
       <xi:include href="xml/sound.xml" />
       <xi:include href="xml/sslconn.xml" />
+      <xi:include href="xml/core.xml" />
       <xi:include href="xml/status.xml" />
-      <xi:include href="xml/stringref.xml" />
       <xi:include href="xml/stun.xml" />
+      <xi:include href="xml/theme.xml" />
       <xi:include href="xml/theme-loader.xml" />
       <xi:include href="xml/theme-manager.xml" />
-      <xi:include href="xml/theme.xml" />
+      <xi:include href="xml/sound-theme.xml" />
+      <xi:include href="xml/sound-theme-loader.xml" />
       <xi:include href="xml/upnp.xml" />
-      <xi:include href="xml/util.xml" />
+      <xi:include href="xml/whiteboard.xml" />
+      <xi:include href="xml/xmlnode.xml" />
       <xi:include href="xml/version.xml" />
-      <xi:include href="xml/whiteboard.xml" />
-      <xi:include href="xml/xfer.xml" />
-      <xi:include href="xml/xmlnode.xml" />
+      <xi:include href="xml/util.xml" />
       <xi:include href="xml/enums.xml" />
+      <xi:include href="xml/purple.xml" />
   </reference>
 
   <reference label="">
@@ -103,8 +102,8 @@
       <title>Ciphers and Hashes</title>
 
         <xi:include href="xml/aescipher.xml" />
+        <xi:include href="xml/descipher.xml" />
         <xi:include href="xml/des3cipher.xml" />
-        <xi:include href="xml/descipher.xml" />
         <xi:include href="xml/hmaccipher.xml" />
         <xi:include href="xml/pbkdf2cipher.xml" />
         <xi:include href="xml/rc4cipher.xml" />
@@ -118,11 +117,11 @@
       <title>Media APIs</title>
 
         <xi:include href="xml/media.xml" />
+        <xi:include href="xml/media-gst.xml" />
         <xi:include href="xml/mediamanager.xml" />
-        <xi:include href="xml/media-gst.xml" />
-        <xi:include href="xml/backend-iface.xml" />
         <xi:include href="xml/candidate.xml" />
         <xi:include href="xml/codec.xml" />
+        <xi:include href="xml/backend-iface.xml" />
         <xi:include href="xml/enum-types.xml" />
     </reference>
 
@@ -147,14 +146,14 @@
       <xi:include href="signals_conversation.xml" />
       <xi:include href="signals_core.xml" />
       <xi:include href="signals_dbus_server.xml" />
-      <xi:include href="signals_imgstore.xml" />
+      <xi:include href="signals_xfer.xml" />
       <xi:include href="signals_log.xml" />
       <xi:include href="signals_notify.xml" />
       <xi:include href="signals_plugin.xml" />
       <xi:include href="signals_protocol.xml" />
       <xi:include href="signals_savedstatus.xml" />
       <xi:include href="signals_sound.xml" />
-      <xi:include href="signals_xfer.xml" />
+      <xi:include href="signals_imgstore.xml" />
       <xi:include href="signals_jabber.xml" />
   </reference>
 
--- a/libpurple/purple-socket.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/purple-socket.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,8 +1,3 @@
-/**
- * @file purple-socket.h Generic sockets
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -23,6 +18,12 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
  */
+/**
+ * SECTION:purple-socket
+ * @section_id: libpurple-purple-socket
+ * @short_description: <filename>purple-socket.h</filename>
+ * @title: Generic sockets
+ */
 
 #ifndef _PURPLE_SOCKET_H_
 #define _PURPLE_SOCKET_H_
--- a/libpurple/request-datasheet.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/request-datasheet.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,8 +1,3 @@
-/**
- * @file request-datasheet.h Request Datasheet API
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -23,6 +18,13 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
  */
+/**
+ * SECTION:request-datasheet
+ * @section_id: libpurple-request-datasheet
+ * @short_description: <filename>request-datasheet.h</filename>
+ * @title: Request Datasheet API
+ */
+
 #ifndef _PURPLE_REQUEST_DATA_H_
 #define _PURPLE_REQUEST_DATA_H_
 
--- a/libpurple/request.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/request.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,8 +1,3 @@
-/**
- * @file request.h Request API
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -23,6 +18,13 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:request
+ * @section_id: libpurple-request
+ * @short_description: <filename>request.h</filename>
+ * @title: Request API
+ */
+
 #ifndef _PURPLE_REQUEST_H_
 #define _PURPLE_REQUEST_H_
 
--- a/libpurple/roomlist.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/roomlist.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,8 +1,3 @@
-/**
- * @file roomlist.h Room List API
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -23,6 +18,12 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:roomlist
+ * @section_id: libpurple-roomlist
+ * @short_description: <filename>roomlist.h</filename>
+ * @title: Room List API
+ */
 
 #ifndef _PURPLE_ROOMLIST_H_
 #define _PURPLE_ROOMLIST_H_
--- a/libpurple/savedstatuses.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/savedstatuses.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,9 +1,3 @@
-/**
- * @file savedstatuses.h Saved Status API
- * @ingroup core
- * @see @ref savedstatus-signals
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -24,6 +18,14 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:savedstatuses
+ * @section_id: libpurple-savedstatuses
+ * @short_description: <filename>savedstatuses.h</filename>
+ * @title: Saved Status API
+ * @see_also: <link linkend="chapter-signals-savedstatus">Saved Status signals</link>
+ */
+
 #ifndef _PURPLE_SAVEDSTATUSES_H_
 #define _PURPLE_SAVEDSTATUSES_H_
 
--- a/libpurple/server.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/server.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,8 +1,3 @@
-/**
- * @file server.h Server API
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -23,6 +18,13 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:server
+ * @section_id: libpurple-server
+ * @short_description: <filename>server.h</filename>
+ * @title: Server API
+ */
+
 #ifndef _PURPLE_SERVER_H_
 #define _PURPLE_SERVER_H_
 
--- a/libpurple/signals.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/signals.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,8 +1,3 @@
-/**
- * @file signals.h Signal API
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -23,6 +18,14 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:signals
+ * @section_id: libpurple-signals
+ * @short_description: <filename>signals.h</filename>
+ * @title: Purple-signals API
+ * @see_also: <link linkend="chapter-tut-signals">Signals tutorial</link>
+ */
+
 #ifndef _PURPLE_SIGNALS_H_
 #define _PURPLE_SIGNALS_H_
 
--- a/libpurple/smiley.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/smiley.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,8 +1,3 @@
-/**
- * @file smiley.h Smiley API
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -24,6 +19,12 @@
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  *
  */
+/**
+ * SECTION:smiley
+ * @section_id: libpurple-smiley
+ * @short_description: <filename>smiley.h</filename>
+ * @title: Smiley API
+ */
 
 #ifndef _PURPLE_SMILEY_H_
 #define _PURPLE_SMILEY_H_
--- a/libpurple/sound-theme-loader.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/sound-theme-loader.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,7 +1,3 @@
-/**
- * @file sound-theme-loader.h  Purple Sound Theme Loader Class API
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -22,6 +18,12 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:sound-theme-loader
+ * @section_id: libpurple-sound-theme-loader
+ * @short_description: <filename>sound-theme-loader.h</filename>
+ * @title: Sound Theme Loader class
+ */
 
 #ifndef PURPLE_SOUND_THEME_LOADER_H
 #define PURPLE_SOUND_THEME_LOADER_H
--- a/libpurple/sound-theme.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/sound-theme.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,7 +1,3 @@
-/**
- * @file sound-theme.h  Purple Sound Theme Abstact Class API
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -22,6 +18,12 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:sound-theme
+ * @section_id: libpurple-sound-theme
+ * @short_description: <filename>sound-theme.h</filename>
+ * @title: Sound Theme abstact class
+ */
 
 #ifndef PURPLE_SOUND_THEME_H
 #define PURPLE_SOUND_THEME_H
--- a/libpurple/sound.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/sound.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,9 +1,3 @@
-/**
- * @file sound.h Sound API
- * @ingroup core
- * @see @ref sound-signals
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -24,6 +18,14 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:sound
+ * @section_id: libpurple-sound
+ * @short_description: <filename>sound.h</filename>
+ * @title: Sound API
+ * @see_also: <link linkend="chapter-signals-sound">Sound signals</link>
+ */
+
 #ifndef _PURPLE_SOUND_H_
 #define _PURPLE_SOUND_H_
 
--- a/libpurple/sslconn.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/sslconn.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,8 +1,3 @@
-/**
- * @file sslconn.h SSL API
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -23,6 +18,13 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:sslconn
+ * @section_id: libpurple-sslconn
+ * @short_description: <filename>sslconn.h</filename>
+ * @title: SSL API
+ */
+
 #ifndef _PURPLE_SSLCONN_H_
 #define _PURPLE_SSLCONN_H_
 
--- a/libpurple/status.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/status.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,7 +1,3 @@
-/**
- * @file status.h Status API
- * @ingroup core
- */
 /*
  * purple
  *
@@ -23,6 +19,13 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:status
+ * @section_id: libpurple-status
+ * @short_description: <filename>status.h</filename>
+ * @title: Status object API
+ */
+
 #ifndef _PURPLE_STATUS_H_
 #define _PURPLE_STATUS_H_
 
--- a/libpurple/stringref.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/stringref.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,10 +1,5 @@
 /* TODO: Can we just replace this whole thing with a GCache */
 
-/**
- * @file stringref.h Reference-counted immutable strings
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -26,6 +21,13 @@
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  *
  */
+/**
+ * SECTION:stringref
+ * @section_id: libpurple-stringref
+ * @short_description: <filename>stringref.h</filename>
+ * @title: Reference-counted immutable strings
+ */
+
 #ifndef _PURPLE_STRINGREF_H_
 #define _PURPLE_STRINGREF_H_
 
--- a/libpurple/stun.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/stun.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,8 +1,3 @@
-/**
- * @file stun.h STUN API
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -23,6 +18,13 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:stun
+ * @section_id: libpurple-stun
+ * @short_description: <filename>stun.h</filename>
+ * @title: STUN API
+ */
+
 #ifndef _PURPLE_STUN_H_
 #define _PURPLE_STUN_H_
 
--- a/libpurple/theme-loader.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/theme-loader.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,7 +1,3 @@
-/**
- * @file theme-loader.h  Purple Theme Loader Abstact Class API
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -22,6 +18,12 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:theme-loader
+ * @section_id: libpurple-theme-loader
+ * @short_description: <filename>theme-loader.h</filename>
+ * @title: Theme Loader abstact class
+ */
 
 #ifndef PURPLE_THEME_LOADER_H
 #define PURPLE_THEME_LOADER_H
--- a/libpurple/theme-manager.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/theme-manager.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,7 +1,3 @@
-/**
- * @file theme-manager.h  Theme Manager API
- */
-
 /*
  * purple
  *
@@ -23,6 +19,12 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:theme-manager
+ * @section_id: libpurple-theme-manager
+ * @short_description: <filename>theme-manager.h</filename>
+ * @title: Theme Manager API
+ */
 
 #ifndef PURPLE_THEME_MANAGER_H
 #define PURPLE_THEME_MANAGER_H
--- a/libpurple/theme.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/theme.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,7 +1,3 @@
-/**
- * @file theme.h  Purple Theme Abstact Class API
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -22,6 +18,12 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:theme
+ * @section_id: libpurple-theme
+ * @short_description: <filename>theme.h</filename>
+ * @title: Theme abstact class
+ */
 
 #ifndef PURPLE_THEME_H
 #define PURPLE_THEME_H
--- a/libpurple/upnp.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/upnp.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,8 +1,3 @@
-/**
- * @file upnp.h Universal Plug N Play API
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -23,6 +18,12 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:upnp
+ * @section_id: libpurple-upnp
+ * @short_description: <filename>upnp.h</filename>
+ * @title: Universal Plug N Play API
+ */
 
 #ifndef _PURPLE_UPNP_H_
 #define _PURPLE_UPNP_H_
--- a/libpurple/util.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/util.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,8 +1,3 @@
-/**
- * @file util.h Utility Functions
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -26,6 +21,13 @@
  * @todo Rename the functions so that they live somewhere in the purple
  *       namespace.
  */
+/**
+ * SECTION:util
+ * @section_id: libpurple-util
+ * @short_description: <filename>util.h</filename>
+ * @title: Utility Functions
+ */
+
 #ifndef _PURPLE_UTIL_H_
 #define _PURPLE_UTIL_H_
 
--- a/libpurple/whiteboard.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/whiteboard.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,6 +1,3 @@
-/**
- * @file whiteboard.h The PurpleWhiteboard core object
- */
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -21,6 +18,12 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:whiteboard
+ * @section_id: libpurple-whiteboard
+ * @short_description: <filename>whiteboard.h</filename>
+ * @title: Whiteboard object
+ */
 
 #ifndef _PURPLE_WHITEBOARD_H_
 #define _PURPLE_WHITEBOARD_H_
--- a/libpurple/xfer.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/xfer.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,9 +1,3 @@
-/**
- * @file xfer.h File Transfer API
- * @ingroup core
- * @see @ref xfer-signals
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -24,6 +18,14 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:xfer
+ * @section_id: libpurple-xfer
+ * @short_description: <filename>xfer.h</filename>
+ * @title: File Transfer API
+ * @see_also: <link linkend="chapter-signals-xfer">File Transfer signals</link>
+ */
+
 #ifndef _PURPLE_XFER_H_
 #define _PURPLE_XFER_H_
 
--- a/libpurple/xmlnode.h	Tue Feb 04 01:44:42 2014 +0530
+++ b/libpurple/xmlnode.h	Tue Feb 04 02:32:01 2014 +0530
@@ -1,8 +1,3 @@
-/**
- * @file xmlnode.h XML DOM functions
- * @ingroup core
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -23,6 +18,13 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:xmlnode
+ * @section_id: libpurple-xmlnode
+ * @short_description: <filename>xmlnode.h</filename>
+ * @title: XML DOM functions
+ */
+
 #ifndef _PURPLE_XMLNODE_H_
 #define _PURPLE_XMLNODE_H_
 

mercurial