Merge of unposted: extra documentation arising out of discoveries by Bart in zsh-users/10626 and 22653.

1 files changed, 9 insertions, 1 deletions

diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index f0bbc56c3..19f5b3356 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -1268,7 +1268,8 @@ item(tt(file-list))(
 This style controls whether files completed using the standard builtin
 mechanism are to be listed with a long list similar to tt(ls -l)
 (although note that this feature actually uses the shell module
-tt(zsh/stat) for file information).
+tt(zsh/stat) for file information; this loads the builtin tt(stat)
+which will replace any external tt(stat) executable).
 
 The style may either be set to a true value (or `tt(all)'), or
 one of the values `tt(insert)' or `tt(list)', indicating that files
@@ -1750,6 +1751,9 @@ escape sequences `tt(%S)', `tt(%s)', `tt(%B)', `tt(%b)', `tt(%U)',
 standout, bold and underline are also available, as is the form
 `tt(%{)...tt(%})' for enclosing escape sequences which display with zero
 width.
+
+After deleting this prompt the variable tt(LISTPROMPT) should be unset for
+the the removal to take effect.
 )
 kindex(list-rows-first, completion style)
 item(tt(list-rows-first))(
@@ -2623,6 +2627,10 @@ example(zle -C all-matches complete-word _generic
 bindkey '^Xa' all-matches
 zstyle ':completion:all-matches:*' old-matches only
 zstyle ':completion:all-matches::::' completer _all_matches)
+
+Note that this does not generate completions by itself.  First use
+any of the standard ways of generating a list of completions,
+then use tt(^Xa) to show all matches.
 )
 findex(_approximate)
 item(tt(_approximate))(