From 2b150f52f8961b9e7b3a477d59b68275902ed1a7 Mon Sep 17 00:00:00 2001
From: Sjoerd Simons <sjoerd@luon.net>
Date: Mon, 17 Oct 2016 22:47:58 +0200
Subject: [PATCH] Update documentation for cookie handling commands

Closes: #531
Approved by: cgwalters
---
 man/ostree-remote.xml      | 22 ++++++++++++++++++++++
 man/ostree.repo-config.xml | 12 ++++++++++++
 2 files changed, 34 insertions(+)

diff --git a/man/ostree-remote.xml b/man/ostree-remote.xml
index 2e600845..88e61ac0 100644
--- a/man/ostree-remote.xml
+++ b/man/ostree-remote.xml
@@ -69,6 +69,25 @@ Boston, MA 02111-1307, USA.
             <cmdsynopsis>
                 <command>ostree remote summary</command> <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">NAME</arg>
             </cmdsynopsis>
+            <cmdsynopsis>
+                <command>ostree remote add-cookie</command>
+                <arg choice="req">NAME</arg>
+                <arg choice="req">DOMAIN</arg>
+                <arg choice="req">PATH</arg>
+                <arg choice="req">COOKIE_NAME</arg>
+                <arg choice="req">VALUE</arg>
+            </cmdsynopsis>
+            <cmdsynopsis>
+                <command>ostree remote delete-cookie</command>
+                <arg choice="req">NAME</arg>
+                <arg choice="req">DOMAIN</arg>
+                <arg choice="req">PATH</arg>
+                <arg choice="req">COOKIE_NAME</arg>
+                <arg choice="req">VALUE</arg>
+            </cmdsynopsis>
+            <cmdsynopsis>
+                <command>ostree remote list-cookies</command> <arg choice="req">NAME</arg>
+            </cmdsynopsis>
     </refsynopsisdiv>
 
     <refsect1>
@@ -83,6 +102,9 @@ Boston, MA 02111-1307, USA.
         <para>
             The GPG keys to import may be in binary OpenPGP format or ASCII armored.  The optional <arg>KEY-ID</arg> list can restrict which keys are imported from a keyring file or input stream.  All keys are imported if this list is omitted.  If neither <option>--keyring</option> nor <option>--stdin</option> options are given, then keys are imported from the user's personal GPG keyring.
         </para>
+        <para>
+            The various cookie related command allow management of a remote specific cookie jar.
+        </para>
     </refsect1>
 
     <refsect1>
diff --git a/man/ostree.repo-config.xml b/man/ostree.repo-config.xml
index 0c421ba4..1182aa93 100644
--- a/man/ostree.repo-config.xml
+++ b/man/ostree.repo-config.xml
@@ -204,6 +204,18 @@ Boston, MA 02111-1307, USA.
       in the section <literal>GPG verification</literal>.
     </para>
   </refsect1>
+
+  <refsect1>
+    <title>Per-remote HTTP cookies</title>
+    <para>
+      Some content providers may want to control access to remote
+      repositories via HTTP cookies.  The <command>ostree remote
+      add-cookie</command> and <command>ostree remote
+      delete-cookie</command> commands will update a per-remote
+      lookaside cookie jar, named
+      <filename>$remotename.cookies.txt</filename>.
+    </para>
+  </refsect1>
   
   <refsect1>
     <title>See Also</title>