[shepherd] branch master updated: doc: Mention "daemonizing" processes for 'make-forkexec-constructor'.

[Ludovic Courtès]

This is an automated email from the git hooks/post-receive script.

civodul pushed a commit to branch master
in repository shepherd.

The following commit(s) were added to refs/heads/master by this push:
     new 3bc4a9c  doc: Mention "daemonizing" processes for 
'make-forkexec-constructor'.
3bc4a9c is described below

commit 3bc4a9c96c76abf78c76d71d42536e62ea173b21
Author: Ludovic Courtès <address@hidden>
AuthorDate: Sun Mar 8 12:18:09 2020 +0100

    doc: Mention "daemonizing" processes for 'make-forkexec-constructor'.
    
    Suggested by Maxim Cournoyer <address@hidden>.
    It was found confusing as noted in <https://bugs.gnu.org/39708>.
    
    * doc/shepherd.texi (Service De- and Constructors): Add note about
    processes that daemonize.
---
 doc/shepherd.texi | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/shepherd.texi b/doc/shepherd.texi
index 2f264a8..9ecd2ab 100644
--- a/doc/shepherd.texi
+++ b/doc/shepherd.texi
@@ -903,7 +903,9 @@ the current directory to @var{directory}, changes the 
environment to
 @var{environment-variables} (using the @code{environ} procedure), sets the
 current user to @var{user} and the current group to @var{group} unless they
 are @code{#f}, and executes @var{command} (a list of strings.)  The result of
-the procedure will be the PID of the child process.
+the procedure will be the PID of the child process.  Note that this will
+not work as expected if the process ``daemonizes'' (forks); in that
+case, you will need to pass @code{#:pid-file}, as explained below.
 
 When @var{pid-file} is true, it must be the name of a PID file
 associated with the process being launched; the return value is the PID