diff --git a/python/ql/lib/semmlecode.python.dbscheme b/python/ql/lib/semmlecode.python.dbscheme
index 8d257a4a9bc..279cbb08d38 100644
--- a/python/ql/lib/semmlecode.python.dbscheme
+++ b/python/ql/lib/semmlecode.python.dbscheme
@@ -1,5 +1,6 @@
 /*
  *      This dbscheme is auto-generated by 'semmle/dbscheme_gen.py'.
+ *      Run "make dbscheme" in python/extractor/ to regenerate.
  *      WARNING: Any modifications to this file will be lost.
  *      Relations can be changed by modifying master.py or
  *      by adding rules to dbscheme.template
@@ -47,20 +48,26 @@ externalData(
   string value : string ref
 );
 
+/*- Database metadata -*/
+
+/**
+ * The CLI will automatically emit applicable tuples for this table,
+ * such as `databaseMetadata("isOverlay", "true")` when building an
+ * overlay database.
+ */
+databaseMetadata(
+  string metadataKey: string ref,
+  string value: string ref
+);
+
 /*- Overlay support -*/
 
 /**
- * The CLI will automatically emit the tuple `databaseMetadata("isOverlay", "true")`,
- * along with an `overlayChangedFiles` tuple for each new/modified/deleted file,
- * when building an overlay database, and these can be used by the discard predicates.
+ * The CLI will automatically emit tuples for each new/modified/deleted file
+ * when building an overlay database.
  */
-databaseMetadata(
-  string metadataKey : string ref,
-  string value : string ref
-);
-
 overlayChangedFiles(
-  string path : string ref
+  string path: string ref
 );
 
 /*- DEPRECATED: Snapshot date -*/