[PATCH v2] dirmngr: Clarify deprecation of --daemon without --homedir.

Daniel Kahn Gillmor dkg at fifthhorseman.net
Thu Nov 10 14:34:55 CET 2016

* doc/dirmngr.texi: Clarify that --daemon is only deprecated without


The existing documentation claims that dirmngr --daemon is deprecated.

But "gpgconf --launch dirmngr" and "gpg-connect-agent --dirmngr" (the
two documented ways to reliably start dirmngr) both spawn dirmngr
using a --daemon argument.

I believe what's actually deprecated is --daemon *without* --homedir.

This patch attempts to clarify the documentation.

Debian-bug-id: 833565
Signed-off-by: Daniel Kahn Gillmor <dkg at fifthhorseman.net>
 doc/dirmngr.texi | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/dirmngr.texi b/doc/dirmngr.texi
index 6620a87..e059583 100644
--- a/doc/dirmngr.texi
+++ b/doc/dirmngr.texi
@@ -83,7 +83,8 @@ This is only used for testing.
 @opindex daemon
 Run in background daemon mode and listen for commands on a socket.
 Note that this also changes the default home directory and enables the
-internal certificate validation code.  This mode is deprecated.
+internal certificate validation code.  Running in @code{--daemon} mode
+without supplying @{--homedir} is deprecated.
 @item --supervised
 @opindex supervised
@@ -148,7 +149,8 @@ running mode:
 @item With @code{--daemon} given on the commandline
 the directory named @file{@value{SYSCONFDIR}} is used for configuration files
-and @file{@value{LOCALCACHEDIR}} for cached CRLs.
+and @file{@value{LOCALCACHEDIR}} for cached CRLs.  This mode of operation
+(@code{--daemon} but no explicit @code{--homedir}) is deprecated.
 @item Without @code{--daemon} given on the commandline
 the directory named @file{.gnupg} directly below the home directory

More information about the Gnupg-devel mailing list