/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