X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;f=mysql_selector.c;h=0eb19bc58da2f7d78681a793efb746cc0b14bc00;hb=37dd76b70c9ca6459c483653c1a1d1cc9f32237c;hp=91972e84ab0c179fba33129a811d171bd1c00021;hpb=f05276c4bf63c327da914ed4aae2568f38e47892;p=paraslash.git

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