More changes in the Emacs manual

* doc/emacs/fixit.texi (Undo): Mention 'revert-buffer'.
(Fixing Case): Fix punctuation.
(Spelling): Fix a typo.  Suggested by Toon Claes <toon@iotcl.com>
in emacs-manual-bugs@gnu.org.

* doc/emacs/modes.texi (Major Modes): Break a long sentence into
2.  Reported by Stefan Kamphausen <stefan.kamphausen@acrolinx.com>
in emacs-manual-bugs@gnu.org.

* doc/emacs/indent.texi (Just Spaces): Yet another minor
rewording.

* doc/emacs/building.texi (Watch Expressions): Improve wording.
(Multithreaded Debugging): Spell "tool bar" as 2 words.  Reported
by Alberto Sartori <alberto.sartori@sissa.it> in
emacs-manual-bugs@gnu.org.
(Grep Searching): Mention the effect of
'compilation-mode-line-errors'.  (Bug#30397)

* doc/emacs/basic.texi (Moving Point): Minor reformatting and
rewording of what <LEFT> and <RIGHT> do.

5 files changed, 33 insertions, 25 deletions

diff --git a/doc/emacs/basic.texi b/doc/emacs/basic.texi
index 11be78de68b..8a8298bc2c4 100644
--- a/doc/emacs/basic.texi
+++ b/doc/emacs/basic.texi
@@ -189,8 +189,9 @@ Move forward one character (@code{forward-char}).
 This command (@code{right-char}) behaves like @kbd{C-f}, with one
 exception: when editing right-to-left scripts such as Arabic, it
 instead moves @emph{backward} if the current paragraph is a
-right-to-left paragraph.  @xref{Bidirectional Editing}.  If
-@code{visual-order-cursor-movement} is non-@code{nil}, this command
+right-to-left paragraph.  @xref{Bidirectional Editing}.
+
+If @code{visual-order-cursor-movement} is non-@code{nil}, this command
 moves to the character that is to the right of the current screen
 position, moving to the next or previous screen line as appropriate.
 Note that this might potentially move point many buffer positions
@@ -206,10 +207,10 @@ Move backward one character (@code{backward-char}).
 @findex left-char
 This command (@code{left-char}) behaves like @kbd{C-b}, except it
 moves @emph{forward} if the current paragraph is right-to-left.
-@xref{Bidirectional Editing}.  If @code{visual-order-cursor-movement}
-is non-@code{nil}, this command moves to the character that is to the
-left of the current screen position, moving to the previous or next
-screen line as appropriate.
+@xref{Bidirectional Editing}.
+
+The variable @code{visual-order-cursor-movement} affects this like
+@key{RIGHT}, but moving left instead of right on the screen.
 
 @item C-n
 @itemx @key{DOWN}
diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index 7e4b68e6f71..f61e3335770 100644
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@ -384,6 +384,10 @@ grep -nH -e foo *.el | grep bar | grep toto
 can find the corresponding lines in the original files using @w{@kbd{C-x
 `}}, @key{RET}, and so forth, just like compilation errors.
 
+  As with compilation commands (@pxref{Compilation}), while the grep
+command runs, the mode line is updated to show the number of matches
+that have been seen so far.
+
   Some grep programs accept a @samp{--color} option to output special
 markers around matches for the purpose of highlighting.  You can make
 use of this feature by setting @code{grep-highlight-matches} to
@@ -1218,9 +1222,9 @@ edit its value.
 @vindex gdb-delete-out-of-scope
   If the variable @code{gdb-delete-out-of-scope} is non-@code{nil}
 (the default value), Emacs automatically deletes watch expressions
-which go out of scope.  Sometimes, when re-entering the same function,
-it may be useful to set this value to @code{nil} so that you don't
-need to recreate the watch expression.
+which go out of scope.  Sometimes, when your program re-enters the
+same function many times, it may be useful to set this value to
+@code{nil} so that you don't need to recreate the watch expression.
 
 @vindex gdb-use-colon-colon-notation
   If the variable @code{gdb-use-colon-colon-notation} is
@@ -1285,7 +1289,7 @@ execution control commands.
 value), interruption and continuation commands apply to all threads,
 so you can halt or continue all your threads with one command using
 @code{gud-stop-subjob} and @code{gud-cont}, respectively.  The
-@samp{Go} button is shown on the toolbar when at least one thread is
+@samp{Go} button is shown on the tool bar when at least one thread is
 stopped, whereas @samp{Stop} button is shown when at least one thread
 is running.
 
@@ -1293,8 +1297,8 @@ is running.
 
 When @code{gdb-gud-control-all-threads} is @code{nil}, only the
 current thread is stopped/continued.  @samp{Go} and @samp{Stop}
-buttons on the GUD toolbar are shown depending on the state of current
-thread.
+buttons on the GUD tool bar are shown depending on the state of
+current thread.
 @end table
 
 You can change the current value of @code{gdb-gud-control-all-threads}
diff --git a/doc/emacs/fixit.texi b/doc/emacs/fixit.texi
index aca85f3de07..c872e9bb3ac 100644
--- a/doc/emacs/fixit.texi
+++ b/doc/emacs/fixit.texi
@@ -78,7 +78,6 @@ the undo command.
 previous undo commands, use @kbd{M-x undo-only}.  This is like
 @code{undo}, but will not redo changes you have just undone.
 
-@c What about @kbd{M-x revert-buffer}? --xfq
   If you notice that a buffer has been modified accidentally, the
 easiest way to recover is to type @kbd{C-/} repeatedly until the stars
 disappear from the front of the mode line (@pxref{Mode Line}).
@@ -90,6 +89,10 @@ the last change you made undone, you will see whether it was an
 intentional change.  If it was an accident, leave it undone.  If it
 was deliberate, redo the change as described above.
 
+Alternatively, you can discard all the changes since the buffer was
+last visited or saved with @kbd{M-x revert-buffer}
+(@pxref{Reverting}).
+
 @cindex selective undo
 @kindex C-u C-/
   When there is an active region, any use of @code{undo} performs
@@ -216,7 +219,7 @@ Convert last word to lower case with capital initial.
 @kindex M-@t{-} M-u
 @kindex M-@t{-} M-c
   A very common error is to type words in the wrong case.  Because of this,
-the word case-conversion commands @kbd{M-l}, @kbd{M-u} and @kbd{M-c} have a
+the word case-conversion commands @kbd{M-l}, @kbd{M-u}, and @kbd{M-c} have a
 special feature when used with a negative argument: they do not move the
 cursor.  As soon as you see you have mistyped the last word, you can simply
 case-convert it and go on typing.  @xref{Case}.
@@ -231,7 +234,7 @@ case-convert it and go on typing.  @xref{Case}.
 single word or of a portion of a buffer.  These commands only work if
 a spelling checker program, one of Hunspell, Aspell, Ispell or
 Enchant, is installed.  These programs are not part of Emacs, but one
-of them is usually installed in GNU/Linux and other free operating
+of them is usually installed on GNU/Linux and other free operating
 systems.
 @ifnottex
 @xref{Top, Aspell,, aspell, The Aspell Manual}.
diff --git a/doc/emacs/indent.texi b/doc/emacs/indent.texi
index 73f0f375155..b38e85819ce 100644
--- a/doc/emacs/indent.texi
+++ b/doc/emacs/indent.texi
@@ -201,12 +201,12 @@ are always displayed as empty spaces extending to the next
 @node Just Spaces
 @section Tabs vs.@: Spaces
 
-  Normally, indentation commands insert (or remove) a mix of space
-characters and tab characters so as to align to the desired column.
-Tab characters are displayed as a stretch of empty space extending to
-the next @dfn{display tab stop}.  By default, there is one display tab
-stop every @code{tab-width} columns (the default is 8).  @xref{Text
-Display}.
+  Normally, indentation commands insert (or remove) the shortest
+possible series of tab and space characters so as to align to the
+desired column.  Tab characters are displayed as a stretch of empty
+space extending to the next @dfn{display tab stop}.  By default, there
+is one display tab stop every @code{tab-width} columns (the default is
+8).  @xref{Text Display}.
 
 @vindex indent-tabs-mode
   If you prefer, all indentation can be made from spaces only.  To
diff --git a/doc/emacs/modes.texi b/doc/emacs/modes.texi
index 1312a24d985..2bbc17b26db 100644
--- a/doc/emacs/modes.texi
+++ b/doc/emacs/modes.texi
@@ -57,10 +57,10 @@ for specific programming languages.  These include Lisp mode (which
 has several variants), C mode, Fortran mode, and others.  The third
 group consists of major modes that are not associated directly with
 files; they are used in buffers created for specific purposes by
-Emacs, such as Dired mode for buffers made by Dired (@pxref{Dired}),
-Message mode for buffers made by @kbd{C-x m} (@pxref{Sending Mail}),
-and Shell mode for buffers used to communicate with an inferior shell
-process (@pxref{Interactive Shell}).
+Emacs.  Examples include Dired mode for buffers made by Dired
+(@pxref{Dired}), Message mode for buffers made by @kbd{C-x m}
+(@pxref{Sending Mail}), and Shell mode for buffers used to communicate
+with an inferior shell process (@pxref{Interactive Shell}).
 
   Usually, the major mode is automatically set by Emacs, when you
 first visit a file or create a buffer (@pxref{Choosing Modes}).  You