branch master updated: * doc/info-stnd.texi: Revise use of @key and @kbd.

[Gavin D. Smith]

This is an automated email from the git hooks/post-receive script.

gavin pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new d4f7225954 * doc/info-stnd.texi: Revise use of @key and @kbd.
d4f7225954 is described below

commit d4f7225954c6920e67e99d7d5f95759527ecb5bb
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Sun Jan 2 13:42:54 2022 +0000

    * doc/info-stnd.texi: Revise use of @key and @kbd.
---
 ChangeLog          |  4 ++++
 doc/info-stnd.texi | 62 +++++++++++++++++++++++++++---------------------------
 2 files changed, 35 insertions(+), 31 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 681f4532b7..872373e147 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2022-01-02  Gavin Smith  <gavinsmith0123@gmail.com>
+
+       * doc/info-stnd.texi: Revise use of @key and @kbd.
+
 2022-01-02  Patrice Dumas  <pertusus@free.fr>
 
        * tp/Texinfo/Convert/LaTeX.pm (output, convert, convert_tree): always
diff --git a/doc/info-stnd.texi b/doc/info-stnd.texi
index 3e34d6d4bf..6a3a8e1fba 100644
--- a/doc/info-stnd.texi
+++ b/doc/info-stnd.texi
@@ -99,8 +99,8 @@ that you read in Info.
 
 @cindex Emacs Info reader
 @cindex Info files, reading in Emacs
-GNU Emacs also provides an Info reader (just type @kbd{M-x info} in
-Emacs).  Emacs Info and stand-alone Info have nearly identical user
+GNU Emacs also provides an Info reader (just type @code{@kbd{M-x} info}
+in Emacs).  Emacs Info and stand-alone Info have nearly identical user
 interfaces, although customization and other details are different
 (this manual explains the stand-alone Info reader).  The Emacs Info
 reader supports the X Window System and other such bitmapped
@@ -451,7 +451,7 @@ By default, Info passes SGR terminal control sequences 
(also known as
 ANSI escape sequences) found in documents directly through to the
 terminal.  If you use the @code{--no-raw-escapes} options, these
 sequences are displayed as other control characters are; for example, an
-@kbd{ESC} byte is displayed as @samp{^[}.  The @code{--raw-escapes} and
+@key{ESC} byte is displayed as @samp{^[}.  The @code{--raw-escapes} and
 @code{-R} options do not do anything, but are included for completeness.
 
 @cindex man pages, bold and underline
@@ -491,7 +491,7 @@ Tell Info to look for the node that describes how to invoke 
the
 program and its command-line options, and begin the session by
 displaying that node.  It is provided to make it easier to find the
 most important usage information in a manual without navigating
-through menu hierarchies.  The effect is similar to the @code{M-x
+through menu hierarchies.  The effect is similar to the @code{@kbd{M-x}
 goto-invocation} command (@pxref{goto-invocation}) from inside Info.
 
 @item --speech-friendly
@@ -572,17 +572,17 @@ the screen.
 The notation used in this manual to describe keystrokes
 is the same as the notation used within the Emacs manual
 (@pxref{User Input,,, emacs, The GNU Emacs Manual}).
-@kbd{C-@var{x}} means press the @kbd{CTRL} key and the
-key @var{x}.  @kbd{M-@var{x}} means press the @kbd{META} key and
-the key @var{x}.  On many terminals the @kbd{META} key is known as
-the @kbd{ALT} key.  @kbd{SPC} is the space bar.  The other keys are
+@kbd{C-@var{x}} means press the @key{CTRL} key and the
+key @var{x}.  @kbd{M-@var{x}} means press the @key{META} key and
+the key @var{x}.  On many terminals the @key{META} key is known as
+the @key{ALT} key.  @key{SPC} is the space bar.  The other keys are
 usually called by the names printed on them.
 
 The following table lists the basic cursor movement commands in Info.
 Each entry consists of the key sequence you should type to execute the
-cursor movement, the @code{M-x} command name (displayed
+cursor movement, the @kbd{M-x} command name (displayed
 in parentheses), and a short description of what the command
-does.@footnote{@code{M-x} is also a command;
+does.@footnote{@kbd{M-x} is also a command;
 it invokes @code{execute-extended-command}, letting you run a command
 by name.  @xref{M-x, , Executing an extended command, emacs, The GNU
 Emacs Manual}, for more detailed information.}
@@ -717,7 +717,7 @@ Shift the text in this window up.  This is identical to the 
@key{SPC}
 operation above, except that it never scrolls beyond the end of the
 current node.
 
-@item @code{M-x scroll-forward-page-only-set-window}
+@item @code{@kbd{M-x} scroll-forward-page-only-set-window}
 @findex scroll-forward-page-only-set-window
 Scroll forward, like with @kbd{C-v}, but if a numeric argument is
 specified, it becomes the default scroll size for subsequent
@@ -755,30 +755,30 @@ the current node.  The default scroll size can be changed 
by invoking
 the @code{scroll-backward-page-only-set-window} command with a numeric
 argument.
 
-@item @code{M-x scroll-backward-page-only-set-window}
+@item @code{@kbd{M-x} scroll-backward-page-only-set-window}
 @findex scroll-backward-page-only-set-window
 Scroll backward, like with @kbd{M-v}, but if a numeric argument is
 specified, it becomes the default scroll size for subsequent
 @code{scroll-forward} and @code{scroll-backward} commands.
 
-@item @code{M-x down-line}
+@item @code{@kbd{M-x} down-line}
 @findex down-line
 Scroll forward by one line.  With a numeric argument, scroll forward
 that many lines.
 
-@item @code{M-x up-line}
+@item @code{@kbd{M-x} up-line}
 @findex up-line
 Scroll backward one line.  With a numeric argument, scroll backward that
 many lines.
 
-@item @code{M-x scroll-half-screen-down}
+@item @code{@kbd{M-x} scroll-half-screen-down}
 @findex scroll-half-screen-down
 Scroll forward by half of the screen size.  With a numeric argument,
 scroll that many lines.  If an argument is specified, it becomes the new
 default number of lines to scroll for subsequent
 @code{scroll-half-screen-down} and @code{scroll-half-screen-up} commands.
 
-@item @code{M-x scroll-half-screen-up}
+@item @code{@kbd{M-x} scroll-half-screen-up}
 @findex scroll-half-screen-up
 Scroll back by half of the screen size.  With a numeric argument,
 scroll that many lines.  If an argument is specified, it becomes the new
@@ -815,7 +815,7 @@ lines which are longer than the screen width @dfn{wrap}, 
i.e., they are
 continued on the next line.  Lines which wrap have a @samp{\} appearing
 in the rightmost column of the screen.  You can cause such lines to be
 terminated at the rightmost column by changing the state of line
-wrapping in the window with @code{C-x w}.  When a line which needs more
+wrapping in the window with @kbd{C-x w}.  When a line which needs more
 space than one screen width to display is displayed, a @samp{$} appears
 in the rightmost column of the screen, and the remainder of the line is
 invisible.  When long lines are truncated, the mode line displays the
@@ -1045,7 +1045,7 @@ Select a node which has been previously visited in a 
visible window.
 This is similar to @samp{C-x C-b} followed by @samp{m}, but no window is
 created.
 
-@item @code{M-x man}
+@item @code{@kbd{M-x} man}
 @findex man
 @cindex man pages, displaying
 Read the name of a man page to load and display.  This uses the @command{man}
@@ -1182,7 +1182,7 @@ matches in other chapters.
 @findex clear-search
 If the @code{highlight-searches} variable is set, matches from search
 commands will be highlighted.  @xref{Variables,, @code{highlight-searches}}.
-Use the @kbd{M-x clear-search} command to clear any search highlights.
+Use the @code{@kbd{M-x} clear-search} command to clear any search highlights.
 
 @cindex search, and case-sensitivity
 @cindex case-sensitivity, and search
@@ -1232,7 +1232,7 @@ matches in a new virtual node, synthesized on the fly.
 Move to the node containing the next matching index item from the last
 @samp{i} command.
 
-@item @kbd{M-x index-apropos}
+@item @code{@kbd{M-x} index-apropos}
 @findex index-apropos
 Grovel the indices of all the known Info files on your system for a
 string, and build a menu of the possible matches.
@@ -1354,7 +1354,7 @@ Reads the name of a menu item in the echo area and 
selects its node.
 Completion is available while reading the menu label.  @xref{The Echo
 Area, completion}.
 
-@item @kbd{M-x find-menu}
+@item @code{@kbd{M-x} find-menu}
 @findex find-menu
 Move the cursor to the start of this node's menu.
 @end table
@@ -1482,7 +1482,7 @@ window on the screen.  Given a numeric argument, 
@samp{C-x o} moves over
 that many windows.  A negative argument causes @samp{C-x o} to select
 the previous window on the screen.
 
-@item @kbd{M-x prev-window}
+@item @code{@kbd{M-x} prev-window}
 @findex prev-window
 Select the previous window on the screen.  This is identical to
 @samp{C-x o} with a negative argument.
@@ -1762,7 +1762,7 @@ reference document for later use, or if you don't have 
@TeX{} installed.
 Info provides you with a command for doing this.
 
 @table @asis
-@item @kbd{M-x print-node}
+@item @code{@kbd{M-x} print-node}
 @findex print-node
 @cindex @env{INFO_PRINT_COMMAND}, environment variable
 Pipe the contents of the current node through the command in the
@@ -1787,24 +1787,24 @@ the underlying OS.
 GNU Info contains several commands which self-document GNU Info:
 
 @table @asis
-@item @kbd{M-x describe-command}
+@item @code{@kbd{M-x} describe-command}
 @cindex functions, describing
 @cindex commands, describing
 @findex describe-command
 Read the name of an Info command in the echo area and then display a
 brief description of what that command does.
 
-@item @kbd{M-x describe-key}
+@item @code{@kbd{M-x} describe-key}
 @cindex keys, describing
 @findex describe-key
 Read a key sequence in the echo area, and then display the name and
 documentation of the Info command that the key sequence invokes.
 
-@item @kbd{M-x describe-variable}
+@item @code{@kbd{M-x} describe-variable}
 Read the name of a variable in the echo area and then display a brief
 description of what the variable affects.
 
-@item @kbd{M-x where-is}
+@item @code{@kbd{M-x} where-is}
 @findex where-is
 Read the name of an Info command in the echo area, and then display
 a key sequence which can be typed in order to invoke that command.
@@ -1835,7 +1835,7 @@ Show information about what's currently being viewed in 
the echo area:
 the Info file name, and current line number and percentage within the
 current node.
 
-@item @kbd{M-x info-version}
+@item @code{@kbd{M-x} info-version}
 @findex info-version
 Display the name and version of the currently running Info program.
 
@@ -1927,7 +1927,7 @@ and it is actually only 40 lines tall, here is a way to 
tell Info that
 the operating system is correct.
 
 @table @asis
-@item @kbd{M-x set-screen-height}
+@item @code{@kbd{M-x} set-screen-height}
 @findex set-screen-height
 @cindex screen, changing the height of
 Read a height value in the echo area and set the height of the
@@ -1976,7 +1976,7 @@ Key Bindings}).
 @end enumerate
 
 @table @asis
-@item @kbd{M-x set-variable}
+@item @code{@kbd{M-x} set-variable}
 @cindex variables, setting
 @findex set-variable
 Read the name of a variable, and the value for it, in the echo area
@@ -1984,7 +1984,7 @@ and then set the variable to that value.  Completion is 
available when
 reading the variable name (@pxref{The Echo Area}); completion is also
 available when reading the value when that makes sense. 
 
-@item @kbd{M-x describe-variable}
+@item @code{@kbd{M-x} describe-variable}
 @cindex variables, describing
 @findex describe-variable
 Read the name of a variable in the echo area and display its value and