summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDan McGee <dan@archlinux.org>2011-09-01 22:04:28 +0200
committerDan McGee <dan@archlinux.org>2011-09-03 04:41:40 +0200
commit5a9b07b0e7fc73dc85f07bbab5cba007efe8d8aa (patch)
treeec7ca9c6b4427b10d0812cf4ea9cc635db70c88e /doc
parent24f4f9822fe8c6758e72577173495705cfcc6713 (diff)
downloadpacman-5a9b07b0e7fc73dc85f07bbab5cba007efe8d8aa.tar.gz
pacman-5a9b07b0e7fc73dc85f07bbab5cba007efe8d8aa.tar.xz
pacman-key help and documentation cleanup
We were using the mystical [<foobar>] options which is some sort of cross between a <required> argument and an [optional] one. Remove this madness and do some other general cleanup/consistency work in the manpage. Signed-off-by: Dan McGee <dan@archlinux.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/pacman-key.8.txt26
1 files changed, 13 insertions, 13 deletions
diff --git a/doc/pacman-key.8.txt b/doc/pacman-key.8.txt
index 4201107f..7481ce5b 100644
--- a/doc/pacman-key.8.txt
+++ b/doc/pacman-key.8.txt
@@ -23,7 +23,7 @@ provides the ability to import and export keys, fetch keys from keyservers and
update the key trust database.
More complex keyring management can be achieved using GnuPG directly combined with
-the `--homedir` option pointing at the pacman keyring (located in
+the '\--homedir' option pointing at the pacman keyring (located in
+{sysconfdir}/pacman.d/gnupg+ by default).
@@ -46,8 +46,8 @@ Options
is specified, all keys will be exported.
*\--edit-key* <keyid(s)>::
- Present a menu for key management task on the specified keyids. Useful for
- adjusting a keys trust level.
+ Present a menu for key management task on the specified keyid(s). Useful
+ for adjusting a keys trust level.
*-f, \--finger* [keyid(s)]::
List a fingerprint for each specified keyid, or for all known keys if no
@@ -60,37 +60,37 @@ Options
*-h, \--help*::
Output syntax and command line options.
-*--import* <dir(s)>::
+*\--import* <dir(s)>::
Adds keys from pubring.gpg into pacman's keyring and imports ownertrust
values from trustdb.gpg in the specified directories.
-*--import-dirs* <dir(s)> ::
+*\--import-dirs* <dir(s)> ::
Imports ownertrust values from trustdb.gpg in the specified directories.
-*--init*::
+*\--init*::
Ensure the keyring is properly initialized and has the required access
permissions.
*-l, \--list-keys* [keyid(s)]::
Lists all or specified keys from the public keyring.
-*--list-sigs* [keyid(s)]::
- Same as --list-keys, but the signatures are listed too.
+*\--list-sigs* [keyid(s)]::
+ Same as '\--list-keys', but the signatures are listed too.
*\--lsign-key* <keyid>::
Locally sign the given key. This is primarily used to root the web of trust
- in the local private key generated by \--init.
+ in the local private key generated by '\--init'.
*-r, \--receive* <keyserver> <keyid(s)>::
- Fetch the specified keyids from the specified key server URL.
+ Fetch the specified keyid(s) from the specified key server URL.
-*\--populate* [<keyring(s)>]::
+*\--populate* [keyring(s)]::
Reload the default keys from the (optionally provided) keyrings in
+{pkgdatadir}/keyrings+. For more information, see
<<SC,Providing a Keyring for Import>> below.
*-u, \--updatedb*::
- Equivalent to \--check-trustdb in GnuPG.
+ Equivalent to '\--check-trustdb' in GnuPG.
*-v, \--verify* <signature>::
Verify the given signature file.
@@ -113,7 +113,7 @@ repository adding keys to the pacman keyring without the users knowledge.
A key being marked as revoked always takes priority over the key being added to
the pacman keyring, regardless of the keyring it is provided in. To prevent a
-key from being revoked when using --populate, its ID can be listed in
+key from being revoked when using '\--populate', its ID can be listed in
+{sysconfdir}/pacman.d/gnupg/holdkeys+.
See Also