From ae91959e0ecc3e2bd9e305442151ef45b5d71f32 Mon Sep 17 00:00:00 2001
From: Jonathan Lebon <jlebon@redhat.com>
Date: Wed, 7 Mar 2018 21:03:33 +0000
Subject: [PATCH] man/rpm-ostree: Add `override` command

Add the missing docs for the recently promoted `override` command.

Also drop the `pkg-add` and `pkg-remove` mentions. I think `install` and
`uninstall` have pervaded enough by now that most people have probably
forgotten (or never learned) the legacy aliases. Let's just nuke them
from the man pages.

Closes: #1291
Approved by: cgwalters
---
 man/rpm-ostree.xml | 35 +++++++++++++++++++++++++++++++++--
 1 file changed, 33 insertions(+), 2 deletions(-)

diff --git a/man/rpm-ostree.xml b/man/rpm-ostree.xml
index 8e51bdea..53a6cf41 100644
--- a/man/rpm-ostree.xml
+++ b/man/rpm-ostree.xml
@@ -211,7 +211,7 @@ Boston, MA 02111-1307, USA.
       </varlistentry>
 
       <varlistentry>
-        <term><command>install (pkg-add)</command></term>
+        <term><command>install</command></term>
 
         <listitem>
           <para>
@@ -249,7 +249,7 @@ Boston, MA 02111-1307, USA.
       </varlistentry>
 
       <varlistentry>
-        <term><command>uninstall (pkg-remove)</command></term>
+        <term><command>uninstall</command></term>
 
         <listitem>
           <para>
@@ -441,6 +441,37 @@ Boston, MA 02111-1307, USA.
         </listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><command>override</command></term>
+
+        <listitem>
+          <para>
+            Provides subcommands for overriding (modifying) the base
+            OSTree layer. Such modifications should be done with care
+            and are normally not intended to be long-lasting. For
+            example, one might replace a base package with its older
+            version to avoid a regression. Overrides are automatically
+            carried over during new deployments. The subcommands are:
+          </para>
+
+          <para>
+            <command>remove</command> to remove base packages.
+          </para>
+
+          <para>
+            <command>replace</command> to replace base packages.
+            Currently, only local RPM replacements are supported:
+            one must directly provide the RPMs to substitute in.
+          </para>
+
+          <para>
+            <command>reset</command> to reset previous overrides.
+            Currently, the full <literal>NEVRA</literal> of the target
+            packages must be specified.
+          </para>
+        </listitem>
+      </varlistentry>
+
       <varlistentry>
         <term><command>refresh-md</command></term>