[Emacs-diffs] emacs-26 923e415: More changes in the Emacs manual

[Eli Zaretskii]

branch: emacs-26
commit 923e4157baebf026910bd37b3cb5099b6aff7b3f
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    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 <address@hidden>
    in address@hidden
    
    * doc/emacs/modes.texi (Major Modes): Break a long sentence into
    2.  Reported by Stefan Kamphausen <address@hidden>
    in address@hidden
    
    * 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 <address@hidden> in
    address@hidden
    (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.
---
 doc/emacs/basic.texi    | 13 +++++++------
 doc/emacs/building.texi | 16 ++++++++++------
 doc/emacs/fixit.texi    |  9 ++++++---
 doc/emacs/indent.texi   | 12 ++++++------
 doc/emacs/modes.texi    |  8 ++++----
 5 files changed, 33 insertions(+), 25 deletions(-)

diff --git a/doc/emacs/basic.texi b/doc/emacs/basic.texi
index 11be78d..8a8298b 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
address@hidden is address@hidden, this command
+right-to-left paragraph.  @xref{Bidirectional Editing}.
+
+If @code{visual-order-cursor-movement} is address@hidden, 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.
address@hidden Editing}.  If @code{visual-order-cursor-movement}
-is address@hidden, 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.
address@hidden Editing}.
+
+The variable @code{visual-order-cursor-movement} affects this like
address@hidden, 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 7e4b68e..f61e333 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 @address@hidden
 `}}, @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 address@hidden
 (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
address@hidden 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
address@hidden button is shown on the toolbar when at least one thread is
address@hidden 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 aca85f3..c872e9b 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.
 
address@hidden 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 address@hidden M-u
 @kindex address@hidden 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 73f0f37..b38e858 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 1312a24..2bbc17b 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