mirrors/make
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/make.git synced 2024-10-23 20:59:55 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

* doc/make.text (Wildcards): Document that glob results are sorted.

Browse source
This commit is contained in:
Paul Smith 2021-12-05 15:16:26 -05:00
parent 1d20aa7247
commit 55b993ae09
1 changed files with 12 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
doc/make.texi
View file

@ -2142,6 +2142,13 @@ The wildcard characters in @code{make} are @samp{*}, @samp{?} and
specifies a list of all the files (in the working directory) whose names
end in @samp{.c}.@refill
If an expression matches multiple files than the results will be
sorted.@footnote{Some older versions of GNU @code{make} did not sort the
results of wildcard expansion.} However multiple expressions will not be
globally sorted. For example, @file{*.c *.h} will list all the files whose
names end in @samp{.c}, sorted, followed by all the files whose names end in
@samp{.h}, sorted.
@cindex @code{~} (tilde)
@cindex tilde (@code{~})
@cindex home directory
@ -2309,6 +2316,11 @@ function. Note that this is different from how unmatched wildcards
behave in rules, where they are used verbatim rather than ignored
(@pxref{Wildcard Pitfall}).
As with wildcard expansion in rules, the results of the @code{wildcard}
function are sorted. But again, each individual expression is sorted
separately, so @samp{$(wildcard *.c *.h)} will expand to all files matching
@samp{.c}, sorted, followed by all files matching @samp{.h}, sorted.
One use of the @code{wildcard} function is to get a list of all the C source
files in a directory, like this: