summaryrefslogtreecommitdiff
path: root/doc/emacs
diff options
context:
space:
mode:
authorMartin Rudalics <rudalics@gmx.at>2018-01-28 19:27:39 +0100
committerMartin Rudalics <rudalics@gmx.at>2018-01-28 19:27:39 +0100
commit8d4500087f547e203cfba03f61dcbe641bf650de (patch)
tree029c52952933d3b6d38d20dfb093ea21e9309216 /doc/emacs
parent194ded59904b77e7073e697ebf8eac08e05a7ed3 (diff)
downloademacs-8d4500087f547e203cfba03f61dcbe641bf650de.tar.gz
Fix some issues in the emacs/lispref manuals
* doc/emacs/basic.texi (Continuation Lines): * doc/emacs/building.texi (GDB User Interface Layout): * doc/emacs/dired.texi (Misc Dired Features): * doc/emacs/maintaining.texi (Identifier Search): * doc/emacs/mark.texi (Using Region): * doc/emacs/misc.texi (Document View, DocView Conversion): * doc/emacs/modes.texi (Major Modes): * doc/emacs/mule.texi (Input Methods, Unibyte Mode): * doc/emacs/sending.texi (Mail Methods): Replace @code by @kbd. * doc/emacs/frames.texi (Text-Only Mouse): * doc/lispref/maps.texi (Standard Keymaps): Replace @kbd by @key. * doc/lispref/compile.texi (Compiler Errors): Write non-@code{nil} instead of non-nil. * doc/lispref/debugging.texi (Internals of Debugger): 'backtrace' is not a command. 'debugger-stack-frame-as-list' is an option. * doc/lispref/display.texi (Size of Displayed Text): 'window-lines-pixel-dimensions' has a last argument 'left'. * doc/lispref/display.texi (Attribute Functions): 'set-face-underline' and 'set-face-inverse-video' are commands. (Tooltips): 'tooltip-frame-parameters' is an option. (Bidirectional Display): 'bidi-paragraph-direction' is an option. * doc/lispref/frames.texi (Cursor Parameters): 'cursor-type' is an option. (Input Focus): Argument FRAME of 'x-focus-frame' is not optional. (Child Frames): Both arguments of 'frame-ancestor-p' are non-optional. 'iconify-child-frame' is an option. * doc/lispref/os.texi (Killing Emacs): 'kill-emacs-query-functions' is an option. * doc/lispref/windows.texi (Mouse Window Auto-selection): 'mouse-autoselect-window' is an option.
Diffstat (limited to 'doc/emacs')
-rw-r--r--doc/emacs/basic.texi4
-rw-r--r--doc/emacs/building.texi4
-rw-r--r--doc/emacs/dired.texi2
-rw-r--r--doc/emacs/frames.texi2
-rw-r--r--doc/emacs/maintaining.texi2
-rw-r--r--doc/emacs/mark.texi2
-rw-r--r--doc/emacs/misc.texi6
-rw-r--r--doc/emacs/modes.texi2
-rw-r--r--doc/emacs/mule.texi27
-rw-r--r--doc/emacs/sending.texi4
10 files changed, 28 insertions, 27 deletions
diff --git a/doc/emacs/basic.texi b/doc/emacs/basic.texi
index dbcb8177a01..b59ccf6ccfa 100644
--- a/doc/emacs/basic.texi
+++ b/doc/emacs/basic.texi
@@ -608,8 +608,8 @@ newlines. In that case, you can use Visual Line mode, which enables
@dfn{word wrapping}: instead of wrapping long lines exactly at the
right window edge, Emacs wraps them at the word boundaries (i.e.,
space or tab characters) nearest to the right window edge. Visual
-Line mode also redefines editing commands such as @code{C-a},
-@code{C-n}, and @code{C-k} to operate on screen lines rather than
+Line mode also redefines editing commands such as @kbd{C-a},
+@kbd{C-n}, and @kbd{C-k} to operate on screen lines rather than
logical lines. @xref{Visual Line Mode}.
@node Position Info
diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index eb8d2027cf8..65669ada50e 100644
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@ -926,8 +926,8 @@ premium.
You may also specify additional GDB-related buffers to display,
either in the same frame or a different one. Select the buffers you
-want by typing @code{M-x gdb-display-@var{buffertype}-buffer} or
-@code{M-x gdb-frame-@var{buffertype}-buffer}, where @var{buffertype}
+want by typing @kbd{M-x gdb-display-@var{buffertype}-buffer} or
+@kbd{M-x gdb-frame-@var{buffertype}-buffer}, where @var{buffertype}
is the relevant buffer type, such as @samp{breakpoints}. You can do
the same with the menu bar, with the @samp{GDB-Windows} and
@samp{GDB-Frames} sub-menus of the @samp{GUD} menu.
diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index b8450ce9982..e3241452c88 100644
--- a/doc/emacs/dired.texi
+++ b/doc/emacs/dired.texi
@@ -1515,7 +1515,7 @@ function @code{file-attributes}). This expression is evaluated for
each pair of like-named files, and files differ if the expression's
value is non-@code{nil}.
- For instance, the sequence @code{M-x dired-compare-directories
+ For instance, the sequence @kbd{M-x dired-compare-directories
@key{RET} (> mtime1 mtime2) @key{RET}} marks files newer in this
directory than in the other, and marks files older in the other
directory than in this one. It also marks files with no counterpart,
diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi
index 1b63ee58de2..7a7e1fd5636 100644
--- a/doc/emacs/frames.texi
+++ b/doc/emacs/frames.texi
@@ -1381,7 +1381,7 @@ can use @kbd{M-x xterm-mouse-mode} to give Emacs control over simple
uses of the mouse---basically, only non-modified single clicks are
supported. Newer versions of @command{xterm} also support
mouse-tracking. The normal @command{xterm} mouse functionality for
-such clicks is still available by holding down the @kbd{SHIFT} key
+such clicks is still available by holding down the @key{SHIFT} key
when you press the mouse button. Xterm Mouse mode is a global minor
mode (@pxref{Minor Modes}). Repeating the command turns the mode off
again.
diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index cb53529cea7..e61c7f90348 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -1957,7 +1957,7 @@ query-replace-regexp}. It then performs the specified replacement in
the names of the matching identifiers in all the places in all the
files where these identifiers are referenced. This is useful when you
rename your identifiers as part of refactoring. This command should
-be invoked in the @file{*xref*} buffer generated by @code{M-?}.
+be invoked in the @file{*xref*} buffer generated by @kbd{M-?}.
@findex tags-search
@kbd{M-x tags-search} reads a regexp using the minibuffer, then
diff --git a/doc/emacs/mark.texi b/doc/emacs/mark.texi
index 072a3bc4b11..7cb48a67e7c 100644
--- a/doc/emacs/mark.texi
+++ b/doc/emacs/mark.texi
@@ -273,7 +273,7 @@ active. If you change the value to @code{kill}, these commands
@vindex mark-even-if-inactive
Other commands always operate on the region, and have no default
behavior. Such commands usually have the word @code{region} in their
-names, like @kbd{C-w} (@code{kill-region}) and @code{C-x C-u}
+names, like @kbd{C-w} (@code{kill-region}) and @kbd{C-x C-u}
(@code{upcase-region}). If the mark is inactive, they operate on the
@dfn{inactive region}---that is, on the text between point and the
position at which the mark was last set (@pxref{Mark Ring}). To
diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi
index fb39a78de96..aeb8560ea00 100644
--- a/doc/emacs/misc.texi
+++ b/doc/emacs/misc.texi
@@ -434,8 +434,8 @@ by typing @kbd{C-c C-c} you switch to the fallback mode. With another
also be displayed from within DocView mode by typing @kbd{C-c C-t}
(@code{doc-view-open-text}).
- You can explicitly enable DocView mode with the command @code{M-x
-doc-view-mode}. You can toggle DocView minor mode with @code{M-x
+ You can explicitly enable DocView mode with the command @kbd{M-x
+doc-view-mode}. You can toggle DocView minor mode with @kbd{M-x
doc-view-minor-mode}.
When DocView mode starts, it displays a welcome screen and begins
@@ -576,7 +576,7 @@ including its entire margins.
For efficiency, DocView caches the images produced by @command{gs}.
The name of this directory is given by the variable
@code{doc-view-cache-directory}. You can clear the cache directory by
-typing @code{M-x doc-view-clear-cache}.
+typing @kbd{M-x doc-view-clear-cache}.
@findex doc-view-kill-proc
@findex doc-view-kill-proc-and-buffer
diff --git a/doc/emacs/modes.texi b/doc/emacs/modes.texi
index 97fe4cb7083..f0986702d5a 100644
--- a/doc/emacs/modes.texi
+++ b/doc/emacs/modes.texi
@@ -104,7 +104,7 @@ value for the variable @code{comment-start}, 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 @code{C-h m} (@code{describe-mode}).
+list of its key bindings, type @kbd{C-h m} (@code{describe-mode}).
@xref{Misc Help}.
@cindex mode hook
diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi
index be07bcc5bb2..fd25604c700 100644
--- a/doc/emacs/mule.texi
+++ b/doc/emacs/mule.texi
@@ -477,7 +477,7 @@ display the next row or the previous row.
Type @kbd{C-f} and @kbd{C-b} to move forward and backward among
the alternatives in the current row. As you do this, Emacs highlights
-the current alternative with a special color; type @code{C-@key{SPC}}
+the current alternative with a special color; type @kbd{C-@key{SPC}}
to select the current alternative and use it as input. The
alternatives in the row are also numbered; the number appears before
the alternative. Typing a number selects the associated alternative
@@ -1658,24 +1658,25 @@ characters:
@cindex 8-bit input
@item
You can use an input method for the selected language environment.
-@xref{Input Methods}. When you use an input method in a unibyte buffer,
-the non-@acronym{ASCII} character you specify with it is converted to unibyte.
+@xref{Input Methods}. When you use an input method in a unibyte
+buffer, the non-@acronym{ASCII} character you specify with it is
+converted to unibyte.
@item
If your keyboard can generate character codes 128 (decimal) and up,
-representing non-@acronym{ASCII} characters, you can type those character codes
-directly.
+representing non-@acronym{ASCII} characters, you can type those
+character codes directly.
On a graphical display, you should not need to do anything special to
use these keys; they should simply work. On a text terminal, you
-should use the command @code{M-x set-keyboard-coding-system} or customize the
-variable @code{keyboard-coding-system} to specify which coding system
-your keyboard uses (@pxref{Terminal Coding}). Enabling this feature
-will probably require you to use @key{ESC} to type Meta characters;
-however, on a console terminal or in @code{xterm}, you can arrange for
-Meta to be converted to @key{ESC} and still be able type 8-bit
-characters present directly on the keyboard or using @key{Compose} or
-@key{AltGr} keys. @xref{User Input}.
+should use the command @kbd{M-x set-keyboard-coding-system} or
+customize the variable @code{keyboard-coding-system} to specify which
+coding system your keyboard uses (@pxref{Terminal Coding}). Enabling
+this feature will probably require you to use @key{ESC} to type Meta
+characters; however, on a console terminal or in @code{xterm}, you can
+arrange for Meta to be converted to @key{ESC} and still be able to
+type 8-bit characters present directly on the keyboard or using
+@key{Compose} or @key{AltGr} keys. @xref{User Input}.
@cindex @code{iso-transl} library
@cindex compose character
diff --git a/doc/emacs/sending.texi b/doc/emacs/sending.texi
index 6f6ef5f3dab..299f7896172 100644
--- a/doc/emacs/sending.texi
+++ b/doc/emacs/sending.texi
@@ -676,8 +676,8 @@ such as MIME support. Another available mode is MH-E
@vindex mail-user-agent
You can choose any of these @dfn{mail user agents} as your preferred
-method for editing and sending mail. The commands @code{C-x m},
-@code{C-x 4 m} and @code{C-x 5 m} use whichever agent you have
+method for editing and sending mail. The commands @kbd{C-x m},
+@kbd{C-x 4 m} and @kbd{C-x 5 m} use whichever agent you have
specified; so do various other parts of Emacs that send mail, such as
the bug reporter (@pxref{Bugs}). To specify a mail user agent,
customize the variable @code{mail-user-agent}. Currently, legitimate