From a218bdb282cdcc3db4f6065d16eeaa5fe6bb4b05 Mon Sep 17 00:00:00 2001
From: Matthew Leeds <matthew.leeds@endlessm.com>
Date: Wed, 15 Nov 2017 22:25:57 -0800
Subject: [PATCH] docs: Document "flatpak update --appstream" better

The manpage description for flatpak-update's --appstream option says it
updates appstream data for the remote, but it's unclear that the remote
should be passed on the command line instead of a ref. This commit
updates the manpage to document that form of the command.

Closes: #1177
Approved by: alexlarsson
---
 doc/flatpak-update.xml | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/doc/flatpak-update.xml b/doc/flatpak-update.xml
index c90ac1ac..57734272 100644
--- a/doc/flatpak-update.xml
+++ b/doc/flatpak-update.xml
@@ -34,6 +34,12 @@
                 <arg choice="opt" rep="repeat">OPTION</arg>
                 <arg choice="opt" rep="repeat">REF</arg>
             </cmdsynopsis>
+            <cmdsynopsis>
+                <command>flatpak update</command>
+                <arg choice="opt" rep="repeat">OPTION</arg>
+                <arg choice="plain">--appstream</arg>
+                <arg choice="opt">REMOTE</arg>
+            </cmdsynopsis>
     </refsynopsisdiv>
 
     <refsect1>
@@ -188,7 +194,7 @@
                 <term><option>--appstream</option></term>
 
                 <listitem><para>
-                    Update appstream for the remote.
+                    Update appstream for <arg choice="plain">REMOTE</arg>, or all remotes if no remote is specified.
                 </para></listitem>
             </varlistentry>