docs: macro synopses document default failure cases.

* doc/autoconf.texi (Fortran Compiler, Obsolete Macros):
Document failure case for AC_F77_DUMMY_MAIN, AC_FC_DUMMY_MAIN,
AC_FC_SRCEXT, AC_FC_FREEFORM, AC_FC_FIXEDFORM,
AC_FC_LINE_LENGTH, and AC_TRY_RUN macros.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>

diff --git a/ChangeLog b/ChangeLog
index a5c06c14c1e5df627a7ef17a16c48eb7748b2fe5..b2033f55ec7c3df423ceaa78cb3b1c82d51cbeb9 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2011-03-04  Ralf Wildenhues  <Ralf.Wildenhues@gmx.de>
 
+       docs: macro synopses document default failure cases.
+       * doc/autoconf.texi (Fortran Compiler, Obsolete Macros):
+       Document failure case for AC_F77_DUMMY_MAIN, AC_FC_DUMMY_MAIN,
+       AC_FC_SRCEXT, AC_FC_FREEFORM, AC_FC_FIXEDFORM,
+       AC_FC_LINE_LENGTH, and AC_TRY_RUN macros.
+
        Reword Fortran macro documentation.
        * doc/autoconf.texi (Fortran Compiler): Improve wording for
        AC_FC_FREEFORM, AC_FC_FIXEDFORM, and AC_FC_LINE_LENGTH macros.

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 557d76387e8a700c14fbcf3400a476e896a63c7d..5fc9ffed9556c8688db3f8d3d6f44cc51294fbd1 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -7969,8 +7969,10 @@ because the complex defines that the function wrapper macros create
 may not work with C/C++ compiler drivers.
 @end defmac
 
-@defmac AC_F77_DUMMY_MAIN (@ovar{action-if-found}, @ovar{action-if-not-found})
-@defmacx AC_FC_DUMMY_MAIN (@ovar{action-if-found}, @ovar{action-if-not-found})
+@defmac AC_F77_DUMMY_MAIN (@ovar{action-if-found}, @dvar{action-if-not-found, @
+  AC_MSG_FAILURE})
+@defmacx AC_FC_DUMMY_MAIN (@ovar{action-if-found}, @dvar{action-if-not-found, @
+  AC_MSG_FAILURE})
 @acindex{F77_DUMMY_MAIN}
 @cvindex F77_DUMMY_MAIN
 @acindex{FC_DUMMY_MAIN}
@@ -8140,7 +8142,7 @@ to call Fortran routines from some language other than C/C++.
 @end defmac
 
 @defmac AC_FC_SRCEXT (@var{ext}, @ovar{action-if-success}, @
-  @ovar{action-if-failure})
+  @dvar{action-if-failure, AC_MSG_FAILURE})
 @acindex{FC_SRCEXT}
 By default, the @code{FC} macros perform their tests using a @file{.f}
 extension for source-code files.  Some compilers, however, only enable
@@ -8184,7 +8186,8 @@ error message).
 
 @end defmac
 
-@defmac AC_FC_FREEFORM (@ovar{action-if-success}, @ovar{action-if-failure})
+@defmac AC_FC_FREEFORM (@ovar{action-if-success}, @dvar{action-if-failure, @
+  AC_MSG_FAILURE})
 @acindex{FC_FREEFORM}
 
 Try to ensure that the Fortran compiler (@code{$FC}) allows free-format
@@ -8206,7 +8209,8 @@ calls @var{action-if-failure} (defaults to exiting with an error
 message).
 @end defmac
 
-@defmac AC_FC_FIXEDFORM (@ovar{action-if-success}, @ovar{action-if-failure})
+@defmac AC_FC_FIXEDFORM (@ovar{action-if-success}, @dvar{action-if-failure, @
+  AC_MSG_FAILURE})
 @acindex{FC_FIXEDFORM}
 
 Try to ensure that the Fortran compiler (@code{$FC}) allows the old
@@ -8228,7 +8232,7 @@ message).
 @end defmac
 
 @defmac AC_FC_LINE_LENGTH (@ovar{length}, @ovar{action-if-success}, @
-  @ovar{action-if-failure})
+  @dvar{action-if-failure, AC_MSG_FAILURE})
 @acindex{FC_LINE_LENGTH}
 
 Try to ensure that the Fortran compiler (@code{$FC}) accepts long source
@@ -23281,7 +23285,7 @@ AC_LINK_IFELSE([AC_LANG_CALL([], [@var{function}])],
 @end defmac
 
 @defmac AC_TRY_RUN (@var{program}, @ovar{action-if-true}, @
-  @ovar{action-if-false}, @ovar{action-if-cross-compiling})
+  @ovar{action-if-false}, @dvar{action-if-cross-compiling, AC_MSG_FAILURE})
 @acindex{TRY_RUN}
 Same as: