From 923e4157baebf026910bd37b3cb5099b6aff7b3f Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 9 Feb 2018 12:08:19 +0200 Subject: [PATCH] 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 in emacs-manual-bugs@gnu.org. * doc/emacs/modes.texi (Major Modes): Break a long sentence into 2. Reported by Stefan Kamphausen 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 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 and 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 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 -- 2.39.2