martin/emacs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Improve the max-specpdl-size doc string

Browse Source 
* src/eval.c (syms_of_eval): Mention what "specpdl" means.
This commit is contained in:
Lars Ingebrigtsen
2021-09-29 07:53:10 +02:00
parent 081eb52e4d
commit 3efa45849a
1 changed files with 13 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
src/eval.c
View File

@@ -4311,13 +4311,19 @@ syms_of_eval (void)
{
DEFVAR_INT ("max-specpdl-size", max_specpdl_size,
doc: /* Limit on number of Lisp variable bindings and `unwind-protect's.
If Lisp code tries to increase the total number past this amount,
an error is signaled.
You can safely use a value considerably larger than the default value,
if that proves inconveniently small. However, if you increase it too far,
Emacs could run out of memory trying to make the stack bigger.
Note that this limit may be silently increased by the debugger
if `debug-on-error' or `debug-on-quit' is set. */);
If Lisp code tries to use more bindings than this amount, an error is
signaled.
You can safely increase this variable substantially if the default
value proves inconveniently small. However, if you increase it too
much, Emacs could run out of memory trying to make the stack bigger.
Note that this limit may be silently increased by the debugger if
`debug-on-error' or `debug-on-quit' is set.
\"spec\" is short for \"special variables\", i.e., dynamically bound
variables. \"PDL\" is short for \"push-down list\", which is an old
term for \"stack\". */);
DEFVAR_INT ("max-lisp-eval-depth", max_lisp_eval_depth,
doc: /* Limit on depth in `eval', `apply' and `funcall' before error.