[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Fixing trivial grammaros
From: |
Eric Blake |
Subject: |
Re: Fixing trivial grammaros |
Date: |
Wed, 22 Apr 2009 20:53:10 -0600 |
User-agent: |
Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.21) Gecko/20090302 Thunderbird/2.0.0.21 Mnenhy/0.7.6.666 |
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
According to Ralf Wildenhues on 4/21/2009 2:48 PM:
>> At least we're consistent in using the term 'AC_CONFIG_FOOS' throughout the
>> manual. But on rereading this, I think I'd like:
>>
>> @address@hidden
>>
>> better, since it emphasizes that FOOS is a meta-syntactic placeholder for
>> one
>> of the four config actions. It won't help info text (since FOOS is already
>> in
>> capitals), but will make html and pdf renderings nicer.
>
> Hmm. We have more instances of using foo or FOO or FOOS instead of
> using metasyntactic variables in the manual, in several markup
> circumstances. I think such a change would deserve a bit more work,
> and maybe some renaming, too.
How about the following? I searched the entire manual for uses of _foo
and _FOO, and only these stood out to me.
- --
Don't work too hard, make some time for fun as well!
Eric Blake address@hidden
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Cygwin)
Comment: Public key at home.comcast.net/~ericblake/eblake.gpg
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
iEYEARECAAYFAknv2BYACgkQ84KuGfSFAYApawCgqk9uHeGWyxFVW4p32WhTYsej
bdsAnikuCa7/o0Cv+RO8O61miCMT2coc
=qLfU
-----END PGP SIGNATURE-----
>From 9cee35c16c4a13555bb8dbda285bf44032b73b0f Mon Sep 17 00:00:00 2001
From: Eric Blake <address@hidden>
Date: Wed, 22 Apr 2009 16:53:19 -0600
Subject: [PATCH] Change FOO placeholder to use @var{text} instead.
* doc/autoconf.texi (Configuration Actions): Rename AC_CONFIG_FOOS
to address@hidden
* doc/autoconf.texi (config.status Invocation): Likewise.
(AC_FOO_IFELSE vs AC_TRY_FOO): Rename node...
(address@hidden vs address@hidden): ...to this.
Signed-off-by: Eric Blake <address@hidden>
---
ChangeLog | 7 +++++++
doc/autoconf.texi | 22 ++++++++++++----------
2 files changed, 19 insertions(+), 10 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 8bc3ecd..d40e9c0 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,12 @@
2009-04-22 Eric Blake <address@hidden>
+ Change FOO placeholder to use @var{text} instead.
+ * doc/autoconf.texi (Configuration Actions): Rename AC_CONFIG_FOOS
+ to address@hidden
+ * doc/autoconf.texi (config.status Invocation): Likewise.
+ (AC_FOO_IFELSE vs AC_TRY_FOO): Rename node...
+ (address@hidden vs address@hidden): ...to this.
+
Add m4_argn.
* lib/m4sugar/m4sugar.m4 (m4_argn): New macro.
* NEWS: Document it.
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 516e58d..74b64d5 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -594,7 +594,7 @@ Top
* New Macros:: Interaction with foreign macros
* Hosts and Cross-Compilation:: Bugward compatibility kludges
* AC_LIBOBJ vs LIBOBJS:: LIBOBJS is a forbidden token
-* AC_FOO_IFELSE vs AC_TRY_FOO:: A more generic scheme for testing sources
+* address@hidden vs address@hidden:: A more generic scheme for testing sources
Generating Test Suites with Autotest
@@ -2105,7 +2105,7 @@ Configuration Actions
@c FIXME: Can't use @ovar here, Texinfo 4.0 goes lunatic and emits something
@c awful.
@example
-AC_CONFIG_FOOS(@address@hidden, address@hidden, address@hidden)
address@hidden(@address@hidden, address@hidden, address@hidden)
@end example
@noindent
@@ -2122,15 +2122,15 @@ Configuration Actions
@example
@dots{} && my_foos="$my_foos fooo"
@dots{} && my_foos="$my_foos foooo"
-AC_CONFIG_FOOS([$my_foos])
address@hidden([$my_foos])
@end example
@noindent
and use this instead:
@example
address@hidden && AC_CONFIG_FOOS([fooo])
address@hidden && AC_CONFIG_FOOS([foooo])
address@hidden && address@hidden([fooo])
address@hidden && address@hidden([foooo])
@end example
The macros @code{AC_CONFIG_FILES} and @code{AC_CONFIG_HEADERS} use
@@ -3434,7 +3434,7 @@ Configuration Commands
Execute the @var{cmds} right before creating @file{config.status}.
This macro presents the last opportunity to call @code{AC_SUBST},
address@hidden, or @code{AC_CONFIG_FOOS} macros.
address@hidden, or @address@hidden macros.
@end defmac
@defmac AC_CONFIG_COMMANDS_POST (@var{cmds})
@@ -20064,7 +20064,7 @@ config.status Invocation
It configures each @var{tag}; if none are specified, all the templates
are instantiated. A @var{tag} refers to a file or other tag associated
-with a configuration action, as specified by an @code{AC_CONFIG_FOOS}
+with a configuration action, as specified by an @address@hidden
macro (@pxref{Configuration Actions}). The files must be specified
without their dependencies, as in
@@ -21678,7 +21678,7 @@ Autoconf 2.13
* New Macros:: Interaction with foreign macros
* Hosts and Cross-Compilation:: Bugward compatibility kludges
* AC_LIBOBJ vs LIBOBJS:: LIBOBJS is a forbidden token
-* AC_FOO_IFELSE vs AC_TRY_FOO:: A more generic scheme for testing sources
+* address@hidden vs address@hidden:: A more generic scheme for testing sources
@end menu
@node Changed Quotation
@@ -21974,8 +21974,10 @@ AC_LIBOBJ vs LIBOBJS
The @code{LIBOBJDIR} feature is experimental.
address@hidden AC_FOO_IFELSE vs AC_TRY_FOO
address@hidden @code{AC_FOO_IFELSE} vs.@: @code{AC_TRY_FOO}
address@hidden address@hidden vs address@hidden
address@hidden @address@hidden vs.@: @address@hidden
address@hidden the anchor keeps the old node name, to try to avoid breaking
links
address@hidden vs AC_TRY_FOO}
Since Autoconf 2.50, internal codes uses @code{AC_PREPROC_IFELSE},
@code{AC_COMPILE_IFELSE}, @code{AC_LINK_IFELSE}, and
--
1.6.1.2
Re: Fixing trivial grammaros, Paolo Bonzini, 2009/04/22