docs/pull: Finish incomplete docs for pull@hash syntax

Closes: https://github.com/ostreedev/ostree/issues/1043
Closes: #1045
Approved by: guyshapiro

diff --git a/man/ostree-pull.xml b/man/ostree-pull.xml
index 394a29c27da9689ee5f5341e1d9b9708a526ad13..dd901aa20765104f431ebe3babdc33d49bfde1ff 100644 (file)
--- a/man/ostree-pull.xml
+++ b/man/ostree-pull.xml
@@ -136,8 +136,11 @@ Boston, MA 02111-1307, USA.
         </para>
 
        <para>
-         A special syntax in the <literal>@</literal> character allows
-         specifying a specific commit to retrieve from a branch.  This
+    A special syntax in the <literal>@</literal> character allows
+    specifying a specific commit to retrieve from a branch.  The
+    use cases for this are somewhat similar to pulling a specific
+    git tag; one could e.g. script a system upgrade to a known-good
+    version, rather than the latest from the content provider.
        </para>
 
     </refsect1>