From 8d4500087f547e203cfba03f61dcbe641bf650de Mon Sep 17 00:00:00 2001 From: Martin Rudalics Date: Sun, 28 Jan 2018 19:27:39 +0100 Subject: 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. --- doc/emacs/basic.texi | 4 ++-- doc/emacs/building.texi | 4 ++-- doc/emacs/dired.texi | 2 +- doc/emacs/frames.texi | 2 +- doc/emacs/maintaining.texi | 2 +- doc/emacs/mark.texi | 2 +- doc/emacs/misc.texi | 6 +++--- doc/emacs/modes.texi | 2 +- doc/emacs/mule.texi | 27 ++++++++++++++------------- doc/emacs/sending.texi | 4 ++-- 10 files changed, 28 insertions(+), 27 deletions(-) (limited to 'doc/emacs') 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 -- cgit v1.2.1