From 5d651fc8fd47d6e9193fb904abd0fb4bb1815911 Mon Sep 17 00:00:00 2001
From: Werner Koch <wk@gnupg.org>
Date: Wed, 20 Dec 2023 15:30:37 +0100
Subject: [PATCH] doc: Explain what to put into mailcap for gpg-wks-client.

--
---
 doc/wks.texi | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doc/wks.texi b/doc/wks.texi
index 26d8b96f6..a8d0455e5 100644
--- a/doc/wks.texi
+++ b/doc/wks.texi
@@ -243,6 +243,21 @@ Display a brief help page and exit.
 
 @end table
 
+@noindent
+@mansect examples
+@chapheading Examples
+
+To use the services with clients lacking integrated support, the
+mailcap mechanism can be used.  Simply put:
+@example
+application/vnd.gnupg.wks; \
+  @value{BINDIR}/gpg-wks-client -v --read --send; \
+  needsterminal; \
+  description=WKS message
+@end example
+into the @file{/etc/mailcap}.  This assumes that a /usr/lib/sendmail
+is installed.  With this configuration any real mail programs will run
+gpg-wks-client for messages received from a Web Key Service.
 
 @mansect see also
 @ifset isman