[svn] GnuPG - r3873 - trunk/doc
svn author dshaw
cvs at cvs.gnupg.org
Tue Aug 23 06:42:26 CEST 2005
Author: dshaw
Date: 2005-08-23 06:42:25 +0200 (Tue, 23 Aug 2005)
New Revision: 3873
Modified:
trunk/doc/ChangeLog
trunk/doc/gpg.sgml
Log:
* gpg.sgml: Fix documentation for setpref/updpref, document
import-clean, --status-file, --logger-file, --attribute-file,
--passphrase-file, --passphrase, and --command-file. Comment out the
"+word match" selection syntax since it isn't supported.
Modified: trunk/doc/ChangeLog
===================================================================
--- trunk/doc/ChangeLog 2005-08-22 02:26:57 UTC (rev 3872)
+++ trunk/doc/ChangeLog 2005-08-23 04:42:25 UTC (rev 3873)
@@ -1,3 +1,10 @@
+2005-08-23 David Shaw <dshaw at jabberwocky.com>
+
+ * gpg.sgml: Fix documentation for setpref/updpref, document
+ import-clean, --status-file, --logger-file, --attribute-file,
+ --passphrase-file, --passphrase, and --command-file. Comment out
+ the "+word match" selection syntax since it isn't supported.
+
2005-07-22 Werner Koch <wk at g10code.com>
* gpg.sgml: Removed entry for --no-interactive-selection.
Modified: trunk/doc/gpg.sgml
===================================================================
--- trunk/doc/gpg.sgml 2005-08-22 02:26:57 UTC (rev 3872)
+++ trunk/doc/gpg.sgml 2005-08-23 04:42:25 UTC (rev 3873)
@@ -511,25 +511,17 @@
<varlistentry>
<term>setpref &ParmString;</term>
<listitem><para>
-Set the list of user ID preferences to &ParmString;, this should be a
-string similar to the one printed by "pref". Using an empty string
-will set the default preference string, using "none" will remove the
-preferences. Use "gpg --version" to get a list of available
-algorithms. This command just initializes an internal list and does
-not change anything unless another command (such as "updpref") which
-changes the self-signatures is used.
+Set the list of user ID preferences to &ParmString; for all (or just
+the selected) user IDs. Calling setpref with no arguments sets the
+preference list to the default (either built-in or set via
+--default-preference-list), and calling setpref with "none" as the
+argument sets an empty preference list. Use "gpg --version" to get a
+list of available algorithms. Note that while you can change the
+preferences on an attribute user ID (aka "photo ID"), GnuPG does not
+select keys via attribute user IDs so these preferences will not be
+used by GnuPG.
</para></listitem></varlistentry>
<varlistentry>
- <term>updpref</term>
- <listitem><para>
-Change the preferences of all user IDs (or just of the selected ones
-to the current list of preferences. The timestamp of all affected
-self-signatures will be advanced by one second. Note that while you
-can change the preferences on an attribute user ID (aka "photo ID"),
-GnuPG does not select keys via attribute user IDs so these preferences
-will not be used by GnuPG.
-</para></listitem></varlistentry>
- <varlistentry>
<term>keyserver</term>
<listitem><para>
Set a preferred keyserver for the specified user ID(s). This allows
@@ -1410,6 +1402,12 @@
--edit-key command "clean uids" after import. Defaults to no.
</para></listitem></varlistentry>
+<varlistentry>
+<term>import-clean</term>
+<listitem><para>
+Identical to "import-clean-sigs import-clean-uids".
+</para></listitem></varlistentry>
+
</variablelist>
</para></listitem></varlistentry>
@@ -1864,6 +1862,12 @@
See the file DETAILS in the documentation for a listing of them.
</para></listitem></varlistentry>
+<varlistentry>
+<term>--status-file &ParmFile;</term>
+<listitem><para>
+Same as --status-fd, except the status data is written to file
+&ParmFile;.
+</para></listitem></varlistentry>
<varlistentry>
<term>--logger-fd &ParmN;</term>
@@ -1871,6 +1875,12 @@
Write log output to file descriptor &ParmN; and not to stderr.
</para></listitem></varlistentry>
+<varlistentry>
+<term>--logger-file &ParmFile;</term>
+<listitem><para>
+Same as --logger-fd, except the logger data is written to file
+&ParmFile;.
+</para></listitem></varlistentry>
<varlistentry>
<term>--attribute-fd &ParmN;</term>
@@ -1881,7 +1891,14 @@
delivered to the file descriptor.
</para></listitem></varlistentry>
+<varlistentry>
+<term>--attribute-file &ParmFile;</term>
+<listitem><para>
+Same as --attribute-fd, except the attribute data is written to file
+&ParmFile;.
+</para></listitem></varlistentry>
+
<varlistentry>
<term>--comment &ParmString;</term>
<term>--no-comments</term>
@@ -2231,6 +2248,23 @@
</para></listitem></varlistentry>
<varlistentry>
+<term>--passphrase-file &ParmFile;</term>
+<listitem><para>
+Read the passphrase from file &ParmFile;. This can only be used if
+only one passphrase is supplied. Obviously, a passphrase stored in a
+file is of questionable security. Don't use this option if you can
+avoid it.
+</para></listitem></varlistentry>
+
+<varlistentry>
+<term>--passphrase &ParmString;</term>
+<listitem><para>
+Use &ParmString; as the passphrase. This can only be used if only one
+passphrase is supplied. Obviously, this is of very questionable
+security. Don't use this option if you can avoid it.
+</para></listitem></varlistentry>
+
+<varlistentry>
<term>--command-fd &ParmN;</term>
<listitem><para>
This is a replacement for the deprecated shared-memory IPC mode.
@@ -2241,6 +2275,13 @@
</para></listitem></varlistentry>
<varlistentry>
+<term>--command-file &ParmFile;</term>
+<listitem><para>
+Same as --command-fd, except the commands are read out of file
+&ParmFile;
+</para></listitem></varlistentry>
+
+<varlistentry>
<term>--use-agent</term>
<term>--no-use-agent</term>
<listitem><para>
@@ -2821,10 +2862,9 @@
<varlistentry>
<term>--default-preference-list &ParmString;</term>
<listitem><para>
-Set the list of default preferences to &ParmString;, this list should
-be a string similar to the one printed by the command "pref" in the
-edit menu. This affects both key generation and "updpref" in the edit
-menu.
+Set the list of default preferences to &ParmString;. This preference
+list is used for new keys and becomes the default for "setpref" in the
+edit menu.
</para></listitem></varlistentry>
<varlistentry>
@@ -2903,6 +2943,7 @@
</para></listitem>
</varlistentry>
+<!-- we don't do this
<varlistentry>
<term>+Heinrich Heine duesseldorf</term>
<listitem><para>
@@ -2911,6 +2952,7 @@
digits, the underscore and all characters with bit 7 set.
</para></listitem>
</varlistentry>
+-->
<varlistentry>
<term>Heine</term>
More information about the Gnupg-commits
mailing list