---
 man/machinectl.xml | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/man/machinectl.xml b/man/machinectl.xml
index 640cb8b..e01c102 100644
--- a/man/machinectl.xml
+++ b/man/machinectl.xml
@@ -635,7 +635,13 @@
         <para>Note that pressing C-c during execution of this command
         will not abort the download. Use
         <command>cancel-transfer</command>, described
-        below.</para></listitem>
+        below.</para>
+
+        <para>
+          To update an existing (local) image add <option>--force</option> and run
+          <command>pull-dkr</command>.
+        </para>
+      </listitem>
       </varlistentry>
 
       <varlistentry>
@@ -740,6 +746,18 @@
       index server to be specified with the
       <literal>--dkr-index-url=</literal>.</para>
     </example>
+
+    <example>
+      <title>Update an existing Fedora <literal>dkr</literal> image</title>
+
+      <programlisting># machinectl pull-dkr --verify=no mattdm/fedora --force
+# systemd-nspawn -M fedora</programlisting>
+
+      <para>Updates an existing <literal>dkr</literal> image and opens a shell
+      in it. Note that the specified download command might require an
+      index server to be specified with the
+      <literal>--dkr-index-url=</literal>.</para>
+    </example>
   </refsect1>
 
   <refsect1>
-- 
2.3.0