summaryrefslogtreecommitdiff
path: root/lispref
diff options
context:
space:
mode:
authorStefan Monnier <monnier@iro.umontreal.ca>2005-07-21 19:03:13 +0000
committerStefan Monnier <monnier@iro.umontreal.ca>2005-07-21 19:03:13 +0000
commit0c17e67cf2b5ab64c9e134f03942f173a956338c (patch)
tree047b98b40d6fba25681f546e74682764d968552b /lispref
parent1d256714e5a772b4e0780c908ebeee1ce19c92fb (diff)
downloademacs-0c17e67cf2b5ab64c9e134f03942f173a956338c.tar.gz
(Garbage Collection): Add gc-cons-percentage.
Diffstat (limited to 'lispref')
-rw-r--r--lispref/ChangeLog8
-rw-r--r--lispref/internals.texi14
2 files changed, 19 insertions, 3 deletions
diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index c75d8060bff..5ed7f2165ce 100644
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2005-07-21 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ * internals.texi (Garbage Collection): Add gc-cons-percentage.
+
2005-07-18 Juri Linkov <juri@jurta.org>
* commands.texi (Accessing Events):
@@ -13,8 +17,8 @@
2005-07-13 Luc Teirlinck <teirllm@auburn.edu>
- * customize.texi (Variable Definitions): Add
- `custom-initialize-safe-set' and `custom-initialize-safe-default'.
+ * customize.texi (Variable Definitions):
+ Add `custom-initialize-safe-set' and `custom-initialize-safe-default'.
`standard-value' is a list too.
(Defining New Types): Use @key{RET} instead of @key{ret}.
diff --git a/lispref/internals.texi b/lispref/internals.texi
index 5a83c82ff5f..61b643bd54a 100644
--- a/lispref/internals.texi
+++ b/lispref/internals.texi
@@ -1,6 +1,6 @@
@c -*-texinfo-*-
@c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1998, 1999
+@c Copyright (C) 1990, 1991, 1992, 1993, 1998, 1999, 2005
@c Free Software Foundation, Inc.
@c See the file elisp.texi for copying conditions.
@setfilename ../info/internals
@@ -368,6 +368,18 @@ 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