(Garbage Collection): Clarify previous change.

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index 5ed7f2165ce6323ba6e1818b0a3e88fa1c8fd512..74431dc03be339c748134b4db569c7a2dab24ee8 100644 (file)
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2005-07-22  Richard M. Stallman  <rms@gnu.org>
+
+       * internals.texi (Garbage Collection): Clarify previous change.
+
 2005-07-21  Stefan Monnier  <monnier@iro.umontreal.ca>
 
        * internals.texi (Garbage Collection): Add gc-cons-percentage.

diff --git a/lispref/internals.texi b/lispref/internals.texi
index 61b643bd54a111bad9565d56abba3d087b4c2b89..5cc0fe6e497bac3a21116bfb0de0e8216c505412 100644 (file)
--- 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