1
0
mirror of git://git.gnupg.org/gnupg.git synced 2024-12-23 10:29:58 +01:00

* DETAILS: Details for --list-config.

* gpg.sgml: Document --ungroup and --list-config.
This commit is contained in:
David Shaw 2004-01-30 19:03:22 +00:00
parent 0030198cad
commit bbd5cda569
3 changed files with 81 additions and 7 deletions

View File

@ -1,3 +1,9 @@
2004-01-30 David Shaw <dshaw@jabberwocky.com>
* DETAILS: Details for --list-config.
* gpg.sgml: Document --ungroup and --list-config.
2004-01-07 David Shaw <dshaw@jabberwocky.com>
* gpg.sgml: Fix a few minor typos. Clarify what --textmode is

View File

@ -522,6 +522,55 @@ attribute defined:
All other data after this header is raw image (JPEG) data.
Format of the "--list-config" output
====================================
--list-config outputs information about the GnuPG configuration for
the benefit of frontends or other programs that call GnuPG. There are
several list-config items, all colon delimited like the rest of the
--with-colons output. The first field is always "cfg" to indicate
configuration information. The second field is one of (with
examples):
version: the third field contains the version of GnuPG.
cfg:version:1.3.5
pubkey: the third field contains the public key algorithmdcaiphers
this version of GnuPG supports, separated by semicolons. The
algorithm numbers are as specified in RFC-2440.
cfg:pubkey:1;2;3;16;17
cipher: the third field contains the symmetric ciphers this version of
GnuPG supports, separated by semicolons. The cipher numbers
are as specified in RFC-2440.
cfg:cipher:2;3;4;7;8;9;10
digest: the third field contains the digest (hash) algorithms this
version of GnuPG supports, separated by semicolons. The
digest numbers are as specified in RFC-2440.
cfg:digest:1;2;3;8;9;10
compress: the third field contains the compression algorithms this
version of GnuPG supports, separated by semicolons. The
algorithm numbers are as specified in RFC-2440.
cfg:compress:0;1;2;3
group: the third field contains the name of the group, and the fourth
field contains the values that the group expands to, separated
by semicolons.
For example, a group of:
group mynames = paige 0x12345678 joe patti
would result in:
cfg:group:mynames:patti;joe;0x12345678;paige
Key generation
==============
Key generation shows progress by printing different characters to

View File

@ -204,7 +204,7 @@ for a quick encryption of multiple files.
<term>--decrypt-files <optional><parameter/files/</optional></term>
<listitem><para>
The same as --encrypt-files with the difference that files will be
decrypted. The syntax or the filenames is the same.
decrypted. The syntax of the filenames is the same.
</para></listitem></varlistentry>
<!--
@ -908,15 +908,17 @@ Try to be as quiet as possible.
<varlistentry>
<term>-z &ParmN;, --compress-level &ParmN;</term>
<term>-z &ParmN;</term>
<term>--compress-level &ParmN;</term>
<term>--bzip2-compress-level &ParmN;</term>
<listitem><para>
Set compression level to &ParmN; for the ZIP and ZLIB compression
algorithms. The default is to use the default compression level of
zlib (normally 6). --bzip2-compress-level sets the compression level
for the BZIP2 compression algorithm (defaulting to 6 as well). This
is a different option since BZIP2 uses a significant amount of memory
for each additional compression level. -z sets both.
is a different option from --compress-level since BZIP2 uses a
significant amount of memory for each additional compression level.
-z sets both. A value of 0 for &ParmN; disables compression.
</para></listitem></varlistentry>
<varlistentry>
@ -2439,8 +2441,9 @@ Experimental use only.
<term>--group &ParmNameValues;</term>
<listitem><para>
Sets up a named group, which is similar to aliases in email programs.
Any time the group name is a recipient (-r or --recipient), it will
be expanded to the values specified.
Any time the group name is a recipient (-r or --recipient), it will be
expanded to the values specified. Multiple groups with the same name
are automatically merged into a single group.
</para><para>
The values are &ParmKeyIDs; or fingerprints, but any key description
is accepted. Note that a value with spaces in it will be treated as
@ -2451,10 +2454,16 @@ this option to prevent the shell from treating it as multiple
arguments.
</para></listitem></varlistentry>
<varlistentry>
<term>--ungroup &ParmName;</term>
<listitem><para>
Remove a given entry from the --group list.
</para></listitem></varlistentry>
<varlistentry>
<term>--no-groups</term>
<listitem><para>
Clear the --group list.
Remove all entries from the --group list.
</para></listitem></varlistentry>
<varlistentry>
@ -2507,6 +2516,16 @@ edit menu. This affects both key generation and "updpref" in the edit
menu.
</para></listitem></varlistentry>
<varlistentry>
<term>--list-config &OptParmNames;</term>
<listitem><para>
Display various internal configuration parameters of GnuPG. This
option is intended for external programs that call GnuPG to perform
tasks, and is thus not generally useful. See the file
<filename>doc/DETAILS</filename> in the source distribution for the
details of which configuration items may be listed. --list-config is
only useful with --with-colons set.
</para></listitem></varlistentry>
</variablelist>
</refsect1>