From: Andre Noll <maan@systemlinux.org>
Date: Mon, 29 Jan 2007 22:59:09 +0000 (+0100)
Subject: clarify documentation of mysql_selector_init()
X-Git-Tag: v0.2.15~53
X-Git-Url: http://git.tue.mpg.de/?a=commitdiff_plain;h=37dd76b70c9ca6459c483653c1a1d1cc9f32237c;p=paraslash.git

clarify documentation of mysql_selector_init()
---

diff --git a/mysql_selector.c b/mysql_selector.c
index 91972e84..0eb19bc5 100644
--- a/mysql_selector.c
+++ b/mysql_selector.c
@@ -2152,8 +2152,15 @@ static void shutdown_connection(void)
 /**
  * the init function of the mysql-based audio file selector
  *
- * Check the command line options and initialize all function pointers of \a db.
- * Connect to the mysql server and initialize the info string.
+ * \param db pointer to the struct to initialize
+ *
+ * Check the command line options and initialize all function pointers of \a
+ * db.  Connect to the mysql server and initialize the info string.
+ *
+ * \return This function returns success even if it could not connect
+ * to the mysql server. This is because the connect is expected to fail
+ * if there the paraslash database is not yet created. This gives the
+ * user a chance to send the "cdb" to create the database.
  *
  * \sa struct audio_file_selector, misc_meta_data::selector_info,
  * random_selector.c