Re: branch-1_4 doc improvements

[Eric Blake]

Eric Blake <ebb9 <at> byu.net> writes:

> 
> And finally, the patch I've been working on for a week, which turned up
> all the smaller issues along the way.  I changed the formatting to use
>  <at> deffn consistently, fixed grammar mistakes as I saw them, and adjusted
> wording where it was awkward.  I've tested info, pdf, and html outputs to
> make sure all three look reasonable.

The node on builtin had some bad merging.

2006-07-17  Eric Blake  <address@hidden>

        * doc/m4.texinfo (Builtin): Delete redundant text.

Index: doc/m4.texinfo
===================================================================
RCS file: /sources/m4/m4/doc/m4.texinfo,v
retrieving revision 1.1.1.1.2.46
diff -u -r1.1.1.1.2.46 m4.texinfo
--- doc/m4.texinfo      15 Jul 2006 22:08:58 -0000      1.1.1.1.2.46
+++ doc/m4.texinfo      17 Jul 2006 16:51:10 -0000
@@ -1636,7 +1636,7 @@
 @end deffn
 
 This can be used even if @var{name} has been given another definition
-that has covered the original, or been undefined so that no @var{name}
+that has covered the original, or been undefined so that no macro
 maps to the builtin.
 
 @example
@@ -1662,54 +1662,9 @@
 @result{}foo
 @end example
 
-Note that this can be used to invoke builtins that normally require
-parameters without actually providing them; but it will provoke a
-warning, and usually result in a void expansion.
-
address@hidden
-builtin
address@hidden
-builtin()
address@hidden:2: m4: undefined builtin `'
address@hidden
-builtin(`builtin')
address@hidden:3: m4: Warning: too few arguments to builtin `builtin'
address@hidden
-builtin(`builtin',)
address@hidden:4: m4: undefined builtin `'
address@hidden
address@hidden example
-
-This can be used even if @var{name} has been given another definition
-that has covered the original, or been undefined so that no @var{name}
-maps to the builtin.
-
address@hidden
-pushdef(`define', `hidden')
address@hidden
-undefine(`undefine')
address@hidden
-define(`foo', `bar')
address@hidden
-foo
address@hidden
-builtin(`define', `foo', `BAR')
address@hidden
-foo
address@hidden
-undefine(`foo')
address@hidden(foo)
-foo
address@hidden
-builtin(`undefine', `foo')
address@hidden
-foo
address@hidden
address@hidden example
-
-Note that this can be used to invoke builtins that normally require
-parameters without actually providing them; but it will provoke a
-warning, and usually result in a void expansion.
+Note that this can be used to invoke builtins without arguments, even
+when they normally require parameters to be recognized; but it will
+provoke a warning, and result in a void expansion.
 
 @example
 builtin