* 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.
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
@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}
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
@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
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.
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}
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}).
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
@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}.
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}.
@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
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
projects / emacs.git / commitdiff