From 1c9baad8a886399ef2362420fe34c4718d06f0de Mon Sep 17 00:00:00 2001
From: Colin Walters <walters@verbum.org>
Date: Mon, 5 Mar 2018 17:18:54 -0500
Subject: [PATCH] docs/prune: Document that --static-deltas-only isn't that
 useful

This is the documentation followup to: https://github.com/ostreedev/ostree/pull/1482

See also https://github.com/ostreedev/ostree/issues/1481

Closes: #1484
Approved by: jlebon
---
 man/ostree-prune.xml | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/man/ostree-prune.xml b/man/ostree-prune.xml
index 641176ba..f1b517f3 100644
--- a/man/ostree-prune.xml
+++ b/man/ostree-prune.xml
@@ -114,8 +114,12 @@ Boston, MA 02111-1307, USA.
                 <term><option>--static-deltas-only</option>=DEPTH</term>
 
                 <listitem><para>
-                  Change the behaviour of --keep-younger-than and --delete-commit to prune only
-                  the static deltas files.
+                  This option may currently <emphasis>only</emphasis> be used in combination with
+                  <option>--delete-commit</option>.  Previous versions of ostree silently accepted
+                  the option without that, and ignored it.  However, there are desired use
+                  cases for pruning just static deltas (while retaining the commits), and it's
+                  likely at some point this option will be supported for use cases outside of just
+                  <option>--delete-commit</option>.
                 </para></listitem>
             </varlistentry>
         </variablelist>