54241 + 54242: use extra-verbose style in _parameters

add notes in the description of extra-verbose style in zshcompsys(1)

ChangeLog

@@ -1,3 +1,10 @@
+2026-03-24  Jun-ichi Takimoto  <takimoto-j@kba.biglobe.ne.jp>
+
+	* 54241 + 54242: Completion/Unix/Type/_path_commands,
+	Completion/Zsh/Type/_parameters, Doc/Zsh/compsys.yo,
+	Test/Y01completion.ztst: use extra-verbose style for displaying
+	parameter values when completing parameter names
+
 2026-03-09  Jun-ichi Takimoto  <takimoto-j@kba.biglobe.ne.jp>
 
 	* unposted: Doc/zman.yo: fix an error in nmref()

Completion/Unix/Type/_path_commands

@@ -57,7 +57,7 @@ _call_whatis() {
 _path_commands() {
 local need_desc expl ret=1
 
-if zstyle -t ":completion:${curcontext}:" extra-verbose; then
+if zstyle -t ":completion:${curcontext}:commands" extra-verbose; then
   local update_policy first
   if [[ $+_command_descriptions -eq 0 ]]; then
     first=yes

Completion/Zsh/Type/_parameters

@@ -16,7 +16,7 @@ zstyle -t ":completion:${curcontext}:parameters" prefix-needed &&
 _description parameters expl parameter
 zparseopts -D -K -E g:=pattern
 
-if zstyle -T ":completion:${curcontext}:parameters" verbose; then
+if zstyle -t ":completion:${curcontext}:parameters" extra-verbose; then
   described=(
       "${(@M)${(@k)parameters[(R)$~pattern[2]~*(hideval|local|special)*]}:#$~pfilt*}"
   )

Doc/Zsh/compsys.yo

@@ -1375,9 +1375,12 @@ However, menu completion can be used to cycle through all matches.
 )
 kindex(extra-verbose, completion style)
 item(tt(extra-verbose))(
-If set, the completion listing is more verbose at the cost of
-a probable decrease in completion speed.  Completion performance
-will suffer if this style is set to `true'.
+If this style set to `true', the completion listing is still more verbose.
+
+Currently, it is used for tt(commands) and tt(parameters) tags.
+If it is `true' for the tt(commands) (or tt(parameters)) tag, short
+descriptions of the commands (or the values of the parameters) are
+displayed along with the command (or parameter) names.
 )
 kindex(fake, completion style)
 item(tt(fake))(

Test/Y01completion.ztst

@@ -329,10 +329,10 @@ F:regression test workers/31611
   comptesteval "typeset -a bar=({$'\\0'..$'\\C-?'})"
   comptesteval 'typeset -A bat=( "$bar[@]" )'
   comptesteval 'typeset bay="$bar"'
-  comptesteval 'zstyle ":completion:*:parameters" verbose yes'
+  comptesteval 'zstyle ":completion:*:parameters" extra-verbose yes'
   comptesteval 'zstyle ":completion:*" fake-parameters bar bat bay'
   comptest $': $ba\t'
-0:verbose shows parameter values
+0:extra-verbose shows parameter values
 >line: {: $ba}{}
 >DESCRIPTION:{parameter}
 >NO:{bar  -- ( '^@' '^A' '^B' '^C' '^D' '^E' '^F' '^G' '^H' '\t' '\n' '^K' '^L' '}