Mercurial > emacs

--- a/lispref/ChangeLog	Thu Jul 21 16:38:17 2005 +0000
+++ b/lispref/ChangeLog	Thu Jul 21 19:03:13 2005 +0000
@@ -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}.
--- 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