doc: Document gpgsm's --keyserver option.

--

Also fix a few related entries.

Signed-off-by: Werner Koch <wk@gnupg.org>

2 files changed, 20 insertions, 3 deletions

diff --git a/doc/dirmngr.texi b/doc/dirmngr.texi
index eb9a92160..c841de77e 100644
--- a/doc/dirmngr.texi
+++ b/doc/dirmngr.texi
@@ -399,9 +399,10 @@ configured LDAP server if the connection using the "proxy" failed.
 
 @item --ldapserverlist-file @var{file}
 @opindex ldapserverlist-file
-Read the list of LDAP servers to consult for CRLs and certificates from
-file instead of the default per-user ldap server list file. The default
-value for @var{file} is @file{dirmngr_ldapservers.conf}.
+Read a list of LDAP servers to consult for CRLs and certificates from
+file.  This servers from this list are used after any servers set by a
+client for its session. The default value for @var{file} is
+@file{dirmngr_ldapservers.conf}.
 
 This server list file contains one LDAP server per line in the format
 
diff --git a/doc/gpgsm.texi b/doc/gpgsm.texi
index ecc43cd3c..0745f8626 100644
--- a/doc/gpgsm.texi
+++ b/doc/gpgsm.texi
@@ -347,6 +347,22 @@ Outputs additional information while running.
 You can increase the verbosity by giving several
 verbose commands to @command{gpgsm}, such as @samp{-vv}.
 
+
+@item --keyserver @var{string}
+@opindex keyserver
+Add an LDAP server to use for certificate and CRL lookup.  This option
+can be given multiple times to configure more than one LDAP server.
+Note that the @command{dirmngr} can in addition be configured with a
+default list of LDAP servers to be used after those configured with
+this option.  The syntax of @var{string} is:
+
+@sc{hostname:port:username:password:base_dn}
+
+Note that all parts of that string are expected to be UTF-8 encoded.
+This may lead to problems if the @sc{password} has originally been
+encoded as Latin-1; in such a case better configure this LDAP server
+using the global configuration of @command{dirmngr}.
+
 @item --policy-file @var{filename}
 @opindex policy-file
 Change the default name of the policy file to @var{filename}.  The