Sat 17 Nov 2012 07:09:08 PM UTC, comment #1:
Thanks for the bug report. I committed this patch:
From 8d2596f8ea7f1ae8056efe9c033054aec2ccab54 Mon Sep 17 00:00:00 2001
From: Paul Eggert <eggert@cs.ucla.edu>
Date: Sat, 17 Nov 2012 11:06:05 -0800
Subject: [PATCH] AC_CHECK_FILES: improve documentation
- doc/autoconf.texi (Files): Document AC_CHECK_FILES better.
Reported by Christophe Curis in
<http://savannah.gnu.org/support/?108182>.
---
doc/autoconf.texi | 13 +++++++------
1 file changed, 7 insertions(+), 6 deletions(-)
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index d1483b8..5b556da 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -4457,7 +4457,7 @@ of the host machine, and therefore, they die when cross-compiling.
@caindex file_@var{file}
Check whether file @var{file} exists on the native system. If it is
found, execute @var{action-if-found}, otherwise do
-@var{action-if-not-found}, if given. The result of this test is cached
+@var{action-if-not-found}, if given. Cache the result of this test
in the @code{ac_cv_file_@var{file}} variable, with characters not
suitable for a variable name mapped to underscores.
@end defmac
@@ -4466,11 +4466,12 @@ suitable for a variable name mapped to underscores.
@ovar{action-if-not-found})
@acindex{CHECK_FILES}
@caindex file_@var{file}
-Executes @code{AC_CHECK_FILE} once for each file listed in @var{files}.
-Additionally, defines @samp{HAVE_@var{file}} (@pxref{Standard Symbols})
-for each file found. The results of each test are cached in the
-@code{ac_cv_file_@var{file}} variable, with characters not suitable for
-a variable name mapped to underscores.
+For each file listed in @var{files}, execute @code{AC_CHECK_FILE}
+and perform either @var{action-if-found} or @var{action-if-not-found}.
+Like @code{AC_CHECK_FILE}, this defines @samp{HAVE_@var{file}}
+(@pxref{Standard Symbols}) for each file found and caches the results of
+each test in the @code{ac_cv_file_@var{file}} variable, with characters
+not suitable for a variable name mapped to underscores.
@end defmac
--
1.7.11.7
|
Sat 17 Nov 2012 05:45:59 PM UTC, original submission:
Hello,
While browsing the on-line documentation for Autoconf, I found a point that could need some added information:
http://www.gnu.org/software/autoconf/manual/autoconf-2.69/html_node/Files.html
The macro AC_CHECK_FILES proposes two actions (if-found and if-not-found), but it is not clear:
- are they executed once for each file?
- or only once in the end?
In the later case (which is what I suppose the behaviour, - but please could you state explicitly it in the page?), would you mind also specifying that 'action-if-found' is executed only if all files are found? (provided it is the case, of course).
This may sound a bit nit-picking, but I fell it would be better to leave no point open to interpretation.
|