clarify documentation of mysql_selector_init()

diff --git a/mysql_selector.c b/mysql_selector.c
index 91972e84ab0c179fba33129a811d171bd1c00021..0eb19bc58da2f7d78681a793efb746cc0b14bc00 100644 (file)
--- 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