[evolution] Move "section" documentation out of header files.

From: Matthew Barnes <mbarnes src gnome org>
To: commits-list gnome org
Cc:
Subject: [evolution] Move "section" documentation out of header files.
Date: Sun, 21 Mar 2010 21:25:12 +0000 (UTC)
commit f9dd2dd10b3639a5924b7724624547ae56f2a4a0
Author: Matthew Barnes <mbarnes redhat com>
Date:   Sun Mar 21 17:24:42 2010 -0400

    Move "section" documentation out of header files.

 e-util/e-account-utils.c  |    5 +++++
 e-util/e-account-utils.h  |    5 -----
 e-util/e-module.c         |    5 +++++
 e-util/e-module.h         |    5 -----
 e-util/e-selection.c      |    6 ++++++
 e-util/e-selection.h      |    6 ------
 e-util/e-ui-manager.c     |    9 +++++++++
 e-util/e-ui-manager.h     |    9 ---------
 e-util/e-util.c           |    5 +++++
 e-util/e-util.h           |    5 -----
 mail/mail-folder-cache.c  |    5 +++++
 mail/mail-folder-cache.h  |    5 -----
 shell/e-shell-backend.c   |    6 ++++++
 shell/e-shell-backend.h   |    6 ------
 shell/e-shell-content.c   |    6 ++++++
 shell/e-shell-content.h   |    6 ------
 shell/e-shell-searchbar.c |    6 ++++++
 shell/e-shell-searchbar.h |    6 ------
 shell/e-shell-settings.c  |    6 ++++++
 shell/e-shell-settings.h  |    6 ------
 shell/e-shell-sidebar.c   |    6 ++++++
 shell/e-shell-sidebar.h   |    6 ------
 shell/e-shell-switcher.c  |    6 ++++++
 shell/e-shell-switcher.h  |    6 ------
 shell/e-shell-taskbar.c   |    6 ++++++
 shell/e-shell-taskbar.h   |    6 ------
 shell/e-shell-utils.c     |    6 ++++++
 shell/e-shell-utils.h     |    6 ------
 shell/e-shell-view.c      |    6 ++++++
 shell/e-shell-view.h      |    6 ------
 shell/e-shell-window.c    |    6 ++++++
 shell/e-shell-window.h    |    6 ------
 shell/e-shell.c           |    6 ++++++
 shell/e-shell.h           |    6 ------
 34 files changed, 101 insertions(+), 101 deletions(-)
---
diff --git a/e-util/e-account-utils.c b/e-util/e-account-utils.c
index 4d169d9..4395542 100644
--- a/e-util/e-account-utils.c
+++ b/e-util/e-account-utils.c
@@ -15,6 +15,11 @@
  * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
  */
 
+/**
+ * SECTION: e-account-utils
+ * @include: e-util/e-account-utils.h
+ **/
+
 #include "e-account-utils.h"
 
 #include <gconf/gconf-client.h>
diff --git a/e-util/e-account-utils.h b/e-util/e-account-utils.h
index ca18440..f2ae8fc 100644
--- a/e-util/e-account-utils.h
+++ b/e-util/e-account-utils.h
@@ -15,11 +15,6 @@
  * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
  */
 
-/**
- * SECTION: e-account-utils
- * @include: e-util/e-account-utils.h
- **/
-
 #ifndef E_ACCOUNT_UTILS_H
 #define E_ACCOUNT_UTILS_H
 
diff --git a/e-util/e-module.c b/e-util/e-module.c
index 3919841..0ee4227 100644
--- a/e-util/e-module.c
+++ b/e-util/e-module.c
@@ -19,6 +19,11 @@
  *
  */
 
+/**
+ * SECTION: e-module
+ * @include: e-util/e-module.h
+ **/
+
 #include "e-module.h"
 
 #include <glib/gi18n.h>
diff --git a/e-util/e-module.h b/e-util/e-module.h
index 6f99fc0..dc96bb3 100644
--- a/e-util/e-module.h
+++ b/e-util/e-module.h
@@ -19,11 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-module
- * @include: e-util/e-module.h
- **/
-
 #ifndef E_MODULE_H
 #define E_MODULE_H
 
diff --git a/e-util/e-selection.c b/e-util/e-selection.c
index 8be4c0b..3561dda 100644
--- a/e-util/e-selection.c
+++ b/e-util/e-selection.c
@@ -19,6 +19,12 @@
  *
  */
 
+/**
+ * SECTION: e-selection
+ * @short_description: selection and clipboard utilities
+ * @include: e-util/e-selection.h
+ **/
+
 #include "e-selection.h"
 
 #include <string.h>
diff --git a/e-util/e-selection.h b/e-util/e-selection.h
index f179180..88ac772 100644
--- a/e-util/e-selection.h
+++ b/e-util/e-selection.h
@@ -19,12 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-selection
- * @short_description: selection and clipboard utilities
- * @include: e-util/e-selection.h
- **/
-
 #ifndef E_SELECTION_H
 #define E_SELECTION_H
 
diff --git a/e-util/e-ui-manager.c b/e-util/e-ui-manager.c
index d7c249a..4086707 100644
--- a/e-util/e-ui-manager.c
+++ b/e-util/e-ui-manager.c
@@ -16,6 +16,15 @@
  *
  */
 
+/**
+ * SECTION: e-ui-manager
+ * @short_description: construct menus and toolbars from a UI definition
+ * @include: e-util/e-ui-manager.h
+ *
+ * This is a #GtkUIManager with support for Evolution's "express" mode,
+ * which influences the parsing of UI definitions.
+ **/
+
 #include "e-ui-manager.h"
 #include "e-util-private.h"
 
diff --git a/e-util/e-ui-manager.h b/e-util/e-ui-manager.h
index f0dc02c..9b1f389 100644
--- a/e-util/e-ui-manager.h
+++ b/e-util/e-ui-manager.h
@@ -16,15 +16,6 @@
  *
  */
 
-/**
- * SECTION: e-ui-manager
- * @short_description: construct menus and toolbars from a UI definition
- * @include: e-util/e-ui-manager.h
- *
- * This is a #GtkUIManager with support for Evolution's "express" mode,
- * which influences the parsing of UI definitions.
- **/
-
 #ifndef E_UI_MANAGER_H
 #define E_UI_MANAGER_H
 
diff --git a/e-util/e-util.c b/e-util/e-util.c
index cf5c0b0..46404e6 100644
--- a/e-util/e-util.c
+++ b/e-util/e-util.c
@@ -20,6 +20,11 @@
  *
  */
 
+/**
+ * SECTION: e-util
+ * @include: e-util/e-util.h
+ **/
+
 #include <config.h>
 
 #include <stdlib.h>
diff --git a/e-util/e-util.h b/e-util/e-util.h
index dfbc6c0..887cc20 100644
--- a/e-util/e-util.h
+++ b/e-util/e-util.h
@@ -20,11 +20,6 @@
  *
  */
 
-/**
- * SECTION: e-util
- * @include: e-util/e-util.h
- **/
-
 #ifndef E_UTIL_H
 #define E_UTIL_H
 
diff --git a/mail/mail-folder-cache.c b/mail/mail-folder-cache.c
index 10a66a4..b1a332d 100644
--- a/mail/mail-folder-cache.c
+++ b/mail/mail-folder-cache.c
@@ -23,6 +23,11 @@
  *
  */
 
+/**
+ * SECTION: mail-folder-cache
+ * @short_description: Stores information about open folders
+ **/
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/mail/mail-folder-cache.h b/mail/mail-folder-cache.h
index 8a7b82e..dd3a108 100644
--- a/mail/mail-folder-cache.h
+++ b/mail/mail-folder-cache.h
@@ -31,11 +31,6 @@
 
 G_BEGIN_DECLS
 
-/**
- * SECTION: mail-folder-cache
- * @short_description: Stores information about open folders
- **/
-
 #define MAIL_TYPE_FOLDER_CACHE            mail_folder_cache_get_type()
 #define MAIL_FOLDER_CACHE(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), MAIL_TYPE_FOLDER_CACHE, MailFolderCache))
 #define MAIL_FOLDER_CACHE_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), MAIL_TYPE_FOLDER_CACHE, MailFolderCacheClass))
diff --git a/shell/e-shell-backend.c b/shell/e-shell-backend.c
index 18ebe0f..ed35471 100644
--- a/shell/e-shell-backend.c
+++ b/shell/e-shell-backend.c
@@ -21,6 +21,12 @@
  * Copyright (C) 2009 Intel Corporation
  */
 
+/**
+ * SECTION: e-shell-backend
+ * @short_description: dynamically loaded capabilities
+ * @include: shell/e-shell-backend.h
+ **/
+
 #include "e-shell-backend.h"
 
 #include <errno.h>
diff --git a/shell/e-shell-backend.h b/shell/e-shell-backend.h
index cda014e..df4abc8 100644
--- a/shell/e-shell-backend.h
+++ b/shell/e-shell-backend.h
@@ -19,12 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-shell-backend
- * @short_description: dynamically loaded capabilities
- * @include: shell/e-shell-backend.h
- **/
-
 #ifndef E_SHELL_BACKEND_H
 #define E_SHELL_BACKEND_H
 
diff --git a/shell/e-shell-content.c b/shell/e-shell-content.c
index af799ae..4c17131 100644
--- a/shell/e-shell-content.c
+++ b/shell/e-shell-content.c
@@ -19,6 +19,12 @@
  *
  */
 
+/**
+ * SECTION: e-shell-content
+ * @short_description: the right side of the main window
+ * @include: shell/e-shell-content.h
+ **/
+
 #include "e-shell-content.h"
 
 #include <glib/gi18n.h>
diff --git a/shell/e-shell-content.h b/shell/e-shell-content.h
index 3c3332b..7a85214 100644
--- a/shell/e-shell-content.h
+++ b/shell/e-shell-content.h
@@ -19,12 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-shell-content
- * @short_description: the right side of the main window
- * @include: shell/e-shell-content.h
- **/
-
 #ifndef E_SHELL_CONTENT_H
 #define E_SHELL_CONTENT_H
 
diff --git a/shell/e-shell-searchbar.c b/shell/e-shell-searchbar.c
index 4b2c2c8..0cfe16c 100644
--- a/shell/e-shell-searchbar.c
+++ b/shell/e-shell-searchbar.c
@@ -19,6 +19,12 @@
  *
  */
 
+/**
+ * SECTION: e-shell-searchbar
+ * @short_description: quick search interface
+ * @include: shell/e-shell-searchbar.h
+ **/
+
 #include "e-shell-searchbar.h"
 
 #include <config.h>
diff --git a/shell/e-shell-searchbar.h b/shell/e-shell-searchbar.h
index 23fa480..77860cd 100644
--- a/shell/e-shell-searchbar.h
+++ b/shell/e-shell-searchbar.h
@@ -19,12 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-shell-searchbar
- * @short_description: quick search interface
- * @include: shell/e-shell-searchbar.h
- **/
-
 #ifndef E_SHELL_SEARCHBAR_H
 #define E_SHELL_SEARCHBAR_H
 
diff --git a/shell/e-shell-settings.c b/shell/e-shell-settings.c
index 99e1822..7c5cac4 100644
--- a/shell/e-shell-settings.c
+++ b/shell/e-shell-settings.c
@@ -19,6 +19,12 @@
  *
  */
 
+/**
+ * SECTION: e-shell-settings
+ * @short_description: settings management
+ * @include: shell/e-shell-settings.h
+ **/
+
 #include "e-shell-settings.h"
 
 #include "e-util/gconf-bridge.h"
diff --git a/shell/e-shell-settings.h b/shell/e-shell-settings.h
index c1ac497..15aaff2 100644
--- a/shell/e-shell-settings.h
+++ b/shell/e-shell-settings.h
@@ -19,12 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-shell-settings
- * @short_description: settings management
- * @include: shell/e-shell-settings.h
- **/
-
 #ifndef E_SHELL_SETTINGS_H
 #define E_SHELL_SETTINGS_H
 
diff --git a/shell/e-shell-sidebar.c b/shell/e-shell-sidebar.c
index d293f08..edb8ba5 100644
--- a/shell/e-shell-sidebar.c
+++ b/shell/e-shell-sidebar.c
@@ -19,6 +19,12 @@
  *
  */
 
+/**
+ * SECTION: e-shell-sidebar
+ * @short_description: the left side of the main window
+ * @include: shell/e-shell-sidebar.h
+ **/
+
 #include "e-shell-sidebar.h"
 
 #include <e-util/e-binding.h>
diff --git a/shell/e-shell-sidebar.h b/shell/e-shell-sidebar.h
index 5999aa9..95f2e97 100644
--- a/shell/e-shell-sidebar.h
+++ b/shell/e-shell-sidebar.h
@@ -19,12 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-shell-sidebar
- * @short_description: the left side of the main window
- * @include: shell/e-shell-sidebar.h
- **/
-
 #ifndef E_SHELL_SIDEBAR_H
 #define E_SHELL_SIDEBAR_H
 
diff --git a/shell/e-shell-switcher.c b/shell/e-shell-switcher.c
index ad9a3c7..c12423d 100644
--- a/shell/e-shell-switcher.c
+++ b/shell/e-shell-switcher.c
@@ -19,6 +19,12 @@
  *
  */
 
+/**
+ * SECTION: e-shell-switcher
+ * @short_description: buttons for switching views
+ * @include: shell/e-shell-switcher.h
+ **/
+
 #include "e-shell-switcher.h"
 
 #include <glib/gi18n.h>
diff --git a/shell/e-shell-switcher.h b/shell/e-shell-switcher.h
index dd3eddf..b18546d 100644
--- a/shell/e-shell-switcher.h
+++ b/shell/e-shell-switcher.h
@@ -19,12 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-shell-switcher
- * @short_description: buttons for switching views
- * @include: shell/e-shell-switcher.h
- **/
-
 #ifndef E_SHELL_SWITCHER_H
 #define E_SHELL_SWITCHER_H
 
diff --git a/shell/e-shell-taskbar.c b/shell/e-shell-taskbar.c
index 2129d51..bf8dfa7 100644
--- a/shell/e-shell-taskbar.c
+++ b/shell/e-shell-taskbar.c
@@ -19,6 +19,12 @@
  *
  */
 
+/**
+ * SECTION: e-shell-taskbar
+ * @short_description: the bottom of the main window
+ * @include: shell/e-shell-taskbar.h
+ **/
+
 #include "e-shell-taskbar.h"
 
 #include <e-shell-view.h>
diff --git a/shell/e-shell-taskbar.h b/shell/e-shell-taskbar.h
index d2ebfbb..e01ec40 100644
--- a/shell/e-shell-taskbar.h
+++ b/shell/e-shell-taskbar.h
@@ -19,12 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-shell-taskbar
- * @short_description: the bottom of the main window
- * @include: shell/e-shell-taskbar.h
- **/
-
 #ifndef E_SHELL_TASKBAR_H
 #define E_SHELL_TASKBAR_H
 
diff --git a/shell/e-shell-utils.c b/shell/e-shell-utils.c
index c7b2969..4bc9c48 100644
--- a/shell/e-shell-utils.c
+++ b/shell/e-shell-utils.c
@@ -19,6 +19,12 @@
  *
  */
 
+/**
+ * SECTION: e-shell-utils
+ * @short_description: high-level utilities with shell integration
+ * @include: shell/e-shell-utils.h
+ **/
+
 #include "e-shell-utils.h"
 
 #include <glib/gi18n-lib.h>
diff --git a/shell/e-shell-utils.h b/shell/e-shell-utils.h
index e705ded..428d49a 100644
--- a/shell/e-shell-utils.h
+++ b/shell/e-shell-utils.h
@@ -19,12 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-shell-utils
- * @short_description: high-level utilities with shell integration
- * @include: shell/e-shell-utils.h
- **/
-
 #ifndef E_SHELL_UTILS_H
 #define E_SHELL_UTILS_H
 
diff --git a/shell/e-shell-view.c b/shell/e-shell-view.c
index 8b94200..6463e84 100644
--- a/shell/e-shell-view.c
+++ b/shell/e-shell-view.c
@@ -19,6 +19,12 @@
  *
  */
 
+/**
+ * SECTION: e-shell-view
+ * @short_description: views within the main window
+ * @include: shell/e-shell-view.h
+ **/
+
 #include "e-shell-view.h"
 
 #include <string.h>
diff --git a/shell/e-shell-view.h b/shell/e-shell-view.h
index d014d69..1c24556 100644
--- a/shell/e-shell-view.h
+++ b/shell/e-shell-view.h
@@ -19,12 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-shell-view
- * @short_description: views within the main window
- * @include: shell/e-shell-view.h
- **/
-
 #ifndef E_SHELL_VIEW_H
 #define E_SHELL_VIEW_H
 
diff --git a/shell/e-shell-window.c b/shell/e-shell-window.c
index 04ecc0e..d09926b 100644
--- a/shell/e-shell-window.c
+++ b/shell/e-shell-window.c
@@ -19,6 +19,12 @@
  *
  */
 
+/**
+ * SECTION: e-shell-window
+ * @short_description: the main window
+ * @include: shell/e-shell-window.h
+ **/
+
 #include "e-shell-window-private.h"
 
 #include <gconf/gconf-client.h>
diff --git a/shell/e-shell-window.h b/shell/e-shell-window.h
index 0bd7107..58401b2 100644
--- a/shell/e-shell-window.h
+++ b/shell/e-shell-window.h
@@ -19,12 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-shell-window
- * @short_description: the main window
- * @include: shell/e-shell-window.h
- **/
-
 #ifndef E_SHELL_WINDOW_H
 #define E_SHELL_WINDOW_H
 
diff --git a/shell/e-shell.c b/shell/e-shell.c
index 459ebdc..c9dfd15 100644
--- a/shell/e-shell.c
+++ b/shell/e-shell.c
@@ -19,6 +19,12 @@
  *
  */
 
+/**
+ * SECTION: e-shell
+ * @short_description: the backbone of Evolution
+ * @include: shell/e-shell.h
+ **/
+
 #include "e-shell.h"
 
 #include <glib/gi18n.h>
diff --git a/shell/e-shell.h b/shell/e-shell.h
index 5ff9abb..adc0ffd 100644
--- a/shell/e-shell.h
+++ b/shell/e-shell.h
@@ -19,12 +19,6 @@
  *
  */
 
-/**
- * SECTION: e-shell
- * @short_description: the backbone of Evolution
- * @include: shell/e-shell.h
- **/
-
 #ifndef E_SHELL_H
 #define E_SHELL_H
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]