inline docs for crosscheck & cleanup

Author: aristath

wp-includes/sqlite/db.php

@@ -14,10 +14,6 @@
 	return;
 }
 
-// @TODO: Remove before merging
-define( 'SQLITE_DEBUG_CROSSCHECK', false );
-error_reporting( E_ALL & ~E_DEPRECATED );
-
 if ( ! extension_loaded( 'pdo' ) ) {
 	wp_die(
 		new WP_Error(
@@ -54,6 +50,12 @@
 require_once __DIR__ . '/class-wp-sqlite-db.php';
 require_once __DIR__ . '/install-functions.php';
 
+/*
+ * Debug: Cross-check with MySQL.
+ * This is for debugging purpose only and requires files
+ * that are present in the GitHub repository
+ * but not the plugin published on WordPress.org.
+ */
 $crosscheck_tests_file_path = dirname( dirname( __DIR__ ) ) . '/tests/class-wp-sqlite-crosscheck-db.php';
 if ( defined( 'SQLITE_DEBUG_CROSSCHECK' ) && SQLITE_DEBUG_CROSSCHECK && file_exists( $crosscheck_tests_file_path ) ) {
 	require_once $crosscheck_tests_file_path;

wp-includes/sqlite/install-functions.php

@@ -64,6 +64,12 @@ function sqlite_make_db_sqlite() {
 		}
 	}
 
+	/*
+	 * Debug: Cross-check with MySQL.
+	 * This is for debugging purpose only and requires files
+	 * that are present in the GitHub repository
+	 * but not the plugin published on WordPress.org.
+	 */
 	if ( defined( 'SQLITE_DEBUG_CROSSCHECK' ) && SQLITE_DEBUG_CROSSCHECK ) {
 		$host = DB_HOST;
 		$port = 3306;