From fbefe875c77e03b9070f1f6b5e3f0ea085749ba7 Mon Sep 17 00:00:00 2001
From: Colin Walters <walters@verbum.org>
Date: Tue, 1 Aug 2017 09:12:16 -0400
Subject: [PATCH] docs/pull: Finish incomplete docs for pull@hash syntax

Closes: https://github.com/ostreedev/ostree/issues/1043

Closes: #1045
Approved by: guyshapiro
---
 man/ostree-pull.xml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/man/ostree-pull.xml b/man/ostree-pull.xml
index 394a29c2..dd901aa2 100644
--- 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>