Re: Ambiguity in autoconf info documentation

[Ralf Wildenhues]

Hello Reuben,

* Reuben Thomas wrote on Tue, Apr 10, 2007 at 01:06:50PM CEST:
> 
> It is ambiguous whether the phrase "with any `-' characters changed 
> into `_'" refers to the FEATURE name, and hence the variable name 
> (which appears to be the case) or its value.
> 
> I suggest changing the text starting "shell variable" to:
> 
> "shell variable named `enable_FEATURE', with any `-' characters in 
> FEATURE changed into `_'."

Thanks.  I'm applying this patch.

Cheers,
Ralf

2007-04-11  Ralf Wildenhues  <address@hidden>

        * doc/autoconf.texi (External Software, Package Options):
        Fix ambiguous wording.  Report by Reuben Thomas <address@hidden>.

Index: doc/autoconf.texi
===================================================================
RCS file: /cvsroot/autoconf/autoconf/doc/autoconf.texi,v
retrieving revision 1.1141
diff -u -r1.1141 autoconf.texi
--- doc/autoconf.texi   29 Mar 2007 22:25:18 -0000      1.1141
+++ doc/autoconf.texi   11 Apr 2007 03:44:34 -0000
@@ -15919,9 +15919,10 @@
 
 The option's argument is available to the shell commands
 @var{action-if-given} in the shell variable @code{withval}, which is
-actually just the value of the shell variable @address@hidden,
-with any non-alphanumeric characters changed into @samp{_}.  You may use that
-variable instead, if you wish.
+actually just the value of the shell variable named
address@hidden@var{package}}, with any non-alphanumeric characters in
address@hidden changed into @samp{_}.  You may use that variable instead,
+if you wish.
 
 The argument @var{help-string} is a description of the option that
 looks like this:
@@ -16077,11 +16078,11 @@
 
 The option's argument is available to the shell commands
 @var{action-if-given} in the shell variable @code{enableval}, which is
-actually just the value of the shell variable
address@hidden@var{feature}}, with any non-alphanumeric characters changed into
address@hidden  You may use that variable instead, if you wish.  The
address@hidden argument is like that of @code{AC_ARG_WITH}
-(@pxref{External Software}).
+actually just the value of the shell variable named
address@hidden@var{feature}}, with any non-alphanumeric characters in
address@hidden changed into @samp{_}.  You may use that variable instead,
+if you wish.  The @var{help-string} argument is like that of
address@hidden (@pxref{External Software}).
 
 You should format your @var{help-string} with the macro
 @code{AS_HELP_STRING} (@pxref{Pretty Help Strings}).