[Emacs-diffs] /srv/bzr/emacs/trunk r107029: Minor tweaks to the Lisp manual.

[Chong Yidong]

------------------------------------------------------------
revno: 107029
fixes bug(s): http://debbugs.gnu.org/10657
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Tue 2012-01-31 14:51:33 +0800
message:
  Minor tweaks to the Lisp manual.
  
  * syntax.texi (Parsing Expressions): Clarify intro.
  (Parser State): Remove unnecessary statement (Bug#10661).
  
  * eval.texi (Intro Eval): Add footnote about "sexp" terminology.
modified:
  doc/lispref/ChangeLog
  doc/lispref/eval.texi
  doc/lispref/syntax.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-01-31 05:03:09 +0000
+++ b/doc/lispref/ChangeLog     2012-01-31 06:51:33 +0000
@@ -1,3 +1,10 @@
+2012-01-31  Chong Yidong  <address@hidden>
+
+       * syntax.texi (Parsing Expressions): Clarify intro (Bug#10657).
+       (Parser State): Remove unnecessary statement (Bug#10661).
+
+       * eval.texi (Intro Eval): Add footnote about "sexp" terminology.
+
 2012-01-31  Glenn Morris  <address@hidden>
 
        * modes.texi (Defining Minor Modes):

=== modified file 'doc/lispref/eval.texi'
--- a/doc/lispref/eval.texi     2012-01-23 04:23:50 +0000
+++ b/doc/lispref/eval.texi     2012-01-31 06:51:33 +0000
@@ -39,12 +39,15 @@
 
 @cindex form
 @cindex expression
-  A Lisp object that is intended for evaluation is called an
address@hidden or a @dfn{form}.  The fact that forms are data
-objects and not merely text is one of the fundamental differences
-between Lisp-like languages and typical programming languages.  Any
-object can be evaluated, but in practice only numbers, symbols, lists
-and strings are evaluated very often.
address@hidden S-expression
+  A Lisp object that is intended for evaluation is called a @dfn{form}
+or @address@hidden is sometimes also referred to as an
address@hidden or @dfn{sexp}, but we generally do not use this
+terminology in this manual.}.  The fact that forms are data objects
+and not merely text is one of the fundamental differences between
+Lisp-like languages and typical programming languages.  Any object can
+be evaluated, but in practice only numbers, symbols, lists and strings
+are evaluated very often.
 
   In subsequent sections, we will describe the details of what
 evaluation means for each kind of form.
@@ -96,12 +99,12 @@
 @node Forms
 @section Kinds of Forms
 
-  A Lisp object that is intended to be evaluated is called a @dfn{form}.
-How Emacs evaluates a form depends on its data type.  Emacs has three
-different kinds of form that are evaluated differently: symbols, lists,
-and ``all other types.''  This section describes all three kinds, one by
-one, starting with the ``all other types'' which are self-evaluating
-forms.
+  A Lisp object that is intended to be evaluated is called a
address@hidden (or an @dfn{expression}).  How Emacs evaluates a form
+depends on its data type.  Emacs has three different kinds of form
+that are evaluated differently: symbols, lists, and ``all other
+types.''  This section describes all three kinds, one by one, starting
+with the ``all other types'' which are self-evaluating forms.
 
 @menu
 * Self-Evaluating Forms::   Forms that evaluate to themselves.

=== modified file 'doc/lispref/syntax.texi'
--- a/doc/lispref/syntax.texi   2012-01-29 07:35:58 +0000
+++ b/doc/lispref/syntax.texi   2012-01-31 06:51:33 +0000
@@ -606,11 +606,13 @@
 @section Parsing Expressions
 
   This section describes functions for parsing and scanning balanced
-expressions, also known as @dfn{sexps}.  Basically, a sexp is either a
-balanced parenthetical grouping, a string, or a symbol name (a
-sequence of characters whose syntax is either word constituent or
-symbol constituent).  However, characters whose syntax is expression
-prefix are treated as part of the sexp if they appear next to it.
+expressions.  We will refer to such expressions as @dfn{sexps},
+following the terminology of Lisp, even though these functions can act
+on languages other than Lisp.  Basically, a sexp is either a balanced
+parenthetical grouping, a string, or a ``symbol'' (i.e.@: a sequence
+of characters whose syntax is either word constituent or symbol
+constituent).  However, characters whose syntax is expression prefix
+are treated as part of the sexp if they appear next to it.
 
   The syntax table controls the interpretation of characters, so these
 functions can be used for Lisp expressions when in Lisp mode and for C
@@ -830,10 +832,6 @@
 arrived at a top level position.
 @end defun
 
-  We have provided this access function rather than document how the
-data is represented in the state, because we plan to change the
-representation in the future.
-
 @node Low-Level Parsing
 @subsection Low-Level Parsing