diff options
Diffstat (limited to 'doc/lispref')
| -rw-r--r-- | doc/lispref/control.texi | 5 | ||||
| -rw-r--r-- | doc/lispref/edebug.texi | 5 | ||||
| -rw-r--r-- | doc/lispref/eval.texi | 5 | ||||
| -rw-r--r-- | doc/lispref/variables.texi | 21 |
4 files changed, 3 insertions, 33 deletions
diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi index d4520ebdee5..ee2acdb002b 100644 --- a/doc/lispref/control.texi +++ b/doc/lispref/control.texi | |||
| @@ -2366,11 +2366,6 @@ of the @var{cleanup-forms} themselves exits nonlocally (via a | |||
| 2366 | guaranteed to evaluate the rest of them. If the failure of one of the | 2366 | guaranteed to evaluate the rest of them. If the failure of one of the |
| 2367 | @var{cleanup-forms} has the potential to cause trouble, then protect | 2367 | @var{cleanup-forms} has the potential to cause trouble, then protect |
| 2368 | it with another @code{unwind-protect} around that form. | 2368 | it with another @code{unwind-protect} around that form. |
| 2369 | |||
| 2370 | The number of currently active @code{unwind-protect} forms counts, | ||
| 2371 | together with the number of local variable bindings, against the limit | ||
| 2372 | @code{max-specpdl-size} (@pxref{Definition of max-specpdl-size,, Local | ||
| 2373 | Variables}). | ||
| 2374 | @end defspec | 2369 | @end defspec |
| 2375 | 2370 | ||
| 2376 | For example, here we make an invisible buffer for temporary use, and | 2371 | For example, here we make an invisible buffer for temporary use, and |
diff --git a/doc/lispref/edebug.texi b/doc/lispref/edebug.texi index 56f7b7bdfad..6a51489d8a4 100644 --- a/doc/lispref/edebug.texi +++ b/doc/lispref/edebug.texi | |||
| @@ -1032,9 +1032,8 @@ program. | |||
| 1032 | @itemize @bullet | 1032 | @itemize @bullet |
| 1033 | @item | 1033 | @item |
| 1034 | @vindex edebug-max-depth | 1034 | @vindex edebug-max-depth |
| 1035 | @code{max-lisp-eval-depth} (@pxref{Eval}) and @code{max-specpdl-size} | 1035 | @code{max-lisp-eval-depth} (@pxref{Eval}) is increased to reduce Edebug's |
| 1036 | (@pxref{Local Variables}) are both increased to reduce Edebug's impact | 1036 | impact on the stack. You could, however, still run out of stack space when |
| 1037 | on the stack. You could, however, still run out of stack space when | ||
| 1038 | using Edebug. You can also enlarge the value of | 1037 | using Edebug. You can also enlarge the value of |
| 1039 | @code{edebug-max-depth} if Edebug reaches the limit of recursion depth | 1038 | @code{edebug-max-depth} if Edebug reaches the limit of recursion depth |
| 1040 | instrumenting code that contains very large quoted lists. | 1039 | instrumenting code that contains very large quoted lists. |
diff --git a/doc/lispref/eval.texi b/doc/lispref/eval.texi index 6e29a5403f1..11c321b32ed 100644 --- a/doc/lispref/eval.texi +++ b/doc/lispref/eval.texi | |||
| @@ -830,7 +830,7 @@ This variable defines the maximum depth allowed in calls to @code{eval}, | |||
| 830 | @code{apply}, and @code{funcall} before an error is signaled (with error | 830 | @code{apply}, and @code{funcall} before an error is signaled (with error |
| 831 | message @code{"Lisp nesting exceeds max-lisp-eval-depth"}). | 831 | message @code{"Lisp nesting exceeds max-lisp-eval-depth"}). |
| 832 | 832 | ||
| 833 | This limit, with the associated error when it is exceeded, is one way | 833 | This limit, with the associated error when it is exceeded, is how |
| 834 | Emacs Lisp avoids infinite recursion on an ill-defined function. If | 834 | Emacs Lisp avoids infinite recursion on an ill-defined function. If |
| 835 | you increase the value of @code{max-lisp-eval-depth} too much, such | 835 | you increase the value of @code{max-lisp-eval-depth} too much, such |
| 836 | code can cause stack overflow instead. On some systems, this overflow | 836 | code can cause stack overflow instead. On some systems, this overflow |
| @@ -851,9 +851,6 @@ less than 100, Lisp will reset it to 100 if the given value is | |||
| 851 | reached. Entry to the Lisp debugger increases the value, if there is | 851 | reached. Entry to the Lisp debugger increases the value, if there is |
| 852 | little room left, to make sure the debugger itself has room to | 852 | little room left, to make sure the debugger itself has room to |
| 853 | execute. | 853 | execute. |
| 854 | |||
| 855 | @code{max-specpdl-size} provides another limit on nesting. | ||
| 856 | @xref{Definition of max-specpdl-size,, Local Variables}. | ||
| 857 | @end defopt | 854 | @end defopt |
| 858 | 855 | ||
| 859 | @defvar values | 856 | @defvar values |
diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi index 975e945b343..ccd19630bf7 100644 --- a/doc/lispref/variables.texi +++ b/doc/lispref/variables.texi | |||
| @@ -358,27 +358,6 @@ Variables}); a few variables have terminal-local bindings | |||
| 358 | like ordinary local bindings, but they are localized depending on | 358 | like ordinary local bindings, but they are localized depending on |
| 359 | where you are in Emacs. | 359 | where you are in Emacs. |
| 360 | 360 | ||
| 361 | @defopt max-specpdl-size | ||
| 362 | @anchor{Definition of max-specpdl-size} | ||
| 363 | @cindex variable limit error | ||
| 364 | @cindex evaluation error | ||
| 365 | @cindex infinite recursion | ||
| 366 | This variable defines the limit on the total number of local variable | ||
| 367 | bindings and @code{unwind-protect} cleanups (@pxref{Cleanups,, | ||
| 368 | Cleaning Up from Nonlocal Exits}) that are allowed before Emacs | ||
| 369 | signals an error (with data @code{"Variable binding depth exceeds | ||
| 370 | max-specpdl-size"}). | ||
| 371 | |||
| 372 | This limit, with the associated error when it is exceeded, is one way | ||
| 373 | that Lisp avoids infinite recursion on an ill-defined function. | ||
| 374 | @code{max-lisp-eval-depth} provides another limit on depth of nesting. | ||
| 375 | @xref{Definition of max-lisp-eval-depth,, Eval}. | ||
| 376 | |||
| 377 | The default value is 2500. Entry to the Lisp debugger increases the | ||
| 378 | value, if there is little room left, to make sure the debugger itself | ||
| 379 | has room to execute. | ||
| 380 | @end defopt | ||
| 381 | |||
| 382 | @node Void Variables | 361 | @node Void Variables |
| 383 | @section When a Variable is Void | 362 | @section When a Variable is Void |
| 384 | @cindex @code{void-variable} error | 363 | @cindex @code{void-variable} error |