From db83b526373744c4e652827a45f1d7c97d9235d2 Mon Sep 17 00:00:00 2001
From: Christian Grothoff <christian@grothoff.org>
Date: Tue, 26 Jan 2021 21:45:50 +0100
Subject: document #6724 in man pages

---
 manpages/taler-auditor-offline.1.rst  | 24 ++++++++++++------------
 manpages/taler-exchange-offline.1.rst | 24 +++++++++++++-----------
 2 files changed, 25 insertions(+), 23 deletions(-)

(limited to 'manpages')

diff --git a/manpages/taler-auditor-offline.1.rst b/manpages/taler-auditor-offline.1.rst
index 7c10f35a..59065e72 100644
--- a/manpages/taler-auditor-offline.1.rst
+++ b/manpages/taler-auditor-offline.1.rst
@@ -79,19 +79,11 @@ by the auditor. To obtain the auditor's public key, use:
 
 .. code-block:: console
 
-   $ AUDITOR_PRIV_FILE=`taler-config -f -c $CONF -s AUDITOR -o AUDITOR_PRIV_FILE`
-   $ gnunet-ecc -p $AUDITOR_PRIV_FILE
-
-Note that if the private key file does not yet exist, the above will fail.
-In this case, create the private key using:
-
-.. code-block:: console
-
-   $ AUDITOR_PRIV_FILE=`taler-config -f -c $CONF -s AUDITOR -o AUDITOR_PRIV_FILE`
-   $ AUDITOR_PRIV_DIR=`dirname $AUDITOR_PRIV_FILE`
-   $ mkdir -p $AUDITOR_PRIV_DIR
-   $ gnunet-ecc -g1 $AUDITOR_PRIV_FILE
+   $ taler-auditor-offline setup
 
+Note that if the private key file already exists, the above will simply output
+the existing key.  Passing additional arguments after setup (including "-")
+will cause the output to be encapsulated in JSON.
 
 Relevant configuration options for **taler-auditor-offline** are:
 
@@ -102,6 +94,14 @@ Relevant configuration options for **taler-auditor-offline** are:
 Subcommands
 ===========
 
+setup
+-----
+
+When run the first time, this subcommand sets up the offline private key and
+outputs the resulting public key. Subsequent invocations will simply again
+output the (same) public key (in the format usable for the exchange
+configuration).
+
 download
 --------
 
diff --git a/manpages/taler-exchange-offline.1.rst b/manpages/taler-exchange-offline.1.rst
index 1c901b8c..f779339c 100644
--- a/manpages/taler-exchange-offline.1.rst
+++ b/manpages/taler-exchange-offline.1.rst
@@ -74,18 +74,11 @@ obtain the master public key, use:
 
 .. code-block:: console
 
-   $ MASTER_PRIV_FILE=`taler-config -f -c $CONF -s EXCHANGE -o MASTER_PRIV_FILE`
-   $ gnunet-ecc -p $MASTER_PRIV_FILE
+   $ taler-exchange-offline setup
 
-Note that if the private key file does not yet exist, the above will fail.
-In this case, create the private key using:
-
-.. code-block:: console
-
-   $ MASTER_PRIV_FILE=`taler-config -f -c $CONF -s EXCHANGE -o MASTER_PRIV_FILE`
-   $ MASTER_PRIV_DIR=`dirname $MASTER_PRIV_FILE`
-   $ mkdir -p $MASTER_PRIV_DIR
-   $ gnunet-ecc -g1 $MASTER_PRIV_FILE
+Note that if the private key file already exists, the above will simply output
+the existing key.  Passing additional arguments after setup (including "-")
+will cause the output to be encapsulated in JSON.
 
 
 Relevant configuration options for **taler-exchange-offline** are:
@@ -99,6 +92,15 @@ Relevant configuration options for **taler-exchange-offline** are:
 Subcommands
 ===========
 
+setup
+-----
+
+When run the first time, this subcommand sets up the offline private key and
+outputs the resulting public key. Subsequent invocations will simply again
+output the (same) public key (in the format usable for the exchange
+configuration).
+
+
 download
 --------
 
-- 
cgit v1.2.3