From a31fd3077d64bb319e9caabf4109721b9778a02d Mon Sep 17 00:00:00 2001 From: Bart Schaefer Date: Mon, 6 Sep 2021 12:46:28 -0700 Subject: 48888: improve doc for $$ and $PPID, add fail test for PPID readonly-ness --- Doc/Zsh/mod_system.yo | 6 +++--- Doc/Zsh/params.yo | 15 ++++++++------- 2 files changed, 11 insertions(+), 10 deletions(-) (limited to 'Doc') 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($) )( -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(-) )( @@ -817,9 +818,9 @@ The operating system, as determined at compile time. ) vindex(PPID) item(tt(PPID) )( -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))( -- cgit 1.4.1