diff options
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/Zsh/compsys.yo | 20 | ||||
| -rw-r--r-- | Doc/Zsh/mod_complist.yo | 24 |
2 files changed, 26 insertions, 18 deletions
diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo index 84d301e5a..547db492b 100644 --- a/Doc/Zsh/compsys.yo +++ b/Doc/Zsh/compsys.yo @@ -1274,11 +1274,21 @@ completion lists that don't fit on the screen can be scrolled (see ifzman(the description of the tt(zsh/complist) module in zmanref(zshmodules))\ ifnzman(noderef(The zsh/complist Module))\ ). The value will be displayed after every screenful, prompting for a -key and may contain the escape `tt(%l)' which will be replaced by the -number of the last line displayed and the total number of lines. As +key press. It may contain the escape `tt(%l)' or `tt(%L)' which will be +replaced by the number of the last line displayed and the total number +of lines. A `tt(%m)' or `tt(%M)' will be replaced by the number of the +last match shown and the total number of matches and `tt(%p)' and +`tt(%P)' will be replaced by `tt(Top)' when at the beginning of the +list, `tt(Bottom)' when at the end and the position shown in percent +of the total length. In each of these cases the form with the +uppercase letter is replaced by a string of fixed width, padded to the +right with spaces. As usual, the `tt(%S)', `tt(%s)', `tt(%B)', `tt(%b)', `tt(%U)', `tt(%u)', and `tt(%{)...tt(%})' escapes for the terminal display modes are understood, too. + +Note that this style has a default value. If you don't want to use +scrolling, set this style to an empty string. ) kindex(list-rows-first, completion style) item(tt(list-rows-first))( @@ -1578,11 +1588,7 @@ If this is set to a non-empty string for the tt(default) tag, its value will be displayed during menu-selection (see the tt(menu) style above) when the completion list does not fit on the screen as a whole. The same escapes as for the tt(list-prompt) style are -understood, plus `tt(%m)' which is replaced by the number of the -currently selected match and the total number of matches and `tt(%p)' -which is replaced by `tt(Top)' when the mark is on the first line, -`tt(Bottom)' when it is on the last line and the relative position of -the mark in the list given as a percentage. +understood, but give the number of the match or line the mark is on. ) kindex(select-scroll, completion style) item(tt(select-scroll))( diff --git a/Doc/Zsh/mod_complist.yo b/Doc/Zsh/mod_complist.yo index 63039c5d1..4a6429e79 100644 --- a/Doc/Zsh/mod_complist.yo +++ b/Doc/Zsh/mod_complist.yo @@ -159,10 +159,16 @@ currently selected. If the parameter tt(LISTPROMPT) is set, its value will be used as the prompt. The value may contain escapes of the form `tt(%x)'. It supports the escapes `tt(%B)', `tt(%b)', `tt(%S)', `tt(%s)', `tt(%U)', -`tt(%u)' and `tt(%{...%})' known from the shell prompts and the -additional sequence `tt(%l)' which is replaced by the number of the -last line shown and the total number of lines in the form -`var(number)tt(/)var(total)'. +`tt(%u)' and `tt(%{...%})' known from the shell prompts and three +pairs of additional sequences. A `tt(%l)' or `tt(%L)' is replaced by +the number of the last line shown and the total number of lines in the form +`var(number)tt(/)var(total)'. A `tt(%m)' or `tt(%M)' is replaced with +the number of the last match shown and the total number of matches and +`tt(%p)' or `tt(%P)' is replaced with `tt(Top)', `tt(Bottom)' or the +position of the first line shown in percent of the total number of +lines, respectively. In each of these cases the one with the uppercase +letter will be replaced with a string of fixed width, padded to the +right with spaces. As for the tt(ZLS_COLORS) and tt(ZLS_COLOURS) parameters, tt(LISTPROMPT) should not be set directly when using the shell @@ -207,13 +213,9 @@ control sequence as for the `tt(%S)' escape in prompts is used. If there are more matches than fit on the screen and the parameter tt(SELECTPROMPT) is set, its value will be shown below the -matches. Next to the escape sequences understood for the -tt(LISTPROMPT) parameter, a `tt(%m)' will be replaced by a string -containing the number of the match the mark is on and the total number -of matches in the form `var(number)tt(/)var(total)' and the sequence -`tt(%p)' will be replaced with `tt(Top)', `tt(Bottom)' or the position -in percent of the total size when the mark is in the first line, in -the last line or somewhere in between, respectively. +matches. It supports the sames escape sequences as tt(LISTPROMPT), but +the number of the match or line shown will be that of the one where +the mark is placed. The tt(SELECTSCROLL) parameter can be used to specify how the list is scrolled. If the parameter is unset, this is done line by line, if it |