From a21fedf555e04a863eec57355d22b3efb05e6cdf Mon Sep 17 00:00:00 2001 From: David Shaw Date: Tue, 23 Aug 2005 04:42:25 +0000 Subject: * 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. --- doc/ChangeLog | 7 +++++ doc/gpg.sgml | 84 ++++++++++++++++++++++++++++++++++++++++++++--------------- 2 files changed, 70 insertions(+), 21 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index 6eec1b954..a7036309f 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,10 @@ +2005-08-23 David Shaw + + * 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 * gpg.sgml: Removed entry for --no-interactive-selection. diff --git a/doc/gpg.sgml b/doc/gpg.sgml index c184b5940..62d635f02 100644 --- a/doc/gpg.sgml +++ b/doc/gpg.sgml @@ -511,23 +511,15 @@ are not already included in the preference list. setpref &ParmString; -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. - - - updpref - -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. +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. keyserver @@ -1410,6 +1402,12 @@ the new key that are not usable. This is the same as running the --edit-key command "clean uids" after import. Defaults to no. + +import-clean + +Identical to "import-clean-sigs import-clean-uids". + + @@ -1864,6 +1862,12 @@ Write special status strings to the file descriptor &ParmN;. See the file DETAILS in the documentation for a listing of them. + +--status-file &ParmFile; + +Same as --status-fd, except the status data is written to file +&ParmFile;. + --logger-fd &ParmN; @@ -1871,6 +1875,12 @@ See the file DETAILS in the documentation for a listing of them. Write log output to file descriptor &ParmN; and not to stderr. + +--logger-file &ParmFile; + +Same as --logger-fd, except the logger data is written to file +&ParmFile;. + --attribute-fd &ParmN; @@ -1881,6 +1891,13 @@ needed to separate out the various subpackets from the stream delivered to the file descriptor. + +--attribute-file &ParmFile; + +Same as --attribute-fd, except the attribute data is written to file +&ParmFile;. + + --comment &ParmString; @@ -2230,6 +2247,23 @@ can only be used if only one passphrase is supplied. Don't use this option if you can avoid it. + +--passphrase-file &ParmFile; + +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. + + + +--passphrase &ParmString; + +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. + + --command-fd &ParmN; @@ -2240,6 +2274,13 @@ together with --status-fd. See the file doc/DETAILS in the source distribution for details on how to use it. + +--command-file &ParmFile; + +Same as --command-fd, except the commands are read out of file +&ParmFile; + + --use-agent --no-use-agent @@ -2821,10 +2862,9 @@ used when there are no recipient keys to consider (e.g. --symmetric). --default-preference-list &ParmString; -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. @@ -2903,6 +2943,7 @@ indicates this email address mode. + Heine -- cgit v1.2.3