diff lispref/internals.texi @ 64580:8e0b1420853a

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

--- a/lispref/internals.texi	Thu Jul 21 16:38:17 2005 +0000
+++ b/lispref/internals.texi	Thu Jul 21 19:03:13 2005 +0000
@@ -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
@@ -368,6 +368,18 @@
 @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
 memory used by Lisp data, broken down by data type.  By contrast, the
 function @code{memory-limit} provides information on the total amount of