* doc/autoconf.texi (Examining Declarations) <AC_TRY_CPP>:

(Examining Syntax) <AC_TRY_COMPILE>
(Examining Libraries) <AC_TRY_LINK>
(Test Programs) <AC_TRY_RUN>: These macros double quote some of
their arguments.
Reported by Werner Lemberg.

diff --git a/ChangeLog b/ChangeLog
index 94e6822e1aff68a3d75eb98128d288dbc5c56949..9268ce313b448c2175133485e8f9646188b40a86 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2001-08-20  Akim Demaille  <akim@epita.fr>
+
+       * doc/autoconf.texi (Examining Declarations) <AC_TRY_CPP>:
+       (Examining Syntax) <AC_TRY_COMPILE>
+       (Examining Libraries) <AC_TRY_LINK>
+       (Test Programs) <AC_TRY_RUN>: These macros double quote some of
+       their arguments.
+       Reported by Werner Lemberg.
+
 2001-08-20  Akim Demaille  <akim@epita.fr>
 
        * lib/autotest/general.m4 (AT_INIT): Compute top_builddir,

diff --git a/THANKS b/THANKS
index f009aba4e80b6e14ee8cbf0333b8652be04a32d6..de55ddd17143f33f4d084315470952afa16ab4b2 100644 (file)
--- a/THANKS
+++ b/THANKS
@@ -157,6 +157,7 @@ Tom Yu                      tlyu@mit.edu
 Tony Leneis                 tony@plaza.ds.adp.com
 Viktor Dukhovni             viktor@anaheim.esm.com
 Volker Borchert             bt@teknon.de
+Werner Lemberg              wl@gnu.org
 Wilfredo Sanchez            wsanchez@apple.com
 Wolfgang Mueller            Wolfgang.Mueller@cui.unige.ch
 

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 36e7500ce13b670a7a99b48e5a22b66010d7baf9..20fc4047ad6cde1fe59d535e5c3efd05df3e9165 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -5189,14 +5189,14 @@ The macro @code{AC_TRY_CPP} is used to check whether particular header
 files exist.  You can check for one at a time, or more than one if you
 need several header files to all exist for some purpose.
 
-@defmac AC_TRY_CPP (@var{includes}, @ovar{action-if-true}, @ovar{action-if-false})
+@defmac AC_TRY_CPP (@var{input}, @ovar{action-if-true}, @ovar{action-if-false})
 @acindex TRY_CPP
-@var{includes} is C or C++ @code{#include} statements and declarations,
-on which shell variable, back quote, and backslash substitutions are
-performed.  (Actually, it can be any C program, but other statements are
-probably not useful.)  If the preprocessor produces no error messages
-while processing it, run shell commands @var{action-if-true}.  Otherwise
-run shell commands @var{action-if-false}.
+If the preprocessor produces no error messages while processing the
+@var{input} (typically includes), run shell commands
+@var{action-if-true}.  Otherwise run shell commands
+@var{action-if-false}.  Beware that @var{input} is double quoted.  Shell
+variable, back quote, and backslash substitutions are performed on
+@var{input}.
 
 This macro uses @code{CPPFLAGS}, but not @code{CFLAGS}, because
 @option{-g}, @option{-O}, etc. are not valid options to many C
@@ -5253,9 +5253,12 @@ all systems.
 
 @defmac AC_TRY_COMPILE (@var{includes}, @var{function-body}, @ovar{action-if-found}, @ovar{action-if-not-found})
 @acindex TRY_COMPILE
-Create a C, C++ or Fortran 77 test program (depending on which language
-is current, @pxref{Language Choice}), to see whether a function whose
-body consists of @var{function-body} can be compiled.
+Create a test program in the current language (@pxref{Language Choice})
+to see whether a function whose body consists of @var{function-body} can
+be compiled.  If the file compiles successfully, run shell commands
+@var{action-if-found}, otherwise run @var{action-if-not-found}.
+
+This macro double quotes both @var{includes} and @var{function-body}.
 
 For C and C++, @var{includes} is any @code{#include} statements needed
 by the code in @var{function-body} (@var{includes} will be ignored if
@@ -5265,9 +5268,6 @@ selected language, as well as @code{CPPFLAGS}, when compiling.  If
 Fortran 77 is the currently selected language then @code{FFLAGS} will be
 used when compiling.
 
-If the file compiles successfully, run shell commands
-@var{action-if-found}, otherwise run @var{action-if-not-found}.
-
 This macro does not try to link; use @code{AC_TRY_LINK} if you need to
 do that (@pxref{Examining Libraries}).
 @end defmac
@@ -5306,7 +5306,11 @@ program.
 @acindex TRY_LINK
 Depending on the current language (@pxref{Language Choice}), create a
 test program to see whether a function whose body consists of
-@var{function-body} can be compiled and linked.
+@var{function-body} can be compiled and linked.  If the file compiles
+and links successfully, run shell commands @var{action-if-found},
+otherwise run @var{action-if-not-found}.
+
+This macro double quotes both @var{includes} and @var{function-body}.
 
 For C and C++, @var{includes} is any @code{#include} statements needed
 by the code in @var{function-body} (@var{includes} will be ignored if
@@ -5316,9 +5320,6 @@ selected language, as well as @code{CPPFLAGS}, when compiling.  If
 Fortran 77 is the currently selected language then @code{FFLAGS} will be
 used when compiling.  However, both @code{LDFLAGS} and @code{LIBS} will
 be used during linking in all cases.
-
-If the file compiles and links successfully, run shell commands
-@var{action-if-found}, otherwise run @var{action-if-not-found}.
 @end defmac
 
 @defmac AC_TRY_LINK_FUNC (@var{function}, @ovar{action-if-found}, @ovar{action-if-not-found})
@@ -5362,14 +5363,17 @@ system while configuring.
 
 @defmac AC_TRY_RUN (@var{program}, @ovar{action-if-true}, @ovar{action-if-false}, @ovar{action-if-cross-compiling})
 @acindex TRY_RUN
-@var{program} is the text of a C program, on which shell variable and
-back quote substitutions are performed.  If it compiles and links
-successfully and returns an exit status of 0 when executed, run shell
-commands @var{action-if-true}.  Otherwise, run shell commands
-@var{action-if-false}; the exit status of the program is available in
-the shell variable @samp{$?}.  This macro uses @code{CFLAGS} or
-@code{CXXFLAGS}, @code{CPPFLAGS}, @code{LDFLAGS}, and @code{LIBS} when
-compiling.
+If @var{program} compiles and links successfully and returns an exit
+status of 0 when executed, run shell commands @var{action-if-true}.
+Otherwise, run shell commands @var{action-if-false}; the exit status of
+the program should be available in the shell variable @samp{$?}, but has
+never been: don't depend on this.
+
+This macro double quotes @var{program}, the text of a program in the
+current language (@pxref{Language Choice}), on which shell variable and
+back quote substitutions are performed.  This macro uses @code{CFLAGS}
+or @code{CXXFLAGS}, @code{CPPFLAGS}, @code{LDFLAGS}, and @code{LIBS}
+when compiling.
 
 If the C compiler being used does not produce executables that run on
 the system where @code{configure} is being run, then the test program is