Another round of manual fixes from proofreading

* doc/emacs/search.texi (Incremental Search)
(Nonincremental Search): Mention the menu bar and fix typos.
Reported by David Bonnafous <dbonnafo@gmail.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/building.texi (Compilation): Improve wording.
Suggested by drone <yoorobot@gmail.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/kmacro.texi (Basic Keyboard Macro): Clarify text.
Suggested by Robert Pluim <rpluim@gmail.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/display.texi (Highlight Interactively, Fringes):
Improve wording.  Suggested by Justin Heyes-Jones
<justinhj@gmail.com> in emacs-manual-bugs@gnu.org.
* doc/emacs/commands.texi (User Input, Commands): Add missing
commas.
* doc/emacs/screen.texi (Menu Bar): Mention keyboard keys to
navigate menus.  Suggested by oldgaro <oldgaro@protonmail.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/search.texi (Not Exiting Isearch): Fix a typo.
Reported by "Kocken, I.J. (Ilja)" <I.J.Kocken@uu.nl> in
emacs-manual-bugs@gnu.org.
* doc/emacs/basic.texi (Inserting Text): Mention one more label of
RET.  Suggested by Francis Wright <f.j.wright@live.co.uk> in
emacs-manual-bugs@gnu.org.
* doc/emacs/text.texi (Paragraphs): Clarify text.  Reported by
Marcin Borkowski <mbork@mbork.pl> in emacs-manual-bugs@gnu.org.
* doc/emacs/maintaining.texi (Introduction to VC)
(Why Version Control?, VCS Merging): Fix typos and section
capitalization.  Suggested by "R. P. Dillon"
<rpdillon@killring.org> in emacs-manual-bugs@gnu.org.
* doc/emacs/modes.texi (Major Modes, Choosing Modes): Fix typos.
Reported by clemens.radermacher@posteo.de in
emacs-manual-bugs@gnu.org.
This commit is contained in:
Eli Zaretskii 2018-01-31 18:23:17 +02:00
parent 22922c7c67
commit 25c01983af
10 changed files with 53 additions and 46 deletions

View file

@ -45,16 +45,16 @@ forward, so that point remains just after the inserted text.
@cindex newline @cindex newline
@c @findex electric-indent-just-newline @c @findex electric-indent-just-newline
To end a line and start a new one, type @key{RET} (@code{newline}). To end a line and start a new one, type @key{RET} (@code{newline}).
(The @key{RET} key may be labeled @key{Return} or @key{Enter} on your (The @key{RET} key may be labeled @key{Return}, or @key{Enter}, or
keyboard, but we refer to it as @key{RET} in this manual.) This with a funny-looking left-pointing arrow on your keyboard, but we
command inserts a newline character into the buffer, then indents refer to it as @key{RET} in this manual.) This command inserts a
(@pxref{Indentation}) according to the major mode. If point is at the end newline character into the buffer, then indents (@pxref{Indentation})
of the line, the effect is to create a new blank line after it and according to the major mode. If point is at the end of the line, the
indent the new line; if point is in the middle of a line, the line is effect is to create a new blank line after it and indent the new line;
split at that position. To turn off the auto-indentation, you can if point is in the middle of a line, the line is split at that
either disable Electric Indent mode (@pxref{Indent Convenience}) or position. To turn off the auto-indentation, you can either disable
type @kbd{C-j}, which inserts just a newline, without any Electric Indent mode (@pxref{Indent Convenience}) or type @kbd{C-j},
auto-indentation. which inserts just a newline, without any auto-indentation.
As we explain later in this manual, you can change the way Emacs As we explain later in this manual, you can change the way Emacs
handles text insertion by turning on @dfn{minor modes}. For instance, handles text insertion by turning on @dfn{minor modes}. For instance,

View file

@ -58,8 +58,8 @@ compile}. This reads a shell command line using the minibuffer, and
then executes the command by running a shell as a subprocess (or then executes the command by running a shell as a subprocess (or
@dfn{inferior process}) of Emacs. The output is inserted in a buffer @dfn{inferior process}) of Emacs. The output is inserted in a buffer
named @file{*compilation*}. The current buffer's default directory is named @file{*compilation*}. The current buffer's default directory is
used as the working directory for the execution of the command; used as the working directory for the execution of the command, so by
normally, therefore, compilation takes place in this directory. default compilation takes place in that directory.
@vindex compile-command @vindex compile-command
The default compilation command is @samp{make -k}, which is usually The default compilation command is @samp{make -k}, which is usually

View file

@ -48,7 +48,7 @@ are certain characters found on non-English keyboards
labeled @key{Alt})@footnote{We refer to @key{Alt} as @key{META} for labeled @key{Alt})@footnote{We refer to @key{Alt} as @key{META} for
historical reasons.}. For example, @kbd{Control-a} is entered by historical reasons.}. For example, @kbd{Control-a} is entered by
holding down the @key{Ctrl} key while pressing @kbd{a}; we will refer holding down the @key{Ctrl} key while pressing @kbd{a}; we will refer
to this as @kbd{C-a} for short. Similarly @kbd{@key{META}-a}, or @kbd{M-a} to this as @kbd{C-a} for short. Similarly, @kbd{@key{META}-a}, or @kbd{M-a}
for short, is entered by holding down the @key{Alt} key and pressing for short, is entered by holding down the @key{Alt} key and pressing
@kbd{a}. Modifier keys can also be applied to non-alphanumerical @kbd{a}. Modifier keys can also be applied to non-alphanumerical
characters, e.g., @kbd{C-@key{F1}} or @kbd{M-@key{LEFT}}. characters, e.g., @kbd{C-@key{F1}} or @kbd{M-@key{LEFT}}.
@ -161,8 +161,8 @@ is bound to @code{next-line}. If you rebind @kbd{C-n} to the command
In this manual, we will often speak of keys like @kbd{C-n} as In this manual, we will often speak of keys like @kbd{C-n} as
commands, even though strictly speaking the key is bound to a command. commands, even though strictly speaking the key is bound to a command.
Usually we state the name of the command which really does the work in Usually, we state the name of the command which really does the work
parentheses after mentioning the key that runs it. For example, we in parentheses after mentioning the key that runs it. For example, we
will say that ``The command @kbd{C-n} (@code{next-line}) moves point will say that ``The command @kbd{C-n} (@code{next-line}) moves point
vertically down'', meaning that the command @code{next-line} moves vertically down'', meaning that the command @code{next-line} moves
vertically down, and the key @kbd{C-n} is normally bound to it. vertically down, and the key @kbd{C-n} is normally bound to it.

View file

@ -957,7 +957,7 @@ mode for all buffers, use @kbd{M-x global-hi-lock-mode} or place
Hi Lock mode works like Font Lock mode (@pxref{Font Lock}), except Hi Lock mode works like Font Lock mode (@pxref{Font Lock}), except
that you specify explicitly the regular expressions to highlight. You that you specify explicitly the regular expressions to highlight. You
control them with the commands described below. (The key bindings can control them with the following commands. (The key bindings
below that begin with @kbd{C-x w} are deprecated in favor of the below that begin with @kbd{C-x w} are deprecated in favor of the
global @kbd{M-s h} bindings, and will be removed in some future Emacs global @kbd{M-s h} bindings, and will be removed in some future Emacs
version.) version.)
@ -1087,11 +1087,11 @@ mode's symbol is a member of the list @code{hi-lock-exclude-modes}.
On graphical displays, each Emacs window normally has narrow On graphical displays, each Emacs window normally has narrow
@dfn{fringes} on the left and right edges. The fringes are used to @dfn{fringes} on the left and right edges. The fringes are used to
display symbols that provide information about the text in the window. display symbols that provide information about the text in the window.
You can type @kbd{M-x fringe-mode} to disable the fringes, or modify You can type @kbd{M-x fringe-mode} to toggle display of the fringes or
their width. This command affects fringes in all frames; to modify to modify their width. This command affects fringes in all frames; to
fringes on the selected frame only, use @kbd{M-x set-fringe-style}. modify fringes on the selected frame only, use @kbd{M-x
You can make your changes to the fringes permanent by customizing the set-fringe-style}. You can make your changes to the fringes permanent
variable @code{fringe-mode}. by customizing the variable @code{fringe-mode}.
The most common use of the fringes is to indicate a continuation The most common use of the fringes is to indicate a continuation
line (@pxref{Continuation Lines}). When one line of text is split line (@pxref{Continuation Lines}). When one line of text is split

View file

@ -159,7 +159,8 @@ the most recent macro, type @kbd{C-x e}
defining a macro, the macro is terminated and executed immediately. defining a macro, the macro is terminated and executed immediately.
Immediately after typing @kbd{C-x e}, you can type @key{e} repeatedly Immediately after typing @kbd{C-x e}, you can type @key{e} repeatedly
to immediately repeat the macro one or more times. You can also give to immediately repeat the macro one or more times. You can also give
@kbd{C-x e} a repeat argument, just like @key{F4}. @kbd{C-x e} a repeat argument, just like @key{F4} (when it is used to
execute a macro).
@kbd{C-x )} can be given a repeat count as an argument. This means @kbd{C-x )} can be given a repeat count as an argument. This means
to repeat the macro right after defining it. The macro definition to repeat the macro right after defining it. The macro definition

View file

@ -112,7 +112,7 @@ control operations.
Some uncommon or intricate version control operations, such as Some uncommon or intricate version control operations, such as
altering repository settings, are not supported in VC@. You should altering repository settings, are not supported in VC@. You should
perform such tasks outside Emacs, e.g., via the command line. perform such tasks outside VC, e.g., via the command line.
This section provides a general overview of version control, and This section provides a general overview of version control, and
describes the version control systems that VC supports. You can skip describes the version control systems that VC supports. You can skip
@ -130,7 +130,7 @@ you want to use.
@end menu @end menu
@node Why Version Control? @node Why Version Control?
@subsubsection Understanding the problems it addresses @subsubsection Understanding the Problems it Addresses
Version control systems provide you with three important Version control systems provide you with three important
capabilities: capabilities:
@ -147,10 +147,10 @@ detected and resolved.
@item @item
@dfn{History}: the ability to attach historical data to your data, @dfn{History}: the ability to attach historical data to your data,
such as explanatory comments about the intention behind each change to such as explanatory comments about the intention behind each change.
it. Even for a programmer working solo, change histories are an Even for a programmer working solo, change histories are an important
important aid to memory; for a multi-person project, they are a aid to memory; for a multi-person project, they are a vitally
vitally important form of communication among developers. important form of communication among developers.
@end itemize @end itemize
@node Version Control Systems @node Version Control Systems
@ -272,7 +272,7 @@ or changeset-based; and centralized or decentralized. VC handles all
these modes of operation, but it cannot hide the differences. these modes of operation, but it cannot hide the differences.
@node VCS Merging @node VCS Merging
@subsubsection Merge-based vs lock-based Version Control @subsubsection Merge-based vs Lock-based Version Control
A version control system typically has some mechanism to coordinate A version control system typically has some mechanism to coordinate
between users who want to change the same file. There are two ways to between users who want to change the same file. There are two ways to

View file

@ -97,11 +97,12 @@ do something more suitable for the mode. For instance, programming
language modes bind @key{TAB} to indent the current line according to language modes bind @key{TAB} to indent the current line according to
the rules of the language (@pxref{Indentation}). The keys that are the rules of the language (@pxref{Indentation}). The keys that are
commonly changed are @key{TAB}, @key{DEL}, and @kbd{C-j}. Many modes commonly changed are @key{TAB}, @key{DEL}, and @kbd{C-j}. Many modes
also define special commands of their own, usually bound in the prefix also define special commands of their own, usually bound to key
key @kbd{C-c}. Major modes can also alter user options and variables; sequences whose prefix key is @kbd{C-c} (@pxref{Keys}). Major modes
for instance, programming language modes typically set a buffer-local can also alter user options and variables; for instance, programming
value for the variable @code{comment-start}, which determines how language modes typically set a buffer-local value for the variable
source code comments are delimited (@pxref{Comments}). @code{comment-start}, which determines how source code comments are
delimited (@pxref{Comments}).
To view the documentation for the current major mode, including a To view the documentation for the current major mode, including a
list of its key bindings, type @kbd{C-h m} (@code{describe-mode}). list of its key bindings, type @kbd{C-h m} (@code{describe-mode}).
@ -437,8 +438,8 @@ a single case-insensitive search through @code{auto-mode-alist}.
Finally, if Emacs @emph{still} hasn't found a major mode to use, it Finally, if Emacs @emph{still} hasn't found a major mode to use, it
compares the text at the start of the buffer to the variable compares the text at the start of the buffer to the variable
@code{magic-fallback-mode-alist}. This variable works like @code{magic-fallback-mode-alist}. This variable works like
@code{magic-mode-alist}, described above, except that is consulted @code{magic-mode-alist}, described above, except that it is consulted
only after @code{auto-mode-alist}. By default, only @emph{after} @code{auto-mode-alist}. By default,
@code{magic-fallback-mode-alist} contains forms that check for image @code{magic-fallback-mode-alist} contains forms that check for image
files, HTML/XML/SGML files, PostScript files, and Unix style Conf files, HTML/XML/SGML files, PostScript files, and Unix style Conf
files. files.

View file

@ -309,12 +309,13 @@ way (@pxref{Key Help}).
@cindex menu bar access using keyboard @cindex menu bar access using keyboard
Instead of using the mouse, you can also invoke the first menu bar Instead of using the mouse, you can also invoke the first menu bar
item by pressing @key{F10} (to run the command @code{menu-bar-open}). item by pressing @key{F10} (to run the command @code{menu-bar-open}).
You can then navigate the menus with the arrow keys. To activate a You can then navigate the menus with the arrow keys or with @kbd{C-b},
selected menu item, press @key{RET}; to cancel menu navigation, press @kbd{C-f} (left/right), @kbd{C-p}, and @kbd{C-n} (up/down). To
@kbd{C-g} or @kbd{@key{ESC} @key{ESC} @key{ESC}}. (However, note that activate a selected menu item, press @key{RET}; to cancel menu
when Emacs was built with a GUI toolkit, the menus are drawn and navigation, press @kbd{C-g} or @kbd{@key{ESC} @key{ESC} @key{ESC}}.
controlled by the toolkit, and the key sequences to cancel menu (However, note that when Emacs was built with a GUI toolkit, the menus
navigation might be different from the above description.) are drawn and controlled by the toolkit, and the key sequences to
cancel menu navigation might be different from the above description.)
@kindex M-` @kindex M-`
@findex tmm-menubar @findex tmm-menubar

View file

@ -53,6 +53,9 @@ Incremental search forward (@code{isearch-forward}).
Incremental search backward (@code{isearch-backward}). Incremental search backward (@code{isearch-backward}).
@end table @end table
You can also invoke incremental search from the menu bar's
@samp{Edit->Search} menu.
@menu @menu
* Basic Isearch:: Basic incremental search commands. * Basic Isearch:: Basic incremental search commands.
* Repeat Isearch:: Searching for the same string again. * Repeat Isearch:: Searching for the same string again.
@ -425,7 +428,7 @@ of the keymap @code{isearch-mode-map} (@pxref{Keymaps}).
@subsection Not Exiting Incremental Search @subsection Not Exiting Incremental Search
This subsection describes how to control whether typing a command not This subsection describes how to control whether typing a command not
specifically meaningful is searches exits the search before executing specifically meaningful in searches exits the search before executing
the command. It also describes two categories of commands which you the command. It also describes two categories of commands which you
can type without exiting the current incremental search, even though can type without exiting the current incremental search, even though
they are not themselves part of incremental search. they are not themselves part of incremental search.
@ -548,7 +551,7 @@ command for nonincremental search, if the string you specify is empty.
@key{RET}} does likewise, invoking the nonincremental @key{RET}} does likewise, invoking the nonincremental
backward-searching command. backward-searching command.
Nonincremental search can also be invoked form the menu bar's Nonincremental search can also be invoked from the menu bar's
@samp{Edit->Search} menu. @samp{Edit->Search} menu.
@findex search-forward @findex search-forward

View file

@ -274,8 +274,9 @@ Put point and mark around this or next paragraph (@code{mark-paragraph}).
@findex backward-paragraph @findex backward-paragraph
@findex forward-paragraph @findex forward-paragraph
@kbd{M-@{} (@code{backward-paragraph}) moves to the beginning of the @kbd{M-@{} (@code{backward-paragraph}) moves to the beginning of the
current or previous paragraph (see below for the definition of a current or previous paragraph, depending on where point is when the
paragraph). @kbd{M-@}} (@code{forward-paragraph}) moves to the end of command is invoked (see below for the definition of a paragraph).
@kbd{M-@}} (@code{forward-paragraph}) similarly moves to the end of
the current or next paragraph. If there is a blank line before the the current or next paragraph. If there is a blank line before the
paragraph, @kbd{M-@{} moves to the blank line. paragraph, @kbd{M-@{} moves to the blank line.