emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] emacs-26 56e3e4f: Improve indexing in the ELisp manual


From: Eli Zaretskii
Subject: [Emacs-diffs] emacs-26 56e3e4f: Improve indexing in the ELisp manual
Date: Sat, 24 Nov 2018 03:02:01 -0500 (EST)

branch: emacs-26
commit 56e3e4fe6816b5f13c410300e2bf5a0c1fcbe03a
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Improve indexing in the ELisp manual
    
    * doc/lispref/control.texi (Control Structures, Sequencing)
    (Conditionals, Iteration, Catch and Throw, Handling Errors)
    (Cleanups):
    * doc/lispref/eval.texi (Self-Evaluating Forms)
    (Symbol Forms, Function Forms, Macro Forms, Special Forms)
    (Quoting, Backquote): Add index entries that begin with
    "forms".  (Bug#33440)
---
 doc/lispref/control.texi | 7 +++++++
 doc/lispref/eval.texi    | 9 +++++++++
 2 files changed, 16 insertions(+)

diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi
index 8989b7d..4e5422a 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
address@hidden 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
address@hidden 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
address@hidden forms, conditional
 
   Conditional control structures choose among alternatives.  Emacs Lisp
 has five conditional forms: @code{if}, which is much the same as in
@@ -1273,6 +1276,7 @@ up being equivalent to @code{dolist} (@pxref{Iteration}).
 @section Iteration
 @cindex iteration
 @cindex recursion
address@hidden forms, iteration
 
   Iteration means executing part of a program repetitively.  For
 example, you might want to repeat some computation once for each element
@@ -1496,6 +1500,7 @@ exited.
 
 @node Catch and Throw
 @subsection Explicit Nonlocal Exits: @code{catch} and @code{throw}
address@hidden 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
@@ -1867,6 +1872,7 @@ variables precisely as they were at the time of the error.
 @subsubsection Writing Code to Handle Errors
 @cindex error handler
 @cindex handling errors
address@hidden 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
address@hidden forms for cleanup
 
   The @code{unwind-protect} construct is essential whenever you
 temporarily put a data structure in an inconsistent state; it permits
diff --git a/doc/lispref/eval.texi b/doc/lispref/eval.texi
index 373b12e..416815e 100644
--- a/doc/lispref/eval.texi
+++ b/doc/lispref/eval.texi
@@ -127,6 +127,7 @@ with the other types, which are self-evaluating forms.
 @cindex vector evaluation
 @cindex literal evaluation
 @cindex self-evaluating form
address@hidden form, self-evaluating
 
   A @dfn{self-evaluating form} is any form that is not a list or
 symbol.  Self-evaluating forms evaluate to themselves: the result of
@@ -179,6 +180,8 @@ program.  Here is an example:
 @node Symbol Forms
 @subsection Symbol Forms
 @cindex symbol evaluation
address@hidden symbol forms
address@hidden forms, symbol
 
   When a symbol is evaluated, it is treated as a variable.  The result
 is the variable's value, if it has one.  If the symbol has no value as
@@ -215,6 +218,7 @@ its value ordinarily cannot be changed.  @xref{Constant 
Variables}.
 @node Classifying Lists
 @subsection Classification of List Forms
 @cindex list form evaluation
address@hidden forms, list
 
   A form that is a nonempty list is either a function call, a macro
 call, or a special form, according to its first element.  These three
@@ -349,6 +353,7 @@ Here is how you could define @code{indirect-function} in 
Lisp:
 @subsection Evaluation of Function Forms
 @cindex function form evaluation
 @cindex function call
address@hidden forms, function call
 
   If the first element of a list being evaluated is a Lisp function
 object, byte-code object or primitive function object, then that list is
@@ -372,6 +377,7 @@ body form becomes the value of the function call.
 @node Macro Forms
 @subsection Lisp Macro Evaluation
 @cindex macro call evaluation
address@hidden forms, macro call
 
   If the first element of a list being evaluated is a macro object, then
 the list is a @dfn{macro call}.  When a macro call is evaluated, the
@@ -418,6 +424,7 @@ expansion.
 @node Special Forms
 @subsection Special Forms
 @cindex special forms
address@hidden forms, special
 @cindex evaluation of special forms
 
   A @dfn{special form} is a primitive function specially marked so that
@@ -539,6 +546,7 @@ described in @ref{Autoload}.
 
 @node Quoting
 @section Quoting
address@hidden forms, quote
 
   The special form @code{quote} returns its single argument, as written,
 without evaluating it.  This provides a way to include constant symbols
@@ -598,6 +606,7 @@ only part of a list, while computing and substituting other 
parts.
 @cindex backquote (list substitution)
 @cindex ` (list substitution)
 @findex `
address@hidden forms, backquote
 
   @dfn{Backquote constructs} allow you to quote a list, but
 selectively evaluate elements of that list.  In the simplest case, it



reply via email to

[Prev in Thread] Current Thread [Next in Thread]