mirrors/make
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/make.git synced 2025-01-27 01:27:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

* doc/make.texi (Overview): Update reference to POSIX.1-2024

Browse source
This commit is contained in:
Paul Smith 2024-06-19 14:03:40 -04:00
parent 69038e62e0
commit 49b955a50d
1 changed files with 23 additions and 23 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

46
doc/make.texi
View file

@ -410,22 +410,22 @@ Troubleshooting Make and Makefiles
@comment node-name, next, previous, up @comment node-name, next, previous, up
@chapter Overview of @code{make} @chapter Overview of @code{make}
The @code{make} utility automatically determines which pieces of a large The @code{make} utility determines which files in a project are out of date,
program need to be recompiled, and issues commands to recompile them. This and runs commands to bring them up to date. This manual describes the GNU
manual describes GNU Make, which was implemented by Richard Stallman and project's implementation of @code{make}, GNU Make, which was created by
Roland McGrath. Paul D. Smith has handled development and maintenance since Richard Stallman and Roland McGrath. Paul D. Smith has handled development
Version 3.76 (1997). and maintenance since Version 3.76 (1997).
GNU @code{make} conforms to @cite{IEEE Standard 1003.2-2017} (POSIX.1-2017). GNU @code{make} conforms to @cite{IEEE Standard 1003.1-2024} (POSIX.1-2024).
@cindex POSIX @cindex POSIX
@cindex IEEE Standard 1003.2 @cindex IEEE Standard 1003.1
@cindex standards conformance @cindex standards conformance
Our examples show C programs, since they are most common, but you can use Our examples show C programs, since they are common, but you can use
@code{make} with any programming language whose compiler can be run with a @code{make} with any programming language whose compiler can be run with a
shell command. Indeed, @code{make} is not limited to building programs. You shell command. Indeed, @code{make} is not limited to compiling programs: it
can use it to describe any task where some files must be updated automatically can be used to automate any task where some files need to be updated
from others whenever the others change. automatically whenever other files have been changed.
@menu @menu
* Preparing:: Preparing and running @code{make}. * Preparing:: Preparing and running @code{make}.
@ -436,10 +436,10 @@ from others whenever the others change.
@node Preparing @node Preparing
@section Preparing and Running Make @section Preparing and Running Make
To use @code{make}, you must write a file called the @dfn{makefile} that To use @code{make}, you must write a file, called a @dfn{makefile}, that
describes the relationships among files in your program and provides commands describes the relationships among files in your project and provides commands
for updating each file. For example, in a typical program the executable file for updating each file. For example, in a typical C program the executable
is updated from object files, which are in turn made by compiling source file is updated from object files, which are in turn made by compiling source
files. files.
Once a suitable makefile exists, each time you change some source files, Once a suitable makefile exists, each time you change some source files,
@ -1160,10 +1160,10 @@ whitespace preceding the backslash, all whitespace at the beginning of
the line after the backslash/newline, and any consecutive the line after the backslash/newline, and any consecutive
backslash/newline combinations. backslash/newline combinations.
If the @code{.POSIX} special target is defined then backslash/newline If the @code{.POSIX} special target is defined then backslash/newline handling
handling is modified slightly to conform to POSIX.2: first, whitespace is modified slightly to conform to POSIX: first, whitespace preceding a
preceding a backslash is not removed and second, consecutive backslash is not removed and second, consecutive backslash/newlines are not
backslash/newlines are not condensed. condensed.
@subsubheading Splitting Without Adding Whitespace @subsubheading Splitting Without Adding Whitespace
@cindex whitespace, avoiding on line split @cindex whitespace, avoiding on line split
@ -5203,7 +5203,7 @@ This is not usually useful to do. However, some systems have a small
fixed limit on the size of the environment, and putting so much fixed limit on the size of the environment, and putting so much
information into the value of @code{MAKEFLAGS} can exceed it. If you information into the value of @code{MAKEFLAGS} can exceed it. If you
see the error message @samp{Arg list too long}, this may be the problem. see the error message @samp{Arg list too long}, this may be the problem.
(For strict compliance with POSIX.2, changing @code{MAKEOVERRIDES} does (For strict compliance with POSIX, changing @code{MAKEOVERRIDES} does
not affect @code{MAKEFLAGS} if the special target @samp{.POSIX} appears not affect @code{MAKEFLAGS} if the special target @samp{.POSIX} appears
in the makefile. You probably do not care about this.) in the makefile. You probably do not care about this.)
@ -12939,7 +12939,7 @@ inspired whom, since GNU @code{make} had @code{patsubst} before SunOS
@item @item
The special significance of @samp{+} characters preceding recipe lines The special significance of @samp{+} characters preceding recipe lines
(@pxref{Instead of Execution, ,Instead of Executing Recipes}) is (@pxref{Instead of Execution, ,Instead of Executing Recipes}) is
mandated by @cite{IEEE Standard 1003.2-1992} (POSIX.2). mandated by @cite{IEEE Standard 1003.1-2024} (POSIX).
@item @item
The @samp{+=} syntax to append to the value of a variable comes from SunOS The @samp{+=} syntax to append to the value of a variable comes from SunOS
@ -13084,8 +13084,8 @@ Load dynamic objects which can modify the behavior of @code{make}.
@cindex features, missing @cindex features, missing
The @code{make} programs in various other systems support a few features The @code{make} programs in various other systems support a few features
that are not implemented in GNU @code{make}. The POSIX.2 standard that are not implemented in GNU @code{make}. The POSIX standard
(@cite{IEEE Standard 1003.2-1992}) which specifies @code{make} does not (@cite{IEEE Standard 1003.1-2024}) which specifies @code{make} does not
require any of these features. require any of these features.
@itemize @bullet @itemize @bullet