Patch: more doc updates

[Tom Tromey]

I'm checking this in -- more updates to the docs.

2001-07-04  Tom Tromey  <address@hidden>

        * automake.texi (Headers): Mention that we prefer uninstalled
        headers in _SOURCES.
        (ANSI): Mention cross-compilation limitation.

Tom

Index: automake.texi
===================================================================
RCS file: /cvs/automake/automake/automake.texi,v
retrieving revision 1.218
diff -u -r1.218 automake.texi
--- automake.texi 2001/07/02 00:50:29 1.218
+++ automake.texi 2001/07/04 15:26:41
@@ -2677,7 +2677,11 @@
 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 @@
 
 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