# HG changeset patch # User Stefan Monnier # Date 1121972593 0 # Node ID 8e0b1420853acb893b55074b2c99666541fdd3e3 # Parent 51c5f403fb8135d25912a793ec8c9c9a6d82bcf2 (Garbage Collection): Add gc-cons-percentage. diff -r 51c5f403fb81 -r 8e0b1420853a lispref/ChangeLog --- 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 + + * internals.texi (Garbage Collection): Add gc-cons-percentage. + 2005-07-18 Juri Linkov * commands.texi (Accessing Events): @@ -13,8 +17,8 @@ 2005-07-13 Luc Teirlinck - * 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 -r 51c5f403fb81 -r 8e0b1420853a lispref/internals.texi --- 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