mirrors/make
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/make.git synced 2024-10-24 05:09:58 +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 specifies a list of all the files (in the working directory) whose names
end in @samp{.c}.@refill 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 @code{~} (tilde)
@cindex tilde (@code{~}) @cindex tilde (@code{~})
@cindex home directory @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 behave in rules, where they are used verbatim rather than ignored
(@pxref{Wildcard Pitfall}). (@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 One use of the @code{wildcard} function is to get a list of all the C source
files in a directory, like this: files in a directory, like this: