[SCM] GNU Autoconf source repository branch, master, updated. v2.63-274-gbf93492

[Eric Blake]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU Autoconf source repository".

http://git.sv.gnu.org/gitweb/?p=autoconf.git;a=commitdiff;h=bf9349266bd3c4d80b27d7668fc03869df404924

The branch, master has been updated
       via  bf9349266bd3c4d80b27d7668fc03869df404924 (commit)
       via  20dd02aa3f0de034c2bef7f4e13944f211213a9e (commit)
      from  f8fcfad14630930c1877dcc4915c17be8fa46612 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit bf9349266bd3c4d80b27d7668fc03869df404924
Author: Eric Blake <address@hidden>
Date:   Tue Feb 3 09:15:54 2009 -0700

    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.
    
    Signed-off-by: Eric Blake <address@hidden>

commit 20dd02aa3f0de034c2bef7f4e13944f211213a9e
Author: Eric Blake <address@hidden>
Date:   Tue Feb 3 09:01:52 2009 -0700

    Document lib64 in config.site.
    
    * doc/autoconf.texi (Site Defaults): Fix typo in FHS sample file.
    Mention use of lib64.
    * THANKS: Update.
    Reported by Tom Browder, with help from Peter Breitenlohner.
    
    Signed-off-by: Eric Blake <address@hidden>

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog         |   14 ++++++++++++++
 THANKS            |    1 +
 doc/autoconf.texi |   34 +++++++++++++++++++++++++++++++---
 3 files changed, 46 insertions(+), 3 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index a706db2..3d1cea4 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,17 @@
+2009-02-03  Eric Blake  <address@hidden>
+
+       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.
+       * doc/autoconf.texi (Site Defaults): Fix typo in FHS sample file.
+       Mention use of lib64.
+       * THANKS: Update.
+       Reported by Tom Browder, with help from Peter Breitenlohner.
+
 2009-01-28  Eric Blake  <address@hidden>
 
        Use AC_DEFUN_ONCE for uncontroversial one-shot macros.
diff --git a/THANKS b/THANKS
index 74895cf..a4d9c23 100644
--- a/THANKS
+++ b/THANKS
@@ -343,6 +343,7 @@ Thomas Winder               address@hidden
 Tim Mooney                  address@hidden
 Tim Rice                    address@hidden
 Tim Van Holder              address@hidden
+Tom Browder                 address@hidden
 Tom Epperly                 address@hidden
 Tom Lane                    address@hidden
 Tom Purcell                 address@hidden
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 0d20f2a..a8cf779 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -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{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
address@hidden 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
 
 @defvar configure_input
@@ -19737,12 +19753,12 @@ site files.  Your code should check that variables 
such as @code{prefix}
 and @code{cache_file} have their default values (as set near the top of
 @command{configure}) before changing them.
 
-Here is a sample file @file{/usr/share/local/gnu/share/config.site}.  The
+Here is a sample file @file{/usr/share/local/@/gnu/share/@/config.site}.  The
 command @samp{configure --prefix=/usr/share/local/gnu} would read this
 file (if @code{CONFIG_SITE} is not set to a different file).
 
 @example
-# config.site for configure
+# /usr/share/local/gnu/share/config.site for configure
 #
 # Change some defaults.
 test "$prefix" = NONE && prefix=/usr/share/local/gnu
@@ -19770,7 +19786,7 @@ in a manner consistent with the Filesystem Hierarchy 
Standard
 the locations recommended by @acronym{FHS}.
 
 @example
-# /usr/local/config.site for FHS defaults when installing below /usr,
+# /usr/share/config.site for FHS defaults when installing below /usr,
 # and the respective settings were not changed on the command line.
 if test "$prefix" = /usr; then
   test "$sysconfdir" = 'address@hidden@}/etc' && sysconfdir=/etc
@@ -19779,6 +19795,18 @@ if test "$prefix" = /usr; then
 fi
 @end example
 
address@hidden lib64
address@hidden 64-bit libraries
+Likewise, on platforms where 64-bit libraries are built by default, then
+installed in @file{/usr/local/@/lib64} instead of @file{/usr/local/@/lib},
+it is appropriate to install @file{/usr/local/@/share/config.site}:
+
address@hidden
+# /usr/local/share/config.site for platforms that prefer
+# the directory /usr/local/lib64 over /usr/local/lib.
+test "$libdir" = 'address@hidden@}/lib' && libdir='address@hidden@}/lib64'
address@hidden example
+
 
 @c ============================================== Running configure Scripts.
 


hooks/post-receive
--
GNU Autoconf source repository