/[make]/make/doc/make.texi
ViewVC logotype

Diff of /make/doc/make.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.21 by psmith, Sun Nov 28 23:11:23 2004 UTC revision 1.22 by bosk, Tue Nov 30 19:51:24 2004 UTC
# Line 6188  wildcard characters (as in shell file na Line 6188  wildcard characters (as in shell file na
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
# Line 9756  Find file names matching a shell file na Line 9777  Find file names matching a shell file na
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

Legend:
Removed from v.1.21  
changed lines
  Added in v.1.22

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26