summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorMikael Magnusson <mikachu@gmail.com>2025-05-22 03:35:19 +0200
committerMikael Magnusson <mikachu@gmail.com>2025-05-22 04:03:18 +0200
commitbfb8ec65a6dabc2f16e3a1fc7e96fdeca8c985ef (patch)
tree19162e06ee20006c97dce8a7ec0df173a455c1d7 /Doc
parent53636: docs: clarify valid parameter names (diff)
downloadzsh-bfb8ec65a6dabc2f16e3a1fc7e96fdeca8c985ef.tar
zsh-bfb8ec65a6dabc2f16e3a1fc7e96fdeca8c985ef.tar.gz
zsh-bfb8ec65a6dabc2f16e3a1fc7e96fdeca8c985ef.tar.bz2
zsh-bfb8ec65a6dabc2f16e3a1fc7e96fdeca8c985ef.tar.lz
zsh-bfb8ec65a6dabc2f16e3a1fc7e96fdeca8c985ef.tar.xz
zsh-bfb8ec65a6dabc2f16e3a1fc7e96fdeca8c985ef.tar.zst
zsh-bfb8ec65a6dabc2f16e3a1fc7e96fdeca8c985ef.zip
53660: Clarify namespaces starting with a .
Diffstat (limited to 'Doc')
-rw-r--r--Doc/Zsh/expn.yo4
-rw-r--r--Doc/Zsh/params.yo7
2 files changed, 6 insertions, 5 deletions
diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo
index 1db65d24f..70212dbc8 100644
--- a/Doc/Zsh/expn.yo
+++ b/Doc/Zsh/expn.yo
@@ -616,9 +616,7 @@ the format `tt(.)var(identifier)tt(.)' This currently has no special
meaning to the shell, but provides a convenient means of grouping
related parameters. Expansions using a namespace em(must) include
braces (tt({) and tt(})) as shown in the descriptions below, and
-only one namespace prefix is allowed. Note that, for support of
-possible future features, the first `tt(.)' is optional, but omitting
-it is discouraged.
+only one namespace prefix is allowed.
In the expansions discussed below that require a pattern, the form of
the pattern is the same as that used for filename generation;
diff --git a/Doc/Zsh/params.yo b/Doc/Zsh/params.yo
index 59e964519..0a550cf96 100644
--- a/Doc/Zsh/params.yo
+++ b/Doc/Zsh/params.yo
@@ -67,8 +67,11 @@ with a `tt(.)' prefix are not listed by the `tt(set)' builtin, nor
shown by the `tt(typeset)' builtin unless explicitly named or the
`tt(-m)' option is used. They provide a convenient way to group
related variables. Note that, for support of possible future features,
-the first `tt(.)' is optional, but omitting it is discouraged. Unlike
-ksh, a namespace need not be declared before it is referenced.
+the first `tt(.)' is optional, but omitting it is discouraged. Note also
+that a name starting with a `tt(.)' does not refer to the same parameter
+as one that does not, eg, `tt(.foo.bar)' and `tt(foo.bar)' are distinct
+parameters. Unlike ksh, a namespace need not be declared before it
+is referenced.
In scalar assignment, var(value) is expanded as a single string, in
which the elements of arrays are joined together; filename expansion is