helpAutoconf - Support: sr #108182, [doc] Clarification for behaviour...

 
 

sr #108182: [doc] Clarification for behaviour of AC_CHECK_FILES

Submitted by:  Christophe CURIS <lobotomy>
Submitted on:  Sat 17 Nov 2012 05:45:59 PM UTC  
 
Category: NonePriority: 5 - Normal
Severity: 2 - MinorStatus: Done
Privacy: PublicAssigned to: None
Open/Closed: OpenOperating System: None

Add a New Comment (Rich MarkupRich Markup):
   

You are not logged in

Please log in, so followups can be emailed to you.

 

Sun 18 Nov 2012 01:49:46 PM UTC, comment #2:

Hi Paul,

Thanks for the improvement, it looks a lot more clear now, and confirms it was worth specifying!

Best regards,
Christophe

Christophe CURIS <lobotomy>
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

Paul Eggert <eggert>
Project Administrator
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.

Christophe CURIS <lobotomy>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach File(s):
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -unavailable- added by eggert (Posted a comment)
  • -unavailable- added by lobotomy (Submitted the item)
  •  

    Do you think this task is very important?
    If so, you can click here to add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

    Please enter the title of George Orwell's famous dystopian book (it's a date):

     

     

    Follows 1 latest change.

    Date Changed By Updated Field Previous Value => Replaced By
    Sat 17 Nov 2012 07:09:08 PM UTCeggertStatusNone=>Done

    Back to the top


    Powered by Savane 3.1-cleanup