Hi,
On Tue, Dec 05, 2006 at 11:58:50AM -0800, Paul Eggert wrote:
> Stepan Kasal <[EMAIL PROTECTED]> writes:
>
> > * doc/autoconf.texi (Configuration Headers): Remove the
> > example with multiple input files.
> > (autoheader Invocation): Encourage `AH_BOTTOM', discouraging
> > multiple input files.
>
> Thanks, please install.
Done, thanks for your review.
This mail goes also to autoconf-patches, which is why I'm attaching
the patch again.
Stepan
2006-12-05 Stepan Kasal <[EMAIL PROTECTED]>
* doc/autoconf.texi (Configuration Headers): Remove the
example with multiple input files.
(autoheader Invocation): Encourage `AH_BOTTOM', discouraging
multiple input files.
Index: doc/autoconf.texi
===================================================================
RCS file: /cvsroot/autoconf/autoconf/doc/autoconf.texi,v
retrieving revision 1.1112
diff -u -r1.1112 autoconf.texi
--- doc/autoconf.texi 28 Nov 2006 03:29:47 -0000 1.1112
+++ doc/autoconf.texi 5 Dec 2006 19:34:44 -0000
@@ -2934,17 +2934,13 @@
Usually the input file is named @[EMAIL PROTECTED]; however, you can
override the input file name by appending to @var{header} a
-colon-separated list of input files. Examples:
+colon-separated list of input files. For example, you might need to make
+the input file name acceptable to @acronym{DOS} variants:
@example
AC_CONFIG_HEADERS([config.h:config.hin])
-AC_CONFIG_HEADERS([defines.h:defs.pre:defines.h.in:defs.post])
@end example
[EMAIL PROTECTED]
-Doing this allows you to keep your file names acceptable to
[EMAIL PROTECTED] variants, or
-to prepend and/or append boilerplate to the file.
@end defmac
@defmac AH_HEADER
@@ -3028,11 +3024,18 @@
@cindex @command{autoheader}
The @command{autoheader} program can create a template file of C
[EMAIL PROTECTED] statements for @command{configure} to use. If
[EMAIL PROTECTED] invokes @code{AC_CONFIG_HEADERS(@var{file})},
[EMAIL PROTECTED] creates @[EMAIL PROTECTED]; if multiple file
-arguments are given, the first one is used. Otherwise,
[EMAIL PROTECTED] creates @file{config.h.in}.
[EMAIL PROTECTED] statements for @command{configure} to use.
+It searches for the first invocation of @code{AC_CONFIG_HEADERS} in
[EMAIL PROTECTED] sources to determine the name of the template.
+(If the first call of @code{AC_CONFIG_HEADERS} specifies more than one
+input file name, @command{autoheader} uses the first one.)
+
+It is recommended that only one input file is used. If you want to append
+a boilerplate code, it is preferable to use
[EMAIL PROTECTED]([[#include <conf_post.h>]])}.
+File @file{conf_post.h} is not processed during the configuration then,
+which make things clearer. Analogically, @code{AH_TOP} can be used to
+prepend a boilerplate code.
In order to do its job, @command{autoheader} needs you to document all
of the symbols that you might use. Typically this is done via an
_______________________________________________
Autoconf mailing list
Autoconf@gnu.org
http://lists.gnu.org/mailman/listinfo/autoconf
