man: Various tweaks/updates to the man page

I initially started this since I wanted to have the client-side
commands first, but ended up splitting them into a separate section.

Various other things:

 - Update the intro
 - Add jlebon to authors

Closes: #1189
Approved by: jlebon

man/rpm-ostree.xml

@@ -27,6 +27,15 @@ Boston, MA 02111-1307, USA.
     <title>rpm-ostree</title>
     <productname>rpm-ostree</productname>
 
+    <authorgroup>
+      <author>
+        <contrib>Developer</contrib>
+        <firstname>Jonathan</firstname>
+        <surname>Lebon</surname>
+        <email>jlebon@redhat.com</email>
+      </author>
+    </authorgroup>
+
     <authorgroup>
       <author>
         <contrib>Developer</contrib>
@@ -45,7 +54,7 @@ Boston, MA 02111-1307, USA.
   <refnamediv>
     <refname>rpm-ostree</refname>
     <refpurpose>
-      Operating system upgrade and software management tool
+      Hybrid image/package system for host operating system updates
     </refpurpose>
   </refnamediv>
 
@@ -61,11 +70,12 @@ Boston, MA 02111-1307, USA.
     <title>Description</title>
 
     <para>
-      rpm-ostree (also called "atomic" if configured) is a system
+      rpm-ostree is a hybrid image and package system; as the name suggests, it
-      software management tool that combines features of both
+      uses OSTree for the image side, and RPM for the package side.  It supports
-      traditional RPM and OSTree.  It has support for both server-side
+      composing RPMs server-side into an OSTree commit (like an image), and
-      composing of trees, as well as client-side upgrading and
+      clients can replicate that bit-for-bit, with fast incremental updates.
-      management of deployments.
+      Additionally, the hybrid nature comes to the fore with client-side package
+      layering and overrides.
     </para>
 
     <para>
@@ -81,41 +91,26 @@ Boston, MA 02111-1307, USA.
       OSTree layer replicates a complete filesystem tree from a
       compose server into a new deployment, available on the next
       reboot.  One benefit of this is that there will always be a
-      previous deployment, available for rollback.
+      previous deployment, available for rollback.  This also
+      makes it easier to reliably "queue" an update without destabilizing
+      the running system at all.  (Currently though there's an experimental
+      <literal>livefs</literal> command that supports changing the
+      running filesystem).
     </para>
 
     <para>
-      Note in this "pure replication" model, at present there is no
+      Note in this "pure replication" model, there is no per-client
-      dependency resolution on the client machines, nor any ability to
+      packaging overhead.  Dependency resolution, SELinux labeling,
-      add or remove packages.  You may however use /usr/local/bin, or
+      all of the scripts etc. were run on the server side and captured
-      an application mechanism such as
+      in the OSTree commit.
-      <citerefentry>
-        <refentrytitle>docker</refentrytitle>
-        <manvolnum>1</manvolnum>
-      </citerefentry>.
     </para>
   </refsect1>
 
   <refsect1>
-    <title>Commands</title>
+    <title>Client side commands</title>
 
     <variablelist>
 
-      <varlistentry>
-        <term><command>compose</command></term>
-
-        <listitem>
-          <para>
-            Entrypoint for tree composition; most typically used on servers to
-            prepare trees for replication by client systems. The
-            <literal>tree</literal> subcommand processes a treefile, installs
-            packages, and commits the result to an OSTree repository. There are
-            also split commands <literal>install</literal>,
-            <literal>postprocess</literal>, and <literal>commit</literal>.
-          </para>
-        </listitem>
-      </varlistentry>
-
       <varlistentry>
         <term><command>cancel</command></term>
 
@@ -548,6 +543,30 @@ Boston, MA 02111-1307, USA.
     </variablelist>
   </refsect1>
 
+  <refsect1>
+    <title>Server side commands</title>
+
+    <variablelist>
+
+      <varlistentry>
+        <term><command>compose</command></term>
+
+        <listitem>
+          <para>
+            Entrypoint for tree composition; most typically used on servers to
+            prepare trees for replication by client systems. The
+            <literal>tree</literal> subcommand processes a treefile, installs
+            packages, and commits the result to an OSTree repository. There are
+            also split commands <literal>install</literal>,
+            <literal>postprocess</literal>, and <literal>commit</literal>.
+          </para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </refsect1>
+
   <refsect1>
     <title>See Also</title>