emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] master c4f8b55 1/3: Merge from origin/emacs-26


From: Glenn Morris
Subject: [Emacs-diffs] master c4f8b55 1/3: Merge from origin/emacs-26
Date: Fri, 2 Feb 2018 10:55:33 -0500 (EST)

branch: master
commit c4f8b5545efb94cdab21d92b83b388b059235d5c
Merge: 6ff8b77 56c37bb
Author: Glenn Morris <address@hidden>
Commit: Glenn Morris <address@hidden>

    Merge from origin/emacs-26
    
    56c37bb Use @key{} where it is missing in the manuals
    25c0198 Another round of manual fixes from proofreading
---
 doc/emacs/basic.texi       | 20 ++++++++++----------
 doc/emacs/building.texi    |  4 ++--
 doc/emacs/commands.texi    |  6 +++---
 doc/emacs/display.texi     | 18 +++++++++---------
 doc/emacs/emacs.texi       |  2 +-
 doc/emacs/killing.texi     |  2 +-
 doc/emacs/kmacro.texi      |  3 ++-
 doc/emacs/maintaining.texi | 16 ++++++++--------
 doc/emacs/modes.texi       | 15 ++++++++-------
 doc/emacs/programs.texi    |  2 +-
 doc/emacs/screen.texi      | 13 +++++++------
 doc/emacs/search.texi      | 11 +++++++----
 doc/emacs/text.texi        |  5 +++--
 doc/lispref/commands.texi  |  2 +-
 doc/lispref/debugging.texi |  8 ++++----
 doc/lispref/display.texi   |  2 +-
 doc/lispref/modes.texi     |  9 +++++----
 doc/lispref/nonascii.texi  |  2 +-
 doc/lispref/tips.texi      | 19 ++++++++++---------
 19 files changed, 84 insertions(+), 75 deletions(-)

diff --git a/doc/emacs/basic.texi b/doc/emacs/basic.texi
index edb3d08..55e0145 100644
--- a/doc/emacs/basic.texi
+++ b/doc/emacs/basic.texi
@@ -45,16 +45,16 @@ forward, so that point remains just after the inserted text.
 @cindex newline
 @c @findex electric-indent-just-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
-keyboard, but we refer to it as @key{RET} in this manual.)  This
-command inserts a newline character into the buffer, then indents
-(@pxref{Indentation}) according to the major mode.  If point is at the end
-of the line, the effect is to create a new blank line after it and
-indent the new line; if point is in the middle of a line, the line is
-split at that position.  To turn off the auto-indentation, you can
-either disable Electric Indent mode (@pxref{Indent Convenience}) or
-type @kbd{C-j}, which inserts just a newline, without any
-auto-indentation.
+(The @key{RET} key may be labeled @key{Return}, or @key{Enter}, or
+with a funny-looking left-pointing arrow on your keyboard, but we
+refer to it as @key{RET} in this manual.)  This command inserts a
+newline character into the buffer, then indents (@pxref{Indentation})
+according to the major mode.  If point is at the end of the line, the
+effect is to create a new blank line after it and indent the new line;
+if point is in the middle of a line, the line is split at that
+position.  To turn off the auto-indentation, you can either disable
+Electric Indent mode (@pxref{Indent Convenience}) or type @kbd{C-j},
+which inserts just a newline, without any auto-indentation.
 
   As we explain later in this manual, you can change the way Emacs
 handles text insertion by turning on @dfn{minor modes}.  For instance,
diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index 65669ad..f1fc24d 100644
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@ -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
 @dfn{inferior process}) of Emacs.  The output is inserted in a buffer
 named @file{*compilation*}.  The current buffer's default directory is
-used as the working directory for the execution of the command;
-normally, therefore, compilation takes place in this directory.
+used as the working directory for the execution of the command, so by
+default compilation takes place in that directory.
 
 @vindex compile-command
   The default compilation command is @samp{make -k}, which is usually
diff --git a/doc/emacs/commands.texi b/doc/emacs/commands.texi
index 05f4e4b..2e65bfd 100644
--- a/doc/emacs/commands.texi
+++ b/doc/emacs/commands.texi
@@ -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
 historical reasons.}.  For example, @kbd{Control-a} is entered by
 holding down the @key{Ctrl} key while pressing @kbd{a}; we will refer
-to this as @kbd{C-a} for short.  Similarly @address@hidden, or @kbd{M-a}
+to this as @kbd{C-a} for short.  Similarly, @address@hidden, or @kbd{M-a}
 for short, is entered by holding down the @key{Alt} key and pressing
 @kbd{a}.  Modifier keys can also be applied to non-alphanumerical
 characters, e.g., @address@hidden or @address@hidden
@@ -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
 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
-parentheses after mentioning the key that runs it.  For example, we
+Usually, we state the name of the command which really does the work
+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
 vertically down'', meaning that the command @code{next-line} moves
 vertically down, and the key @kbd{C-n} is normally bound to it.
diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
index d338aee..d0ab548 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.texi
@@ -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
 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
 global @kbd{M-s h} bindings, and will be removed in some future Emacs
 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
 @dfn{fringes} on the left and right edges.  The fringes are used to
 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
-their width.  This command affects fringes in all frames; to modify
-fringes on the selected frame only, use @kbd{M-x set-fringe-style}.
-You can make your changes to the fringes permanent by customizing the
-variable @code{fringe-mode}.
+You can type @kbd{M-x fringe-mode} to toggle display of the fringes or
+to modify their width.  This command affects fringes in all frames; to
+modify fringes on the selected frame only, use @kbd{M-x
+set-fringe-style}.  You can make your changes to the fringes permanent
+by customizing the variable @code{fringe-mode}.
 
   The most common use of the fringes is to indicate a continuation
 line (@pxref{Continuation Lines}).  When one line of text is split
@@ -1259,9 +1259,9 @@ Highlight empty lines.
 @item big-indent
 @vindex whitespace-big-indent-regexp
 Highlight too-deep indentation.  By default any sequence of at least 4
-consecutive TAB characters or 32 consecutive SPC characters is
-highlighted.  To change that, customize the regular expression
address@hidden
+consecutive @key{TAB} characters or 32 consecutive @key{SPC}
+characters is highlighted.  To change that, customize the regular
+expression @code{whitespace-big-indent-regexp}.
 
 @item space-mark
 Draw space and non-breaking characters with a special glyph.
diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi
index 0051868..b053922 100644
--- a/doc/emacs/emacs.texi
+++ b/doc/emacs/emacs.texi
@@ -723,7 +723,7 @@ C and Related Modes
 
 * Motion in C::         Commands to move by C statements, etc.
 * Electric C::          Colon and other chars can automatically reindent.
-* Hungry Delete::       A more powerful DEL command.
+* Hungry Delete::       A more powerful @key{DEL} command.
 * Other C Commands::    Filling comments, viewing expansion of macros,
                           and other neat features.
 
diff --git a/doc/emacs/killing.texi b/doc/emacs/killing.texi
index 6efcc9d..7820393 100644
--- a/doc/emacs/killing.texi
+++ b/doc/emacs/killing.texi
@@ -857,7 +857,7 @@ region is active.
 
 Unlike the standard region, the region-rectangle can have its corners
 extended past the end of buffer, or inside stretches of white space
-that point normally cannot enter, like the TAB.
+that point normally cannot enter, like the @key{TAB}.
 
 @findex rectangle-exchange-point-and-mark
 @findex address@hidden, in rectangle-mark-mode}
diff --git a/doc/emacs/kmacro.texi b/doc/emacs/kmacro.texi
index a3426a3..c9cef75 100644
--- a/doc/emacs/kmacro.texi
+++ b/doc/emacs/kmacro.texi
@@ -159,7 +159,8 @@ the most recent macro, type @kbd{C-x e}
 defining a macro, the macro is terminated and executed immediately.
 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
address@hidden e} a repeat argument, just like @key{F4}.
address@hidden 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
 to repeat the macro right after defining it.  The macro definition
diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index e61c7f9..8acbb53 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -112,7 +112,7 @@ control operations.
 
   Some uncommon or intricate version control operations, such as
 altering repository settings, are not supported in address@hidden  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
 describes the version control systems that VC supports.  You can skip
@@ -130,7 +130,7 @@ you want to use.
 @end menu
 
 @node Why Version Control?
address@hidden Understanding the problems it addresses
address@hidden Understanding the Problems it Addresses
 
   Version control systems provide you with three important
 capabilities:
@@ -147,10 +147,10 @@ detected and resolved.
 
 @item
 @dfn{History}: the ability to attach historical data to your data,
-such as explanatory comments about the intention behind each change to
-it.  Even for a programmer working solo, change histories are an
-important aid to memory; for a multi-person project, they are a
-vitally important form of communication among developers.
+such as explanatory comments about the intention behind each change.
+Even for a programmer working solo, change histories are an important
+aid to memory; for a multi-person project, they are a vitally
+important form of communication among developers.
 @end itemize
 
 @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.
 
 @node VCS Merging
address@hidden Merge-based vs lock-based Version Control
address@hidden Merge-based vs Lock-based Version Control
 
   A version control system typically has some mechanism to coordinate
 between users who want to change the same file.  There are two ways to
@@ -1899,7 +1899,7 @@ Move to the previous reference and display it in the 
other window
 @findex xref-show-location-at-point
 Display the reference on the current line in the other window
 (@code{xref-show-location-at-point}).
address@hidden TAB
address@hidden @key{TAB}
 @findex xref-quit-and-goto-xref
 Display the reference on the current line and bury the @file{*xref*}
 buffer (@code{xref-quit-and-goto-xref}).
diff --git a/doc/emacs/modes.texi b/doc/emacs/modes.texi
index f098670..1312a24 100644
--- a/doc/emacs/modes.texi
+++ b/doc/emacs/modes.texi
@@ -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
 the rules of the language (@pxref{Indentation}).  The keys that are
 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
-key @kbd{C-c}.  Major modes can also alter user options and variables;
-for instance, programming language modes typically set a buffer-local
-value for the variable @code{comment-start}, which determines how
-source code comments are delimited (@pxref{Comments}).
+also define special commands of their own, usually bound to key
+sequences whose prefix key is @kbd{C-c} (@pxref{Keys}).  Major modes
+can also alter user options and variables; for instance, programming
+language modes typically set a buffer-local value for the variable
address@hidden, which determines how source code comments are
+delimited (@pxref{Comments}).
 
   To view the documentation for the current major mode, including a
 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
 compares the text at the start of the buffer to the variable
 @code{magic-fallback-mode-alist}.  This variable works like
address@hidden, described above, except that is consulted
-only after @code{auto-mode-alist}.  By default,
address@hidden, described above, except that it is consulted
+only @emph{after} @code{auto-mode-alist}.  By default,
 @code{magic-fallback-mode-alist} contains forms that check for image
 files, HTML/XML/SGML files, PostScript files, and Unix style Conf
 files.
diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi
index 4289124..970647e 100644
--- a/doc/emacs/programs.texi
+++ b/doc/emacs/programs.texi
@@ -1587,7 +1587,7 @@ with Emacs.
 @menu
 * Motion in C::                 Commands to move by C statements, etc.
 * Electric C::                  Colon and other chars can automatically 
reindent.
-* Hungry Delete::               A more powerful DEL command.
+* Hungry Delete::               A more powerful @key{DEL} command.
 * Other C Commands::            Filling comments, viewing expansion of macros,
                                 and other neat features.
 @end menu
diff --git a/doc/emacs/screen.texi b/doc/emacs/screen.texi
index 8dd5e5f..37c082e 100644
--- a/doc/emacs/screen.texi
+++ b/doc/emacs/screen.texi
@@ -309,12 +309,13 @@ way (@pxref{Key Help}).
 @cindex menu bar access using keyboard
   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}).
-You can then navigate the menus with the arrow keys.  To activate a
-selected menu item, press @key{RET}; to cancel menu navigation, press
address@hidden or @address@hidden @key{ESC} @key{ESC}}.  (However, note that
-when Emacs was built with a GUI toolkit, the menus are drawn and
-controlled by the toolkit, and the key sequences to cancel menu
-navigation might be different from the above description.)
+You can then navigate the menus with the arrow keys or with @kbd{C-b},
address@hidden (left/right), @kbd{C-p}, and @kbd{C-n} (up/down).  To
+activate a selected menu item, press @key{RET}; to cancel menu
+navigation, press @kbd{C-g} or @address@hidden @key{ESC} @key{ESC}}.
+(However, note that when Emacs was built with a GUI toolkit, the menus
+are drawn and controlled by the toolkit, and the key sequences to
+cancel menu navigation might be different from the above description.)
 
 @kindex M-`
 @findex tmm-menubar
diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi
index daaded1..c0adab4 100644
--- a/doc/emacs/search.texi
+++ b/doc/emacs/search.texi
@@ -53,6 +53,9 @@ Incremental search forward (@code{isearch-forward}).
 Incremental search backward (@code{isearch-backward}).
 @end table
 
+You can also invoke incremental search from the menu bar's
address@hidden>Search} menu.
+
 @menu
 * Basic Isearch::        Basic incremental search commands.
 * 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
 
 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
 can type without exiting the current incremental search, even though
 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
 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.
 
 @findex search-forward
@@ -1672,8 +1675,8 @@ line.  In particular, @kbd{C-g} simply exits the 
@code{query-replace}.
 
   To restart a @code{query-replace} once it is exited, use @kbd{C-x
 @key{ESC} @key{ESC}}, which repeats the @code{query-replace} because it
-used the minibuffer to read its arguments.  @xref{Repetition, C-x ESC
-ESC}.
+used the minibuffer to read its arguments.  @xref{Repetition, C-x @key{ESC}
address@hidden
 
 @cindex invisible text, and query-replace
   The option @code{search-invisible} determines how @code{query-replace}
diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi
index b9d3b7b..df3a42a 100644
--- a/doc/emacs/text.texi
+++ b/doc/emacs/text.texi
@@ -274,8 +274,9 @@ Put point and mark around this or next paragraph 
(@code{mark-paragraph}).
 @findex backward-paragraph
 @findex forward-paragraph
   @address@hidden (@code{backward-paragraph}) moves to the beginning of the
-current or previous paragraph (see below for the definition of a
-paragraph).  @address@hidden (@code{forward-paragraph}) moves to the end of
+current or previous paragraph, depending on where point is when the
+command is invoked (see below for the definition of a paragraph).
address@hidden@}} (@code{forward-paragraph}) similarly moves to the end of
 the current or next paragraph.  If there is a blank line before the
 paragraph, @address@hidden moves to the blank line.
 
diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 6700b8f..0753d6f 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -748,7 +748,7 @@ part of the prompt.
 @group
 (execute-extended-command 3)
 ---------- Buffer: Minibuffer ----------
-3 M-x forward-word RET
+3 M-x forward-word @key{RET}
 ---------- Buffer: Minibuffer ----------
      @result{} t
 @end group
diff --git a/doc/lispref/debugging.texi b/doc/lispref/debugging.texi
index e69f95b..0969207 100644
--- a/doc/lispref/debugging.texi
+++ b/doc/lispref/debugging.texi
@@ -941,10 +941,10 @@ The profiler report buffer shows, on each line, a 
function that was
 called, followed by how much resource (processor or memory) it used in
 absolute and percentage times since profiling started.  If a given
 line has a @samp{+} symbol at the left-hand side, you can expand that
-line by typing @key{RET}, in order to see the function(s) called by
-the higher-level function.  Use a prefix argument (@key{C-u RET}) to
-see the whole call tree below a function.  Pressing @key{RET} again
-will collapse back to the original state.
+line by typing @address@hidden, in order to see the function(s) called
+by the higher-level function.  Use a prefix argument (@kbd{C-u
address@hidden) to see the whole call tree below a function.  Pressing
address@hidden@key{RET}} again will collapse back to the original state.
 
 Press @kbd{j} or @kbd{mouse-2} to jump to the definition of a function.
 Press @kbd{d} to view a function's documentation.
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index fbf943a..bd1f671 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -4599,7 +4599,7 @@ first character in the group of consecutive characters 
that have the
 same @code{display} property.  The space width is the pixel width of
 that character, multiplied by @var{factor}.  (On text-mode terminals,
 the ``pixel width'' of a character is usually 1, but it could be more
-for TABs and double-width CJK characters.)
+for @key{TAB}s and double-width CJK characters.)
 
 @item :align-to @var{hpos}
 Specifies that the space should be wide enough to reach @var{hpos}.
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index efa14e5..f1a00e7 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -3545,10 +3545,11 @@ provided grammar is precise enough, 
@code{transpose-sexps} can correctly
 transpose the two arguments of a @code{+} operator, taking into account
 the precedence rules of the language.
 
-Calling @code{smie-setup} is also sufficient to make TAB indentation work in
-the expected way, extends @code{blink-matching-paren} to apply to
-elements like @code{begin...end}, and provides some commands that you
-can bind in the major mode keymap.
+Calling @code{smie-setup} is also sufficient to make @key{TAB}
+indentation work in the expected way, extends
address@hidden to apply to elements like
address@hidden, and provides some commands that you can bind in
+the major mode keymap.
 
 @deffn Command smie-close-block
 This command closes the most recently opened (and not yet closed) block.
diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi
index 2fd2bbc..8bc7e20 100644
--- a/doc/lispref/nonascii.texi
+++ b/doc/lispref/nonascii.texi
@@ -1776,7 +1776,7 @@ affect it.
 Binding @code{coding-system-for-write} to a address@hidden value
 prevents output primitives from calling the function specified by
 @code{select-safe-coding-system-function} (@pxref{User-Chosen Coding
-Systems}).  This is because @kbd{C-x RET c}
+Systems}).  This is because @kbd{C-x @key{RET} c}
 (@code{universal-coding-system-argument}) works by binding
 @code{coding-system-for-write}, and Emacs should obey user selection.
 If a Lisp program binds @code{coding-system-for-write} to a value that
diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi
index 0f883fe..0695d9b 100644
--- a/doc/lispref/tips.texi
+++ b/doc/lispref/tips.texi
@@ -17,14 +17,15 @@ should follow.
 @findex checkdoc
 @findex checkdoc-current-buffer
 @findex checkdoc-file
-  You can automatically check some of the conventions described below by
-running the command @kbd{M-x checkdoc RET} when visiting a Lisp file.
-It cannot check all of the conventions, and not all the warnings it
-gives necessarily correspond to problems, but it is worth examining them
-all.  Alternatively, use the command @kbd{M-x checkdoc-current-buffer RET}
-to check the conventions in the current buffer, or @code{checkdoc-file}
-when you want to check a file in batch mode, e.g., with a command run by
address@hidden@w{M-x compile RET}}.
+  You can automatically check some of the conventions described below
+by running the command @kbd{M-x checkdoc @key{RET}} when visiting a
+Lisp file.  It cannot check all of the conventions, and not all the
+warnings it gives necessarily correspond to problems, but it is worth
+examining them all.  Alternatively, use the command @kbd{M-x
+checkdoc-current-buffer @key{RET}} to check the conventions in the
+current buffer, or @code{checkdoc-file} when you want to check a file
+in batch mode, e.g., with a command run by @address@hidden compile
address@hidden
 
 @menu
 * Coding Conventions::        Conventions for clean and robust programs.
@@ -1028,7 +1029,7 @@ but only the main one.
 @findex checkdoc-package-keywords
 This line lists keywords for the @code{finder-by-keyword} help command.
 Please use that command to see a list of the meaningful keywords.  The
-command @kbd{M-x checkdoc-package-keywords RET} will find and display
+command @kbd{M-x checkdoc-package-keywords @key{RET}} will find and display
 any keywords that are not in @code{finder-known-keywords}.  If you set
 the variable @code{checkdoc-package-keywords-flag} address@hidden,
 checkdoc commands will include the keyword verification in its checks.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]