/soc/2013/ankitkv/gobjectification: e5206d7698e5: Add section bl...

[Ankit Vani]

Changeset: e5206d7698e522eefa0253a5af4aefdb567badbd
Author:	 Ankit Vani <a at nevitus.org>
Date:	 2014-02-04 01:44 +0530
Branch:	 soc.2013.gobjectification.plugins
URL: https://hg.pidgin.im/soc/2013/ankitkv/gobjectification/rev/e5206d7698e5

Description:

Add section blocks for plugins.h, protocol.h, protocols.h

diffstat:

 libpurple/plugins.h   |  18 ++++++++++--------
 libpurple/protocol.h  |  11 ++++++-----
 libpurple/protocols.h |  12 +++++++-----
 3 files changed, 23 insertions(+), 18 deletions(-)

diffs (83 lines):

diff --git a/libpurple/plugins.h b/libpurple/plugins.h
--- a/libpurple/plugins.h
+++ b/libpurple/plugins.h
@@ -1,11 +1,3 @@
-/**
- * @file plugins.h Plugins API
- * @ingroup core
- * @see @ref plugin-signals
- * @see @ref plugin-ids
- * @see @ref plugin-i18n
- */
-
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -26,6 +18,16 @@
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  */
+/**
+ * SECTION:plugins
+ * @section_id: libpurple-plugins
+ * @short_description: <filename>plugins.h</filename>
+ * @title: Plugin API
+ * @see_also: <link linkend="chapter-signals-plugin">Plugin signals</link>,
+ *     <link linkend="chapter-plugin-ids">Plugin IDs</link>,
+ *     <link linkend="chapter-plugin-i18n">Third Party Plugin Translation</link>
+ */
+
 #ifndef _PURPLE_PLUGINS_H_
 #define _PURPLE_PLUGINS_H_
 
diff --git a/libpurple/protocol.h b/libpurple/protocol.h
--- a/libpurple/protocol.h
+++ b/libpurple/protocol.h
@@ -1,8 +1,3 @@
-/**
- * @file protocol.h Protocol object and interfaces 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:protocol
+ * @section_id: libpurple-protocol
+ * @short_description: <filename>protocol.h</filename>
+ * @title: Protocol object and interfaces
+ */
 
 #ifndef _PURPLE_PROTOCOL_H_
 #define _PURPLE_PROTOCOL_H_
diff --git a/libpurple/protocols.h b/libpurple/protocols.h
--- a/libpurple/protocols.h
+++ b/libpurple/protocols.h
@@ -1,8 +1,3 @@
-/**
- * @file protocols.h Protocols 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:protocols
+ * @section_id: libpurple-protocols
+ * @short_description: <filename>protocols.h</filename>
+ * @title: Protocols subsystem API
+ * @see_also: <link linkend="chapter-signals-protocol">Protocol signals</link>
+ */
 
 #ifndef _PURPLE_PROTOCOLS_H_
 #define _PURPLE_PROTOCOLS_H_