docs: macro synopses document default failure cases. (was: AC_FC_CHECK_BOUNDS for Fortran array bounds checking.)

[Ralf Wildenhues]

* Eric Blake wrote on Tue, Mar 01, 2011 at 08:53:02PM CET:
> On 02/27/2011 09:10 AM, Ralf Wildenhues wrote:
> > here's a first macro to improve Fortran support in Autoconf.

> > OK to push?  Eve-Marie, OK to add your name and email to THANKS?
> 
> OK from my end, after addressing a nit.  In fact, since you are much
> more familiar with Fortran than I am, I'm comfortable with you pushing
> all of your recent Fortran patches if you don't get any better review
> within a few days.

Thanks.  I will do so.  I have roughly a dozen new macros for Fortran
(some in mind, some done, some in between).

> > +++ b/doc/autoconf.texi
> > @@ -8246,6 +8246,16 @@ Fortran Compiler
> >  message).
> >  @end defmac
> >  
> > address@hidden AC_FC_CHECK_BOUNDS (@ovar{action-if-success}, 
> > @ovar{action-if-failure})
> 
> Should this be listed as @dvar{action-if-failure, AC_MSG_FAILURE}...

Yes.  In fact, let's add this to other places in the manual where it is
missing.  I'm pushing the patch below as obvious, together with some of
the other recently posted patches.  The AC_FC_CHECK_BOUNDS one will come
shortly too.

Thanks,
Ralf

    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.

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 557d763..5fc9ffe 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -7969,8 +7969,10 @@ Fortran Compiler
 may not work with C/C++ compiler drivers.
 @end defmac
 
address@hidden AC_F77_DUMMY_MAIN (@ovar{action-if-found}, 
@ovar{action-if-not-found})
address@hidden AC_FC_DUMMY_MAIN (@ovar{action-if-found}, 
@ovar{action-if-not-found})
address@hidden AC_F77_DUMMY_MAIN (@ovar{action-if-found}, 
@dvar{action-if-not-found, @
+  AC_MSG_FAILURE})
address@hidden 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 @@ Fortran Compiler
 @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 @@ Fortran Compiler
 
 @end defmac
 
address@hidden AC_FC_FREEFORM (@ovar{action-if-success}, 
@ovar{action-if-failure})
address@hidden 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 @@ Fortran Compiler
 message).
 @end defmac
 
address@hidden AC_FC_FIXEDFORM (@ovar{action-if-success}, 
@ovar{action-if-failure})
address@hidden 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 @@ Fortran Compiler
 @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 @@ Obsolete Macros
 @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: