diff --git a/README.md b/README.md
index b71d86d8..1ce6e600 100644
--- a/README.md
+++ b/README.md
@@ -57,10 +57,10 @@ Once you have that done, choose a build directory.  Here we'll use
 Running rpm-ostree
 ------------------
 
-The core "rpm-ostree" takes as input a "treefile".  See examples in
-`doc/treefile-examples`.
+The core "rpm-ostree tree compose" builtin as input a "treefile".  See
+examples in `doc/treefile-examples`, as well as `doc/treefile.md`.
 
-	# rpm-ostree treecompose --repo=/srv/rpm-ostree/repo --proxy=http://127.0.0.1:8123 sometreefile.json
+	# rpm-ostree compose tree --repo=/srv/rpm-ostree/repo --proxy=http://127.0.0.1:8123 sometreefile.json
 
 All this does is use yum to download RPMs from the referenced repos,
 and commit the result to the OSTree repository, using the ref named by
diff --git a/man/rpm-ostree.xml b/man/rpm-ostree.xml
index d3214fe9..74c5c17e 100644
--- a/man/rpm-ostree.xml
+++ b/man/rpm-ostree.xml
@@ -112,6 +112,16 @@ Boston, MA 02111-1307, USA.
         Otherwise, make the currently booted
         tree the default.</para></listitem>
       </varlistentry>
+
+      <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.  Currently has two subcommands,
+	<literal>tree</literal> and
+	<literal>sign</literal>.</para></listitem>
+      </varlistentry>
     </variablelist>
 
   </refsect1>