Update documentation of 'process-running-child-p'

* doc/lispref/processes.texi (Input to Processes): Document the
changes in return value of 'process-running-child-p'.

2 files changed, 9 insertions, 5 deletions

diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index 2a4bd8a067..f660b15938 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -1138,10 +1138,12 @@ The function returns @var{process}.
 @end defun
 
 @defun process-running-child-p &optional process
-This function will tell you whether a @var{process} has given control of
-its terminal to its own child process.  The value is @code{t} if this is
-true, or if Emacs cannot tell; it is @code{nil} if Emacs can be certain
-that this is not so.
+This function will tell you whether a @var{process} has given control
+of its terminal to its own child process.  If this is true, the
+function returns the numeric ID of the foreground process group of
+@var{process}; it returns @code{nil} if Emacs can be certain that this
+is not so.  The value is @code{t} if Emacs cannot tell whether this is
+true.
 @end defun
 
 @node Signals to Processes
diff --git a/etc/NEWS b/etc/NEWS
index 6d474437de..6323b24dae 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1242,9 +1242,11 @@ active region handling.
 +++
 ** deactivate-mark is now buffer-local.
 
++++
 ** `cl-the' now asserts that its argument is of the given type.
 
-** `process-running-child-p` may now return a numeric process
++++
+** `process-running-child-p' may now return a numeric process
 group ID instead of `t'.
 
 +++