6188 |
@code{wildcard} is a space-separated list of the names of existing files |
@code{wildcard} is a space-separated list of the names of existing files |
6189 |
that match the pattern. |
that match the pattern. |
6190 |
@xref{Wildcards, ,Using Wildcard Characters in File Names}. |
@xref{Wildcards, ,Using Wildcard Characters in File Names}. |
6191 |
|
|
6192 |
|
@item $(realpath @var{names}@dots{}) |
6193 |
|
@findex realpath |
6194 |
|
@cindex realpath |
6195 |
|
@cindex file name, realpath of |
6196 |
|
For each file name in @var{names} return the canonical absolute name. |
6197 |
|
A canonical name does not contain any @code{.} or @code{..} components, |
6198 |
|
nor any repeated path separators (@code{/}) or symlinks. In case of a |
6199 |
|
failure the empty string is returned. Consult the @code{realpath(3)} |
6200 |
|
documentation for a list of possible failure causes. |
6201 |
|
|
6202 |
|
@item $(abspath @var{names}@dots{}) |
6203 |
|
@findex abspath |
6204 |
|
@cindex abspath |
6205 |
|
@cindex file name, abspath of |
6206 |
|
For each file name in @var{names} return an absolute name that does |
6207 |
|
not contain any @code{.} or @code{..} components, nor any repeated path |
6208 |
|
separators (@code{/}). Note that in contrast to @code{realpath} |
6209 |
|
function, @code{abspath} does not resolve symlinks and does not require |
6210 |
|
the file names to refer to an existing file or directory. Use the |
6211 |
|
@code{wildcard} function to test for existence. |
6212 |
@end table |
@end table |
6213 |
|
|
6214 |
@node Foreach Function, If Function, File Name Functions, Functions |
@node Foreach Function, If Function, File Name Functions, Functions |
9777 |
@samp{%} pattern).@* |
@samp{%} pattern).@* |
9778 |
@xref{Wildcard Function, ,The Function @code{wildcard}}. |
@xref{Wildcard Function, ,The Function @code{wildcard}}. |
9779 |
|
|
9780 |
|
@item $(realpath @var{names}@dots{}) |
9781 |
|
For each file name in @var{names}, expand to an absolute name that |
9782 |
|
does not contain any @code{.}, @code{..}, nor symlinks.@* |
9783 |
|
@xref{File Name Functions, ,Functions for File Names}. |
9784 |
|
|
9785 |
|
@item $(abspath @var{names}@dots{}) |
9786 |
|
For each file name in @var{names}, expand to an absolute name that |
9787 |
|
does not contain any @code{.} or @code{..} components, but preserves |
9788 |
|
symlinks.@* |
9789 |
|
@xref{File Name Functions, ,Functions for File Names}. |
9790 |
|
|
9791 |
@item $(error @var{text}@dots{}) |
@item $(error @var{text}@dots{}) |
9792 |
|
|
9793 |
When this function is evaluated, @code{make} generates a fatal error |
When this function is evaluated, @code{make} generates a fatal error |