# HG changeset patch
# User nenolod
# Date 1165226208 28800
# Node ID 5cf8de9f2c283879445e615c26e8135b9ab84cf1
# Parent  7bc2489db782ad052c71725e4a530aca102b68a6
[svn] - document ConfigDB.

diff -r 7bc2489db782 -r 5cf8de9f2c28 ChangeLog
--- a/ChangeLog	Mon Dec 04 01:46:09 2006 -0800
+++ b/ChangeLog	Mon Dec 04 01:56:48 2006 -0800
@@ -1,3 +1,10 @@
+2006-12-04 09:46:09 +0000  Daniel Bradshaw <nazca@atheme.org>
+  revision [3099]
+  Numpad 4 and 6 liked to prev and next respectively to be more consistant with the main window
+  trunk/audacious/ui_playlist.c |    6 ++++++
+  1 file changed, 6 insertions(+)
+
+
 2006-12-04 09:44:20 +0000  William Pitcock <nenolod@nenolod.net>
   revision [3097]
   - remove xml_document.c
diff -r 7bc2489db782 -r 5cf8de9f2c28 doc/libaudacious/tmpl/configdb.sgml
--- a/doc/libaudacious/tmpl/configdb.sgml	Mon Dec 04 01:46:09 2006 -0800
+++ b/doc/libaudacious/tmpl/configdb.sgml	Mon Dec 04 01:56:48 2006 -0800
@@ -1,8 +1,8 @@
 <!-- ##### SECTION Title ##### -->
-configdb
+ConfigDB
 
 <!-- ##### SECTION Short_Description ##### -->
-
+The audacious configuration database.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff -r 7bc2489db782 -r 5cf8de9f2c28 doc/libaudacious/tmpl/libaudacious-unused.sgml
--- a/doc/libaudacious/tmpl/libaudacious-unused.sgml	Mon Dec 04 01:46:09 2006 -0800
+++ b/doc/libaudacious/tmpl/libaudacious-unused.sgml	Mon Dec 04 01:56:48 2006 -0800
@@ -1,3 +1,27 @@
+<!-- ##### SECTION ./tmpl/xml_document.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xml_document.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xml_document.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xml_document.sgml:Stability_Level ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xml_document.sgml:Title ##### -->
+xml_document
+
+
 <!-- ##### STRUCT XmmsEntry ##### -->
 <para>
 
diff -r 7bc2489db782 -r 5cf8de9f2c28 libaudacious/configdb.h
--- a/libaudacious/configdb.h	Mon Dec 04 01:46:09 2006 -0800
+++ b/libaudacious/configdb.h	Mon Dec 04 01:56:48 2006 -0800
@@ -9,51 +9,181 @@
 
 G_BEGIN_DECLS
 
+    /**
+     * bmp_cfg_db_open:
+     *
+     * Opens the configuration database.
+     *
+     * Return value: A configuration database handle.
+     **/
     ConfigDb *bmp_cfg_db_open();
+
+    /**
+     * bmp_cfg_db_close:
+     * @db: A configuration database handle.
+     *
+     * Closes the configuration database.
+     **/
     void bmp_cfg_db_close(ConfigDb *db);
 
+    /**
+     * bmp_cfg_db_get_string:
+     * @db: A configuration database handle.
+     * @section: The section of the configuration database to search.
+     * @key: The name of the field in the configuration database to look up.
+     * @value: Pointer to a buffer to put the data in.
+     *
+     * Searches the configuration database for a value.
+     *
+     * Return value: TRUE if successful, FALSE otherwise.
+     **/
     gboolean bmp_cfg_db_get_string(ConfigDb *db,
                                    const gchar *section,
                                    const gchar *key,
                                    gchar **value);
+
+    /**
+     * bmp_cfg_db_get_int:
+     * @db: A configuration database handle.
+     * @section: The section of the configuration database to search.
+     * @key: The name of the field in the configuration database to look up.
+     * @value: Pointer to an integer to put the data in.
+     *
+     * Searches the configuration database for a value.
+     *
+     * Return value: TRUE if successful, FALSE otherwise.
+     **/
     gboolean bmp_cfg_db_get_int(ConfigDb *db,
                                 const gchar *section,
                                 const gchar *key,
                                 gint *value);
+
+    /**
+     * bmp_cfg_db_get_bool:
+     * @db: A configuration database handle.
+     * @section: The section of the configuration database to search.
+     * @key: The name of the field in the configuration database to look up.
+     * @value: Pointer to a boolean to put the data in.
+     *
+     * Searches the configuration database for a value.
+     *
+     * Return value: TRUE if successful, FALSE otherwise.
+     **/
     gboolean bmp_cfg_db_get_bool(ConfigDb *db,
                                  const gchar *section,
                                  const gchar *key,
                                  gboolean *value);
+
+    /**
+     * bmp_cfg_db_get_float:
+     * @db: A configuration database handle.
+     * @section: The section of the configuration database to search.
+     * @key: The name of the field in the configuration database to look up.
+     * @value: Pointer to a floating point integer to put the data in.
+     *
+     * Searches the configuration database for a value.
+     *
+     * Return value: TRUE if successful, FALSE otherwise.
+     **/
     gboolean bmp_cfg_db_get_float(ConfigDb *db,
                                   const gchar *section,
                                   const gchar *key,
                                   gfloat *value);
+
+    /**
+     * bmp_cfg_db_get_double:
+     * @db: A configuration database handle.
+     * @section: The section of the configuration database to search.
+     * @key: The name of the field in the configuration database to look up.
+     * @value: Pointer to a double-precision floating point integer to put the data in.
+     *
+     * Searches the configuration database for a value.
+     *
+     * Return value: TRUE if successful, FALSE otherwise.
+     **/
     gboolean bmp_cfg_db_get_double(ConfigDb *db,
                                    const gchar *section,
                                    const gchar *key,
                                    gdouble *value);
 
+    /**
+     * bmp_cfg_db_set_string:
+     * @db: A configuration database handle.
+     * @section: The section of the configuration database to search.
+     * @key: The name of the field in the configuration database to set.
+     * @value: Pointer to a buffer containing the data.
+     *
+     * Sets a value in the configuration database.
+     **/
     void bmp_cfg_db_set_string(ConfigDb *db,
                                const gchar *section,
                                const gchar *key,
                                gchar *value);
+
+    /**
+     * bmp_cfg_db_set_int:
+     * @db: A configuration database handle.
+     * @section: The section of the configuration database to search.
+     * @key: The name of the field in the configuration database to set.
+     * @value: Pointer to an integer containing the data.
+     *
+     * Sets a value in the configuration database.
+     **/
     void bmp_cfg_db_set_int(ConfigDb *db,
                             const gchar *section,
                             const gchar *key,
                             gint value);
+
+    /**
+     * bmp_cfg_db_set_bool:
+     * @db: A configuration database handle.
+     * @section: The section of the configuration database to search.
+     * @key: The name of the field in the configuration database to set.
+     * @value: Pointer to a boolean containing the data.
+     *
+     * Sets a value in the configuration database.
+     **/
     void bmp_cfg_db_set_bool(ConfigDb *db,
                              const gchar *section,
                              const gchar *key,
                              gboolean value);
+
+    /**
+     * bmp_cfg_db_set_float:
+     * @db: A configuration database handle.
+     * @section: The section of the configuration database to search.
+     * @key: The name of the field in the configuration database to set.
+     * @value: Pointer to a floating point integer containing the data.
+     *
+     * Sets a value in the configuration database.
+     **/
     void bmp_cfg_db_set_float(ConfigDb *db,
                               const gchar *section,
                               const gchar *key,
                               gfloat value);
+
+    /**
+     * bmp_cfg_db_set_double:
+     * @db: A configuration database handle.
+     * @section: The section of the configuration database to search.
+     * @key: The name of the field in the configuration database to set.
+     * @value: Pointer to a double precision floating point integer containing the data.
+     *
+     * Sets a value in the configuration database.
+     **/
     void bmp_cfg_db_set_double(ConfigDb *db,
                                const gchar *section,
                                const gchar *key,
                                gdouble value);
 
+    /**
+     * bmp_cfg_db_unset_key:
+     * @db: A configuration database handle.
+     * @section: The section of the configuration database to search.
+     * @key: The name of the field in the configuration database to set.
+     *
+     * Removes a value from the configuration database.
+     **/
     void bmp_cfg_db_unset_key(ConfigDb *db,
                               const gchar *section,
                               const gchar *key);