diff options
Diffstat (limited to 'Doc/Zsh')
-rw-r--r-- | Doc/Zsh/compsys.yo | 9 | ||||
-rw-r--r-- | Doc/Zsh/compwid.yo | 34 |
2 files changed, 21 insertions, 22 deletions
diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo index f532ee2d4..fbe5ac265 100644 --- a/Doc/Zsh/compsys.yo +++ b/Doc/Zsh/compsys.yo @@ -835,10 +835,11 @@ item(tt(hosts-ports-users))( Like tt(hosts-ports) but used for commands like tt(telnet) and containing strings of the form `var(host)tt(:)var(port)tt(:)var(user)'. ) -item(tt(ignored-suffixes))( -This style is used with the tt(files) tag and gives suffixes of -filenames to ignore. The matches ignored will only be completed when -there are no other matches. It it is a more configurable version +item(tt(ignored-patterns))( +This style is used with the tags used when adding matches and gives a +number of patterns. All matches that are matched by any of these +patterns will be ignored as long as there are other matches not +matched by any of the patterns. It is a more configurable version of the shell parameter tt($fignore). ) item(tt(insert-unambiguous))( diff --git a/Doc/Zsh/compwid.yo b/Doc/Zsh/compwid.yo index c32cc402d..d15ee98b2 100644 --- a/Doc/Zsh/compwid.yo +++ b/Doc/Zsh/compwid.yo @@ -532,29 +532,27 @@ for testing. Hence it is only useful if combined with the tt(-f) flag, as the tests will not otherwise be performed. ) item(tt(-a))( -The completion code may -build two sets of matches: the normal one where words with one of the -suffixes in the array parameter tt(fignore) are not considered -possible matches, and the alternate set where the words excluded -from the first set are stored. Normally only the matches in the first -set are used, but if this set is empty, the words from the alternate -set are used. - -The tt(compadd) builtin does not use the tt(fignore) parameter and -normally stores all words in the first set. With the tt(-a)-flag -given, however, the given var(words) are stored in the alternate set unless -this flag is overridden by the tt(-F) option. +The completion code may build two sets of matches: the normal and the +alternate set. Normally only the matches in the first set are used, +but if this set is empty, the words from the alternate set are +used. The completion code uses this mechanism, for example, to make +filenames without one of the suffixes defined with the tt(fignore) +shell parameter be preferred over filenames with one of these +suffixes. + +With the tt(-a)-flag given, the var(words) are stored in the alternate +set unless this flag is overridden by the tt(-F) option. ) item(tt(-F) var(array))( -Specifies an array containing suffixes in the same form as the -tt(fignore) parameter. Words with one of these suffixes are stored in -the alternate set of matches and words without one of these suffixes +Specifies an array containing patterns. +Words matching one of these patterns are stored in +the alternate set of matches and words that match none of the patterns are stored in the normal set. The var(array) may be the name of an array parameter or a list of -literal suffixes enclosed in parentheses and quoted, as in `tt(-F "(.o -.h)")'. If the name of an array is given, the elements of the array are -taken as the suffixes. +literal patterns enclosed in parentheses and quoted, as in `tt(-F "(*?.o +*?.h)")'. If the name of an array is given, the elements of the array are +taken as the patterns. ) item(tt(-Q))( This flag instructs the completion |