(Garbage Collection): Add gc-cons-percentage.

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index c75d8060bff237838654e61815a41aa7c1c03785..5ed7f2165ce6323ba6e1818b0a3e88fa1c8fd512 100644 (file)
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2005-07-21  Stefan Monnier  <monnier@iro.umontreal.ca>
+
+       * internals.texi (Garbage Collection): Add gc-cons-percentage.
+
 2005-07-18  Juri Linkov  <juri@jurta.org>
 
        * commands.texi (Accessing Events):
@@ -13,8 +17,8 @@
 
 2005-07-13  Luc Teirlinck  <teirllm@auburn.edu>
 
-       * customize.texi (Variable Definitions): Add
-       `custom-initialize-safe-set' and `custom-initialize-safe-default'.
+       * customize.texi (Variable Definitions):
+       Add `custom-initialize-safe-set' and `custom-initialize-safe-default'.
        `standard-value' is a list too.
        (Defining New Types): Use @key{RET} instead of @key{ret}.
 

diff --git a/lispref/internals.texi b/lispref/internals.texi
index 5a83c82ff5fb0c2327cc3cf8f9970f981e1a7fa3..61b643bd54a111bad9565d56abba3d087b4c2b89 100644 (file)
--- a/lispref/internals.texi
+++ b/lispref/internals.texi
@@ -1,6 +1,6 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1998, 1999
+@c Copyright (C) 1990, 1991, 1992, 1993, 1998, 1999, 2005
 @c   Free Software Foundation, Inc.
 @c See the file elisp.texi for copying conditions.
 @setfilename ../info/internals
@@ -366,6 +366,18 @@ You can make collections more frequent by specifying a smaller value,
 down to 10,000.  A value less than 10,000 will remain in effect only
 until the subsequent garbage collection, at which time
 @code{garbage-collect} will set the threshold back to 10,000.
+@end defopt
+
+@defopt gc-cons-percentage
+The value of this variable is the minimum portion of the heap that
+should be allocated before a garbage collection takes place.  It is
+used only if the specified size is larger than
+@code{gc-cons-threshold}.
+
+As the heap size increases, the time to perform a garbage collection
+increases, so in order to compensate, this variable tries to
+correspondingly reduce the frequency of collection by letting Emacs
+allocate more memory between each collection.
 @end defopt
 
   The value returned by @code{garbage-collect} describes the amount of