Document wide integers better.

* buffers.texi (Buffers):
* files.texi (Visiting): Default buffer maximum is now 2 EiB typically.

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 89a78263e94e69a4353d2e89a1f9e1139599bc85..3b61ca6ccba3afe0ce9ea89333d82f6e1c321789 100644 (file)
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,9 @@
+2011-06-02  Paul Eggert  <eggert@cs.ucla.edu>
+
+       Document wide integers better.
+       * buffers.texi (Buffers):
+       * files.texi (Visiting): Default buffer maximum is now 2 EiB typically.
+
 2011-05-28  Chong Yidong  <cyd@stupidchicken.com>
 
        * custom.texi (Hooks): Reorganize.  Mention Prog mode.

diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi
index ae0d85f249bfda90e1e70dc42611c89ada16461f..9463b02464de7899cae0d5b37ef9b178f6a575bb 100644 (file)
--- a/doc/emacs/buffers.texi
+++ b/doc/emacs/buffers.texi
@@ -43,8 +43,11 @@ can be different from the value in other buffers.  @xref{Locals}.
   A buffer's size cannot be larger than some maximum, which is defined
 by the largest buffer position representable by the @dfn{Emacs
 integer} data type.  This is because Emacs tracks buffer positions
-using that data type.  For 32-bit machines, the largest buffer size is
-512 megabytes.
+using that data type.  For most machines, the maximum buffer size
+enforced by the data types is @math{2^61 - 2} bytes, or about 2 EiB.
+For some older machines, the maximum is @math{2^29 - 2} bytes, or
+about 512 MiB.  Buffer sizes are also limited by the size of Emacs's
+virtual memory.
 
 @menu
 * Select Buffer::       Creating a new buffer or reselecting an old one.

diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index 40bd065610c1610dfd47b6b2a7bc6c6c88ec3379..793a11e62ed5737b65b32b194c0ff0922d28d92f 100644 (file)
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -209,7 +209,8 @@ to reread it.
 about 10 megabytes), Emacs asks you for confirmation first.  You can
 answer @kbd{y} to proceed with visiting the file.  Note, however, that
 Emacs cannot visit files that are larger than the maximum Emacs buffer
-size, which is around 512 megabytes on 32-bit machines
+size, which is limited by the amount of memory Emacs can allocate
+and by the integers that Emacs can represent
 (@pxref{Buffers}).  If you try, Emacs will display an error message
 saying that the maximum buffer size has been exceeded.