From 6696f2a495b6cc41cf0e5f098ca23ed9d0a6ab6b Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Fri, 22 Jul 2005 22:58:30 +0000 Subject: [PATCH] (Garbage Collection): Clarify previous change. --- lispref/ChangeLog | 4 ++++ lispref/internals.texi | 13 ++++++------- 2 files changed, 10 insertions(+), 7 deletions(-) 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 -- 2.39.2