37-doc-double-quoting-macros.patch

[Akim Demaille]

Index: ChangeLog
from  Akim Demaille  <address@hidden>
        
        * 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.
        
Index: THANKS
--- THANKS Tue, 14 Aug 2001 01:47:02 +0200 akim
+++ THANKS Mon, 20 Aug 2001 07:55:04 +0200 akim
@@ -157,6 +157,7 @@ people:
 Tony Leneis                 address@hidden
 Viktor Dukhovni             address@hidden
 Volker Borchert             address@hidden
+Werner Lemberg              address@hidden
 Wilfredo Sanchez            address@hidden
 Wolfgang Mueller            address@hidden
 
Index: doc/autoconf.texi
--- doc/autoconf.texi Fri, 17 Aug 2001 11:35:09 +0200 akim
+++ doc/autoconf.texi Mon, 20 Aug 2001 07:45:25 +0200 akim
@@ -5174,14 +5174,14 @@ @node Examining Declarations, Examining 
 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.
 
address@hidden AC_TRY_CPP (@var{includes}, @ovar{action-if-true}, 
@ovar{action-if-false})
address@hidden AC_TRY_CPP (@var{input}, @ovar{action-if-true}, 
@ovar{action-if-false})
 @acindex TRY_CPP
address@hidden 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
address@hidden (typically includes), run shell commands
address@hidden  Otherwise run shell commands
address@hidden  Beware that @var{input} is double quoted.  Shell
+variable, back quote, and backslash substitutions are performed on
address@hidden
 
 This macro uses @code{CPPFLAGS}, but not @code{CFLAGS}, because
 @option{-g}, @option{-O}, etc. are not valid options to many C
@@ -5238,9 +5238,12 @@ @node Examining Syntax, Examining Librar
 
 @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
address@hidden, 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
@@ -5250,9 +5253,6 @@ @node Examining Syntax, Examining Librar
 Fortran 77 is the currently selected language then @code{FFLAGS} will be
 used when compiling.
 
-If the file compiles successfully, run shell commands
address@hidden, 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
@@ -5291,7 +5291,11 @@ @node Examining Libraries, Run Time, Exa
 @acindex TRY_LINK
 Depending on the current language (@pxref{Language Choice}), create a
 test program to see whether a function whose body consists of
address@hidden can be compiled and linked.
address@hidden 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
@@ -5301,9 +5305,6 @@ @node Examining Libraries, Run Time, Exa
 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
address@hidden, 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})
@@ -5347,14 +5348,17 @@ @node Test Programs, Guidelines, Run Tim
 
 @defmac AC_TRY_RUN (@var{program}, @ovar{action-if-true}, 
@ovar{action-if-false}, @ovar{action-if-cross-compiling})
 @acindex TRY_RUN
address@hidden 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
address@hidden; the exit status of the program is available in
-the shell variable @samp{$?}.  This macro uses @code{CFLAGS} or
address@hidden, @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