comparison lispref/internals.texi @ 64602:cf0f927b0ecc

(Garbage Collection): Clarify previous change.

64601:a0a53728d812

until the subsequent garbage collection, at which time
@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

64602:cf0f927b0ecc

until the subsequent garbage collection, at which time
@code{garbage-collect} will set the threshold back to 10,000.
@end defopt

@defopt gc-cons-percentage
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.  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
memory used by Lisp data, broken down by data type.  By contrast, the
function @code{memory-limit} provides information on the total amount of