mirrors
/
zsh
mirror of git://git.code.sf.net/p/zsh/code
1
0
Fork 0
Code Releases Activity

46132: docs: Use an itemized list in the documentation of the *(o) glob qualifier. 

This should be easier to read, both as a tutorial and as a reference.
This commit is contained in:
Daniel Shahaf 2020-06-26 18:52:21 +00:00
parent a4b4a3a7c7
commit f636cde7b5
2 changed files with 21 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
ChangeLog
View File

@ -1,5 +1,8 @@
2020-06-28 Daniel Shahaf <d.s@daniel.shahaf.name>
* 46132: Doc/Zsh/expn.yo: docs: Use an itemized list in the
documentation of the *(o) glob qualifier.
* 46131: Completion/Unix/Command/_git: _git-config: Partly
fix a bug whereby a 'foo.ba<TAB>' wouldn't be completed to
'foo.bar.baz'.

28
Doc/Zsh/expn.yo
View File

@ -2869,18 +2869,26 @@ matches in directory traversal order will be considered.
Implies tt(oN) when no tt(o)var(c) qualifier is used.
)
item(tt(o)var(c))(
specifies how the names of the files should be sorted. If var(c) is
tt(n) they are sorted by name; if it is tt(L) they
are sorted depending on the size (length) of the files; if tt(l)
they are sorted by the number of links; if tt(a), tt(m), or tt(c)
they are sorted by the time of the last access, modification, or
inode change respectively; if tt(d), files in subdirectories appear before
specifies how the names of the files should be sorted. The following values
of var(c) sort in the following ways:
startsitem()
sitem(tt(n))(By name.)
sitem(tt(L))(By the size (length) of the files.)
sitem(tt(l))(By number of links.)
sitem(tt(a))(By time of last access, youngest first.)
sitem(tt(m))(By time of last modification, youngest first.)
sitem(tt(c))(By time of last inode change, youngest first.)
sitem(tt(d))(By directories: files in subdirectories appear before
those in the current directory at each level of the search DASH()- this is best
combined with other criteria, for example `tt(odon)' to sort on names for
files within the same directory; if tt(N), no sorting is performed.
Note that tt(a), tt(m), and tt(c) compare
the age against the current time, hence the first name in the list is the
youngest file. Also note that the modifiers tt(^) and tt(-) are used,
files within the same directory.)
sitem(tt(N))(No sorting is performed.)
xitem(tt(e)var(string))
sitem(tt(+)var(cmd))(Sort by shell code (see below).)
endsitem()
Note that the modifiers tt(^) and tt(-) are used,
so `tt(*(^-oL))' gives a list of all files sorted by file size in descending
order, following any symbolic links. Unless tt(oN) is used, multiple order
specifiers may occur to resolve ties.