Formerly make.texinfo.~29~

This commit is contained in:
Roland McGrath 1992-06-18 23:25:43 +00:00
parent fcd3964082
commit 320a119913

View file

@ -6477,7 +6477,8 @@ Here is a summary of the directives GNU @code{make} recognizes:
@table @code @table @code
@item define @var{variable} @item define @var{variable}
@itemx endef @itemx endef
Define a multi-line, recursively-expanded variable.
Define a multi-line, recursively-expanded variable.@*
@xref{Sequences}. @xref{Sequences}.
@item ifdef @var{variable} @item ifdef @var{variable}
@ -6488,31 +6489,38 @@ Define a multi-line, recursively-expanded variable.
@itemx ifneq "@var{a}" "@var{b}" @itemx ifneq "@var{a}" "@var{b}"
@itemx else @itemx else
@itemx endif @itemx endif
Conditionally evaluate part of the makefile.
Conditionally evaluate part of the makefile.@*
@xref{Conditionals}. @xref{Conditionals}.
@item include @var{file} @item include @var{file}
Include another makefile.
Include another makefile.@*
@xref{Include}. @xref{Include}.
@item override @var{variable} = @var{value} @item override @var{variable} = @var{value}
@itemx override @var{variable} := @var{value} @itemx override @var{variable} := @var{value}
Define a variable, overriding any previous definition.
Define a variable, overriding any previous definition.@*
@xref{Override Directive}. @xref{Override Directive}.
@item export @item export
Tell @code{make} to export all variables to child processes by default.
Tell @code{make} to export all variables to child processes by default.@*
@xref{Variables/Recursion}. @xref{Variables/Recursion}.
@item export @var{variable} @item export @var{variable}
@itemx export @var{variable} = @var{value} @itemx export @var{variable} = @var{value}
@itemx export @var{variable} := @var{value} @itemx export @var{variable} := @var{value}
@itemx unexport @var{variable} @itemx unexport @var{variable}
Tell @code{make} whether or not to export a particular variable to child Tell @code{make} whether or not to export a particular variable to child
processes. @xref{Variables/Recursion}. processes.@*
@xref{Variables/Recursion}.
@item vpath @item vpath
Specify a search path for files matching a @samp{%} pattern.
Specify a search path for files matching a @samp{%} pattern.@*
@xref{Selective Search}. @xref{Selective Search}.
@end table @end table
@ -6520,88 +6528,110 @@ Here is a summary of the text manipulation functions (@pxref{Functions}):
@table @code @table @code
@item $(subst @var{from},@var{to},@var{text}) @item $(subst @var{from},@var{to},@var{text})
Replace @var{from} with @var{to} in @var{text}.
Replace @var{from} with @var{to} in @var{text}.@*
@xref{Text Functions}. @xref{Text Functions}.
@item $(patsubst @var{pattern},@var{replacement},@var{text}) @item $(patsubst @var{pattern},@var{replacement},@var{text})
Replace words matching @var{pattern} with @var{replacement} in @var{text}.
Replace words matching @var{pattern} with @var{replacement} in @var{text}.@*
@xref{Text Functions}. @xref{Text Functions}.
@item $(strip @var{string}) @item $(strip @var{string})
Remove excess whitespace characters from @var{string}.
Remove excess whitespace characters from @var{string}.@*
@xref{Text Functions}. @xref{Text Functions}.
@item $(findstring @var{find},@var{text}) @item $(findstring @var{find},@var{text})
Locate @var{find} in @var{text}.
Locate @var{find} in @var{text}.@*
@xref{Text Functions}. @xref{Text Functions}.
@item $(filter @var{pattern}@dots{},@var{text}) @item $(filter @var{pattern}@dots{},@var{text})
Select words in @var{text} that match one of the @var{pattern} words.
Select words in @var{text} that match one of the @var{pattern} words.@*
@xref{Text Functions}. @xref{Text Functions}.
@item $(filter-out @var{pattern}@dots{},@var{text}) @item $(filter-out @var{pattern}@dots{},@var{text})
Select words in @var{text} that @emph{do not} match any of the @var{pattern} words.
Select words in @var{text} that @emph{do not} match any of the @var{pattern} words.@*
@xref{Text Functions}. @xref{Text Functions}.
@item $(sort @var{list}) @item $(sort @var{list})
Sort the words in @var{list} lexicographically, removing duplicates.
Sort the words in @var{list} lexicographically, removing duplicates.@*
@xref{Text Functions}. @xref{Text Functions}.
@item $(dir @var{names}) @item $(dir @var{names})
Extract the directory part of each file name.
Extract the directory part of each file name.@*
@xref{Filename Functions}. @xref{Filename Functions}.
@item $(notdir @var{names}) @item $(notdir @var{names})
Extract the non-directory part of each file name.
Extract the non-directory part of each file name.@*
@xref{Filename Functions}. @xref{Filename Functions}.
@item $(suffix @var{names}) @item $(suffix @var{names})
Extract the suffix (the last @samp{.} and following characters) of each file name.
Extract the suffix (the last @samp{.} and following characters) of each file name.@*
@xref{Filename Functions}. @xref{Filename Functions}.
@item $(basename @var{names}) @item $(basename @var{names})
Extract the base name (name without suffix) of each file name.
Extract the base name (name without suffix) of each file name.@*
@xref{Filename Functions}. @xref{Filename Functions}.
@item $(addsuffix @var{suffix},@var{names}) @item $(addsuffix @var{suffix},@var{names})
Append @var{suffix} to each word in @var{names}.
Append @var{suffix} to each word in @var{names}.@*
@xref{Filename Functions}. @xref{Filename Functions}.
@item $(addprefix @var{prefix},@var{names}) @item $(addprefix @var{prefix},@var{names})
Prepend @var{prefix} to each word in @var{names}.
Prepend @var{prefix} to each word in @var{names}.@*
@xref{Filename Functions}. @xref{Filename Functions}.
@item $(join @var{list1},@var{list2}) @item $(join @var{list1},@var{list2})
Join two parallel lists of words.
Join two parallel lists of words.@*
@xref{Filename Functions}. @xref{Filename Functions}.
@item $(word @var{n},@var{text}) @item $(word @var{n},@var{text})
Extract the @var{n}th word (one-origin) of @var{text}.
Extract the @var{n}th word (one-origin) of @var{text}.@*
@xref{Filename Functions}. @xref{Filename Functions}.
@item $(words @var{text}) @item $(words @var{text})
Count the number of words in @var{text}.
Count the number of words in @var{text}.@*
@xref{Filename Functions}. @xref{Filename Functions}.
@item $(firstword @var{names}) @item $(firstword @var{names})
Extract the first word of @var{names}.
Extract the first word of @var{names}.@*
@xref{Filename Functions}. @xref{Filename Functions}.
@item $(wildcard @var{pattern}@dots{}) @item $(wildcard @var{pattern}@dots{})
Find file names matching a shell file name pattern.
Find file names matching a shell file name pattern.@*
@xref{Wildcard Function}. @xref{Wildcard Function}.
@item $(shell @var{command}) @item $(shell @var{command})
Execute a shell command and return its output.
Execute a shell command and return its output.@*
@xref{Shell Function}. @xref{Shell Function}.
@item $(origin @var{var}) @item $(origin @var{var})
Return a string describing how the @code{make} variable @var{var} was defined.
Return a string describing how the @code{make} variable @var{var} was
defined.@*
@xref{Origin Function}. @xref{Origin Function}.
@item $(foreach @var{var},@var{words},@var{text}) @item $(foreach @var{var},@var{words},@var{text})
Evaluate @var{text} with @var{var} bound to each word in @var{words}, Evaluate @var{text} with @var{var} bound to each word in @var{words},
and concatenate the results. and concatenate the results.@*
@xref{Foreach Function}. @xref{Foreach Function}.
@end table @end table
@ -6610,46 +6640,58 @@ Here is a summary of the automatic variables.
@table @code @table @code
@item $@@ @item $@@
The file name of the target.
The file name of the target.@*
@item $% @item $%
The target member name, when the target is an archive member. The target member name, when the target is an archive member.
@item $< @item $<
The name of the first dependency. The name of the first dependency.
@item $? @item $?
The names of all the dependencies that are The names of all the dependencies that are
newer than the target, with spaces between them. newer than the target, with spaces between them.
@item $^ @item $^
The names of all the dependencies, with spaces between them. The names of all the dependencies, with spaces between them.
@item $* @item $*
The stem with which an implicit rule matches (@pxref{Pattern Match, ,How Patterns Match}). The stem with which an implicit rule matches (@pxref{Pattern Match, ,How Patterns Match}).
@item $(@@D) @item $(@@D)
@itemx $(@@F) @itemx $(@@F)
The directory part and the file-within-directory part of @code{$@@}. The directory part and the file-within-directory part of @code{$@@}.
@item $(*D) @item $(*D)
@itemx $(*F) @itemx $(*F)
The directory part and the file-within-directory part of @code{$*}. The directory part and the file-within-directory part of @code{$*}.
@item $(%D) @item $(%D)
@itemx $(%F) @itemx $(%F)
The directory part and the file-within-directory part of @code{$%}. The directory part and the file-within-directory part of @code{$%}.
@item $(<D) @item $(<D)
@itemx $(<F) @itemx $(<F)
The directory part and the file-within-directory part of @code{$<}. The directory part and the file-within-directory part of @code{$<}.
@item $(^D) @item $(^D)
@itemx $(^F) @itemx $(^F)
The directory part and the file-within-directory part of @code{$^}. The directory part and the file-within-directory part of @code{$^}.
@item $(?D) @item $(?D)
@itemx $(?F) @itemx $(?F)
The directory part and the file-within-directory part of @code{$?}. The directory part and the file-within-directory part of @code{$?}.
@end table @end table
@ -6657,29 +6699,35 @@ These variables are used specially by GNU @code{make}:
@table @code @table @code
@item MAKEFILES @item MAKEFILES
Makefiles to be read on every invocation of @code{make}.
Makefiles to be read on every invocation of @code{make}.@*
@xref{MAKEFILES Variable}. @xref{MAKEFILES Variable}.
@item VPATH @item VPATH
Directory search path for files not found in the current directory.
Directory search path for files not found in the current directory.@*
@xref{General Search}. @xref{General Search}.
@item SHELL @item SHELL
The name of the system default command interpreter, usually @file{/bin/sh}. The name of the system default command interpreter, usually @file{/bin/sh}.
@item MAKE @item MAKE
The name with which @code{make} was invoked. The name with which @code{make} was invoked.
Using this variable in commands has special meaning. Using this variable in commands has special meaning.@*
@xref{MAKE Variable}. @xref{MAKE Variable}.
@item MAKELEVEL @item MAKELEVEL
The number of levels of recursion (sub-@code{make}s).
The number of levels of recursion (sub-@code{make}s).@*
@xref{Variables/Recursion}. @xref{Variables/Recursion}.
@item MAKEFLAGS @item MAKEFLAGS
@itemx MFLAGS @itemx MFLAGS
The flags given to @code{make}. You can set this in the environment or The flags given to @code{make}. You can set this in the environment or
a makefile to set flags. a makefile to set flags.@*
@xref{Options/Recursion}. @xref{Options/Recursion}.
@item SUFFIXES @item SUFFIXES