[taler-anastasis] 01/02: document application ID support (-a command-line option)

[gnunet]

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository anastasis.

commit 4712f66cac9894d25eca8246da650dcd448e8563
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Sun Feb 27 11:59:29 2022 +0100

    document application ID support (-a command-line option)
---
 doc/sphinx/manpages/anastasis-gtk.1.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/sphinx/manpages/anastasis-gtk.1.rst 
b/doc/sphinx/manpages/anastasis-gtk.1.rst
index 697f820..f387645 100644
--- a/doc/sphinx/manpages/anastasis-gtk.1.rst
+++ b/doc/sphinx/manpages/anastasis-gtk.1.rst
@@ -26,6 +26,20 @@ Description
 key recover and backup operations.
 
 
+**-a** *ID* \| **--application=**\ \ *ID*
+   Set the application ID to *ID*. Default is ``anastasis-gtk``. Used
+   to store different types of secrets from different applications
+   while using the same user attributes. Basically the application ID
+   is included in the user attributes. Not changable by the GUI as
+   only advanced users should even known about this. Applications that
+   tightly integrate Anastasis should set the application ID to their
+   respective unique name, for example the GNU Taler wallet may use
+   ``gnu-taler-wallet`` for the application ID. If anastasis-gtk is
+   to be used to recover such a secret, the respective application ID
+   must be provided on the command-line. Users that only use
+   anastasis-gtk to backup and restore secrets should not set the
+   application ID, as forgetting the ID makes the secrets irrecoverable.
+
 **-c** *FILENAME* \| **––config=**\ ‌\ *FILENAME*
    Use the configuration from *FILENAME*.
 

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.