From f46dce31884d5730f054bd19edf0492890b9b3d3 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Tue, 22 Mar 2016 10:52:40 -0400
Subject: Align contents of xdg-app.1 with xdg-app --help

---
 doc/xdg-app.xml | 89 +++++++++++++++++++++++++++++++--------------------------
 1 file changed, 48 insertions(+), 41 deletions(-)

(limited to 'doc')

diff --git a/doc/xdg-app.xml b/doc/xdg-app.xml
index 99057f8..75d92c0 100644
--- a/doc/xdg-app.xml
+++ b/doc/xdg-app.xml
@@ -103,109 +103,109 @@
     <refsect1>
         <title>Commands</title>
 
-        <para>Commands related to repository configuration:</para>
+        <para>Commands for managing installed applications and runtimes:</para>
 
         <variablelist>
             <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-remote-add</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
-
-                <listitem><para>
-                    Add a remote repository.
-                </para></listitem>
-            </varlistentry>
-            <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-remote-modify</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+                <term><citerefentry><refentrytitle>xdg-app-install</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Modify remote repository properties.
+                    Install an application or a runtime from a remote.
                 </para></listitem>
             </varlistentry>
             <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-remote-delete</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+                <term><citerefentry><refentrytitle>xdg-app-update</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Delete a remote repository.
+                    Update an installed application or runtime.
                 </para></listitem>
             </varlistentry>
             <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-remote-list</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+                <term><citerefentry><refentrytitle>xdg-app-uninstall</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Lists remote repositories.
+                    Uninstall an installed application or runtime.
                 </para></listitem>
             </varlistentry>
             <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-remote-ls</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+                <term><citerefentry><refentrytitle>xdg-app-list</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Show available runtimes and applications.
+                    List installed applications and/or runtimes.
                 </para></listitem>
             </varlistentry>
         </variablelist>
 
-        <para>Commands for handling installed runtimes and applications:</para>
+
+        <para>Commands for running applications:</para>
 
         <variablelist>
             <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-install</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+                <term><citerefentry><refentrytitle>xdg-app-run</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Install an application or a runtime.
+                    Run an application.
                 </para></listitem>
             </varlistentry>
             <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-update</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+                <term><citerefentry><refentrytitle>xdg-app-override</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Update an application or a runtime.
+                    Override permissions for an application.
                 </para></listitem>
             </varlistentry>
             <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-uninstall</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+                <term><citerefentry><refentrytitle>xdg-app-export-file</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Uninstall an application or a runtime.
+                    Grant an application access to a specific file.
                 </para></listitem>
             </varlistentry>
             <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-list-runtimes</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+                <term><citerefentry><refentrytitle>xdg-app-enter</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    List installed runtimes.
+                    Enter the namespace of a running application.
                 </para></listitem>
             </varlistentry>
+        </variablelist>
+
+        <para>Commands for managing remote rempositories:</para>
+
+        <variablelist>
             <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-list-apps</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+                <term><citerefentry><refentrytitle>xdg-app-remote-add</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    List installed applications.
+                    Add a new remote repository.
                 </para></listitem>
             </varlistentry>
-        </variablelist>
-
-
-        <para>Commands for running applications:</para>
+            <varlistentry>
+                <term><citerefentry><refentrytitle>xdg-app-remote-modify</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
-        <variablelist>
+                <listitem><para>
+                    Modify properties of a configured remote repository.
+                </para></listitem>
+            </varlistentry>
             <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-run</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+                <term><citerefentry><refentrytitle>xdg-app-remote-delete</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Run an application.
+                    Delete a configured remote repository.
                 </para></listitem>
             </varlistentry>
             <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-override</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+                <term><citerefentry><refentrytitle>xdg-app-remote-list</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Override application requirements.
+                    List all configured remote repositories.
                 </para></listitem>
             </varlistentry>
             <varlistentry>
-                <term><citerefentry><refentrytitle>xdg-app-export-file</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+                <term><citerefentry><refentrytitle>xdg-app-remote-ls</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Export a file to a sandboxed application.
+                    List contents of a configured remote repository.
                 </para></listitem>
             </varlistentry>
         </variablelist>
@@ -231,21 +231,28 @@
                 <term><citerefentry><refentrytitle>xdg-app-build-finish</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Finalizes a build directory.
+                    Finalizes a build directory for export.
                 </para></listitem>
             </varlistentry>
             <varlistentry>
                 <term><citerefentry><refentrytitle>xdg-app-build-export</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Create a repository from a build directory.
+                    Export a build directory to a repository.
+                </para></listitem>
+            </varlistentry>
+            <varlistentry>
+                <term><citerefentry><refentrytitle>xdg-app-build-bundle</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
+
+                <listitem><para>
+                    Create a bundle file from a build directory.
                 </para></listitem>
             </varlistentry>
             <varlistentry>
                 <term><citerefentry><refentrytitle>xdg-app-build-update-repo</refentrytitle><manvolnum>1</manvolnum></citerefentry></term>
 
                 <listitem><para>
-                    Update repository metadata.
+                    Update the summary file in a repository.
                 </para></listitem>
             </varlistentry>
         </variablelist>
-- 
cgit v1.2.1