mirror/autoconf
2
0
Fork 0
mirror of git://git.sv.gnu.org/autoconf synced 2025-02-23 14:09:51 +08:00
Code Issues Packages Projects Releases Wiki Activity

Mention that packagers should not pre-set CFLAGS.

Browse Source 
* doc/autoconf.texi (Preset Output Variables) <CFLAGS>: Copy
advice given by automake on handling variables reserved by GNU
Coding Standards.
Reported by Karl Berry.

Signed-off-by: Eric Blake <ebb9@byu.net>
This commit is contained in:
Eric Blake 2009-02-03 09:15:54 -07:00
parent 20dd02aa3f
commit bf9349266b
2 changed files with 22 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
ChangeLog
View File

@ -1,5 +1,11 @@
2009-02-03 Eric Blake <ebb9@byu.net> 2009-02-03 Eric Blake <ebb9@byu.net>
Mention that packagers should not pre-set CFLAGS.
* doc/autoconf.texi (Preset Output Variables) <CFLAGS>: Copy
advice given by automake on handling variables reserved by GNU
Coding Standards.
Reported by Karl Berry.
Document lib64 in config.site. Document lib64 in config.site.
* doc/autoconf.texi (Site Defaults): Fix typo in FHS sample file. * doc/autoconf.texi (Site Defaults): Fix typo in FHS sample file.
Mention use of lib64. Mention use of lib64.

16
doc/autoconf.texi
View File

@ -2351,6 +2351,22 @@ matters get tricky. One approach to put such options directly into
@code{CC}, e.g., @code{CC='gcc -m64'}. Another is to put them into both @code{CC}, e.g., @code{CC='gcc -m64'}. Another is to put them into both
@code{CPPFLAGS} and @code{LDFLAGS}, but not into @code{CFLAGS}. @code{CPPFLAGS} and @code{LDFLAGS}, but not into @code{CFLAGS}.
However, remember that some @file{Makefile} variables are reserved by
the GNU Coding Standards for the use of the ``user''---the person
building the package. For instance, @code{CFLAGS} is one such variable.
Sometimes package developers are tempted to set user variables such as
@code{CFLAGS} because it appears to make their job easier. However, the
package itself should never set a user variable, particularly not to
include switches that are required for proper compilation of the
package. Since these variables are documented as being for the package
builder, that person rightfully expects to be able to override any of
these variables at build time. If the package developer needs to add
switches without interfering with the user, the proper way to do that is
to introduce an additional variable. Automake makes this easy by
introducing @code{AM_CFLAGS} (@pxref{Flag Variables Ordering, , ,
automake, @acronym{GNU} Automake}), but the concept is the same even if
Automake is not used.
@end defvar @end defvar
@defvar configure_input @defvar configure_input