From: Luc Teirlinck <teirllm@auburn.edu>
Date: Mon, 31 Jan 2005 23:31:21 +0000 (+0000)
Subject: (Maintaining Undo): Add `undo-outer-limit'.
X-Git-Tag: ttn-vms-21-2-B4~2492
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=578e484b9e0d1f9bf4437f7f2ba0fbd1b77aac63;p=emacs.git

(Maintaining Undo): Add `undo-outer-limit'.
---

diff --git a/lispref/text.texi b/lispref/text.texi
index 942fb2220a7..3d2fa870bac 100644
--- a/lispref/text.texi
+++ b/lispref/text.texi
@@ -1321,20 +1321,27 @@ preferred name is @code{buffer-disable-undo}.
 them from using up all available memory space, garbage collection trims
 them back to size limits you can set.  (For this purpose, the ``size''
 of an undo list measures the cons cells that make up the list, plus the
-strings of deleted text.)  Two variables control the range of acceptable
-sizes: @code{undo-limit} and @code{undo-strong-limit}.
+strings of deleted text.)  Three variables control the range of acceptable
+sizes: @code{undo-limit}, @code{undo-strong-limit} and
+@code{undo-outer-limit}.
 
-@defvar undo-limit
+@defopt undo-limit
 This is the soft limit for the acceptable size of an undo list.  The
 change group at which this size is exceeded is the last one kept.
-@end defvar
+@end defopt
 
-@defvar undo-strong-limit
+@defopt undo-strong-limit
 This is the upper limit for the acceptable size of an undo list.  The
 change group at which this size is exceeded is discarded itself (along
 with all older change groups).  There is one exception: the very latest
-change group is never discarded no matter how big it is.
-@end defvar
+change group is only discarded if it exceeds @code{undo-outer-limit}.
+@end defopt
+
+@defopt undo-outer-limit
+If at garbage collection time the undo info for the current command
+exceeds this limit, Emacs discards the info and prints a warning
+message.  This is a last ditch limit to prevent memory overflow.
+@end defopt
 
 @node Filling
 @comment  node-name,  next,  previous,  up