* automake.texi (Headers): Mention that we prefer uninstalled

	headers in _SOURCES.
	(ANSI): Mention cross-compilation limitation.

diff --git a/ChangeLog b/ChangeLog
index d7d786d4448183baf2cea1f6f3ad5c42224eb5a7..2930ed39b312ed7a0c0520eb7efdd255197d0f57 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2001-07-04  Tom Tromey  <tromey@redhat.com>
+
+       * automake.texi (Headers): Mention that we prefer uninstalled
+       headers in _SOURCES.
+       (ANSI): Mention cross-compilation limitation.
+
 2001-07-03  Tom Tromey  <tromey@redhat.com>
 
        * configure.in: Upped to 1.4i.

diff --git a/automake.texi b/automake.texi
index 84e9cc574caa0fa2d122a993f482bdcdcd6c8cb0..f44f0005dcfdc515c9095a0378885c4991fa5a42 100644 (file)
--- a/automake.texi
+++ b/automake.texi
@@ -2677,6 +2677,10 @@ into your @file{configure.in}, just before the @code{AC_OUTPUT} call:
 LIBOBJS=`echo $LIBOBJS|sed 's/\.o /\$U.o /g;s/\.o$/\$U.o/'`
 @end example
 
+Note that automatic de-ANSI-fication will not work when the package is
+being built for a different host architecture.  That is because automake
+currently has no way to build @code{ansi2knr} for the build machine.
+
 
 @node Dependencies,  , ANSI, Programs
 @section Automatic dependency tracking
@@ -2788,7 +2792,10 @@ Script objects can be installed in @code{bindir}, @code{sbindir},
 
 Header files are specified by the @samp{HEADERS} family of variables.
 Generally header files are not installed, so the @code{noinst_HEADERS}
-variable will be the most used.
+variable will be the most used.  @footnote{However, for the case of a
+non-installed header file that is actually used by a particular program,
+we recommend listing it in the program's @samp{_SOURCES} variable
+instead of in @code{noinst_HEADERS}.  We believe this is more clear.}
 @vindex HEADERS
 
 All header files must be listed somewhere; missing ones will not appear