[Gnucash-changes] Reorganize where files appear in doxygen output.

David Hampton hampton at cvs.gnucash.org
Sat Jul 23 00:18:44 EDT 2005


Log Message:
-----------
Reorganize where files appear in doxygen output.  A couple of
copyright updates.

Tags:
----
gnucash-gnome2-dev

Modified Files:
--------------
    gnucash:
        ChangeLog
    gnucash/src:
        gnc-ui.h
    gnucash/src/business/business-gnome:
        gnc-plugin-page-invoice.c
        gnc-plugin-page-invoice.h
    gnucash/src/core-utils:
        gnc-gconf-utils.h
    gnucash/src/gnome:
        gnc-plugin-page-account-tree.h
        gnc-plugin-page-register.h
    gnucash/src/gnome-utils:
        dialog-preferences.c
        dialog-preferences.h
        druid-gconf-setup.c
        druid-gconf-setup.h
        gnc-embedded-window.h
        gnc-main-window.c
        gnc-main-window.h
        gnc-plugin-file-history.c
        gnc-plugin-file-history.h
        gnc-plugin-manager.h
        gnc-plugin-menu-additions.c
        gnc-plugin-menu-additions.h
        gnc-plugin-page.c
        gnc-plugin-page.h
        gnc-plugin.c
        gnc-plugin.h
        gnc-window.h

Revision Data
-------------
Index: ChangeLog
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/ChangeLog,v
retrieving revision 1.1487.2.245
retrieving revision 1.1487.2.246
diff -LChangeLog -LChangeLog -u -r1.1487.2.245 -r1.1487.2.246
--- ChangeLog
+++ ChangeLog
@@ -1,7 +1,19 @@
+2005-07-23  David Hampton  <hampton at employees.org>
+
+	* various file: Reorganize where these files appear in doxygen
+	output.
+
 2005-07-22  David Hampton  <hampton at employees.org>
 
+	* numerous business file: Migrate the business preferences over to
+	the new preferences dialog.
+
+	* src/gnome-utils/dialog-preferences.[ch]: Rework the widget
+	lookup code to handle widgets from multiple glade files.
+	Documentation.
+
 	* numerous file: Begin migrating preferences over to the new
-	dialog.
+	preferences dialog.
 
 	* src/gnome-utils/Makefile.am:
 	* src/gnome-utils/dialog-preferences.[ch]:
Index: gnc-plugin-page-invoice.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/business/business-gnome/Attic/gnc-plugin-page-invoice.h,v
retrieving revision 1.1.2.1
retrieving revision 1.1.2.2
diff -Lsrc/business/business-gnome/gnc-plugin-page-invoice.h -Lsrc/business/business-gnome/gnc-plugin-page-invoice.h -u -r1.1.2.1 -r1.1.2.2
--- src/business/business-gnome/gnc-plugin-page-invoice.h
+++ src/business/business-gnome/gnc-plugin-page-invoice.h
@@ -1,8 +1,7 @@
 /* 
  * gnc-plugin-page-invoice.h -- 
  *
- * Copyright (C) 2003 Jan Arne Petersen <jpetersen at uni-bonn.de>
- * Copyright (C) 2003 David Hampton <hampton at employees.org>
+ * Copyright (C) 2005 David Hampton <hampton at employees.org>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License as
@@ -22,14 +21,13 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup ContentPlugins
     @{ */
-/** @addtogroup GuiUtility
+/** @addtogroup InvoicePlugin Business Invoice Page
     @{ */
 /** @file gnc-plugin-register-tree.h 
     @brief  utility functions for the GnuCash UI
-    @author Copyright (C) 2003 Jan Arne Petersen <jpetersen at uni-bonn.de>
-    @author Copyright (C) 2003 David Hampton <hampton at employees.org>
+    @author Copyright (C) 2005 David Hampton <hampton at employees.org>
 */
 
 #ifndef __GNC_PLUGIN_PAGE_INVOICE_H
Index: gnc-plugin-page-invoice.c
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/business/business-gnome/Attic/gnc-plugin-page-invoice.c,v
retrieving revision 1.1.2.3
retrieving revision 1.1.2.4
diff -Lsrc/business/business-gnome/gnc-plugin-page-invoice.c -Lsrc/business/business-gnome/gnc-plugin-page-invoice.c -u -r1.1.2.3 -r1.1.2.4
--- src/business/business-gnome/gnc-plugin-page-invoice.c
+++ src/business/business-gnome/gnc-plugin-page-invoice.c
@@ -1,8 +1,7 @@
 /* 
  * gnc-plugin-page-invoice.c -- 
  *
- * Copyright (C) 2003 Jan Arne Petersen <jpetersen at uni-bonn.de>
- * Copyright (C) 2003 David Hampton <hampton at employees.org>
+ * Copyright (C) 2005 David Hampton <hampton at employees.org>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License as
Index: gnc-gconf-utils.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/core-utils/Attic/gnc-gconf-utils.h,v
retrieving revision 1.1.2.9
retrieving revision 1.1.2.10
diff -Lsrc/core-utils/gnc-gconf-utils.h -Lsrc/core-utils/gnc-gconf-utils.h -u -r1.1.2.9 -r1.1.2.10
--- src/core-utils/gnc-gconf-utils.h
+++ src/core-utils/gnc-gconf-utils.h
@@ -24,7 +24,7 @@
 
 /** @addtogroup GLib
     @{ */
-/** @addtogroup GConf
+/** @addtogroup GConf GConf Utilities
 
     The API in this file is designed to make it easy to use the GConf
     system from within Gnucash.  GConf is a shared key/value storage
Index: gnc-plugin-page-register.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome/Attic/gnc-plugin-page-register.h,v
retrieving revision 1.1.2.11
retrieving revision 1.1.2.12
diff -Lsrc/gnome/gnc-plugin-page-register.h -Lsrc/gnome/gnc-plugin-page-register.h -u -r1.1.2.11 -r1.1.2.12
--- src/gnome/gnc-plugin-page-register.h
+++ src/gnome/gnc-plugin-page-register.h
@@ -22,9 +22,9 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup ContentPlugins
     @{ */
-/** @addtogroup GuiUtility
+/** @addtogroup RegisterPlugin Register Page
     @{ */
 /** @file gnc-plugin-register-tree.h 
     @brief  utility functions for the GnuCash UI
Index: gnc-plugin-page-account-tree.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome/Attic/gnc-plugin-page-account-tree.h,v
retrieving revision 1.1.2.6
retrieving revision 1.1.2.7
diff -Lsrc/gnome/gnc-plugin-page-account-tree.h -Lsrc/gnome/gnc-plugin-page-account-tree.h -u -r1.1.2.6 -r1.1.2.7
--- src/gnome/gnc-plugin-page-account-tree.h
+++ src/gnome/gnc-plugin-page-account-tree.h
@@ -22,9 +22,9 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup ContentPlugins
     @{ */
-/** @addtogroup GuiUtility
+/** @addtogroup GncPluginPageAccountTree An Account Tree Plugin
     @{ */
 /** @file gnc-plugin-page-account-tree.h 
     @brief  utility functions for the GnuCash UI
Index: gnc-ui.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnc-ui.h,v
retrieving revision 1.30.4.10
retrieving revision 1.30.4.11
diff -Lsrc/gnc-ui.h -Lsrc/gnc-ui.h -u -r1.30.4.10 -r1.30.4.11
--- src/gnc-ui.h
+++ src/gnc-ui.h
@@ -18,6 +18,16 @@
  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.        *
 \********************************************************************/
 
+
+/** @addtogroup GUI
+    @{ */
+
+/** @defgroup Dialogs Dialogs */
+/** @defgroup Druids Druids */
+
+/** @} */
+
+
 #ifndef GNC_UI_H
 #define GNC_UI_H
 
Index: gnc-plugin-page.c
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-plugin-page.c,v
retrieving revision 1.1.2.5
retrieving revision 1.1.2.6
diff -Lsrc/gnome-utils/gnc-plugin-page.c -Lsrc/gnome-utils/gnc-plugin-page.c -u -r1.1.2.5 -r1.1.2.6
--- src/gnome-utils/gnc-plugin-page.c
+++ src/gnome-utils/gnc-plugin-page.c
@@ -1,8 +1,7 @@
 /* 
  * gnc-plugin_page.c -- 
  *
- * Copyright (C) 2003 Jan Arne Petersen
- * Author: Jan Arne Petersen <jpetersen at uni-bonn.de>
+ * Copyright (C) 2003 Jan Arne Petersen <jpetersen at uni-bonn.de>
  * Copyright (C) 2003,2005 David Hampton <hampton at employees.org>
  *
  * This program is free software; you can redistribute it and/or
@@ -23,6 +22,16 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
+/** @addtogroup ContentPlugins
+    @{ */
+/** @addtogroup ContentPluginBase Common object and functions
+    @{ */
+/** @file gnc-plugin-page.h
+    @brief Functions for adding plugins to a Gnucash window.
+    @author Copyright (C) 2003 Jan Arne Petersen
+    @author Copyright (C) 2003,2005 David Hampton <hampton at employees.org>
+*/
+
 #include "config.h"
 
 #include <gtk/gtk.h>
@@ -441,3 +450,6 @@
 
   page->priv->use_new_window = use_new;
 }
+
+/** @} */
+/** @} */
Index: gnc-plugin-file-history.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-plugin-file-history.h,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -Lsrc/gnome-utils/gnc-plugin-file-history.h -Lsrc/gnome-utils/gnc-plugin-file-history.h -u -r1.1.2.2 -r1.1.2.3
--- src/gnome-utils/gnc-plugin-file-history.h
+++ src/gnome-utils/gnc-plugin-file-history.h
@@ -20,9 +20,9 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup MenuPlugins
     @{ */
-/** @addtogroup GuiImport Import GUI Utility functions.
+/** @addtogroup PluginFileHistory File History Menu Items
     @{ */
 /** @file gnc-plugin-file-history.h
     @brief Utility functions for writing import modules.
Index: gnc-plugin-menu-additions.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-plugin-menu-additions.h,v
retrieving revision 1.1.2.1
retrieving revision 1.1.2.2
diff -Lsrc/gnome-utils/gnc-plugin-menu-additions.h -Lsrc/gnome-utils/gnc-plugin-menu-additions.h -u -r1.1.2.1 -r1.1.2.2
--- src/gnome-utils/gnc-plugin-menu-additions.h
+++ src/gnome-utils/gnc-plugin-menu-additions.h
@@ -20,9 +20,9 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup MenuPlugins
     @{ */
-/** @addtogroup GuiImport Import GUI Utility functions.
+/** @addtogroup PluginMenuAdditions Non-GtkAction Menu Support
     @{ */
 /** @file gnc-plugin-menu-additions.h
     @brief Utility functions for writing import modules.
Index: gnc-plugin.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-plugin.h,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -Lsrc/gnome-utils/gnc-plugin.h -Lsrc/gnome-utils/gnc-plugin.h -u -r1.1.2.2 -r1.1.2.3
--- src/gnome-utils/gnc-plugin.h
+++ src/gnome-utils/gnc-plugin.h
@@ -1,8 +1,8 @@
 /* 
  * gnc-plugin.h -- A module or plugin which can add more
  *	functionality to gnucash.
- * Copyright (C) 2003 Jan Arne Petersen
- * Author: Jan Arne Petersen <jpetersen at uni-bonn.de>
+ * Copyright (C) 2003 Jan Arne Petersen <jpetersen at uni-bonn.de>
+ * Copyright (C) 2003,2005 David Hampton <hampton at employees.org>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License as
@@ -24,11 +24,43 @@
 
 /** @addtogroup GUI
     @{ */
-/** @addtogroup Wwindow plugin functions.
+
+/** @defgroup WindowsAndPlugin Window/Plugin Structure
+ @{ */
+
+/**
+    @addtogroup Windows Windows
+    @ingroup WindowsAndPlugin
+*/
+
+/**
+    @addtogroup Plugins Plugins
+    @ingroup WindowsAndPlugin
+ @{
+*/
+
+/**
+    @addtogroup MenuPlugins Menu Only Plugins
+    @ingroup Plugins
+*/
+
+/**
+    @addtogroup ContentPlugins Content Plugins
+    @ingroup Plugins
+*/
+
+/** @} */
+/** @} */
+/** @} */
+
+/** @addtogroup MenuPlugins
+    @{ */
+/** @addtogroup MenuPluginBase Common object and functions
     @{ */
 /** @file gnc-plugin.h
     @brief Functions for adding plugins to a Gnucash window.
-    @author Copyright (C) 2002 David Hampton <hampton at employees.org>
+    @author Copyright (C) 2003 Jan Arne Petersen
+    @author Copyright (C) 2003,2005 David Hampton <hampton at employees.org>
 */
 
 #ifndef __GNC_PLUGIN_H
Index: gnc-plugin.c
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-plugin.c,v
retrieving revision 1.1.2.3
retrieving revision 1.1.2.4
diff -Lsrc/gnome-utils/gnc-plugin.c -Lsrc/gnome-utils/gnc-plugin.c -u -r1.1.2.3 -r1.1.2.4
--- src/gnome-utils/gnc-plugin.c
+++ src/gnome-utils/gnc-plugin.c
@@ -1,8 +1,8 @@
 /* 
  * gnc-plugin.c -- 
  *
- * Copyright (C) 2003 Jan Arne Petersen
- * Author: Jan Arne Petersen <jpetersen at uni-bonn.de>
+ * Copyright (C) 2003 Jan Arne Petersen <jpetersen at uni-bonn.de>
+ * Copyright (C) 2003,2005 David Hampton <hampton at employees.org>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License as
@@ -22,6 +22,16 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
+/** @addtogroup MenuPlugins
+    @{ */
+/** @addtogroup MenuPluginBase Common object and functions
+    @{ */
+/** @file gnc-plugin.h
+    @brief Functions for adding plugins to a Gnucash window.
+    @author Copyright (C) 2003 Jan Arne Petersen <jpetersen at uni-bonn.de>
+    @author Copyright (C) 2003,2005 David Hampton <hampton at employees.org>
+*/
+
 #include "config.h"
 
 #include "gnc-plugin.h"
Index: dialog-preferences.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/dialog-preferences.h,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -Lsrc/gnome-utils/dialog-preferences.h -Lsrc/gnome-utils/dialog-preferences.h -u -r1.1.2.2 -r1.1.2.3
--- src/gnome-utils/dialog-preferences.h
+++ src/gnome-utils/dialog-preferences.h
@@ -20,9 +20,9 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup Dialogs
     @{ */
-/** @addtogroup Dialog Preferences Dialog
+/** @addtogroup PrefDialog Preferences Dialog
     @{ */
 /** @file dialog-preferences.h
     @brief Dialog for handling user preferences.
Index: gnc-embedded-window.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-embedded-window.h,v
retrieving revision 1.1.2.1
retrieving revision 1.1.2.2
diff -Lsrc/gnome-utils/gnc-embedded-window.h -Lsrc/gnome-utils/gnc-embedded-window.h -u -r1.1.2.1 -r1.1.2.2
--- src/gnome-utils/gnc-embedded-window.h
+++ src/gnome-utils/gnc-embedded-window.h
@@ -2,8 +2,8 @@
  * gnc-embedded-window.h -- GtkWindow which represents an
  *	emvedded GnuCash window.
  *
- * Copyright (C) 2003 Jan Arne Petersen
- * Author: Jan Arne Petersen <jpetersen at uni-bonn.de>
+ * Copyright (C) 2003 Jan Arne Petersen <jpetersen at uni-bonn.de>
+ * Copyright (C) 2003 David Hampton <hampton at employees.org>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License as
@@ -23,6 +23,16 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
+/** @addtogroup Windows
+    @{ */
+/** @addtogroup GncEmbeddedWindow Embedded Window Functions
+    @{ */
+/** @file gnc-embedded-window.h
+    @brief Functions that are supported by all types of windows.
+    @author Copyright (C) 2003 Jan Arne Petersen
+    @author Copyright (C) 2003 David Hampton <hampton at employees.org>
+*/
+
 #ifndef __GNC_EMBEDDED_WINDOW_H
 #define __GNC_EMBEDDED_WINDOW_H
 
@@ -85,3 +95,6 @@
 G_END_DECLS
 
 #endif /* __GNC_EMBEDDED_WINDOW_H */
+
+/** @} */
+/** @} */
Index: gnc-window.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-window.h,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -Lsrc/gnome-utils/gnc-window.h -Lsrc/gnome-utils/gnc-window.h -u -r1.1.2.2 -r1.1.2.3
--- src/gnome-utils/gnc-window.h
+++ src/gnome-utils/gnc-window.h
@@ -22,6 +22,22 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
+/** @addtogroup Windows
+    @{ */
+/** @addtogroup GncWindow Basic Window Functions
+    @{ */
+/** @file gnc-window.h
+    @brief Functions that are supported by all types of windows.
+    @author Copyright (C) 2003 Jan Arne Petersen
+    @author Copyright (C) 2003 David Hampton <hampton at employees.org>
+
+    GnuCash has two types of "windows" that can show Plugin Pages.
+    The first is called a "Main Window" and is implemented on top of a
+    GtkWindow.  The second is called an "Embedded Window" and is
+    implemented on top of a GtkVBox.  The functions in this file will
+    work with either type of window.
+*/
+
 #ifndef __GNC_WINDOW_H
 #define __GNC_WINDOW_H
 
@@ -62,3 +78,6 @@
 G_END_DECLS
 
 #endif /* __GNC_WINDOW_H */
+
+/** @} */
+/** @} */
Index: druid-gconf-setup.c
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/druid-gconf-setup.c,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -Lsrc/gnome-utils/druid-gconf-setup.c -Lsrc/gnome-utils/druid-gconf-setup.c -u -r1.1.2.2 -r1.1.2.3
--- src/gnome-utils/druid-gconf-setup.c
+++ src/gnome-utils/druid-gconf-setup.c
@@ -21,9 +21,9 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup Druids
     @{ */
-/** @addtogroup GConf Setup Druid
+/** @addtogroup GConfDruid Setup Druid for GConf
     @{ */
 /** @file druid-gconf-setup.c
     @brief Check for gconf.  Help user set up if needed.
Index: gnc-main-window.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-main-window.h,v
retrieving revision 1.1.2.5
retrieving revision 1.1.2.6
diff -Lsrc/gnome-utils/gnc-main-window.h -Lsrc/gnome-utils/gnc-main-window.h -u -r1.1.2.5 -r1.1.2.6
--- src/gnome-utils/gnc-main-window.h
+++ src/gnome-utils/gnc-main-window.h
@@ -23,12 +23,13 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup Windows
     @{ */
-/** @addtogroup GuiWindow Main Window functions.
+/** @addtogroup GncMainWindow Main Window functions.
     @{ */
 /** @file gnc-main-window.h
     @brief Functions for adding content to a window.
+    @author Copyright (C) 2003 Jan Arne Petersen <jpetersen at uni-bonn.de>
     @author Copyright (C) 2003,2005 David Hampton <hampton at employees.org>
 */
 
Index: druid-gconf-setup.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/druid-gconf-setup.h,v
retrieving revision 1.1.2.1
retrieving revision 1.1.2.2
diff -Lsrc/gnome-utils/druid-gconf-setup.h -Lsrc/gnome-utils/druid-gconf-setup.h -u -r1.1.2.1 -r1.1.2.2
--- src/gnome-utils/druid-gconf-setup.h
+++ src/gnome-utils/druid-gconf-setup.h
@@ -21,11 +21,11 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup Druids
     @{ */
-/** @addtogroup GConf Setup Druid
+/** @addtogroup GConfDruid Setup Druid for GConf
     @{ */
-/** @file druid-gconf-setup.c
+/** @file druid-gconf-setup.h
     @brief Check for gconf.  Help user set up if needed.
     @author Copyright (C) 2005 David Hampton <hampton at employees.org>
 */
Index: gnc-main-window.c
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-main-window.c,v
retrieving revision 1.1.2.15
retrieving revision 1.1.2.16
diff -Lsrc/gnome-utils/gnc-main-window.c -Lsrc/gnome-utils/gnc-main-window.c -u -r1.1.2.15 -r1.1.2.16
--- src/gnome-utils/gnc-main-window.c
+++ src/gnome-utils/gnc-main-window.c
@@ -23,6 +23,16 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
+/** @addtogroup Windows
+    @{ */
+/** @addtogroup GncMainWindow Main Window functions.
+    @{ */
+/** @file gnc-main-window.h
+    @brief Functions for adding content to a window.
+    @author Copyright (C) 2003 Jan Arne Petersen <jpetersen at uni-bonn.de>
+    @author Copyright (C) 2003,2005 David Hampton <hampton at employees.org>
+*/
+
 #include "config.h"
 
 #include <gdk/gdkpixbuf.h>
@@ -298,6 +308,8 @@
 /** Look through the list of pages installed in this window and see if
  *  the specified page is there.
  *
+ *  @internal
+ *
  *  @param page The page to search for.
  *
  *  @return TRUE if the page is present in the window, FALSE otherwise.
@@ -321,6 +333,8 @@
 /** This function prompts the user to save the file with a dialog that
  *  follows the HIG guidelines.
  *
+ *  @internal
+ *
  *  @returns This function returns TRUE if the user clicked the Cancel
  *  button.  It returns FALSE if the closing of the window should
  *  continue.
@@ -454,15 +468,17 @@
  *  book.  It closes any page it finds so there are no dangling
  *  references to the book.
  *
+ *  @internal
+ *
  *  @param entity     The guid the item being added, deleted, etc.
  *
- * @param type        The type of the item being added, deleted, etc. This
+ *  @param type       The type of the item being added, deleted, etc. This
  *                    function only cares about a type of GNC_ID_BOOK.
  *
- * @param event_type  The type of the event.  This function only cares
+ *  @param event_type The type of the event.  This function only cares
  *                    about an event type of GNC_EVENT_DESTROY.
  *
- * @param user_data   A pointer to the window data structure.
+ *  @param user_data  A pointer to the window data structure.
  */
 static void
 gnc_main_window_event_handler (GUID *entity, QofIdType type,
@@ -1935,3 +1951,6 @@
   gncwin = GNC_WINDOW(window);
   gnc_window_set_progressbar_window(gncwin);
 }
+
+/** @} */
+/** @} */
Index: dialog-preferences.c
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/dialog-preferences.c,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -Lsrc/gnome-utils/dialog-preferences.c -Lsrc/gnome-utils/dialog-preferences.c -u -r1.1.2.2 -r1.1.2.3
--- src/gnome-utils/dialog-preferences.c
+++ src/gnome-utils/dialog-preferences.c
@@ -20,9 +20,9 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup Dialogs
     @{ */
-/** @addtogroup Preferences Dialog
+/** @addtogroup PrefDialog Preferences Dialog
     @{ */
 /** @file dialog-preferences.c
     @brief Dialog for handling user preferences.
Index: gnc-plugin-file-history.c
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-plugin-file-history.c,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -Lsrc/gnome-utils/gnc-plugin-file-history.c -Lsrc/gnome-utils/gnc-plugin-file-history.c -u -r1.1.2.2 -r1.1.2.3
--- src/gnome-utils/gnc-plugin-file-history.c
+++ src/gnome-utils/gnc-plugin-file-history.c
@@ -1,6 +1,6 @@
 /* 
  * gnc-plugin-file-history.c -- 
- * Copyright (C) 2003,2005 David Hampton hampton at employees.org>
+ * Copyright (C) 2003,2005 David Hampton <hampton at employees.org>
  *
  * This program is free software; you can redistribute it and/or
  * modify it under the terms of the GNU General Public License as
@@ -20,9 +20,9 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup MenuPlugins
     @{ */
-/** @addtogroup GuiImport Import GUI Utility functions.
+/** @addtogroup PluginFileHistory File History Menu Items
     @{ */
 /** @internal
     @file gnc-plugin-file-history.c
Index: gnc-plugin-manager.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-plugin-manager.h,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -Lsrc/gnome-utils/gnc-plugin-manager.h -Lsrc/gnome-utils/gnc-plugin-manager.h -u -r1.1.2.2 -r1.1.2.3
--- src/gnome-utils/gnc-plugin-manager.h
+++ src/gnome-utils/gnc-plugin-manager.h
@@ -22,11 +22,9 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup Plugins
     @{ */
-/** @addtogroup Plugin Architecture
-    @{ */
-/** @addtogroup Plugin Manger
+/** @addtogroup PluginManager Plugin Management Functions
     @{ */
 /** @file gnc-plugin-manager.h 
     @brief  Plugin management functions for the GnuCash UI
@@ -165,4 +163,3 @@
 
 /** @} */
 /** @} */
-/** @} */
Index: gnc-plugin-menu-additions.c
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-plugin-menu-additions.c,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -Lsrc/gnome-utils/gnc-plugin-menu-additions.c -Lsrc/gnome-utils/gnc-plugin-menu-additions.c -u -r1.1.2.2 -r1.1.2.3
--- src/gnome-utils/gnc-plugin-menu-additions.c
+++ src/gnome-utils/gnc-plugin-menu-additions.c
@@ -24,9 +24,9 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
-/** @addtogroup GUI
+/** @addtogroup MenuPlugins
     @{ */
-/** @addtogroup GuiImport Import GUI Utility functions.
+/** @addtogroup PluginMenuAdditions Non-GtkAction Menu Support
     @{ */
 /** @internal
     @file gnc-plugin-menu-additions.c
Index: gnc-plugin-page.h
===================================================================
RCS file: /home/cvs/cvsroot/gnucash/src/gnome-utils/Attic/gnc-plugin-page.h,v
retrieving revision 1.1.2.4
retrieving revision 1.1.2.5
diff -Lsrc/gnome-utils/gnc-plugin-page.h -Lsrc/gnome-utils/gnc-plugin-page.h -u -r1.1.2.4 -r1.1.2.5
--- src/gnome-utils/gnc-plugin-page.h
+++ src/gnome-utils/gnc-plugin-page.h
@@ -23,6 +23,16 @@
  * Boston, MA  02111-1307,  USA       gnu at gnu.org
  */
 
+/** @addtogroup ContentPlugins
+    @{ */
+/** @addtogroup ContentPluginBase Common object and functions
+    @{ */
+/** @file gnc-plugin-page.h
+    @brief Functions for adding plugins to a Gnucash window.
+    @author Copyright (C) 2003 Jan Arne Petersen
+    @author Copyright (C) 2003,2005 David Hampton <hampton at employees.org>
+*/
+
 #ifndef __GNC_PLUGIN_PAGE_H
 #define __GNC_PLUGIN_PAGE_H
 
@@ -222,3 +232,5 @@
 G_END_DECLS
 
 #endif /* __GNC_PLUGIN_PAGE_H */
+/** @} */
+/** @} */


More information about the gnucash-changes mailing list