aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/lispref/internals.texi10
1 files changed, 6 insertions, 4 deletions
diff --git a/doc/lispref/internals.texi b/doc/lispref/internals.texi
index 6a8aaf8ebaf..428d016b274 100644
--- a/doc/lispref/internals.texi
+++ b/doc/lispref/internals.texi
@@ -558,13 +558,15 @@ The initial threshold value is @code{GC_DEFAULT_THRESHOLD}, defined in
558value is 400,000 for the default 32-bit configuration and 800,000 for 558value is 400,000 for the default 32-bit configuration and 800,000 for
559the 64-bit one. If you specify a larger value, garbage collection 559the 64-bit one. If you specify a larger value, garbage collection
560will happen less often. This reduces the amount of time spent garbage 560will happen less often. This reduces the amount of time spent garbage
561collecting, but increases total memory use. You may want to do this 561collecting (so Lisp programs will run faster between cycles of garbage
562when running a program that creates lots of Lisp data. However, we 562collection that happen more rarely), but increases total memory use.
563You may want to do this when running a program that creates lots of
564Lisp data, especially if you need it to run faster. However, we
563recommend against increasing the threshold for prolonged periods of 565recommend against increasing the threshold for prolonged periods of
564time, and advise that you never set it higher than needed for the 566time, and advise that you never set it higher than needed for the
565program to run in reasonable time. Using thresholds higher than 567program to run in reasonable time. Using thresholds higher than
566necessary could potentially cause system-wide memory pressure, and 568necessary could potentially cause higher system-wide memory pressure,
567should therefore be avoided. 569and should therefore be avoided.
568 570
569You can make collections more frequent by specifying a smaller value, down 571You can make collections more frequent by specifying a smaller value, down
570to 1/10th of @code{GC_DEFAULT_THRESHOLD}. A value less than this minimum 572to 1/10th of @code{GC_DEFAULT_THRESHOLD}. A value less than this minimum