Re: doc: Simple grammar fix

[Eric Blake]

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

According to Elias Benali on 6/24/2009 8:39 PM:
> Shouldn't the correct usage be "the number and aggregate size of
> diversions are limited" instead of "is limited" ?

Yes, but that's still passive voice.  And the overall paragraph overuses
forms of the word 'limit', which is counter to the whole idea that m4
strives to have no arbitrary limits.

> If so a patch is included to fix it.

Thanks!  I wish all bug reports came with proposed patches.  m4.info-1 is
generated, so only m4.texinfo needs to be patched.  Here's what I'm pushing:

- --
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

iEYEARECAAYFAkpDbxAACgkQ84KuGfSFAYBJAACeOiIiC3ZekoWUXJvv1CkGIJ0f
VYAAn1vxpeGdkFQox0+TbRdg4rkw7mJP
=rFzn
-----END PGP SIGNATURE-----

>From 59658f499a3e1c2675e7ba6b264dc37e24a57b25 Mon Sep 17 00:00:00 2001
From: Eric Blake <address@hidden>
Date: Thu, 25 Jun 2009 06:32:15 -0600
Subject: [PATCH] Fix description of limits on diversions.

* doc/m4.texinfo (Diversions): Fix grammar.  Be less pessimistic
about limitations.
* THANKS: Update.
Reported by Elias Benali.

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

diff --git a/ChangeLog b/ChangeLog
index e675616..1a8a7c3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2009-06-25  Eric Blake  <address@hidden>
+
+       Fix description of limits on diversions.
+       * doc/m4.texinfo (Diversions): Fix grammar.  Be less pessimistic
+       about limitations.
+       * THANKS: Update.
+       Reported by Elias Benali.
+
 2009-06-17  Eric Blake  <address@hidden>

        Update to latest gnulib.
diff --git a/doc/m4.texinfo b/doc/m4.texinfo
index 1c5230a..48aa74e 100644
--- a/doc/m4.texinfo
+++ b/doc/m4.texinfo
@@ -5090,17 +5090,16 @@ Diversions

 @cindex @env{TMPDIR}
 Numbered diversions are counted from 0 upwards, diversion number 0
-being the normal output stream.  The number of simultaneous diversions
-is limited mainly by the memory used to describe them, because @acronym{GNU}
+being the normal output stream.  @acronym{GNU}
 @code{m4} tries to keep diversions in memory.  However, there is a
-limit to the overall memory usable by all diversions taken altogether
+limit to the overall memory usable by all diversions taken together
 (512K, currently).  When this maximum is about to be exceeded,
 a temporary file is opened to receive the contents of the biggest
 diversion still in memory, freeing this memory for other diversions.
 When creating the temporary file, @code{m4} honors the value of the
 environment variable @env{TMPDIR}, and falls back to @file{/tmp}.
-So, it is theoretically possible that the number and aggregate size of
-diversions is limited only by available disk space.
+Thus, the amount of available disk space provides the only real limit on
+the number and aggregate size of diversions.

 @ignore
 @comment We need to test spilled diversions, but don't need to expose
-- 
1.6.3.3.334.g916e1