Yet more proofreading of the Emacs manual

* doc/emacs/building.texi (Compilation, Grep Searching)
(Debuggers, GUD Customization, Source Buffers)
(Breakpoints Buffer, Threads Buffer): Minor fixes and updates.
Suggested by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.
This commit is contained in:
Eli Zaretskii 2018-03-19 21:53:52 +02:00
parent ba5a372540
commit 23072e468f

View file

@ -45,9 +45,11 @@ messages and show you where the errors occurred.
@item M-x compile @item M-x compile
Run a compiler asynchronously under Emacs, with error messages going to Run a compiler asynchronously under Emacs, with error messages going to
the @file{*compilation*} buffer. the @file{*compilation*} buffer.
@item M-x recompile @item M-x recompile
Invoke a compiler with the same command as in the last invocation of Invoke a compiler with the same command as in the last invocation of
@kbd{M-x compile}. @kbd{M-x compile}.
@item M-x kill-compilation @item M-x kill-compilation
Kill the running compilation subprocess. Kill the running compilation subprocess.
@end table @end table
@ -115,12 +117,12 @@ was started.
@vindex compilation-always-kill @vindex compilation-always-kill
Starting a new compilation also kills any compilation already Starting a new compilation also kills any compilation already
running in @file{*compilation*}, as the buffer can only handle one running in @file{*compilation*}, as the buffer can only handle one
compilation at any time. However, @kbd{M-x compile} asks for compilation at any time. However, @kbd{M-x compile} and @kbd{M-x
confirmation before actually killing a compilation that is running; to recompile} ask for confirmation before actually killing a compilation
always automatically kill the compilation without asking, change the that is running; to always automatically kill the compilation without
variable @code{compilation-always-kill} to @code{t}. You can also asking, change the variable @code{compilation-always-kill} to
kill a compilation process with the command @kbd{M-x @code{t}. You can also kill a compilation process with the command
kill-compilation}. @kbd{M-x kill-compilation}.
To run two compilations at once, start the first one, then rename To run two compilations at once, start the first one, then rename
the @file{*compilation*} buffer (perhaps using @code{rename-uniquely}; the @file{*compilation*} buffer (perhaps using @code{rename-uniquely};
@ -401,7 +403,7 @@ The possible values are either @code{nil} (don't save), @code{ask}
(and is called with the file name as the parameter and should return (and is called with the file name as the parameter and should return
non-@code{nil} if the buffer is to be saved). Any other non-@code{nil} if the buffer is to be saved). Any other
non-@code{nil} value means that all buffers should be saved without non-@code{nil} value means that all buffers should be saved without
asking. asking. The default is @code{ask}.
@findex grep-find @findex grep-find
@findex find-grep @findex find-grep
@ -478,8 +480,8 @@ see the Flymake Info manual, which is distributed with Emacs.
The GUD (Grand Unified Debugger) library provides an Emacs interface The GUD (Grand Unified Debugger) library provides an Emacs interface
to a wide variety of symbolic debuggers. It can run the GNU Debugger to a wide variety of symbolic debuggers. It can run the GNU Debugger
(GDB), as well as DBX, SDB, XDB, Perl's debugging mode, the Python (GDB), as well as DBX, SDB, XDB, Guile REPL debug commands, Perl's
debugger PDB, and the Java Debugger JDB. debugging mode, the Python debugger PDB, and the Java Debugger JDB.
Emacs provides a special interface to GDB, which uses extra Emacs Emacs provides a special interface to GDB, which uses extra Emacs
windows to display the state of the debugged program. @xref{GDB windows to display the state of the debugged program. @xref{GDB
@ -791,12 +793,14 @@ Instead, type @kbd{C-q @key{TAB}} to enter a tab.
@vindex perldb-mode-hook @vindex perldb-mode-hook
@vindex pdb-mode-hook @vindex pdb-mode-hook
@vindex jdb-mode-hook @vindex jdb-mode-hook
@vindex guiler-mode-hook
On startup, GUD runs one of the following hooks: On startup, GUD runs one of the following hooks:
@code{gdb-mode-hook}, if you are using GDB; @code{dbx-mode-hook}, if @code{gdb-mode-hook}, if you are using GDB; @code{dbx-mode-hook}, if
you are using DBX; @code{sdb-mode-hook}, if you are using SDB; you are using DBX; @code{sdb-mode-hook}, if you are using SDB;
@code{xdb-mode-hook}, if you are using XDB; @code{perldb-mode-hook}, @code{xdb-mode-hook}, if you are using XDB; @code{guiler-mode-hook}
for Perl debugging mode; @code{pdb-mode-hook}, for PDB; for Guile REPL debugging; @code{perldb-mode-hook}, for Perl debugging
@code{jdb-mode-hook}, for JDB@. @xref{Hooks}. mode; @code{pdb-mode-hook}, for PDB; @code{jdb-mode-hook}, for JDB@.
@xref{Hooks}.
The @code{gud-def} Lisp macro (@pxref{Defining Macros,,, elisp, the The @code{gud-def} Lisp macro (@pxref{Defining Macros,,, elisp, the
Emacs Lisp Reference Manual}) provides a convenient way to define an Emacs Lisp Reference Manual}) provides a convenient way to define an
@ -952,16 +956,18 @@ still in the right places.
@table @asis @table @asis
@item @kbd{mouse-1} (in fringe) @item @kbd{mouse-1} (in fringe)
Set or clear a breakpoint on that line. Set or clear a breakpoint on that line
(@code{gdb-mouse-set-clear-breakpoint}).
@item @kbd{C-mouse-1} (in fringe) @item @kbd{C-mouse-1} (in fringe)
Enable or disable a breakpoint on that line. Enable or disable a breakpoint on that line
(@code{gdb-mouse-toggle-breakpoint-margin}).
@item @kbd{mouse-3} (in fringe) @item @kbd{mouse-3} (in fringe)
Continue execution to that line. Continue execution to that line (@code{gdb-mouse-until}).
@item @kbd{C-mouse-3} (in fringe) @item @kbd{C-mouse-3} (in fringe)
Jump to that line. Jump to that line (@code{gdb-mouse-jump}).
@end table @end table
On a graphical display, you can click @kbd{mouse-1} in the fringe of On a graphical display, you can click @kbd{mouse-1} in the fringe of
@ -1018,7 +1024,8 @@ Visit the source line for the current breakpoint
@item mouse-2 @item mouse-2
@kindex mouse-2 @r{(GDB Breakpoints buffer)} @kindex mouse-2 @r{(GDB Breakpoints buffer)}
Visit the source line for the breakpoint you click on. Visit the source line for the breakpoint you click on
(@code{gdb-goto-breakpoint}).
@end table @end table
@vindex gdb-show-threads-by-default @vindex gdb-show-threads-by-default
@ -1039,8 +1046,8 @@ point there and press @key{RET} (@code{gdb-select-thread}), or click on
it with @kbd{mouse-2}. This also displays the associated source it with @kbd{mouse-2}. This also displays the associated source
buffer, and updates the contents of the other GDB buffers. buffer, and updates the contents of the other GDB buffers.
You can customize variables under @code{gdb-buffers} group to select You can customize variables in the @code{gdb-buffers} group to
fields included in GDB Threads buffer. select fields included in GDB Threads buffer.
@table @code @table @code
@item gdb-thread-buffer-verbose-names @item gdb-thread-buffer-verbose-names