*** empty log message ***

12 files changed, 91 insertions, 77 deletions

diff --git a/lispref/display.texi b/lispref/display.texi
index e3680f95815..3b69e017fe6 100644
--- a/lispref/display.texi
+++ b/lispref/display.texi
@@ -335,7 +335,7 @@ overlaps the overlay on exit from the search.
 
   During the search, such overlays are made temporarily visible by
 temporarily modifying their invisible and intangible properties.  If you
-want this to be done differently for a certain overlay, give it a
+want this to be done differently for a certain overlay, give it an
 @code{isearch-open-invisible-temporary} property which is a function.
 The function is called with two arguments: the first is the overlay, and
 the second is @code{t} to make the overlay visible, or @code{nil} to
diff --git a/lispref/edebug.texi b/lispref/edebug.texi
index 03a8a6940f6..c40a70d753b 100644
--- a/lispref/edebug.texi
+++ b/lispref/edebug.texi
@@ -867,9 +867,10 @@ correctly; Edebug will tell you when you have tried enough different
 conditions that each form has returned two different values.
 
   Coverage testing makes execution slower, so it is only done if
-@code{edebug-test-coverage} is non-@code{nil}.  Whether or not coverage
-testing is enabled, frequency counting is performed for all execution of
-an instrumented function, even if the execution mode is Go-nonstop.
+@code{edebug-test-coverage} is non-@code{nil}.  Frequency counting is
+performed for all execution of an instrumented function, even if the
+execution mode is Go-nonstop, and regardless of whether coverage testing
+is enabled.
 
   Use @kbd{M-x edebug-display-freq-count} to display both the
 coverage information and the frequency counts for a definition.
@@ -1185,8 +1186,9 @@ elements must all match or none, use @code{&optional
 @item &rest
 @kindex &rest @r{(Edebug)}
 All following elements in the specification list are repeated zero or
-more times.  In the last repetition, however, it is ok if the expression
-runs out before matching all of the elements of the specification list.
+more times.  In the last repetition, however, it is not a problem if the
+expression runs out before matching all of the elements of the
+specification list.
 
 To repeat only a few elements, use @code{[&rest @var{specs}@dots{}]}.
 To specify several elements that must all match on every repetition, use
diff --git a/lispref/elisp.texi b/lispref/elisp.texi
index e1467e97b62..ad38389805f 100644
--- a/lispref/elisp.texi
+++ b/lispref/elisp.texi
@@ -698,7 +698,7 @@ Frames
 * Pop-Up Menus::            Displaying a menu for the user to select from.
 * Dialog Boxes::            Displaying a box to ask yes or no.
 * Pointer Shapes::          Specifying the shape of the mouse pointer.
-* Window System Selections::Transferring text to and from other window.
+* Window System Selections::Transferring text to and from other windows.
 * Color Names::             Getting the definitions of color names.
 * Resources::               Getting resource values from the server.
 * Server Data::             Getting info about the X server.
diff --git a/lispref/errors.texi b/lispref/errors.texi
index cee673fd3c8..700884ebd67 100644
--- a/lispref/errors.texi
+++ b/lispref/errors.texi
@@ -55,7 +55,7 @@ See @code{/} and @code{%} in @ref{Numbers}.
 @xref{Read Only Buffers}.
 
 @item cyclic-function-indirection
-@code{"Symbol's chain of function indirections@* contains a loop"}@*
+@code{"Symbol's chain of function indirections\@* contains a loop"}@*
 @xref{Function Indirection}.
 
 @item end-of-buffer
diff --git a/lispref/frames.texi b/lispref/frames.texi
index 0044a61ac80..20ce6e4fa62 100644
--- a/lispref/frames.texi
+++ b/lispref/frames.texi
@@ -576,10 +576,10 @@ The argument @var{pretend} has the same meaning as in
 
 @findex set-screen-height
 @findex set-screen-width
-  The old-fashioned functions @code{set-screen-height} and
-@code{set-screen-width}, which were used to specify the height and width
-of the screen in Emacs versions that did not support multiple frames,
-are still usable.  They apply to the selected frame.
+  The older functions @code{set-screen-height} and
+@code{set-screen-width} were used to specify the height and width of the
+screen, in Emacs versions that did not support multiple frames.  They
+are semi-obsolete, but still work; they apply to the selected frame.
 
 @defun x-parse-geometry geom
 @cindex geometry specification
diff --git a/lispref/modes.texi b/lispref/modes.texi
index f8a5729ccc3..1ecbd177c0d 100644
--- a/lispref/modes.texi
+++ b/lispref/modes.texi
@@ -1182,8 +1182,8 @@ frame at a time.
 
 @defvar mode-line-buffer-identification
 This variable identifies the buffer being displayed in the window.  Its
-default value is @code{("%12b")}, which means that it usually displays
-twelve characters of the buffer name.
+default value is @code{("%12b")}, which displays the buffer name, padded
+with spaces to at least 12 columns.
 @end defvar
 
 @defvar global-mode-string
@@ -1484,7 +1484,8 @@ For example, Fortran mode uses it this way:
 The @code{imenu-generic-expression} patterns can then use @samp{\\sw+}
 instead of @samp{\\(\\sw\\|\\s_\\)+}.  Note that this technique may be
 inconvenient to use when the mode needs to limit the initial character
-of a name to a smaller set of characters
+of a name to a smaller set of characters than are allowed in the rest
+of a name.
 
 Setting this variable makes it buffer-local in the current buffer.
 @end defvar
diff --git a/lispref/nonascii.texi b/lispref/nonascii.texi
index 019f1365f72..9bd51e2b5c8 100644
--- a/lispref/nonascii.texi
+++ b/lispref/nonascii.texi
@@ -704,13 +704,13 @@ systems used for I/O to a subprocess.
 
 @tindex select-safe-coding-system
 @defun select-safe-coding-system from to &optional preferred-coding-system
-This function selects a coding system for encoding the between
+This function selects a coding system for encoding the text between
 @var{from} and @var{to}, asking the user to choose if necessary.
 
 The optional argument @var{preferred-coding-system} specifies a coding
-system try first.  If it can handle the text in the specified region,
-then it is used.  If this argument is omitted, the current buffer's
-value of @code{buffer-file-coding-system} is tried first.
+system to try first.  If that one can handle the text in the specified
+region, then it is used.  If this argument is omitted, the current
+buffer's value of @code{buffer-file-coding-system} is tried first.
 
 If the region contains some multibyte characters that the preferred
 coding system cannot encode, this function asks the user to choose from
diff --git a/lispref/objects.texi b/lispref/objects.texi
index f2c082b56bc..ccdc1756fe3 100644
--- a/lispref/objects.texi
+++ b/lispref/objects.texi
@@ -321,8 +321,8 @@ $2^{26}$
 @end ifinfo
 bit as well as the code for the corresponding non-control
 character.  Ordinary terminals have no way of generating non-@sc{ASCII}
-control characters, but you can generate them straightforwardly using an
-X terminal.
+control characters, but you can generate them straightforwardly using X
+and other window systems.
 
   For historical reasons, Emacs treats the @key{DEL} character as
 the control equivalent of @kbd{?}:
@@ -433,7 +433,7 @@ important than the @sc{ASCII} representation.
 and the hexadecimal character code.  You can use any number of hex
 digits, so you can represent any character code in this way.
 Thus, @samp{?\x41} for the character @kbd{A}, @samp{?\x1} for the
-character @kbd{C-a}, and @code{?\x8c0} for the character
+character @kbd{C-a}, and @code{?\x8e0} for the character
 @iftex
 @samp{@`a}.
 @end iftex
@@ -553,17 +553,21 @@ same object, @code{nil}.
 @subsection Cons Cell and List Types
 @cindex address field of register
 @cindex decrement field of register
+@cindex pointers
 
-  A @dfn{cons cell} is an object comprising two pointers named the
-@sc{car} and the @sc{cdr}.  Each of them can point to any Lisp object.
+  A @dfn{cons cell} is an object that consists of two pointers or slots,
+called the @sc{car} slot and the @sc{cdr} slot.  Each slot can
+@dfn{point to} or hold to any Lisp object.  We also say that the ``the
+@sc{car} of this cons cell is'' whatever object its @sc{car} slot
+currently points to, and likewise for the @sc{cdr}.
 
   A @dfn{list} is a series of cons cells, linked together so that the
-@sc{cdr} of each cons cell points either to another cons cell or to the
+@sc{cdr} slot of each cons cell holds either the next cons cell or the
 empty list.  @xref{Lists}, for functions that work on lists.  Because
 most cons cells are used as part of lists, the phrase @dfn{list
 structure} has come to refer to any structure made out of cons cells.
 
-  The names @sc{car} and @sc{cdr} have only historical meaning now.  The
+  The names @sc{car} and @sc{cdr} derive from the history of Lisp.  The
 original Lisp implementation ran on an @w{IBM 704} computer which
 divided words into two parts, called the ``address'' part and the
 ``decrement''; @sc{car} was an instruction to extract the contents of
@@ -584,18 +588,19 @@ right parenthesis.
 
    Upon reading, each object inside the parentheses becomes an element
 of the list.  That is, a cons cell is made for each element.  The
-@sc{car} of the cons cell points to the element, and its @sc{cdr} points
-to the next cons cell of the list, which holds the next element in the
-list.  The @sc{cdr} of the last cons cell is set to point to @code{nil}.
+@sc{car} slot of the cons cell points to the element, and its @sc{cdr}
+slot points to the next cons cell of the list, which holds the next
+element in the list.  The @sc{cdr} slot of the last cons cell is set to
+point to @code{nil}.
 
 @cindex box diagrams, for lists
 @cindex diagrams, boxed, for lists
   A list can be illustrated by a diagram in which the cons cells are
-shown as pairs of boxes.  (The Lisp reader cannot read such an
-illustration; unlike the textual notation, which can be understood by
-both humans and computers, the box illustrations can be understood only
-by humans.)  The following represents the three-element list @code{(rose
-violet buttercup)}:
+shown as pairs of boxes, like dominoes.  (The Lisp reader cannot read
+such an illustration; unlike the textual notation, which can be
+understood by both humans and computers, the box illustrations can be
+understood only by humans.)  This picture represents the three-element
+list @code{(rose violet buttercup)}:
 
 @example
 @group
@@ -608,18 +613,18 @@ violet buttercup)}:
 @end group
 @end example
 
-  In this diagram, each box represents a slot that can refer to any Lisp
+  In this diagram, each box represents a slot that can point to any Lisp
 object.  Each pair of boxes represents a cons cell.  Each arrow is a
-reference to a Lisp object, either an atom or another cons cell.
+pointer to a Lisp object, either an atom or another cons cell.
 
-  In this example, the first box, the @sc{car} of the first cons cell,
-refers to or ``contains'' @code{rose} (a symbol).  The second box, the
-@sc{cdr} of the first cons cell, refers to the next pair of boxes, the
-second cons cell.  The @sc{car} of the second cons cell refers to
-@code{violet} and the @sc{cdr} refers to the third cons cell.  The
-@sc{cdr} of the third (and last) cons cell refers to @code{nil}.
+  In this example, the first box, which holds the @sc{car} of the first
+cons cell, points to or ``contains'' @code{rose} (a symbol).  The second
+box, holding the @sc{cdr} of the first cons cell, points to the next
+pair of boxes, the second cons cell.  The @sc{car} of the second cons
+cell is @code{violet}, and its @sc{cdr} is the third cons cell.  The
+@sc{cdr} of the third (and last) cons cell is @code{nil}.
 
-Here is another diagram of the same list, @code{(rose violet
+  Here is another diagram of the same list, @code{(rose violet
 buttercup)}, sketched in a different manner:
 
 @smallexample
@@ -683,13 +688,13 @@ that represents the @sc{car} and @sc{cdr} explicitly.  In this syntax,
 the object @var{a}, and whose @sc{cdr} is the object @var{b}.  Dotted
 pair notation is therefore more general than list syntax.  In the dotted
 pair notation, the list @samp{(1 2 3)} is written as @samp{(1 .  (2 . (3
-. nil)))}.  For @code{nil}-terminated lists, the two notations produce
-the same result, but list notation is usually clearer and more
-convenient when it is applicable.  When printing a list, the dotted pair
-notation is only used if the @sc{cdr} of a cell is not a list.
+. nil)))}.  For @code{nil}-terminated lists, you can use either
+notation, but list notation is usually clearer and more convenient.
+When printing a list, the dotted pair notation is only used if the
+@sc{cdr} of a cons cell is not a list.
 
-  Here's how box notation can illustrate dotted pairs.  This example
-shows the pair @code{(rose . violet)}:
+  Here's an example using boxes to illustrate dotted pair notation.
+This example shows the pair @code{(rose . violet)}:
 
 @example
 @group
@@ -702,10 +707,12 @@ shows the pair @code{(rose . violet)}:
 @end group
 @end example
 
-  Dotted pair notation can be combined with list notation to represent a
-chain of cons cells with a non-@code{nil} final @sc{cdr}.  For example,
-@code{(rose violet . buttercup)} is equivalent to @code{(rose . (violet
-. buttercup))}.  The object looks like this:
+  You can combine dotted pair notation with list notation to represent
+conveniently a chain of cons cells with a non-@code{nil} final @sc{cdr}.
+You write a dot after the last element of the list, followed by the
+@sc{cdr} of the final cons cell.  For example, @code{(rose violet
+. buttercup)} is equivalent to @code{(rose . (violet . buttercup))}.
+The object looks like this:
 
 @example
 @group
@@ -718,11 +725,12 @@ chain of cons cells with a non-@code{nil} final @sc{cdr}.  For example,
 @end group
 @end example
 
-  These diagrams make it evident why @w{@code{(rose .@: violet .@:
-buttercup)}} is invalid syntax; it would require a cons cell that has
-three parts rather than two.
+  The syntax @code{(rose .@: violet .@: buttercup)} is invalid because
+there is nothing that it could mean.  If anything, it would say to put
+@code{buttercup} in the @sc{cdr} of a cons cell whose @sc{cdr} is already
+used for @code{violet}.
 
-  The list @code{(rose violet)} is equivalent to @code{(rose . (violet))}
+  The list @code{(rose violet)} is equivalent to @code{(rose . (violet))},
 and looks like this:
 
 @example
@@ -783,7 +791,7 @@ functions that work on alists.
 @subsection Array Type
 
   An @dfn{array} is composed of an arbitrary number of slots for
-referring to other Lisp objects, arranged in a contiguous block of
+pointing to other Lisp objects, arranged in a contiguous block of
 memory.  Accessing any element of an array takes approximately the same
 amount of time.  In contrast, accessing an element of a list requires
 time proportional to the position of the element in the list.  (Elements
@@ -883,8 +891,9 @@ character code, using a hex escape, @samp{\x@var{nnnnnnn}}, with as many
 digits as necessary.  (Multibyte non-@sc{ASCII} character codes are all
 greater than 256.)  Any character which is not a valid hex digit
 terminates this construct.  If the character that would follow is a hex
-digit, write @w{@samp{\ }} to terminate the hex escape---for example,
-@w{@samp{\x8c0\ }} represents one character, @samp{a} with grave accent.
+digit, write @w{@samp{\ }} (backslash and space)
+to terminate the hex escape---for example,
+@w{@samp{\x8e0\ }} represents one character, @samp{a} with grave accent.
 @w{@samp{\ }} in a string constant is just like backslash-newline; it does
 not contribute any character to the string, but it does terminate the
 preceding hex escape.
@@ -914,7 +923,7 @@ distinguish case in @sc{ASCII} control characters.
 
   Properly speaking, strings cannot hold meta characters; but when a
 string is to be used as a key sequence, there is a special convention
-that allows the meta versions of @sc{ASCII} characters to be put in a
+that provides a way to represent meta versions of @sc{ASCII} characters in a
 string.  If you use the @samp{\M-} syntax to indicate a meta character
 in a string constant, this sets the
 @tex
@@ -965,7 +974,7 @@ that range.  For example,
 represents a string whose textual contents are @samp{foo bar}, in which
 the first three characters have a @code{face} property with value
 @code{bold}, and the last three have a @code{face} property with value
-@code{italic}.  (The fourth character has no text properties so its
+@code{italic}.  (The fourth character has no text properties, so its
 property list is @code{nil}.  It is not actually necessary to mention
 ranges with @code{nil} as the property list, since any characters not
 mentioned in any range will default to having no properties.)
@@ -1032,8 +1041,8 @@ that it begins with @samp{#&} followed by the length.  The string
 constant that follows actually specifies the contents of the bool-vector
 as a bitmap---each ``character'' in the string contains 8 bits, which
 specify the next 8 elements of the bool-vector (1 stands for @code{t},
-and 0 for @code{nil}).  The least significant bits of the character are
-the lowest-numbered elements of the bool-vector.  If the length is not a
+and 0 for @code{nil}).  The least significant bits of the character 
+correspond to the lowest indices in the bool-vector.  If the length is not a
 multiple of 8, the printed representation shows extra elements, but
 these extras really make no difference.
 
diff --git a/lispref/os.texi b/lispref/os.texi
index f9b6595f71c..0d900740933 100644
--- a/lispref/os.texi
+++ b/lispref/os.texi
@@ -194,9 +194,10 @@ loads this @emph{before} the user's init file.  You can inhibit the
 loading of this file with the option @samp{-no-site-file}.
 
 @defvar site-run-file
-This variable specifies the site-customization file to load
-before the user's init file.  Its normal value is @code{"site-start"}.
-(The only way to change it with real effect is before dumping Emacs.)
+This variable specifies the site-customization file to load before the
+user's init file.  Its normal value is @code{"site-start"}.  The only
+way you can change it with real effect is to do so before dumping
+Emacs.
 @end defvar
 
   If there is a great deal of code in your @file{.emacs} file, you
diff --git a/lispref/processes.texi b/lispref/processes.texi
index 400ab2e53a6..289183fb515 100644
--- a/lispref/processes.texi
+++ b/lispref/processes.texi
@@ -512,7 +512,7 @@ is @code{nil}, the process will be deleted silently.
 Otherwise, Emacs will query about killing it.
 
 The value is @code{t} if the process was formerly set up to require
-query.  @code{nil} otherwise.  A newly-created process always requires
+query, @code{nil} otherwise.  A newly-created process always requires
 query.
 
 @smallexample
diff --git a/lispref/text.texi b/lispref/text.texi
index f87b4f9948a..75d6e1863dc 100644
--- a/lispref/text.texi
+++ b/lispref/text.texi
@@ -1200,7 +1200,7 @@ non-@code{nil}.
 
 If @var{nosqueeze} is non-@code{nil}, that means to leave whitespace
 other than line breaks untouched.  If @var{to-eop} is non-@code{nil},
-that means to keep filling to the end of the paragraph---or next hard
+that means to keep filling to the end of the paragraph---or the next hard
 newline, if @code{use-hard-newlines} is enabled (see below).
 
 The variable @code{paragraph-separate} controls how to distinguish
@@ -1243,7 +1243,7 @@ In an interactive call, any prefix argument requests justification.
 
 If @var{nosqueeze} is non-@code{nil}, that means to leave whitespace
 other than line breaks untouched.  If @var{squeeze-after} is
-non-@code{nil}, specifies a position in the region, and means don't
+non-@code{nil}, it specifies a position in the region, and means don't
 canonicalize spaces before that position.
 
 In Adaptive Fill mode, this command calls @code{fill-context-prefix} to
@@ -1434,15 +1434,16 @@ variables described below.
 
 @defopt adaptive-fill-regexp
 This variable holds a regular expression to control Adaptive Fill mode.
-Whichever characters starting after the line's left margin match this
-regular expression, those are the candidate for the fill prefix.
+Adaptive Fill mode matches this regular expression against the text
+starting after the left margin whitespace (if any) on a line; the
+characters it matches are that line's candidate for the fill prefix.
 @end defopt
 
 @defopt adaptive-fill-first-line-regexp
-In a one-line paragraph, if the candidate fill prefix matches
-this regular expression, or if it matches @code{comment-start-skip},
-then it is used---otherwise, it is replaced with an equivalent
-number of spaces.
+In a one-line paragraph, if the candidate fill prefix matches this
+regular expression, or if it matches @code{comment-start-skip}, then it
+is used---otherwise, spaces amounting to the same width are used
+instead.
 
 However, the fill prefix is never taken from a one-line paragraph
 if it would act as a paragraph starter on subsequent lines.
diff --git a/lispref/windows.texi b/lispref/windows.texi
index 31151040e58..29307467d42 100644
--- a/lispref/windows.texi
+++ b/lispref/windows.texi
@@ -253,7 +253,7 @@ characters; see @ref{Display Tables}.
 
 @deffn Command split-window-vertically size
 This function splits the selected window into two windows, one above the
-other, leaving the upper of the two window selected, with @var{size}
+other, leaving the upper of the two windows selected, with @var{size}
 lines.  (If @var{size} is negative, then the lower of the two windows
 gets @minus{} @var{size} lines and the upper window gets the rest, but
 the upper window is still the one selected.)