diff options
author | Bart Schaefer <schaefer@zsh.org> | 2024-02-20 20:16:03 -0800 |
---|---|---|
committer | Bart Schaefer <schaefer@zsh.org> | 2024-02-20 20:16:03 -0800 |
commit | 6b21e5c0e201876f6659b563b56da9a993ae6c03 (patch) | |
tree | a8495275a78da67503895da1a30df15ee676152f /Doc/Zsh/builtins.yo | |
parent | a6ea12286709273e7896916dc8a107cd52f01d26 (diff) | |
download | zsh-6b21e5c0e201876f6659b563b56da9a993ae6c03.tar.gz zsh-6b21e5c0e201876f6659b563b56da9a993ae6c03.tar.xz zsh-6b21e5c0e201876f6659b563b56da9a993ae6c03.zip |
52559: revise "typeset -p" with respect to local readonly special parameters
Update doc and tests to describe handling of global readonly specials and to account for side-effects on zsh/param/private.
Diffstat (limited to 'Doc/Zsh/builtins.yo')
-rw-r--r-- | Doc/Zsh/builtins.yo | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo index 7a8654f27..784089594 100644 --- a/Doc/Zsh/builtins.yo +++ b/Doc/Zsh/builtins.yo @@ -2136,6 +2136,14 @@ tt(-p) may be followed by an optional integer argument. Currently only the value tt(1) is supported. In this case arrays and associative arrays are printed with newlines between indented elements for readability. + +The names and values of readonly special parameters +(most of the parameters marked `<S>' in +ifzman(zmanref(zshparam))ifnzman(noderef(Parameters Set By The Shell)), +except those documented as settable) +are not printed with `tt(-)tt(p)' because to execute those typeset commands +would cause errors. However, these parameters are printed when they +have been made local to the scope where `tt(typeset -p)' is run. ) item(tt(-T) [ var(scalar)[tt(=)var(value)] var(array)[tt(=LPAR())var(value) ...tt(RPAR())] [ var(sep) ] ])( This flag has a different meaning when used with tt(-f); see below. |