Document --limit-card-insert-tries.
authorWerner Koch <wk@gnupg.org>
Tue, 19 Jul 2005 12:25:33 +0000 (12:25 +0000)
committerWerner Koch <wk@gnupg.org>
Tue, 19 Jul 2005 12:25:33 +0000 (12:25 +0000)
doc/ChangeLog
doc/DETAILS
doc/gpg.sgml

index 3667faa..1ed8ca0 100644 (file)
@@ -1,3 +1,7 @@
+2005-07-19  Werner Koch  <wk@g10code.com>
+
+       * gpg.sgml: Document --limit-card-insert-tries.
+
 2005-07-18  David Shaw  <dshaw@jabberwocky.com>
 
        * samplekeys.asc: Update 99242560.
index 67dd57c..01083ee 100644 (file)
@@ -553,13 +553,14 @@ more arguments in future versions.
            5 = No card reader available
 
 
-    PLAINTEXT <format> <timestamp>
+    PLAINTEXT <format> <timestamp> <filename>
         This indicates the format of the plaintext that is about to be
         written.  The format is a 1 byte hex code that shows the
         format of the plaintext: 62 ('b') is binary data, 74 ('t') is
         text data with no character set specified, and 75 ('u') is
         text data encoded in the UTF-8 character set.  The timestamp
-        is in seconds since the epoch.
+        is in seconds since the epoch.  If a filename is available it
+        gets printed as the third argument, percent-escaped as usual.
 
     PLAINTEXT_LENGTH <length>
         This indicates the length of the plaintext that is about to be
index 3cf4da2..8517e81 100644 (file)
@@ -2483,6 +2483,17 @@ option may lead to data and key corruption.
 </para></listitem></varlistentry>
 
 <varlistentry>
+<term>--limit-card-insert-tries &ParmN;</term>
+<listitem><para>
+With &ParmN; greater than 0 the number of prompts asking to insert a
+smartcard gets limited to N-1.  Thus with a value of 1 gpg won't at
+all ask to insert a card if none has been inserted at startup. This
+option is useful in the configuration file in case an application does
+not know about the smartcard support and waits ad infinitum for an
+inserted card.
+</para></listitem></varlistentry>
+
+<varlistentry>
 <term>--no-random-seed-file</term>
 <listitem><para>
 GnuPG uses a file to store its internal random pool over invocations.