diff options
| author | dana <dana@dana.is> | 2019-12-20 15:31:34 -0600 |
|---|---|---|
| committer | dana <dana@dana.is> | 2019-12-20 15:31:34 -0600 |
| commit | 6fd40238256bf05e855bd728289740e9e21eae44 (patch) | |
| tree | 3ddbe455e4e1f7f6ce1bbbcd6fb5f81880b3b319 | |
| parent | fd068221b7fbbcfe89ec74c7eeb0138e90e14b13 (diff) | |
| download | zsh-6fd40238256bf05e855bd728289740e9e21eae44.tar.gz zsh-6fd40238256bf05e855bd728289740e9e21eae44.tar.xz zsh-6fd40238256bf05e855bd728289740e9e21eae44.zip | |
45055: Clarify _files documentation
| -rw-r--r-- | ChangeLog | 4 | ||||
| -rw-r--r-- | Doc/Zsh/compsys.yo | 9 |
2 files changed, 10 insertions, 3 deletions
diff --git a/ChangeLog b/ChangeLog index 897114d3f..a0e6915f5 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2019-12-20 dana <dana@dana.is> + + * 45055: Doc/Zsh/compsys.yo: Clarify _files documentation + 2019-12-18 Peter Stephenson <p.stephenson@samsung.com> * 45083: Src/exec.c: execarith() needs signal protection as diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo index db669fae3..130e85148 100644 --- a/Doc/Zsh/compsys.yo +++ b/Doc/Zsh/compsys.yo @@ -4518,9 +4518,12 @@ New plugins will be picked up and run automatically. ) findex(_files) item(tt(_files))( -The function tt(_files) calls tt(_path_files) with all the arguments it -was passed except for tt(-g) and tt(-/). The use of these two options -depends on the setting of the tt(file-patterns) style. +The function tt(_files) is a wrapper around tt(_path_files). It supports +all of the same functionality, with some enhancements DASH()- notably, it +respects the tt(list-dirs-first) style, and it allows users to override +the behaviour of the tt(-g) and tt(-/) options with the tt(file-patterns) +style. tt(_files) should therefore be preferred over tt(_path_files) in +most cases. This function accepts the full set of options allowed by tt(_path_files), described below. |