[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