Document that AS_INIT is automatically used.

* doc/autoconf.texi (Initialization Macros) <AS_INIT>: Add words
to clarify that only bare-bones scripts need a direct AS_INIT.
Suggested by Reuben Thomas.

Signed-off-by: Eric Blake <ebb9@byu.net>
This commit is contained in:
Eric Blake 2009-09-10 20:16:46 -06:00
parent 98410813c9
commit 6ecb883bb1
2 changed files with 9 additions and 1 deletions

View File

@ -1,5 +1,10 @@
2009-09-10 Eric Blake <ebb9@byu.net>
Document that AS_INIT is automatically used.
* doc/autoconf.texi (Initialization Macros) <AS_INIT>: Add words
to clarify that only bare-bones scripts need a direct AS_INIT.
Suggested by Reuben Thomas.
Clarify portability pitfall of test.
* doc/autoconf.texi (Limitations of Builtins) <test>: Give more
reasons why -a and -o are not portable.

View File

@ -12949,7 +12949,10 @@ generated from, and code to sanitize the environment for the rest of the
script. Among other initializations, this sets @env{SHELL} to the shell
chosen to run the script (@pxref{CONFIG_SHELL}), and @env{LC_ALL} to
ensure the C locale. Finally, it changes the current diversion to
@code{BODY}.
@code{BODY}. @code{AS_INIT} is called automatically by @code{AC_INIT}
and @code{AT_INIT}, so shell code in @file{configure},
@file{config.status}, and @file{testsuite} all benefit from a sanitized
shell environment.
@end defmac
@defmac AS_INIT_GENERATED (@var{file}, @ovar{comment})