[Automake-commit] [SCM] GNU Automake branch, testsuite-work, updated. v1.11-1040-g85df5a3

[Stefano Lattarini]

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 Automake".

http://git.sv.gnu.org/gitweb/?p=automake.git;a=commitdiff;h=85df5a371a8f3f3b5b5bc81529967772ae836f9a

The branch, testsuite-work has been updated
       via  85df5a371a8f3f3b5b5bc81529967772ae836f9a (commit)
       via  9cddc4f56b14502c110b0b1459fa9890c91997ec (commit)
       via  5d4dc886c0863ed2a4fdec933a1bded31402094b (commit)
      from  9bf72f7c55c5cc01d443b364bc14994fbb5f91ff (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 85df5a371a8f3f3b5b5bc81529967772ae836f9a
Merge: 9bf72f7 9cddc4f
Author: Stefano Lattarini <address@hidden>
Date:   Wed Aug 3 15:10:10 2011 +0200

    Merge branch 'master' into testsuite-work
    
    * master:
      docs: how to use '-I' option in AM_CPPFLAGS for best VPATH support

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

Summary of changes:
 ChangeLog         |    6 ++++++
 doc/automake.texi |   12 ++++++++++++
 2 files changed, 18 insertions(+), 0 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index bd20264..33cd8cc 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2011-08-03  Bruno Haible  <address@hidden>
+
+       docs: how to use '-I' option in AM_CPPFLAGS for best VPATH support
+       * doc/automake.texi (Program Variables): Recommend -I options to
+       both the build directory and the source directory when needed.
+
 2011-07-23  Stefano Lattarini  <address@hidden>
 
        tests: relax a test on amhello examples to cater to Solaris tar
diff --git a/doc/automake.texi b/doc/automake.texi
index 8d078b8..c982b40 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -6064,6 +6064,18 @@ the C preprocessor.  In particular it generates 
@samp{-I.},
 @code{AM_CONFIG_HEADER}).  You can disable the default @option{-I}
 options using the @option{nostdinc} option.
 
+When a file to be included is generated during the build and not part
+of a distribution tarball, its location is under @code{$(builddir)},
+not under @code{$(srcdir)}.  This matters especially for packages that
+use header files placed in sub-directories and want to allow builds
+outside the source tree (@pxref{VPATH Builds}). In that case we
+recommend to use a pair of @option{-I} options, such as, e.g.,
address@hidden/subdir -I$(srcdir)/some/subdir} or
address@hidden(top_builddir)/some/subdir -I$(top_srcdir)/some/subdir}.
+Note that the reference to the build tree should come before the
+reference to the source tree, so that accidentally leftover generated
+files in the source directory are ignored.
+
 @code{AM_CPPFLAGS} is ignored in preference to a per-executable (or
 per-library) @code{_CPPFLAGS} variable if it is defined.
 


hooks/post-receive
-- 
GNU Automake