53660: Clarify namespaces starting with a .

ChangeLog

@@ -1,3 +1,8 @@
+2025-05-22  Mikael Magnusson  <mikachu@gmail.com>
+
+	* 53660: Doc/Zsh/expn.yo, Doc/Zsh/params.yo: Clarify namespaces
+	starting with a .
+
 2025-05-19  dana  <dana@dana.is>
 
 	* 53636: Doc/Zsh/params.yo: clarify valid parameter names

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;

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