Improve documentation on AC_{COMPILE,LINK}_IFELSE.

* doc/autoconf.texi (Running the Compiler): Mention that the
object file is available after a successful compile.
(Running the Linker): Likewise for the linker output.
Suggested by Paolo Bonzini.

Signed-off-by: Eric Blake <eblake@redhat.com>

diff --git a/ChangeLog b/ChangeLog
index 13fe16c2c124c0e81ec04adf5a4ef9e590142c4c..747a6290dc6be680b565eb0e7cba61e2dc46a36d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2010-03-02  Eric Blake  <eblake@redhat.com>
 
+       Improve documentation on AC_{COMPILE,LINK}_IFELSE.
+       * doc/autoconf.texi (Running the Compiler): Mention that the
+       object file is available after a successful compile.
+       (Running the Linker): Likewise for the linker output.
+       Suggested by Paolo Bonzini.
+
        Fix typo in docs.
        * doc/autoconf.texi (Conditional constructs) <m4_ifblank>: Fix
        typo.

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index f60aa5c26b490c01d2bc3fb960233e065040539a..7838f76cf9e2d6093fab7d2ac0279b4edf87e2d3 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -8914,7 +8914,8 @@ Run the compiler and compilation flags of the current language
 It is customary to report unexpected failures with
 @code{AC_MSG_FAILURE}.  This macro does not try to link; use
 @code{AC_LINK_IFELSE} if you need to do that (@pxref{Running the
-Linker}).
+Linker}).  If needed, @var{action-if-true} can further access the
+just-linked object file @file{conftest.$ac_object}.
 
 This macro uses @code{AC_REQUIRE} for the compiler associated with the
 current language, which means that if the compiler has not yet been
@@ -8959,7 +8960,8 @@ Run the compiler (and compilation flags) and the linker of the current
 language (@pxref{Language Choice}) on the @var{input}, run the shell
 commands @var{action-if-true} on success, @var{action-if-false}
 otherwise.  The @var{input} can be made by @code{AC_LANG_PROGRAM} and
-friends.
+friends.  If needed, @var{action-if-true} can further access the
+just-linked program file @file{conftest$ac_exeext}.
 
 @code{LDFLAGS} and @code{LIBS} are used for linking, in addition to the
 current compilation flags.