texinfo grammar

[Eric Blake]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

According to 'info texinfo', sentences ending with capitals should use @.
so the spacing is correct.  Likewise, abbreviations that do not end a
sentence should use @:.  Meanwhile, I found a usage of "e.g." that should
have been "i.e." [1].

[1]
http://en.wikipedia.org/wiki/List_of_Latin_phrases_%28A%E2%80%93E%29#endnote_egie

Committing a similar patch to branch and head.

- --
Don't work too hard, make some time for fun as well!

Eric Blake             address@hidden
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (Cygwin)
Comment: Public key at home.comcast.net/~ericblake/eblake.gpg
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFHs7fx84KuGfSFAYARAi7bAJ9pXUT4ERjQf4ANFRTDb36kY88BkACgrIGd
K/AQ0+2JUW8l5SxoOXpBdvc=
=kzaz
-----END PGP SIGNATURE-----

>From e3dce8bbfdf9b917089814b081c80fb40958e1a9 Mon Sep 17 00:00:00 2001
From: Eric Blake <address@hidden>
Date: Wed, 13 Feb 2008 19:02:33 -0700
Subject: [PATCH] Fix texinfo grammar.

* doc/m4.texinfo (Eval, Incompatibilities): Use @. after capital.
(History): Use @: after abbreviations.
(M4exit): Use correct Latin abbreviation.
(Dumpdef, Debugmode, Frozen file format 2): Use correct spacing
between sentences.

Signed-off-by: Eric Blake <address@hidden>
---
 ChangeLog      |    9 +++++++++
 doc/m4.texinfo |   16 ++++++++--------
 2 files changed, 17 insertions(+), 8 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 2554a45..f50ac37 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2008-02-13  Eric Blake  <address@hidden>
+
+       Fix texinfo grammar.
+       * doc/m4.texinfo (Eval, Incompatibilities): Use @. after capital.
+       (History): Use @: after abbreviations.
+       (M4exit): Use correct Latin abbreviation.
+       (Dumpdef, Debugmode, Frozen file format 2): Use correct spacing
+       between sentences.
+
 2008-02-11  Eric Blake  <address@hidden>
 
        Allow builtin text macros to specify number of arguments.
diff --git a/doc/m4.texinfo b/doc/m4.texinfo
index 357358f..c313984 100644
--- a/doc/m4.texinfo
+++ b/doc/m4.texinfo
@@ -365,11 +365,11 @@ debugging their @code{m4} scripts than doing real work.  
Beware that
 @cindex @acronym{GNU} M4, history of
 @code{GPM} was an important ancestor of @code{m4}.  See
 C. Stratchey: ``A General Purpose Macro generator'', Computer Journal
-8,3 (1965), pp. 225 ff.  @code{GPM} is also succinctly described into
+8,3 (1965), pp.@: 225 ff.  @code{GPM} is also succinctly described into
 David Gries classic ``Compiler Construction for Digital Computers''.
 
 The classic B. Kernighan and P.J. Plauger: ``Software Tools'',
-Addison-Wesley, Inc. (1976) describes and implements a Unix
+Addison-Wesley, Inc.@: (1976) describes and implements a Unix
 macro-processor language, which inspired Dennis Ritchie to write
 @code{m3}, a macro processor for the AP-3 minicomputer.
 
@@ -3466,7 +3466,7 @@ f(popdef(`f')dumpdef(`f'))
 @samp{s} flags affect the details of the display.  Remember, the
 @samp{q} flag is implied when the @option{--debug} option (@option{-d},
 @pxref{Debugging options, , Invoking m4}) is used in the command line
-without arguments. Also, @option{--debuglen} (@pxref{Debuglen}) can affect
+without arguments.  Also, @option{--debuglen} (@pxref{Debuglen}) can affect
 output, by truncating longer strings (but not builtin and module names).
 
 @comment options: -ds -l3
@@ -3794,7 +3794,7 @@ the previous setting.
 @comment currently enabled?
 
 If no flags are specified with the @option{--debug} option, the default is
address@hidden Many examples in this manual show their output using
address@hidden  Many examples in this manual show their output using
 default flags.
 
 @cindex @acronym{GNU} extensions
@@ -6616,7 +6616,7 @@ eval(`2 && 1 % 0')
 
 @cindex @acronym{GNU} extensions
 As a @acronym{GNU} extension, @code{eval} supports several operators
-that do not appear in C.  A right-associative exponentiation operator
+that do not appear in address@hidden  A right-associative exponentiation 
operator
 @samp{**} computes the value of the left argument raised to the right,
 modulo the numeric precision width.  If evaluated, the exponent must be
 non-negative, and at least one of the arguments must be non-zero, or a
@@ -7555,7 +7555,7 @@ fatal_error(`this is a BAD one, buster')
 
 After this macro call, @code{m4} will exit with exit status 1.  This macro
 is only intended for error exits, since the normal exit procedures are
-not followed, e.g., diverted text is not undiverted, and saved text
+not followed, i.e., diverted text is not undiverted, and saved text
 (@pxref{M4wrap}) is not reread.  (This macro could be made more robust
 to earlier versions of @code{m4}.  You should try to see if you can find
 weaknesses and correct them; or @pxref{Improved fatal_error, , Answers}).
@@ -7837,7 +7837,7 @@ to the symbol table.
 
 @item F @var{length} @key{NL} @var{string} @key{NL}
 Defines, through @code{pushdef}, a definition for @var{string}
-expanding to the function whose builtin name is also @var{string}. The builtin
+expanding to the function whose builtin name is also @var{string}.  The builtin
 name is searched for among the intrinsic builtin functions only.
 
 @item F @var{length1} , @var{length2} @key{NL} @var{string1} @var{string2} 
@key{NL}
@@ -8066,7 +8066,7 @@ giving an error.
 
 @item
 @acronym{POSIX} requires @code{eval} (@pxref{Eval}) to treat all
-operators with the same precedence as C.  However, earlier versions of
+operators with the same precedence as address@hidden  However, earlier 
versions of
 @acronym{GNU} @code{m4} followed the traditional behavior of other
 @code{m4} implementations, where bitwise and logical negation (@samp{~}
 and @samp{!}) have lower precedence than equality operators; and where
-- 
1.5.4