[src/trunk]: src/bin/sh Note in the description of "jobs -p" that the process...

[kre <kre%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/d3606241a6f5
branches:  trunk
changeset: 372192:d3606241a6f5
user:      kre <kre%NetBSD.org@localhost>
date:      Sun Oct 30 01:19:08 2022 +0000

description:
Note in the description of "jobs -p" that the process id returned is
also the process group identifier (that's a requirement from POSIX, and
is what we have always done - just not been explicit about in sh.1).
Add a note that this value and $! are not necessarily the same (currently,
and perhaps forever, never the same in a pipeline with 2 or more elements).

diffstat:

 bin/sh/sh.1 |  8 ++++++--
 1 files changed, 6 insertions(+), 2 deletions(-)

diffs (22 lines):

diff -r 320435216243 -r d3606241a6f5 bin/sh/sh.1
--- a/bin/sh/sh.1       Sun Oct 30 01:05:47 2022 +0000
+++ b/bin/sh/sh.1       Sun Oct 30 01:19:08 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sh.1,v 1.250 2022/09/18 06:03:19 kre Exp $
+.\"    $NetBSD: sh.1,v 1.251 2022/10/30 01:19:08 kre Exp $
 .\" Copyright (c) 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
 .\"
@@ -3310,7 +3310,11 @@
 With the
 .Fl p
 flag, the output contains only the process identifier of the lead
-process.
+process (which is also the process group identifier).
+Note that this is not necessarily the same process identifier as
+reported in the special parameter
+.Dv \&!
+when a background job is started.
 .Pp
 With the
 .Fl Z