From: Richard M. Stallman Date: Fri, 22 Jul 2005 22:58:30 +0000 (+0000) Subject: (Garbage Collection): Clarify previous change. X-Git-Tag: emacs-pretest-22.0.90~7903 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=6696f2a495b6cc41cf0e5f098ca23ed9d0a6ab6b;p=emacs.git (Garbage Collection): Clarify previous change. --- diff --git a/lispref/ChangeLog b/lispref/ChangeLog index 5ed7f2165ce..74431dc03be 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,3 +1,7 @@ +2005-07-22 Richard M. Stallman + + * internals.texi (Garbage Collection): Clarify previous change. + 2005-07-21 Stefan Monnier * internals.texi (Garbage Collection): Add gc-cons-percentage. diff --git a/lispref/internals.texi b/lispref/internals.texi index 61b643bd54a..5cc0fe6e497 100644 --- a/lispref/internals.texi +++ b/lispref/internals.texi @@ -369,15 +369,14 @@ until the subsequent garbage collection, at which time @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}. +The value of this variable specifies the amount of consing before a +garbage collection occurs, as a fraction of the current heap size. +This criterion and @code{gc-cons-threshold} apply in parallel, and +garbage collection occurs only when both criteria are satisfied. 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. +increases. Thus, it can be desirable to do them less frequently in +proportion. @end defopt The value returned by @code{garbage-collect} describes the amount of