X-Git-Url: https://git.sthu.org/?a=blobdiff_plain;f=keylookup%2Fkeylookup.1;h=6f06ee9dd16f03b7951d5429232ec2805d4d9a77;hb=a22fce97e4ae55320bd3e66ea305567f3c83db20;hp=b65df485294e3d0e06bf5b8c255f89f6974828c9;hpb=67dd4a1be7a4b664a036d59aba8a8113fb899153;p=pgp-tools.git

diff --git a/keylookup/keylookup.1 b/keylookup/keylookup.1
index b65df48..6f06ee9 100644
--- a/keylookup/keylookup.1
+++ b/keylookup/keylookup.1
@@ -1,75 +1,109 @@
-.TH keylookup 1 "" 2005-08-16 ""
+.TH keylookup 1 "" Jun-2002 ""
 .\" manual page (c) 2000, 2001, 2002 Christian Kurz, Peter Palfrader
-.\" manual page (c) 2005 Christoph Berg
 .\" $Id$
+
 .SH NAME
 .LP
-keylookup \- Fetch and Import GnuPG keys from keyservers.
+keylookup - Fetch and Import GnuPG keys from keyservers.
+
 .SH SYNOPSIS
 \fBkeylookup\fP [\fIoptions\fP] \fIsearch-string\fP
+
 .SH DESCRIPTION
 .LP
-\fBkeylookup\fR is a perl script that queries a keyserver for keys 
-matching the \fIsearch-string\fP. It shows a list to the user and offers 
-her/him to select the keys for importing into her/his GnuPG keyring.
-For the actual import of keys GnuPG itself is called.
+\fBkeylookup\fR is a wrapper around gpg \-\-search, allowing you to search
+for keys on a keyserver.  It presents the list of matching keys to the user
+and allows her to select the keys for importing into the GnuPG keyring.
+
+For the search and actual import of keys GnuPG itself is called.
+
+
 .SH OPTIONS
-.IP "\fB--keyserver\fP=\fIkeyserver\fP" 8
+.IP "\fB\-\-keyserver\fP=\fIkeyserver\fP" 8
 Specify the keyserver to use. If no keyserver is specified, it 
 will parse the GnuPG options file for a default keyserver to use.
 If no keyserver can be found, \fBkeylookup\fP will abort.
-.IP "\fB--port\fP=\fIport\fP" 8
+
+.IP "\fB\-\-port\fP=\fIport\fP" 8
 Use a port other than 11371.
-.IP "\fB--frontend\fP=\fIfrontend\fP" 8
+
+.IP "\fB\-\-frontend\fP=\fIfrontend\fP" 8
 \fBkeylookup\fP supports displaying the search results with 3
 different frondends. Both \fBwhiptail\fP and \fBdialog\fP are
 interactive and allow the user to select the keys to import.
 The third frontend \fBplain\fP is non\-interactive and just 
 prints the keys to STDOUT. The user must then call GnuPG him/herself.
+
 If available, \fB/usr/bin/dialog\fP is the default. If it is not
 available but \fB/usr/bin/whiptail\fP is installed, then this is 
 used instead. If nothing else works, we'll fall back to \fBplain\fP.
-.IP "\fB--importall\fP" 8
+
+.IP "\fB\-\-importall\fP" 8
 Don't ask the user which keys to import, but instead import all 
 keys matching the \fIsearch-string\fP. If this is given no 
 frontend is needed.
-.IP "\fB--honor-http-proxy\fP" 8
+
+.IP "\fB\-\-honor\-http\-proxy\fP" 8
 Similar to GnuP \fBkeylookup\fP will only honor the \fBhttp_proxy\fP
 environment variable if this option is given. If it is not given
 but your GnuPG options file includes it, then \fBkeylookup\fP will 
 use it.
-.IP "\fB--help\fP" 8
-Print a brief help message and exit succesfully.
+
+.IP "\fB\-\-help\fP" 8
+Print a brief help message and exit successfully.
+
+
+
 .SH ENVIRONMENT
+
 .IP "HOME" 10 
 Used to locate the default home directory. 
+
 .IP "GNUPGHOME" 10 
 If set directory used instead of "~/.gnupg". 
+
 .IP "http_proxy" 10 
-Only honored when the option --honor-http-proxy is set or honor-http-proxy is
-set in GnuPG's config file.
+Only honored when the option \-\-honor\-http\-proxy is set or
+honor\-http\-proxy is set in GnuPG's config file.
+
+
+
 .SH EXAMPLES
+
 .IP "keylookup Christian Kurz"
 will query your default keyserver for Christian's keys and offer you to
 import them into your keyring with the dialog frontend (if available).
-.IP "keylookup --honor-http-proxy --frontend plain wk@gnupg"
+
+.IP "keylookup \-\-honor\-http\-proxy \-\-frontend plain wk@gnupg"
 will query the default keyserver again, now using the http_proxy if
 the environment variable is defined and list wk@gnupg's (Werner Koch)'s key
 on STDOUT.
-.IP "keylookup --keyserver pgp.mit.edu Peter Palfrader"
+
+.IP "keylookup \-\-keyserver pgp.mit.edu Peter Palfrader"
 will now ask the keyserver pgp.mit.edu for my (Peter's) keys and
 display them for import in dialog.
+
+
 .SH FILES
+
 .IP "~/.gnupg/options"  10
 GnuPG's options file where \fBkeylookup\fP will take the keyserver
-and honor-http-proxy values from if it exists.
+and honor\-http\-proxy values from if it exists.
+
+
 .SH "SEE ALSO"
+
 \fBgpg\fP(1)
+
 .SH BUGS
+
 .LP
 Please report bugs using the Debian bug tracking system at
 http://bugs.debian.org/.
+
+
 .SH AUTHORS
+
 .LP
 Christian Kurz <shorty@debian.org>
 .br