In ‘INSTALL’ put configure vars in one section

* INSTALL: Move description of CFLAGS etc. into the section headed
“Here is a complete list of the variables you may want to set”
since they are also variables one might want to set.
This commit is contained in:
Paul Eggert 2024-07-19 12:44:35 -07:00
parent 153732e638
commit 524e9d50a7

26
INSTALL
View file

@ -517,12 +517,8 @@ Some tests might fail because the compiler should look in special
directories for some header files, or link against optional directories for some header files, or link against optional
libraries, or use special compilation options. You can force libraries, or use special compilation options. You can force
'configure' and the build process which follows it to do that by 'configure' and the build process which follows it to do that by
setting the variables CPPFLAGS, CFLAGS, LDFLAGS, LIBS, CPP and CC setting the variables CC, CFLAGS, CPP, CPPFLAGS, LDFLAGS, and LIBS in
before running 'configure'. CPP is the command which invokes the the 'configure' command.
preprocessor, CPPFLAGS lists the options passed to it, CFLAGS are
compilation options, LDFLAGS are options used when linking, LIBS are
libraries to link against, and CC is the command which invokes the
compiler. By default, gcc is used if available.
Here's an example of a 'configure' invocation, assuming a Bourne-like Here's an example of a 'configure' invocation, assuming a Bourne-like
shell such as Bash, which uses these variables: shell such as Bash, which uses these variables:
@ -689,8 +685,9 @@ configuration), type 'make distclean'.
MAKE VARIABLES MAKE VARIABLES
You can change where the build process installs Emacs and its data You can change where the build process installs Emacs and its data
files by specifying values for 'make' variables as part of the 'make' files, and what programs and options the build process uses, by
command line. For example, if you type specifying values for 'make' variables as part of the 'make' command
line. For example, if you type
make install bindir=/usr/local/gnubin make install bindir=/usr/local/gnubin
@ -760,6 +757,19 @@ Here is a complete list of the variables you may want to set.
determines the default values for the architecture-dependent determines the default values for the architecture-dependent
path variables - 'bindir' and 'libexecdir'. path variables - 'bindir' and 'libexecdir'.
'CC' is the command which invokes the compiler. By default, gcc is used
if available.
'CFLAGS' are compilation options.
'CPP' is the command which invokes the preprocessor.
'CPPFLAGS' lists the options passed to CPP.
'LDFLAGS' are options used when linking.
'LIBS' are libraries to link against.
The above variables serve analogous purposes in the makefiles for all The above variables serve analogous purposes in the makefiles for all
GNU software; the following variables are specific to Emacs. GNU software; the following variables are specific to Emacs.