From cc72e978c2670c68c7f6b55009efcd1b082f48da Mon Sep 17 00:00:00 2001
From: Michael Ryan Peter <mipeter@redhat.com>
Date: Tue, 28 Feb 2023 14:11:51 -0500
Subject: [PATCH] BZ#2056337 Add `opm migrate` to the `opm` CLI tool reference

---
 cli_reference/opm/cli-opm-ref.adoc |  1 +
 modules/opm-cli-ref-migrate.adoc   | 27 +++++++++++++++++++++++++++
 2 files changed, 28 insertions(+)
 create mode 100644 modules/opm-cli-ref-migrate.adoc

diff --git a/cli_reference/opm/cli-opm-ref.adoc b/cli_reference/opm/cli-opm-ref.adoc
index d06f904595bd..0b8b13b4373c 100644
--- a/cli_reference/opm/cli-opm-ref.adoc
+++ b/cli_reference/opm/cli-opm-ref.adoc
@@ -31,6 +31,7 @@ include::modules/opm-cli-ref-init.adoc[leveloffset=+1]
 include::modules/opm-cli-ref-render.adoc[leveloffset=+1]
 include::modules/opm-cli-ref-validate.adoc[leveloffset=+1]
 include::modules/opm-cli-ref-serve.adoc[leveloffset=+1]
+include::modules/opm-cli-ref-migrate.adoc[leveloffset=+1]
 include::modules/opm-cli-ref-index.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
diff --git a/modules/opm-cli-ref-migrate.adoc b/modules/opm-cli-ref-migrate.adoc
new file mode 100644
index 000000000000..55c796dbd2e4
--- /dev/null
+++ b/modules/opm-cli-ref-migrate.adoc
@@ -0,0 +1,27 @@
+// Module included in the following assemblies:
+//
+// * cli_reference/opm/cli-opm-ref.adoc
+
+[id="opm-cli-ref-migrate_{context}"]
+= migrate
+
+Migrate a SQLite database format index image or database file to a file-based catalog.
+
+:FeatureName: The SQLite-based catalog format, including the related CLI commands,
+include::modules/deprecated-feature.adoc[]
+
+.Command syntax
+[source,terminal]
+----
+$ opm  <index_ref> <output_dir> [<flags>]
+----
+
+.`migrate` flags
+[options="header",cols="1,3"]
+|===
+|Flag |Description
+
+|`-o`, `--output` (string)
+|Output format: `json` (the default value) or `yaml`.
+
+|===