[SCM] GNU Autoconf source repository branch, master, updated. v2.64-72-gd2fb059

"Ralf Wildenhues" <[email protected]>
Newsgroups gmane.comp.sysutils.autoconf.cvs
Message-ID <[email protected]> 
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU Autoconf source repository".

http://git.sv.gnu.org/gitweb/?p=autoconf.git;a=commitdiff;h=d2fb059fd3a9daa27cbb55c7b15ce43a4b5ff600

The branch, master has been updated
       via  d2fb059fd3a9daa27cbb55c7b15ce43a4b5ff600 (commit)
      from  59f2fea80a181fb80c0f3e61641080a09e349f45 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit d2fb059fd3a9daa27cbb55c7b15ce43a4b5ff600
Author: Bruno Haible <[email protected]>
Date:   Sat Oct 31 07:56:53 2009 +0100

    Improve cache variable documentation.
    
    * doc/autoconf.texi (AC_PROG_AWK, AC_PROG_GREP, AC_PROG_EGREP,
    AC_PROG_FGREP, AC_PROG_INSTALL, AC_PROG_MKDIR_P, AC_PROG_LEX,
    AC_PROG_YACC, AC_CHECK_PROG, AC_CHECK_PROGS, AC_PATH_PROG,
    AC_PATH_PROGS): Don't suggest to use the cache variable, only to
    override it, or preferably, a non-cache variable associated with
    the test.
    (AC_PROG_SED): Likewise. Fix name of cache variable.
    (AC_FUNC_GETMNTENT): Fix name cache variable.
    (AC_FUNC_LSTAT): Fix typo.
    
    Signed-off-by: Ralf Wildenhues <[email protected]>

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog         |   14 +++++++++++
 doc/autoconf.texi |   64 ++++++++++++++++++++++++++++++++--------------------
 2 files changed, 53 insertions(+), 25 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 296b307..45ef1bb 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,17 @@
+2009-10-31  Bruno Haible  <[email protected]>
+	    Ralf Wildenhues  <[email protected]>
+
+	Improve cache variable documentation.
+	* doc/autoconf.texi (AC_PROG_AWK, AC_PROG_GREP, AC_PROG_EGREP,
+	AC_PROG_FGREP, AC_PROG_INSTALL, AC_PROG_MKDIR_P, AC_PROG_LEX,
+	AC_PROG_YACC, AC_CHECK_PROG, AC_CHECK_PROGS, AC_PATH_PROG,
+	AC_PATH_PROGS): Don't suggest to use the cache variable, only to
+	override it, or preferably, a non-cache variable associated with
+	the test.
+	(AC_PROG_SED): Likewise. Fix name of cache variable.
+	(AC_FUNC_GETMNTENT): Fix name cache variable.
+	(AC_FUNC_LSTAT): Fix typo.
+
 2009-10-31  Ralf Wildenhues  <[email protected]>
 
 	Fix AC_OPENMP for Fortran (F77 and FC).
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 6049b59..8dae763 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -3873,8 +3873,8 @@ in some cases whether they support certain features.
 Check for @code{gawk}, @code{mawk}, @code{nawk}, and @code{awk}, in that
 order, and set output variable @code{AWK} to the first one that is found.
 It tries @code{gawk} first because that is reported to be the
-best implementation.  The result is cached in the @code{ac_cv_prog_AWK}
-variable.
+best implementation.  The result can be overridden by setting the
+variable @code{AWK} or the cache variable @code{ac_cv_prog_AWK}.
 @end defmac
 
 @defmac AC_PROG_GREP
@@ -3886,7 +3886,8 @@ longest input lines possible, and that supports multiple @option{-e} options.
 Set the output variable @code{GREP} to whatever is chosen.
 @xref{grep, , Limitations of Usual Tools}, for more information about
 portability problems with the @command{grep} command family.  The result
-is cached in the @code{ac_cv_path_GREP} variable.
+can be overridden by setting the @code{GREP} variable and is cached in the
+@code{ac_cv_path_GREP} variable.
 @end defmac
 
 @defmac AC_PROG_EGREP
@@ -3896,7 +3897,8 @@ is cached in the @code{ac_cv_path_GREP} variable.
 Check whether @code{$GREP -E} works, or else look for the best available
 @code{egrep} or @code{gegrep} that accepts the longest input lines possible.
 Set the output variable @code{EGREP} to whatever is chosen.  The result
-is cached in the @code{ac_cv_path_EGREP} variable.
+can be overridden by setting the @code{EGREP} variable and is cached in the
+@code{ac_cv_path_EGREP} variable.
 @end defmac
 
 @defmac AC_PROG_FGREP
@@ -3906,7 +3908,8 @@ is cached in the @code{ac_cv_path_EGREP} variable.
 Check whether @code{$GREP -F} works, or else look for the best available
 @code{fgrep} or @code{gfgrep} that accepts the longest input lines possible.
 Set the output variable @code{FGREP} to whatever is chosen.  The result
-is cached in the @code{ac_cv_path_FGREP} variable.
+can be overridden by setting the @code{FGREP} variable and is cached in the
+@code{ac_cv_path_FGREP} variable.
 @end defmac
 
 @defmac AC_PROG_INSTALL
@@ -3949,8 +3952,8 @@ not found in standard @command{install} programs, there is no reason to use
 @code{AC_PROG_INSTALL}; just put the file name of your program into your
 @file{Makefile.in} files.
 
-The result of the test is cached in the @code{ac_cv_path_install} variable,
-if an @command{install} program other than the in-tree script is found.
+The result of the test can be overridden by setting the variable
+@code{INSTALL} or the cache variable @code{ac_cv_path_install}.
 @end defmac
 
 @defmac AC_PROG_MKDIR_P
@@ -3988,8 +3991,8 @@ vulnerability, whereas @code{AC_PROG_MKDIR_P} does.
 @samp{@@MKDIR_P@@} is special, as its value may vary for different
 configuration files.
 
-The result of the test is cached in the @code{ac_cv_path_mkdir} variable,
-if a @command{mkdir} program other than an in-tree script is found.
+The result of the test can be overridden by setting the variable
+@code{MKDIR_P} or the cache variable @code{ac_cv_path_mkdir}.
 @end defmac
 
 @anchor{AC_PROG_LEX}
@@ -4050,7 +4053,8 @@ of Automake will fix this issue; meanwhile, just ignore this message.
 As part of running the test, this macro may delete any file in the
 configuration directory named @file{lex.yy.c} or @file{lexyy.c}.
 
-The result of this test is cached in the @code{ac_cv_prog_LEX} variable.
+The result of this test can be influenced by setting the variable
+@code{LEX} or the cache variable @code{ac_cv_prog_LEX}.
 @end defmac
 
 @anchor{AC_PROG_LN_S}
@@ -4092,13 +4096,14 @@ is found, and otherwise to @samp{:} (do nothing).
 @defmac AC_PROG_SED
 @acindex{PROG_SED}
 @ovindex SED
-@caindex prog_SED
+@caindex path_SED
 Set output variable @code{SED} to a Sed implementation that conforms to
 Posix and does not have arbitrary length limits.  Report an error if no
 acceptable Sed is found.  @xref{sed, , Limitations of Usual Tools}, for more
 information about portability problems with Sed.
 
-The result of this test is cached in the @code{ac_cv_prog_SED} variable.
+The result of this test can be overridden by setting the @code{SED} variable
+and is cached in the @code{ac_cv_path_SED} variable.
 @end defmac
 
 @defmac AC_PROG_YACC
@@ -4110,7 +4115,8 @@ The result of this test is cached in the @code{ac_cv_prog_SED} variable.
 If @code{bison} is found, set output variable @code{YACC} to @samp{bison
 -y}.  Otherwise, if @code{byacc} is found, set @code{YACC} to
 @samp{byacc}.  Otherwise set @code{YACC} to @samp{yacc}.
-The result of this test is cached in the @code{ac_cv_prog_YACC} variable.
+The result of this test can be influenced by setting the variable
+@code{YACC} or the cache variable @code{ac_cv_prog_YACC}.
 @end defmac
 
 @node Generic Programs
@@ -4147,8 +4153,9 @@ absolute file name) even if it is the first found in the search path; in
 that case, set @var{variable} using the absolute file name of the
 @var{prog-to-check-for} found that is not @var{reject}.  If
 @var{variable} was already set, do nothing.  Calls @code{AC_SUBST} for
-@var{variable}.  The result of this test is cached in the
-@code{ac_cv_prog_@var{variable}} variable.
+@var{variable}.  The result of this test can be overridden by setting the
+@var{variable} variable or the cache variable
+@code{ac_cv_prog_@var{variable}}.
 @end defmac
 
 @anchor{AC_CHECK_PROGS}
@@ -4163,7 +4170,8 @@ checking the next program in the list.  If none of the programs in the
 list are found, set @var{variable} to @var{value-if-not-found}; if
 @var{value-if-not-found} is not specified, the value of @var{variable}
 is not changed.  Calls @code{AC_SUBST} for @var{variable}.  The result of
-this test is cached in the @code{ac_cv_prog_@var{variable}} variable.
+this test can be overridden by setting the @var{variable} variable or the
+cache variable @code{ac_cv_prog_@var{variable}}.
 @end defmac
 
 @defmac AC_CHECK_TARGET_TOOL (@var{variable}, @var{prog-to-check-for}, @
@@ -4245,8 +4253,10 @@ For more information, see @ref{Specifying Target Triplets}.
 @acindex{PATH_PROG}
 @caindex path_@var{variable}
 Like @code{AC_CHECK_PROG}, but set @var{variable} to the absolute
-name of @var{prog-to-check-for} if found.  A positive result of this
-test is cached in the @code{ac_cv_path_@var{variable}} variable.
+name of @var{prog-to-check-for} if found.  The result of this test
+can be overridden by setting the @var{variable} variable.  A positive
+result of this test is cached in the @code{ac_cv_path_@var{variable}}
+variable.
 @end defmac
 
 @anchor{AC_PATH_PROGS}
@@ -4256,7 +4266,9 @@ test is cached in the @code{ac_cv_path_@var{variable}} variable.
 @caindex path_@var{variable}
 Like @code{AC_CHECK_PROGS}, but if any of @var{progs-to-check-for}
 are found, set @var{variable} to the absolute name of the program
-found.
+found.  The result of this test can be overridden by setting the
+@var{variable} variable.  A positive result of this test is cached in
+the @code{ac_cv_path_@var{variable}} variable.
 @end defmac
 
 @defmac AC_PATH_PROGS_FEATURE_CHECK (@var{variable}, @
@@ -5001,14 +5013,16 @@ use Gnulib's @code{getloadavg} module.  @xref{Gnulib}.
 @cvindex HAVE_GETMNTENT
 @c @fuindex getmntent
 @prindex @code{getmntent}
-@caindex func_getmntent
+@caindex search_getmntent
 Check for @code{getmntent} in the standard C library, and then in the
 @file{sun}, @file{seq}, and @file{gen} libraries, for @sc{unicos},
 @sc{irix} 4, @sc{ptx}, and UnixWare, respectively.  Then, if
-@code{getmntent} is available, define @code{HAVE_GETMNTENT}.
+@code{getmntent} is available, define @code{HAVE_GETMNTENT} and set
+@code{ac_cv_func_getmntent} to @code{yes}.  Otherwise set
+@code{ac_cv_func_getmntent} to @code{no}.
 
-The result of this macro is cached in the @code{ac_cv_func_getmntent}
-variable.
+The result of this macro can be overridden by setting the cache variable
+@code{ac_cv_search_getmntent}.
 @end defmac
 
 @defmac AC_FUNC_GETPGRP
@@ -5261,7 +5275,7 @@ replacement of it.
 
 The results of these macros are cached in the
 @code{ac_cv_func_stat_empty_string_bug} and the
-@code{ac_cv_func_stat_empty_string_bug} variables, respectively.
+@code{ac_cv_func_lstat_empty_string_bug} variables, respectively.
 
 These macros are obsolescent, as no current systems have the bug.
 New programs need not use these macros.
@@ -5893,7 +5907,7 @@ If you use this macro, your code can refer to @code{STDC_HEADERS} to
 determine whether the system has conforming header files (and probably C
 library functions).
 
-This macro caches its results in the @code{ac_cv_header_stdc} variable.
+This macro caches its result in the @code{ac_cv_header_stdc} variable.
 
 This macro is obsolescent, as current systems have conforming header
 files.  New programs need not use this macro.


hooks/post-receive
-- 
GNU Autoconf source repository
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.