Add db_sql:import config option so we can know for sure whether or not we want a database import

1 files changed, 14 insertions, 2 deletions

diff --git a/data/example.conf b/data/example.conf
index e030a24f4..9f7b27576 100644
--- a/data/example.conf
+++ b/data/example.conf
@@ -1109,11 +1109,11 @@ db_flatfile
  * This module allows saving and loading databases using one of the SQL engines.
  * This module reads and writes to SQL in real time. Changes to the SQL tables
  * will be immediately reflected into Anope. This module should not be loaded
- * in conjunction with db_sql, except during the initial import of existing
- * databases to SQL.
+ * in conjunction with db_sql.
  */
 #module { name = "db_sql_live" }
 
+/* Configuration block for both db_sql and db_sql_live */
 db_sql
 {
 	/*
@@ -1127,6 +1127,18 @@ db_sql
 	 * Do not use the same prefix for other programs.
 	 */
 	#prefix = "anope_db_"
+
+	/* Whether or not to import data from another database module in to SQL on startup.
+	 * If you enable this, be sure that the database services is configured to use is
+	 * empty and that another database module to import from is loaded before db_sql.
+	 * After you enable this and do a database import you should disable it for
+	 * subsequent restarts.
+	 *
+	 * Note that you can not import databases using db_sql_live. If you want to import
+	 * databases and use db_sql_live you should import them using db_sql, then shut down
+	 * and start services with db_sql_live.
+	 */
+	import = false
 }
 
 /*