Re: Tagged parameters

[Peter Stephenson <p.w.stephenson@ntlworld.com>]

On 15/08/2023 15:30 Ray Andrews <rayandrews@eastlink.ca> wrote:
> On 2023-08-15 01:27, Peter Stephenson wrote:
>> Saying they have "no special meaning to the shell" is perhaps not a
>> 100% helpful description. since the fact of just having this option
>> associated with them is itself "special" in the way shown above.
>
> Thanks Peter.  "tags have no special meaning to the shell" is 
> anti-information.  Perhaps something like: "When a parameter is tagged, 
> it changes in no way except that the command: 'typeset -t' will make a 
> list of all tagged parameters along with their values."

Yes, it's worth doing something... here's my go.

pws

diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo
index 5eb9327..b8ce31a 100644
--- a/Doc/Zsh/builtins.yo
+++ b/Doc/Zsh/builtins.yo
@@ -2320,8 +2320,10 @@ readonly). Special variables that have been made readonly retain their value
 and readonly attribute when made local.
 )
 item(tt(-t))(
-Tags the named parameters.  Tags have no special meaning to the shell.
-This flag has a different meaning when used with tt(-f); see above.
+Tags the named parameters.  Tags only exist to mark the parameter for
+the user's own purposes: the set of tagged parameters can be queried
+using `tt(typeset -t)'.  They have no further special meaning to the
+shell.  This flag has a different meaning when used with tt(-f); see above.
 )
 item(tt(-u))(
 Convert the result to upper case whenever the parameter is expanded.