aboutsummaryrefslogtreecommitdiff
path: root/Doc
diff options
context:
space:
mode:
authorBart Schaefer <schaefer@ipost.com>2021-09-06 12:46:28 -0700
committerBart Schaefer <schaefer@ipost.com>2021-09-06 12:46:28 -0700
commita31fd3077d64bb319e9caabf4109721b9778a02d (patch)
treec154af414e3262deb3738d523161693dcaac8250 /Doc
parentc0e5b212f32b3349e963ab2c49a2576bad9e7a08 (diff)
downloadzsh-a31fd3077d64bb319e9caabf4109721b9778a02d.tar.gz
zsh-a31fd3077d64bb319e9caabf4109721b9778a02d.tar.xz
zsh-a31fd3077d64bb319e9caabf4109721b9778a02d.zip
48888: improve doc for $$ and $PPID, add fail test for PPID readonly-ness
Diffstat (limited to 'Doc')
-rw-r--r--Doc/Zsh/mod_system.yo6
-rw-r--r--Doc/Zsh/params.yo15
2 files changed, 11 insertions, 10 deletions
diff --git a/Doc/Zsh/mod_system.yo b/Doc/Zsh/mod_system.yo
index 8f525c576..399b6fe03 100644
--- a/Doc/Zsh/mod_system.yo
+++ b/Doc/Zsh/mod_system.yo
@@ -263,9 +263,9 @@ tt($$), which returns the process ID of the main shell process.
)
item(tt(ppid))(
vindex(ppid, sysparams)
-Returns the process ID of the parent of the current process, even in
-subshells. Compare tt($PPID), which returns the process ID of the parent
-of the main shell process.
+Returns the current process ID of the parent of the current process, even
+in subshells. Compare tt($PPID), which returns the process ID of the
+initial parent of the main shell process.
)
item(tt(procsubstpid))(
Returns the process ID of the last process started for process
diff --git a/Doc/Zsh/params.yo b/Doc/Zsh/params.yo
index dc28a45ae..b514eb072 100644
--- a/Doc/Zsh/params.yo
+++ b/Doc/Zsh/params.yo
@@ -654,10 +654,11 @@ Same as tt(#).
)
vindex($)
item(tt($) <S>)(
-The process ID of this shell. Note that this indicates the original
-shell started by invoking tt(zsh); all processes forked from the shells
-without executing a new program, such as subshells started by
-tt(LPAR())var(...)tt(RPAR()), substitute the same value.
+The process ID of this shell, set when the shell initializes. Processes
+forked from the shell without executing a new program, such as command
+substitutions and commands grouped with tt(LPAR())var(...)tt(RPAR()),
+are subshells that duplicate the current shell, and thus substitute the
+same value for tt($$) as their parent shell.
)
vindex(-)
item(tt(-) <S>)(
@@ -817,9 +818,9 @@ The operating system, as determined at compile time.
)
vindex(PPID)
item(tt(PPID) <S>)(
-The process ID of the parent of the shell. As for tt($$), the
-value indicates the parent of the original shell and does not
-change in subshells.
+The process ID of the parent of the shell, set when the shell initializes.
+As with tt($$), the value does not change in subshells created as a
+duplicate of the current shell.
)
vindex(PWD)
item(tt(PWD))(