document application ID support (-a command-line option)

1 files changed, 14 insertions, 0 deletions

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*.