Generate add/drop table migration statements

1 files changed, 46 insertions, 1 deletions

diff --git a/odb/options.cli b/odb/options.cli
index b086011..457c06f 100644
--- a/odb/options.cli
+++ b/odb/options.cli
@@ -112,7 +112,14 @@ class options
      the generated C++ code. By default the SQL file is generated for
      the MySQL, PostgreSQL, Oracle, and Microsoft SQL Server databases
      and the schema is embedded into the C++ code for the SQLite database.
-     Use the \cb{--schema-format} option to alter the default schema format."
+     Use the \cb{--schema-format} option to alter the default schema format.
+
+     If database schema evolution support is enabled (that is, the object
+     model version is specified), then this option also triggers the
+     generation of database schema migration statements, again either as
+     standalong SQL files or embedded into the generated C++ code. You can
+     suppress the generation of schema migration statements by specifying
+     the \cb{--suppress-migration} option."
   };
 
   bool --generate-schema-only
@@ -122,6 +129,11 @@ class options
      for details)."
   };
 
+  bool --suppress-migration
+  {
+    "Suppress the generation of database schema migration statements."
+  };
+
   database_map<std::set< ::schema_format> > --schema-format
   {
     "<format>",
@@ -323,6 +335,13 @@ class options
      options unless they are absolute paths."
   };
 
+  bool --init-changelog
+  {
+    "Force re-initialization of the changelog even if one exists (all the
+     existing change history will be lost). This option is primarily useful
+     for automated testing."
+  };
+
   database_map<std::string> --odb-file-suffix
   {
     "<suffix>",
@@ -428,6 +447,12 @@ class options
     "Insert <text> at the beginning of the generated database schema file."
   };
 
+  database_map<std::vector<std::string> > --migration-prologue
+  {
+    "<text>",
+    "Insert <text> at the beginning of the generated database migration file."
+  };
+
   // Interludes.
   //
   database_map<std::vector<std::string> > --sql-interlude
@@ -469,6 +494,12 @@ class options
     "Insert <text> at the end of the generated database schema file."
   };
 
+  database_map<std::vector<std::string> > --migration-epilogue
+  {
+    "<text>",
+    "Insert <text> at the end of the generated database migration file."
+  };
+
   // Prologue files.
   //
   database_map<std::string> --hxx-prologue-file
@@ -506,6 +537,13 @@ class options
      database schema file."
   };
 
+  database_map<std::string> --migration-prologue-file
+  {
+    "<f>",
+    "Insert the content of file <f> at the beginning of the generated database
+     migration file."
+  };
+
   // Interlude files.
   //
   database_map<std::string> --sql-interlude-file
@@ -552,6 +590,13 @@ class options
      schema file."
   };
 
+  database_map<std::string> --migration-epilogue-file
+  {
+    "<f>",
+    "Insert the content of file <f> at the end of the generated database
+     migration file."
+  };
+
   // ODB compilation prologue/epilogue.
   //
   database_map<std::vector<std::string> > --odb-prologue