/soc/2013/ankitkv/gobjectification: 8dcae6cd6628: Add section bl...

Ankit Vani a at nevitus.org
Mon Feb 3 12:15:22 EST 2014


Changeset: 8dcae6cd66282c63895958eb143347315423f000
Author:	 Ankit Vani <a at nevitus.org>
Date:	 2014-02-03 20:26 +0530
Branch:	 gtkdoc-conversion
URL: https://hg.pidgin.im/soc/2013/ankitkv/gobjectification/rev/8dcae6cd6628

Description:

Add section blocks for account.h to connection.h

diffstat:

 libpurple/account.h        |  12 +++++++-----
 libpurple/accountopt.h     |  12 +++++++-----
 libpurple/accounts.h       |  14 ++++++++------
 libpurple/blistnode.h      |  11 +++++++----
 libpurple/blistnodetypes.h |  11 +++++++----
 libpurple/buddyicon.h      |  12 +++++++-----
 libpurple/buddylist.h      |  14 ++++++++------
 libpurple/certificate.h    |  13 +++++++------
 libpurple/cipher.h         |  12 +++++++-----
 libpurple/circularbuffer.h |  12 +++++++-----
 libpurple/cmds.h           |  14 ++++++++------
 libpurple/connection.h     |  14 ++++++++------
 12 files changed, 88 insertions(+), 63 deletions(-)

diffs (truncated from 319 to 300 lines):

diff --git a/libpurple/account.h b/libpurple/account.h
--- a/libpurple/account.h
+++ b/libpurple/account.h
@@ -1,8 +1,3 @@
-/**
- * @file account.h Account 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:account
+ * @section_id: libpurple-account
+ * @title: account.h
+ * @short_description: PurpleAccount object
+ */
+
 #ifndef _PURPLE_ACCOUNT_H_
 #define _PURPLE_ACCOUNT_H_
 
diff --git a/libpurple/accountopt.h b/libpurple/accountopt.h
--- a/libpurple/accountopt.h
+++ b/libpurple/accountopt.h
@@ -1,8 +1,3 @@
-/**
- * @file accountopt.h Account Options 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:accountopt
+ * @section_id: libpurple-accountopt
+ * @title: accountopt.h
+ * @short_description: Account Options API
+ */
+
 #ifndef _PURPLE_ACCOUNTOPT_H_
 #define _PURPLE_ACCOUNTOPT_H_
 
diff --git a/libpurple/accounts.h b/libpurple/accounts.h
--- a/libpurple/accounts.h
+++ b/libpurple/accounts.h
@@ -1,9 +1,3 @@
-/**
- * @file accounts.h Accounts API
- * @ingroup core
- * @see @ref account-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:accounts
+ * @section_id: libpurple-accounts
+ * @title: accounts.h
+ * @short_description: Accounts subsystem API
+ * @see_also: <link linkend="chapter-signals-account">Account signals</link>
+ */
+
 #ifndef _PURPLE_ACCOUNTS_H_
 #define _PURPLE_ACCOUNTS_H_
 
diff --git a/libpurple/blistnode.h b/libpurple/blistnode.h
--- a/libpurple/blistnode.h
+++ b/libpurple/blistnode.h
@@ -1,7 +1,3 @@
-/**
- * @file blistnode.h Buddy list node and Counting node API
- * @ingroup core
- */
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -22,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:blistnode
+ * @section_id: libpurple-blistnode
+ * @title: blistnode.h
+ * @short_description: Buddy list node and Counting node objects
+ */
+
 #ifndef _PURPLE_BLIST_NODE_H_
 #define _PURPLE_BLIST_NODE_H_
 
diff --git a/libpurple/blistnodetypes.h b/libpurple/blistnodetypes.h
--- a/libpurple/blistnodetypes.h
+++ b/libpurple/blistnodetypes.h
@@ -1,7 +1,3 @@
-/**
- * @file blistnodetypes.h Buddy, Chat, Contact and Group API
- * @ingroup core
- */
 /* purple
  *
  * Purple is the legal property of its developers, whose names are too numerous
@@ -22,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:blistnodetypes
+ * @section_id: libpurple-blistnodetypes
+ * @title: blistnodetypes.h
+ * @short_description: Buddy list's Buddy, Chat, Contact and Group objects
+ */
+
 #ifndef _PURPLE_BLISTNODE_TYPES_H_
 #define _PURPLE_BLISTNODE_TYPES_H_
 
diff --git a/libpurple/buddyicon.h b/libpurple/buddyicon.h
--- a/libpurple/buddyicon.h
+++ b/libpurple/buddyicon.h
@@ -1,8 +1,3 @@
-/**
- * @file buddyicon.h Buddy Icon 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:buddyicon
+ * @section_id: libpurple-buddyicon
+ * @title: buddyicon.h
+ * @short_description: Buddy Icon API
+ */
+
 #ifndef _PURPLE_BUDDYICON_H_
 #define _PURPLE_BUDDYICON_H_
 
diff --git a/libpurple/buddylist.h b/libpurple/buddylist.h
--- a/libpurple/buddylist.h
+++ b/libpurple/buddylist.h
@@ -1,9 +1,3 @@
-/**
- * @file buddylist.h Buddy List API
- * @ingroup core
- * @see @ref blist-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:buddylist
+ * @section_id: libpurple-buddylist
+ * @title: buddylist.h
+ * @short_description: Buddy List API
+ * @see_also: <link linkend="chapter-signals-blist">Buddy List signals</link>
+ */
+
 #ifndef _PURPLE_BUDDY_LIST_H_
 #define _PURPLE_BUDDY_LIST_H_
 
diff --git a/libpurple/certificate.h b/libpurple/certificate.h
--- a/libpurple/certificate.h
+++ b/libpurple/certificate.h
@@ -1,9 +1,3 @@
-/**
- * @file certificate.h Public-Key Certificate API
- * @ingroup core
- * @see @ref certificate-signals
- */
-
 /*
  *
  * purple
@@ -26,6 +20,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:certificate
+ * @section_id: libpurple-certificate
+ * @title: certificate.h
+ * @short_description: Public-Key Certificate API
+ * @see_also: <link linkend="chapter-signals-certificate">Certificate signals</link>
+ */
 
 #ifndef _PURPLE_CERTIFICATE_H
 #define _PURPLE_CERTIFICATE_H
diff --git a/libpurple/cipher.h b/libpurple/cipher.h
--- a/libpurple/cipher.h
+++ b/libpurple/cipher.h
@@ -1,8 +1,3 @@
-/**
- * @file cipher.h Purple Cipher and Hash 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:cipher
+ * @section_id: libpurple-cipher
+ * @title: cipher.h
+ * @short_description: Cipher and Hash API
+ */
+
 #ifndef PURPLE_CIPHER_H
 #define PURPLE_CIPHER_H
 
diff --git a/libpurple/circularbuffer.h b/libpurple/circularbuffer.h
--- a/libpurple/circularbuffer.h
+++ b/libpurple/circularbuffer.h
@@ -1,8 +1,3 @@
-/**
- * @file circbuffer.h Buffer Utility Functions
- * @ingroup core
- */
-
 /* Purple is the legal property of its developers, whose names are too numerous
  * to list here.  Please refer to the COPYRIGHT file distributed with this
  * source distribution.
@@ -21,6 +16,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:circularbuffer
+ * @section_id: libpurple-circularbuffer
+ * @title: circularbuffer.h
+ * @short_description: Buffer Utility Functions
+ */
+
 #ifndef PURPLE_CIRCULAR_BUFFER_H
 #define PURPLE_CIRCULAR_BUFFER_H
 
diff --git a/libpurple/cmds.h b/libpurple/cmds.h
--- a/libpurple/cmds.h
+++ b/libpurple/cmds.h
@@ -1,9 +1,3 @@
-/**
- * @file cmds.h Commands API
- * @ingroup core
- * @see @ref cmd-signals
- */
-
 /* Copyright (C) 2003 Timothy Ringenbach <omarvo at hotmail.com>
  *
  * This program is free software; you can redistribute it and/or modify
@@ -21,6 +15,14 @@
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  *
  */
+/**
+ * SECTION:cmds
+ * @section_id: libpurple-cmds
+ * @title: cmds.h
+ * @short_description: Commands API
+ * @see_also: <link linkend="chapter-signals-cmd">Command signals</link>
+ */
+
 #ifndef _PURPLE_CMDS_H_
 #define _PURPLE_CMDS_H_
 
diff --git a/libpurple/connection.h b/libpurple/connection.h
--- a/libpurple/connection.h
+++ b/libpurple/connection.h
@@ -1,9 +1,3 @@
-/**
- * @file connection.h Connection API
- * @ingroup core
- * @see @ref connection-signals
- */



More information about the Commits mailing list