summaryrefslogtreecommitdiff
path: root/doc/lispref/control.texi
diff options
context:
space:
mode:
authorGlenn Morris <rgm@gnu.org>2018-11-24 07:51:04 -0800
committerGlenn Morris <rgm@gnu.org>2018-11-24 07:51:04 -0800
commit023502af450f9af3ab80747e5be4812cbc750f45 (patch)
tree5fea297e38d2c3f2f7fd7f9f365773301f01f601 /doc/lispref/control.texi
parentdcacff41958d6dc12baf05e7e9de13d1ab5b09ae (diff)
parent56e3e4fe6816b5f13c410300e2bf5a0c1fcbe03a (diff)
downloademacs-023502af450f9af3ab80747e5be4812cbc750f45.tar.gz
emacs-023502af450f9af3ab80747e5be4812cbc750f45.tar.bz2
emacs-023502af450f9af3ab80747e5be4812cbc750f45.zip
Merge from origin/emacs-26
56e3e4f Improve indexing in the ELisp manual 7a4992a More Symbola-related extensions for default fontset 4ae0a75 Better support for display of U+1F900..U+1F9FF block 8f0c788 Improve documentation of 'edit-abbrevs-mode' 3c643e7 ; NEWS tweak 477414a Improve documentation of 'dired-do-compress' 9c09b1d ; * etc/NES: Minor change in the description of Dired's 'Z'. 52715e3 Improve doc string and display of 'describe-character' 93242b1 * etc/NEWS: Clarify what 'Z' does in Dired. (Bug#33450) 0d59ae3 Update the docs of object internals Conflicts: etc/NEWS
Diffstat (limited to 'doc/lispref/control.texi')
-rw-r--r--doc/lispref/control.texi7
1 files changed, 7 insertions, 0 deletions
diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi
index 5cc43c428ad..6fe0018a8a7 100644
--- a/doc/lispref/control.texi
+++ b/doc/lispref/control.texi
@@ -6,6 +6,7 @@
@node Control Structures
@chapter Control Structures
@cindex special forms for control structures
+@cindex forms for control structures
@cindex control structures
A Lisp program consists of a set of @dfn{expressions}, or
@@ -48,6 +49,7 @@ structure constructs (@pxref{Macros}).
@section Sequencing
@cindex sequencing
@cindex sequential execution
+@cindex forms for sequential execution
Evaluating forms in the order they appear is the most common way
control passes from one form to another. In some contexts, such as in a
@@ -146,6 +148,7 @@ following @var{forms}, in textual order, returning the result of
@node Conditionals
@section Conditionals
@cindex conditional evaluation
+@cindex forms, conditional
Conditional control structures choose among alternatives. Emacs Lisp
has five conditional forms: @code{if}, which is much the same as in
@@ -1271,6 +1274,7 @@ up being equivalent to @code{dolist} (@pxref{Iteration}).
@section Iteration
@cindex iteration
@cindex recursion
+@cindex forms, iteration
Iteration means executing part of a program repetitively. For
example, you might want to repeat some computation once for each element
@@ -1495,6 +1499,7 @@ exited.
@node Catch and Throw
@subsection Explicit Nonlocal Exits: @code{catch} and @code{throw}
+@cindex forms for nonlocal exits
Most control constructs affect only the flow of control within the
construct itself. The function @code{throw} is the exception to this
@@ -1866,6 +1871,7 @@ variables precisely as they were at the time of the error.
@subsubsection Writing Code to Handle Errors
@cindex error handler
@cindex handling errors
+@cindex forms for handling errors
The usual effect of signaling an error is to terminate the command
that is running and return immediately to the Emacs editor command loop.
@@ -2235,6 +2241,7 @@ and their conditions.
@node Cleanups
@subsection Cleaning Up from Nonlocal Exits
@cindex nonlocal exits, cleaning up
+@cindex forms for cleanup
The @code{unwind-protect} construct is essential whenever you
temporarily put a data structure in an inconsistent state; it permits