Move "section" documentation out of header files.

34 files changed, 101 insertions, 101 deletions

diff --git a/e-util/e-account-utils.c b/e-util/e-account-utils.c
index 4d169d956a..4395542f7c 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 ca184404ef..f2ae8fc5dc 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 3919841910..0ee4227823 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 6f99fc0515..dc96bb34d9 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 8be4c0b55a..3561dda636 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 f179180cd9..88ac772bae 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 d7c249af06..4086707e81 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 f0dc02c2cc..9b1f389d76 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 cf5c0b0464..46404e6ed6 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 dfbc6c0746..887cc20ce2 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 10a66a4f47..b1a332d4f4 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 8a7b82eada..dd3a108d03 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 18ebe0f8d8..ed354712d3 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 cda014e5a9..df4abc8104 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 af799ae8e2..4c17131d52 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 3c3332b17b..7a852145e4 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 4b2c2c8f76..0cfe16ca64 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 23fa480a86..77860cdfdb 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 99e1822e68..7c5cac4e53 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 c1ac497dec..15aaff2071 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 d293f08aca..edb8ba5299 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 5999aa9de2..95f2e97dad 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 ad9a3c776a..c12423de99 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 dd3eddf970..b18546d58f 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 2129d518be..bf8dfa7e2a 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 d2ebfbb0c4..e01ec40989 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 c7b296931c..4bc9c480cb 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 e705ded2e5..428d49a836 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 8b94200e98..6463e847d4 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 d014d694ce..1c24556b8f 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 04ecc0ea98..d09926b355 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 0bd71075c9..58401b2dba 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 459ebdc64a..c9dfd156e6 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 5ff9abb77d..adc0ffd126 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