github-repos/make
1
0
Fork 0
mirror of https://github.com/mirror/make.git synced 2024-12-29 14:30:42 +08:00
Code Issues Packages Projects Releases Wiki Activity

More correctly describe the scope of variables

Browse Source 
* NEWS: Use "local" instead of the incorrect "lexically-scoped".
* doc/make.texi: Refer to let/foreach variables as local variables.
This commit is contained in:
Jouke Witteveen 2020-12-25 19:00:10 +01:00 committed by Paul Smith
parent 88732a29f2
commit e5f6dc54b9
2 changed files with 17 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
NEWS
View File

@ -35,8 +35,8 @@ https://sv.gnu.org/bugs/index.php?group=make&report_id=111&fix_release_id=109&se
The configure script should verify the compiler has these features. The configure script should verify the compiler has these features.
* New feature: The $(let ...) function * New feature: The $(let ...) function
This function allows user-defined functions to provide a lexically-scoped This function allows user-defined functions to define a set of local
set of variables: values can be assigned to these variables from within the variables: values can be assigned to these variables from within the
user-defined function and they will not impact global variable assignments. user-defined function and they will not impact global variable assignments.
Implementation provided by Jouke Witteveen <j.witteveen@gmail.com> Implementation provided by Jouke Witteveen <j.witteveen@gmail.com>

21
doc/make.texi
View File

@ -276,7 +276,7 @@ Functions for Transforming Text
* Text Functions:: General-purpose text manipulation functions. * Text Functions:: General-purpose text manipulation functions.
* File Name Functions:: Functions for manipulating file names. * File Name Functions:: Functions for manipulating file names.
* Conditional Functions:: Functions that implement conditions. * Conditional Functions:: Functions that implement conditions.
* Let Function:: Lexically scoped variables. * Let Function:: Local variables.
* Foreach Function:: Repeat some text with controlled variation. * Foreach Function:: Repeat some text with controlled variation.
* File Function:: Write text to a file. * File Function:: Write text to a file.
* Call Function:: Expand a user-defined function. * Call Function:: Expand a user-defined function.
@ -5204,7 +5204,9 @@ variables are called @dfn{macros}.)
Variables and functions in all parts of a makefile are expanded when Variables and functions in all parts of a makefile are expanded when
read, except for in recipes, the right-hand sides of variable read, except for in recipes, the right-hand sides of variable
definitions using @samp{=}, and the bodies of variable definitions definitions using @samp{=}, and the bodies of variable definitions
using the @code{define} directive.@refill using the @code{define} directive. The value a variable expands to is
that of its most recent definition at the time of expansion. In other
words, variables are dynamically scoped.
Variables can represent lists of file names, options to pass to compilers, Variables can represent lists of file names, options to pass to compilers,
programs to run, directories to look in for source files, directories to programs to run, directories to look in for source files, directories to
@ -5792,6 +5794,11 @@ You can specify a value in the makefile, either
with an assignment (@pxref{Setting, ,Setting Variables}) or with a with an assignment (@pxref{Setting, ,Setting Variables}) or with a
verbatim definition (@pxref{Multi-Line, ,Defining Multi-Line Variables}).@refill verbatim definition (@pxref{Multi-Line, ,Defining Multi-Line Variables}).@refill
@item
You can specify a short-lived value with the @code{let} function
(@pxref{Let Function}) or with the @code{foreach} function
(@pxref{Foreach Function}).
@item @item
Variables in the environment become @code{make} variables. Variables in the environment become @code{make} variables.
@xref{Environment, ,Variables from the Environment}. @xref{Environment, ,Variables from the Environment}.
@ -6274,10 +6281,12 @@ the Shell}.@refill
Variable values in @code{make} are usually global; that is, they are the Variable values in @code{make} are usually global; that is, they are the
same regardless of where they are evaluated (unless they're reset, of same regardless of where they are evaluated (unless they're reset, of
course). One exception to that is automatic variables course). Exceptions to that are variables defined with the @code{let}
function (@pxref{Let Function}) or the @code{foreach} function
(@pxref{Foreach Function}, and automatic variables
(@pxref{Automatic Variables}). (@pxref{Automatic Variables}).
The other exception is @dfn{target-specific variable values}. This Another exception are @dfn{target-specific variable values}. This
feature allows you to define different values for the same variable, feature allows you to define different values for the same variable,
based on the target that @code{make} is currently building. As with based on the target that @code{make} is currently building. As with
automatic variables, these values are only available within the context automatic variables, these values are only available within the context
@ -7039,7 +7048,7 @@ be substituted.
* Text Functions:: General-purpose text manipulation functions. * Text Functions:: General-purpose text manipulation functions.
* File Name Functions:: Functions for manipulating file names. * File Name Functions:: Functions for manipulating file names.
* Conditional Functions:: Functions that implement conditions. * Conditional Functions:: Functions that implement conditions.
* Let Function:: Lexically scoped variables. * Let Function:: Local variables.
* Foreach Function:: Repeat some text with controlled variation. * Foreach Function:: Repeat some text with controlled variation.
* File Function:: Write text to a file. * File Function:: Write text to a file.
* Call Function:: Expand a user-defined function. * Call Function:: Expand a user-defined function.
@ -7697,7 +7706,7 @@ the result of the expansion is the expansion of the last argument.
@node Let Function, Foreach Function, Conditional Functions, Functions @node Let Function, Foreach Function, Conditional Functions, Functions
@section The @code{let} Function @section The @code{let} Function
@findex let @findex let
@cindex variables, lexically scoped @cindex variables, local
The @code{let} function provides a means to limit the scope of a The @code{let} function provides a means to limit the scope of a
variable. The assignment of the named variables in a @code{let} variable. The assignment of the named variables in a @code{let}