Re: path PATH

[Ray Andrews <rayandrews@eastlink.ca>]

On 2023-01-29 13:21, Lawrence Velázquez wrote:
> On Sun, Jan 29, 2023, at 10:54 AM, Ray Andrews wrote:
>> BTW am I mistaken that 'hideval' is not discussed anywhere?
> Look up typeset -H in zshbuiltins(1).
>
No mention of 'hideval' that I can see.  It's not a stretch to 
understand that '-H' will set the attribute that is called 'hideval' but 
IMHO that should be explicit.  That's why I suggest that all this stuff 
be explained in one place, namely in the 'Parameters' section of the 
manual.


BTW since 'typeset -p' claims to display information in the same format 
as for the recreation of the parameter:

1 /aWorking/Zsh/Source/Wk 0 $ typeset -Hi zzz=123

1 /aWorking/Zsh/Source/Wk 0 $ typeset -p zzz
typeset -i zzz

... but if I run that output as a new command, the -H is clearly lost.  
'typeset -p' does not do what it claims to do.  Contrast my function (dp 
is the guts of it):

1 /aWorking/Zsh/Source/Wk 0 $ v zzz

Iv    zzz = !hidden!

... an integer with the 'hideval' attribute set.  Accurate and 
complete.  (Tho using my made-up contractions.) Long form:


1 /aWorking/Zsh/Source/Wk 0 $ allvars | grep zzz

zzz                       integer-hideval

'exported' and 'special' are discussed in the 'Parameters' section of 
the manual,  the others are not.  'readonly' is explicitly discussed in 
the above section of zshbuiltins but no other attribute names are.  
'hideval' is referenced in the 'PARAMETER EXPANSION' section of the 
manual but nowhere else.  It's not optimal.  It might take a paragraph 
or two to completely cover the subject, why not do that?  What is the 
virtue in having bits of information on one subject scattered all over?

Seems that the subsection 'Parameter Expansion Flags' under 't' does 
show them all.  So it wouldn't be much work to flesh out the information 
there and merge it into 'Parameters' for a complete understanding of the 
subject in one place.