[PATCH] dirmngr: clarify deprecation of --daemon without --homedir

Daniel Kahn Gillmor dkg at fifthhorseman.net
Tue Aug 9 00:13:15 CEST 2016


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

--

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 033b5d3..126e7bb 100644
--- a/doc/dirmngr.texi
+++ b/doc/dirmngr.texi
@@ -88,7 +88,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 --list-crls
 @opindex list-crls
@@ -146,7 +147,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
-- 
2.8.1




More information about the Gnupg-devel mailing list