[Emacs-diffs] emacs-26 6bdcaec: Fix typos and minor wording issues in ELisp manual

[Eli Zaretskii]

branch: emacs-26
commit 6bdcaec885fb1272617e7e02c6d1e571163b15f5
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Fix typos and minor wording issues in ELisp manual
    
    * doc/lispref/internals.texi (Writing Emacs Primitives):
    * doc/lispref/display.texi (Temporary Displays): Fix typos.
    * doc/lispref/text.texi (Filling, Changing Properties)
    (Transposition): Clarify and fix typos.
    * doc/lispref/positions.texi (Screen Lines): Improve wording.
    * doc/lispref/modes.texi (Minor Mode Conventions)
    (Font Lock Multiline): Fix typos.
    * doc/lispref/variables.texi (Dynamic Binding Tips): Fix a
    cross-reference.  Fix a typo.
    * doc/lispref/sequences.texi (Sequence Functions): Fix typos.
    (Bug#31143)
---
 doc/lispref/internals.texi |  4 ++--
 doc/lispref/modes.texi     |  9 +++++----
 doc/lispref/positions.texi |  6 +++---
 doc/lispref/sequences.texi |  4 ++--
 doc/lispref/text.texi      | 12 ++++++------
 doc/lispref/variables.texi | 15 ++++++++-------
 doc/lispref/windows.texi   |  2 +-
 7 files changed, 27 insertions(+), 25 deletions(-)

diff --git a/doc/lispref/internals.texi b/doc/lispref/internals.texi
index 398ea8d..e604335 100644
--- a/doc/lispref/internals.texi
+++ b/doc/lispref/internals.texi
@@ -739,7 +739,7 @@ DEFUN ("foo", Ffoo, Sfoo, 0, UNEVALLED, 0
        "(list (read-char-by-name \"Insert character: \")\
               (prefix-numeric-value current-prefix-arg)\
               t))",
-  doc: /* @dots{} /*)
+  doc: /* @dots{} */)
 @end group
 @end example
 
@@ -769,7 +769,7 @@ this:
 @example
 @group
 DEFUN ("bar", Fbar, Sbar, 0, UNEVALLED, 0
-  doc: /* @dots{} /*
+  doc: /* @dots{} */
   attributes: @var{attr1} @var{attr2} @dots{})
 @end group
 @end example
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index f1a00e7..8a77745 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -1388,9 +1388,10 @@ similar to the code generated by the 
@code{define-minor-mode} macro):
 
 @example
 (interactive (list (or current-prefix-arg 'toggle)))
-(let ((enable (if (eq arg 'toggle)
-                  (not foo-mode) ; @r{this mode's mode variable}
-                (> (prefix-numeric-value arg) 0))))
+(let ((enable
+       (if (eq arg 'toggle)
+           (not foo-mode) ; @r{this is the mode's mode variable}
+         (> (prefix-numeric-value arg) 0))))
   (if enable
       @var{do-enable}
     @var{do-disable}))
@@ -3375,7 +3376,7 @@ easy to add the @code{font-lock-multiline} property by 
hand.
 
   The @code{font-lock-multiline} property is meant to ensure proper
 refontification; it does not automatically identify new multiline
-constructs.  Identifying the requires that Font Lock mode operate on
+constructs.  Identifying them requires that Font Lock mode operate on
 large enough chunks at a time.  This will happen by accident on many
 cases, which may give the impression that multiline constructs magically
 work.  If you set the @code{font-lock-multiline} variable
diff --git a/doc/lispref/positions.texi b/doc/lispref/positions.texi
index fdc8bb9..a09b6b6 100644
--- a/doc/lispref/positions.texi
+++ b/doc/lispref/positions.texi
@@ -569,9 +569,9 @@ The optional argument @var{cur-col} specifies the current 
column when
 the function is called.  This is the window-relative horizontal
 coordinate of point, measured in units of font width of the frame's
 default face.  Providing it speeds up the function, especially in very
-long lines, because it doesn't have to go back in the buffer in order
-to determine the current column.  Note that @var{cur-col} is also
-counted from the visual start of the line.
+long lines, because the function doesn't have to go back in the buffer
+in order to determine the current column.  Note that @var{cur-col} is
+also counted from the visual start of the line.
 @end defun
 
 @defun count-screen-lines &optional beg end count-final-newline window
diff --git a/doc/lispref/sequences.texi b/doc/lispref/sequences.texi
index 3a599e5..f347cd9 100644
--- a/doc/lispref/sequences.texi
+++ b/doc/lispref/sequences.texi
@@ -728,7 +728,7 @@ to every element of @var{sequence} returns address@hidden
 @result{} t
 @end group
 @group
-(seq-some #'numberp [2 4 "6"])
+(seq-every-p #'numberp [2 4 "6"])
 @result{} nil
 @end group
 @end example
@@ -854,7 +854,7 @@ it is a function of two arguments to use instead of the 
default @code{equal}.
 @end group
 @group
 (seq-uniq '(1 2 2.0 1.0) #'=)
address@hidden [1 2]
address@hidden (1 2)
 @end group
 @end example
 @end defun
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index 0e1c994..2db58f3 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -1612,7 +1612,7 @@ that the line ends exactly at @code{fill-column}.  It 
returns
 
 The argument @var{how}, if address@hidden specifies explicitly the style
 of justification.  It can be @code{left}, @code{right}, @code{full},
address@hidden, or @code{none}.  If it is @code{t}, that means to do
address@hidden, or @code{none}.  If it is @code{t}, that means to
 follow specified justification style (see @code{current-justification},
 below).  @code{nil} means to do full justification.
 
@@ -2976,7 +2976,7 @@ If any text in the region already has a address@hidden 
@code{face} property,
 those face(s) are retained.  This function sets the @code{face}
 property to a list of faces, with @var{face} as the first element (by
 default) and the pre-existing faces as the remaining elements.  If the
-optional argument @var{append} is address@hidden, @var{face} is
+optional argument @var{appendp} is address@hidden, @var{face} is
 appended to the end of the list instead.  Note that in a face list,
 the first occurring value for each attribute takes precedence.
 
@@ -4297,10 +4297,10 @@ read register names use this function.
   This function can be used to transpose stretches of text:
 
 @defun transpose-regions start1 end1 start2 end2 &optional leave-markers
-This function exchanges two nonoverlapping portions of the buffer.
-Arguments @var{start1} and @var{end1} specify the bounds of one portion
-and arguments @var{start2} and @var{end2} specify the bounds of the
-other portion.
+This function exchanges two nonoverlapping portions of the buffer (if
+they overlap, the function signals an error).  Arguments @var{start1}
+and @var{end1} specify the bounds of one portion and arguments
address@hidden and @var{end2} specify the bounds of the other portion.
 
 Normally, @code{transpose-regions} relocates markers with the transposed
 text; a marker previously positioned within one of the two transposed
diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi
index 4d04335..af1bed4 100644
--- a/doc/lispref/variables.texi
+++ b/doc/lispref/variables.texi
@@ -1004,12 +1004,13 @@ affect, nor be affected by, any uses of the same 
variable symbol
 elsewhere in the program.
 
 @item
-Otherwise, define the variable with @code{defvar}, @code{defconst}, or
address@hidden  @xref{Defining Variables}.  Usually, the definition
-should be at top-level in an Emacs Lisp file.  As far as possible, it
-should include a documentation string which explains the meaning and
-purpose of the variable.  You should also choose the variable's name
-to avoid name conflicts (@pxref{Coding Conventions}).
+Otherwise, define the variable with @code{defvar}, @code{defconst}
+(@pxref{Defining Variables}), or @code{defcustom} (@pxref{Variable
+Definitions}).  Usually, the definition should be at top-level in an
+Emacs Lisp file.  As far as possible, it should include a
+documentation string which explains the meaning and purpose of the
+variable.  You should also choose the variable's name to avoid name
+conflicts (@pxref{Coding Conventions}).
 
 Then you can bind the variable anywhere in a program, knowing reliably
 what the effect will be.  Wherever you encounter the variable, it will
@@ -1024,7 +1025,7 @@ variables like @code{case-fold-search}:
 @group
 (defun search-for-abc ()
   "Search for the string \"abc\", ignoring case differences."
-  (let ((case-fold-search nil))
+  (let ((case-fold-search t))
     (re-search-forward "abc")))
 @end group
 @end example
diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index 8d8877b..f5de2fc 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -904,7 +904,7 @@ include mode and header line and a bottom divider, if any.
 
 If @var{window} is part of a horizontal combination and the value of the
 option @code{fit-window-to-buffer-horizontally} (see below) is
address@hidden, this function adjusts @var{window}'s height.  The new
address@hidden, this function adjusts @var{window}'s width.  The new
 width of @var{window} is calculated from the maximum length of its
 buffer's lines that follow the current start position of @var{window}.
 The optional argument @var{max-width} specifies a maximum width and