mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-02 11:21:42 +00:00
Code Issues Releases Activity

Merge from origin/emacs-26

Browse Source 
fd50238 (origin/emacs-26) * doc/lispref/streams.texi (Output Variable...
769ea57 Use "GTK+" where applicable in the manual
5e69219 Document print-escape-control-characters
c00fea9 Merge branch 'emacs-26' of git.savannah.gnu.org:/srv/git/emac...
a2ab0d0 * doc/emacs/killing.texi (Rectangles): Don't use @key for cha...
6288c3d * lisp/emulation/viper.el: Unbreak it.
bf3535e More fixes in the Emacs manual
c87d04e Avoid aborts in 'md5'
9743f48 Mark keys consistently in manuals
ce557a9 Remove @key{} markups from @kindex entries in manuals
71243f0 * doc/emacs/display.texi (Standard Faces): Fix markup of inde...
7a069f3 Fix @kindex entries in manuals
6218933 Fix @cindex entries in manuals
57c9f12 Merge branch 'emacs-26' of git.sv.gnu.org:/srv/git/emacs into...
e415309 Fix @cindex entries in org.texi
560a23e Document reserved keys
105d085 * doc/misc/ebrowse.texi: Use @key{} for keys.

Conflicts:
	doc/misc/tramp.texi
	etc/NEWS
This commit is contained in:
Glenn Morris 2018-02-28 09:40:40 -08:00
commit 3959892419
65 changed files with 2194 additions and 2208 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/emacs/basic.texi
View File

@ -218,14 +218,14 @@ preserves position within the line, like @kbd{C-n}.
@item C-a
@itemx @key{Home}
@kindex C-a
@kindex HOME key
@kindex HOME
@findex move-beginning-of-line
Move to the beginning of the line (@code{move-beginning-of-line}).
@item C-e
@itemx @key{End}
@kindex C-e
@kindex END key
@kindex END
@findex move-end-of-line
Move to the end of the line (@code{move-end-of-line}).
@ -277,7 +277,7 @@ On graphical displays, @kbd{C-@key{HOME}} does the same.
@item M->
@kindex M->
@kindex C-@key{END}
@kindex C-END
@findex end-of-buffer
Move to the end of the buffer (@code{end-of-buffer}). On graphical
displays, @kbd{C-@key{END}} does the same.

2
doc/emacs/building.texi
View File

@ -1499,7 +1499,7 @@ Evaluate all the Emacs Lisp expressions in the buffer.
@ifinfo
@c This uses 'colon' instead of a literal ':' because Info cannot
@c cope with a ':' in a menu.
@kindex M-@key{colon}
@kindex M-colon
@end ifinfo
@ifnotinfo
@kindex M-:

2
doc/emacs/custom.texi
View File

@ -2162,7 +2162,7 @@ loading of this library, use the option @samp{--no-site-file}.
better to put them in @file{default.el}, so that users can more easily
override them.
@cindex site-lisp directories
@cindex @file{site-lisp} directories
You can place @file{default.el} and @file{site-start.el} in any of
the directories which Emacs searches for Lisp libraries. The variable
@code{load-path} (@pxref{Lisp Libraries}) specifies these directories.

4
doc/emacs/dired.texi
View File

@ -1370,8 +1370,8 @@ C-c}.
@node Image-Dired
@section Viewing Image Thumbnails in Dired
@cindex image-dired mode
@cindex image-dired
@cindex @code{image-dired} mode
@cindex @code{image-dired}
Image-Dired is a facility for browsing image files. It provides viewing
the images either as thumbnails or in full size, either inside Emacs

40
doc/emacs/display.texi
View File

@ -526,7 +526,7 @@ frames as if they have a dark background, whereas a value of
background.
@cindex background color
@cindex default face
@cindex @code{default face}
You can customize a face to alter its attributes, and save those
customizations for future Emacs sessions. @xref{Face Customization},
for details.
@ -535,7 +535,7 @@ for details.
of its attributes are specified. Its background color is also used as
the frame's background color. @xref{Colors}.
@cindex cursor face
@cindex @code{cursor} face
Another special face is the @code{cursor} face. On graphical
displays, the background color of this face is used to draw the text
cursor. None of the other attributes of this face have any effect;
@ -627,10 +627,10 @@ but you should not make it a variable-width font.
@item fixed-pitch-serif
This face is like @code{fixed-pitch}, except the font has serifs and
looks more like traditional typewriting.
@cindex variable-pitch face
@cindex @code{variable-pitch} face
@item variable-pitch
This face forces use of a variable-width font.
@cindex shadow face
@cindex @code{shadow} face
@item shadow
This face is used for making the text less noticeable than the surrounding
ordinary text. Usually this can be achieved by using shades of gray in
@ -656,8 +656,8 @@ This face is used to highlight lazy matches for Isearch and Query
Replace (matches other than the current one).
@item region
This face is used for displaying an active region (@pxref{Mark}).
When Emacs is built with GTK support, its colors are taken from the
current GTK theme.
When Emacs is built with GTK+ support, its colors are taken from the
current GTK+ theme.
@item secondary-selection
This face is used for displaying a secondary X selection (@pxref{Secondary
Selection}).
@ -685,40 +685,40 @@ frame:
@table @code
@item mode-line
@cindex mode-line face
@cindex @code{mode-line} face
@cindex faces for mode lines
This face is used for the mode line of the currently selected window,
and for menu bars when toolkit menus are not used. By default, it's
drawn with shadows for a raised effect on graphical displays, and
drawn as the inverse of the default face on non-windowed terminals.
@item mode-line-inactive
@cindex mode-line-inactive face
@cindex @code{mode-line-inactive} face
Like @code{mode-line}, but used for mode lines of the windows other
than the selected one (if @code{mode-line-in-non-selected-windows} is
non-@code{nil}). This face inherits from @code{mode-line}, so changes
in that face affect mode lines in all windows.
@item mode-line-highlight
@cindex mode-line-highlight face
@cindex @code{mode-line-highlight} face
Like @code{highlight}, but used for mouse-sensitive portions of text
on mode lines. Such portions of text typically pop up tooltips
(@pxref{Tooltips}) when the mouse pointer hovers above them.
@item mode-line-buffer-id
@cindex mode-line-buffer-id face
@cindex @code{mode-line-buffer-id} face
This face is used for buffer identification parts in the mode line.
@item header-line
@cindex header-line face
@cindex @code{header-line} face
Similar to @code{mode-line} for a window's header line, which appears
at the top of a window just as the mode line appears at the bottom.
Most windows do not have a header line---only some special modes, such
Info mode, create one.
@item header-line-highlight
@cindex header-line-highlight face
@cindex @code{header-line-highlight} face
Similar to @code{highlight} and @code{mode-line-highlight}, but used
for mouse-sensitive portions of text on header lines. This is a
separate face because the @code{header-line} face might be customized
in a way that does not interact well with @code{highlight}.
@item vertical-border
@cindex vertical-border face
@cindex @code{vertical-border} face
This face is used for the vertical divider between windows on text
terminals.
@item minibuffer-prompt
@ -741,7 +741,7 @@ The @code{:background} attribute of this face specifies the color of
the text cursor. @xref{Cursor Display}.
@item tooltip
This face is used for tooltip text. By default, if Emacs is built
with GTK support, tooltips are drawn via GTK and this face has no
with GTK+ support, tooltips are drawn via GTK+ and this face has no
effect. @xref{Tooltips}.
@item mouse
This face determines the color of the mouse pointer.
@ -1177,7 +1177,7 @@ empty lines at the end of a buffer, without realizing it. In most
cases, this @dfn{trailing whitespace} has no effect, but sometimes it
can be a nuisance.
@cindex trailing-whitespace face
@cindex @code{trailing-whitespace} face
You can make trailing whitespace at the end of a line visible by
setting the buffer-local variable @code{show-trailing-whitespace} to
@code{t}. Then Emacs displays trailing whitespace, using the face
@ -1508,8 +1508,8 @@ as octal escape sequences instead of caret escape sequences.
@cindex non-breaking space
@cindex non-breaking hyphen
@cindex soft hyphen
@cindex escape-glyph face
@cindex nobreak-space face
@cindex @code{escape-glyph} face
@cindex @code{nobreak-space} face
Some non-@acronym{ASCII} characters have the same appearance as an
@acronym{ASCII} space or hyphen (minus) character. Such characters
can cause problems if they are entered into a buffer without your
@ -1531,7 +1531,7 @@ elisp, The Emacs Lisp Reference Manual}.
@cindex glyphless characters
@cindex characters with no font glyphs
@cindex glyphless-char face
@cindex @code{glyphless-char} face
On graphical displays, some characters may have no glyphs in any of
the fonts available to Emacs. These @dfn{glyphless characters} are
normally displayed as boxes containing the hexadecimal character code.
@ -1546,7 +1546,7 @@ for details.
@cindex curly quotes, and terminal capabilities
@cindex curved quotes, and terminal capabilities
@cindex homoglyph face
@cindex @code{homoglyph} face
Emacs tries to determine if the curved quotes @samp{‘} and @samp{’}
can be displayed on the current display. By default, if this seems to
@ -1801,7 +1801,7 @@ may wish to customize the variables
@code{display-line-numbers-width} to a large enough value, to avoid
occasional miscalculations of space reserved for the line numbers.
@cindex line-number face
@cindex @code{line-number} face
The line numbers are displayed in a special face @code{line-number}.
The current line number is displayed in a different face,
@code{line-number-current-line}, so you can make the current line's

4
doc/emacs/emacs.texi
View File

@ -1223,8 +1223,8 @@ GTK resources
* GTK Resource Basics:: Basic usage of GTK+ resources.
* GTK Widget Names:: How GTK+ widgets are named.
* GTK Names in Emacs:: GTK widgets used by Emacs.
* GTK styles:: What can be customized in a GTK widget.
* GTK Names in Emacs:: GTK+ widgets used by Emacs.
* GTK styles:: What can be customized in a GTK+ widget.
Emacs and macOS / GNUstep

4
doc/emacs/files.texi
View File

@ -281,7 +281,7 @@ files. Firstly, when Emacs is built with a suitable GUI toolkit,
commands invoked with the mouse (by clicking on the menu bar or tool
bar) use the toolkit's standard file selection dialog instead of
prompting for the file name in the minibuffer. On GNU/Linux and Unix
platforms, Emacs does this when built with GTK, LessTif, and Motif
platforms, Emacs does this when built with GTK+, LessTif, and Motif
toolkits; on MS-Windows and Mac, the GUI version does that by default.
For information on how to customize this, see @ref{Dialog Boxes}.
@ -1857,7 +1857,7 @@ variable @code{tramp-mode} to @code{nil}. You can turn off the
feature in individual cases by quoting the file name with @samp{/:}
(@pxref{Quoted File Names}).
@cindex ange-ftp
@cindex @code{ange-ftp}
Remote file access through FTP is handled by the Ange-FTP package, which
is documented in the following. Remote file access through the other
methods is handled by the Tramp package, which has its own manual.

18
doc/emacs/frames.texi
View File

@ -479,14 +479,14 @@ cycles through all the frames on your terminal.
@findex delete-other-frames
Delete all frames on the current terminal, except the selected one.
@item M-<F10>
@kindex M-<F10>
@item M-@key{F10}
@kindex M-F10
@findex toggle-frame-maximized
Toggle the maximization state of the current frame. When a frame is
maximized, it fills the screen.
@item <F11>
@kindex <F11>
@item @key{F11>}
@kindex F11
@findex toggle-frame-fullscreen
Toggle full-screen mode for the current frame. (The difference
between full-screen and maximized is normally that the former
@ -901,7 +901,7 @@ that server's selected frame.
@node Frame Parameters
@section Frame Parameters
@cindex default-frame-alist
@vindex default-frame-alist
You can control the default appearance and behavior of all frames by
specifying a default list of @dfn{frame parameters} in the variable
@ -925,7 +925,7 @@ default font to @samp{Monospace-10}:
For a list of frame parameters and their effects, see @ref{Frame
Parameters,,, elisp, The Emacs Lisp Reference Manual}.
@cindex initial-frame-alist
@vindex initial-frame-alist
You can also specify a list of frame parameters which apply to just
the initial frame, by customizing the variable
@code{initial-frame-alist}.
@ -999,11 +999,11 @@ end of the buffer is shown; if @code{nil}, the thumb will be at the
bottom when the end of the buffer is shown. You cannot over-scroll
when the entire buffer is visible.
@cindex scroll-bar face
@cindex @code{scroll-bar} face
The visual appearance of the scroll bars is controlled by the
@code{scroll-bar} face. (Some toolkits, such as GTK and MS-Windows,
@code{scroll-bar} face. (Some toolkits, such as GTK+ and MS-Windows,
ignore this face; the scroll-bar appearance there can only be
customized system-wide, for GTK @pxref{GTK resources}).
customized system-wide, for GTK+ @pxref{GTK resources}).
@cindex vertical border
On graphical frames, vertical scroll bars implicitly serve to separate

1
doc/emacs/help.texi
View File

@ -4,7 +4,6 @@
@c See file emacs.texi for copying conditions.
@node Help
@chapter Help
@kindex Help
@cindex help
@cindex self-documentation
@findex help-command

5
doc/emacs/killing.texi
View File

@ -590,7 +590,7 @@ you can access it using the following Emacs commands:
@table @kbd
@findex mouse-set-secondary
@kindex M-Drag-mouse-1
@cindex secondary-selection face
@cindex @code{secondary-selection} face
@item M-Drag-mouse-1
Set the secondary selection, with one end at the place where you press
down the button, and the other end at the place where you release it
@ -857,7 +857,8 @@ 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 in the middle of a TAB
character.
@findex rectangle-exchange-point-and-mark
@findex exchange-point-and-mark@r{, in rectangle-mark-mode}

2
doc/emacs/maintaining.texi
View File

@ -628,7 +628,7 @@ they use the concept of checking out individual files.
@node Log Buffer
@subsection Features of the Log Entry Buffer
@cindex C-c C-c @r{(Log Edit mode)}
@kindex C-c C-c @r{(Log Edit mode)}
@findex log-edit-done
When you tell VC to commit a change, it pops up a buffer named
@file{*vc-log*}. In this buffer, you should write a @dfn{log entry}

2
doc/emacs/misc.texi
View File

@ -409,7 +409,7 @@ is needed. For OpenDocument and Microsoft Office documents, the
@code{unoconv} tool is needed.}, and displaying those images.
@findex doc-view-toggle-display
@cindex doc-view-minor-mode
@findex doc-view-minor-mode
When you visit a document file that can be displayed with DocView
mode, Emacs automatically uses DocView mode @footnote{The needed
external tools for the document type must be available, and Emacs must

6
doc/emacs/msdos-xtra.texi
View File

@ -412,7 +412,7 @@ will print the region while converting it to the codepage 850 encoding.
@node MS-DOS and MULE
@subsection International Support on MS-DOS
@cindex international support @r{(MS-DOS)}
@cindex international support (MS-DOS)
Emacs on MS-DOS supports the same international character sets as it
does on GNU, Unix and other platforms
@ -471,7 +471,7 @@ codepage built into the display hardware.) You can specify a different
codepage for Emacs to use by setting the variable @code{dos-codepage} in
your init file.
@cindex language environment, automatic selection on @r{MS-DOS}
@cindex language environment, automatic selection on MS-DOS
Multibyte Emacs supports only certain DOS codepages: those which can
display Far-Eastern scripts, like the Japanese codepage 932, and those
that encode a single ISO 8859 character set.
@ -494,7 +494,7 @@ codes. For example, the letter @samp{@,{c}} (@samp{c} with cedilla) has
code 231 in the standard Latin-1 character set, but the corresponding
DOS codepage 850 uses code 135 for this glyph.}
@cindex mode line @r{(MS-DOS)}
@cindex mode line (MS-DOS)
All the @code{cp@var{nnn}} coding systems use the letter @samp{D}
(for ``DOS'') as their mode-line mnemonic. Since both the terminal
coding system and the default coding system for file I/O are set to

4
doc/emacs/msdos.texi
View File

@ -129,7 +129,7 @@ invoked---that will always give you an editor. When invoked via
the program that invoked @command{emacsclient}.
@end enumerate
@cindex emacsclient, on MS-Windows
@cindex @command{emacsclient}, on MS-Windows
Note that, due to limitations of MS-Windows, Emacs cannot have both
GUI and text-mode frames in the same session. It also cannot open
text-mode frames on more than a single @dfn{Command Prompt} window,
@ -694,7 +694,7 @@ its normal effect: for example, @kbd{@key{Lwindow}} opens the
@vindex w32-recognize-altgr
@kindex AltGr @r{(MS-Windows)}
@cindex AltGr key (MS-Windows)
@cindex @key{AltGr} key (MS-Windows)
The variable @code{w32-recognize-altgr} controls whether the
@key{AltGr} key (if it exists on your keyboard), or its equivalent,
the combination of the right @key{Alt} and left @key{Ctrl} keys

16
doc/emacs/programs.texi
View File

@ -1009,7 +1009,7 @@ effect as @kbd{C-u M-;} by typing @kbd{M-x comment-kill}
(@code{comment-dwim} actually calls @code{comment-kill} as a
subroutine when it is given a prefix argument).
@kindex C-c C-c (C mode)
@kindex C-c C-c @r{(C mode)}
@findex comment-region
@findex uncomment-region
The command @kbd{M-x comment-region} is equivalent to calling
@ -1626,7 +1626,7 @@ behind. A prefix argument acts as a repeat count. With a negative
argument, move backward.
@item M-a
@kindex M-a (C mode)
@kindex M-a @r{(C mode)}
@findex c-beginning-of-statement
Move point to the beginning of the innermost C statement
(@code{c-beginning-of-statement}). If point is already at the beginning
@ -1637,7 +1637,7 @@ In comments or in strings which span more than one line, this command
moves by sentences instead of statements.
@item M-e
@kindex M-e (C mode)
@kindex M-e @r{(C mode)}
@findex c-end-of-statement
Move point to the end of the innermost C statement or sentence; like
@kbd{M-a} except that it moves in the other direction
@ -1702,17 +1702,17 @@ preprocessor commands.
@item C-c C-@key{DEL}
@itemx C-c @key{DEL}
@findex c-hungry-delete-backwards
@kindex C-c C-DEL (C Mode)
@kindex C-c DEL (C Mode)
@kindex C-c C-DEL @r{(C Mode)}
@kindex C-c DEL @r{(C Mode)}
Delete the entire block of whitespace preceding point (@code{c-hungry-delete-backwards}).
@item C-c C-d
@itemx C-c C-@key{Delete}
@itemx C-c @key{Delete}
@findex c-hungry-delete-forward
@kindex C-c C-d (C Mode)
@kindex C-c C-Delete (C Mode)
@kindex C-c Delete (C Mode)
@kindex C-c C-d @r{(C Mode)}
@kindex C-c C-Delete @r{(C Mode)}
@kindex C-c Delete @r{(C Mode)}
Delete the entire block of whitespace after point (@code{c-hungry-delete-forward}).
@end table

10
doc/emacs/search.texi
View File

@ -92,7 +92,7 @@ the first @samp{F} previously found. After another @kbd{O}, the
cursor moves to just after the first @samp{FOO}.
@cindex faces for highlighting search matches
@cindex isearch face
@cindex @code{isearch} face
At each step, Emacs highlights the @dfn{current match}---the buffer
text that matches the search string---using the @code{isearch} face
(@pxref{Faces}). @xref{Search Customizations}, for various options
@ -280,7 +280,7 @@ down-casing.
@node Error in Isearch
@subsection Errors in Incremental Search
@cindex isearch-fail face
@cindex @code{isearch-fail} face
If your string is not found at all, the echo area says @samp{Failing
I-Search}, and the cursor moves past the place where Emacs found as
much of your string as it could. Thus, if you search for @samp{FOOT},
@ -1552,8 +1552,8 @@ replacements are not added to the command history, and cannot be
reused.
@cindex faces for highlighting query replace
@cindex query-replace face
@cindex lazy-highlight face, in replace
@cindex @code{query-replace} face
@cindex @code{lazy-highlight} face, in replace
@vindex query-replace-highlight
@vindex query-replace-lazy-highlight
@vindex query-replace-show-replacement
@ -1869,7 +1869,7 @@ setting the variable @code{search-highlight} to @code{nil}.
@cindex lazy highlighting customizations
@vindex isearch-lazy-highlight
@cindex lazy-highlight face
@cindex @code{lazy-highlight} face
The other matches for the search string that are visible on display
are highlighted using the @code{lazy-highlight} face. Setting the
variable @code{isearch-lazy-highlight} to @code{nil} disables this

16
doc/emacs/text.texi
View File

@ -1380,19 +1380,19 @@ buffer cycles the visibility of the entire outline structure, between
(i) showing only top-level heading lines, (ii) showing all heading
lines but no body lines, and (iii) showing everything.
@kindex M-<up> @r{(Org Mode)}
@kindex M-<down> @r{(Org Mode)}
@kindex M-<left> @r{(Org Mode)}
@kindex M-<right> @r{(Org Mode)}
@kindex M-UP @r{(Org Mode)}
@kindex M-DOWN @r{(Org Mode)}
@kindex M-LEFT @r{(Org Mode)}
@kindex M-RIGHT @r{(Org Mode)}
@findex org-metaup
@findex org-metadown
@findex org-metaleft
@findex org-metaright
You can move an entire entry up or down in the buffer, including its
body lines and subtree (if any), by typing @kbd{M-<up>}
(@code{org-metaup}) or @kbd{M-<down>} (@code{org-metadown}) on the
body lines and subtree (if any), by typing @kbd{M-@key{UP}}
(@code{org-metaup}) or @kbd{M-@key{DOWN}} (@code{org-metadown}) on the
heading line. Similarly, you can promote or demote a heading line
with @kbd{M-<left>} (@code{org-metaleft}) and @kbd{M-<right>}
with @kbd{M-@key{LEFT}} (@code{org-metaleft}) and @kbd{M-@key{RIGHT}}
(@code{org-metaright}). These commands execute their global bindings
if invoked on a body line.
@ -2175,7 +2175,7 @@ text properties.
@cindex soft newline
@cindex newlines, hard and soft
@cindex use-hard-newlines
@findex use-hard-newlines
In Enriched mode, Emacs distinguishes between two different kinds of
newlines, @dfn{hard} newlines and @dfn{soft} newlines. You can also
enable or disable this feature in other buffers, by typing @kbd{M-x

4
doc/emacs/trouble.texi
View File

@ -1411,8 +1411,8 @@ patches) over all your contributions.
@node Service
@section How To Get Help with GNU Emacs
@cindex help in using Emacs
@cindex help-gnu-emacs mailing list
@cindex gnu.emacs.help newsgroup
@cindex @samp{help-gnu-emacs} mailing list
@cindex @samp{gnu.emacs.help} newsgroup
If you need help installing, using or changing GNU Emacs, there are
two ways to find it:

95
doc/emacs/xresources.texi
View File

@ -12,10 +12,10 @@ resources, as is usual for programs that use X.
graphical widgets, such as the menu-bar, scroll-bar, and dialog boxes,
is determined by
@ifnottex
GTK resources, which we will also describe.
GTK+ resources, which we will also describe.
@end ifnottex
@iftex
GTK resources.
GTK+ resources.
@end iftex
When Emacs is built without GTK+ support, the appearance of these
widgets is determined by additional X resources.
@ -28,7 +28,7 @@ system registry (@pxref{MS-Windows Registry}).
* Table of Resources:: Table of specific X resources that affect Emacs.
* Lucid Resources:: X resources for Lucid menus.
* Motif Resources:: X resources for Motif and LessTif menus.
* GTK resources:: Resources for GTK widgets.
* GTK resources:: Resources for GTK+ widgets.
@end menu
@node Resources
@ -160,16 +160,16 @@ Width of the frame's external border, in pixels. This has no effect
if Emacs is compiled with GTK+ support.
@end ifnottex
@item @code{cursorColor} (class @code{Foreground})
Text cursor color. If this resource is specified when Emacs starts
up, Emacs sets its value as the background color of the @code{cursor}
face (@pxref{Faces}).
@item @code{cursorBlink} (class @code{CursorBlink})
If the value of this resource is @samp{off} or @samp{false} or
@samp{0} at startup, Emacs disables Blink Cursor mode (@pxref{Cursor
Display}).
@item @code{cursorColor} (class @code{Foreground})
Text cursor color. If this resource is specified when Emacs starts
up, Emacs sets its value as the background color of the @code{cursor}
face (@pxref{Faces}).
@item @code{font} (class @code{Font})
Font name for the @code{default} face (@pxref{Fonts}). You can also
specify a fontset name (@pxref{Fontsets}).
@ -184,6 +184,13 @@ in which case Emacs tries using all available font backends.
@item @code{foreground} (class @code{Foreground})
Default foreground color for text.
@item @code{fullscreen} (class @code{Fullscreen})
The desired fullscreen size. The value can be one of @code{fullboth},
@code{maximized}, @code{fullwidth} or @code{fullheight}, which
correspond to the command-line options @samp{-fs}, @samp{-mm},
@samp{-fw}, and @samp{-fh} (@pxref{Window Size X}). Note that this
applies to the initial frame only.
@item @code{geometry} (class @code{Geometry})
Window size and position. The value should be a size and position
specification, of the same form as in the @samp{-g} or
@ -193,18 +200,15 @@ The size applies to all frames in the Emacs session, but the position
applies only to the initial Emacs frame (or, in the case of a resource
for a specific frame name, only that frame).
Be careful not to specify this resource as @samp{emacs*geometry}, as
that may affect individual menus as well as the main Emacs frame.
@item @code{fullscreen} (class @code{Fullscreen})
The desired fullscreen size. The value can be one of @code{fullboth},
@code{maximized}, @code{fullwidth} or @code{fullheight}, which
correspond to the command-line options @samp{-fs}, @samp{-mm},
@samp{-fw}, and @samp{-fh} (@pxref{Window Size X}). Note that this
applies to the initial frame only.
@ifnottex
@item @code{horizontalScrollBars} (class @code{ScrollBars})
If the value of this resource is @samp{off} or @samp{false} or
@samp{0}, Emacs disables Horizontal Scroll Bar mode at startup
(@pxref{Scroll Bars}).
@item @code{iconName} (class @code{Title})
Name to display in the icon.
@ -318,8 +322,8 @@ This is only relevant if your Emacs is built with XIM support. It
might be useful to turn off XIM on slow X client/server links.
@item @code{verticalScrollBars} (class @code{ScrollBars})
Give frames scroll bars if @samp{on}; don't have scroll bars if
@samp{off}.
Give frames scroll bars on the left if @samp{left}, on the right if
@samp{right}; don't have scroll bars if @samp{off}.
@ifnottex
@item @code{visualClass} (class @code{VisualClass})
@ -346,13 +350,13 @@ resources. @xref{Face Customization}.
@cindex Lucid Widget X Resources
If Emacs is compiled with the X toolkit support using Lucid widgets,
you can use X resources to customize the appearance of the menu bar,
pop-up menus, and dialog boxes. The resources for the menu bar fall
in the @samp{pane.menubar} class (following, as always, either the
name of the Emacs executable or @samp{Emacs} for all Emacs
invocations). The resources for the pop-up menu are in the
@samp{menu*} class. The resources for dialog boxes are in the
@samp{dialog*} class.
you can use X resources to customize the appearance of the menu bar
(@pxref{Menu Bar}), pop-up menus, and dialog boxes (@pxref{Dialog
Boxes}). The resources for the menu bar fall in the
@samp{pane.menubar} class (following, as always, either the name of
the Emacs executable or @samp{Emacs} for all Emacs invocations). The
resources for the pop-up menu are in the @samp{menu*} class. The
resources for dialog boxes are in the @samp{dialog*} class.
For example, to display menu bar entries with the @samp{Courier-12}
font (@pxref{Fonts}), write this:
@ -374,12 +378,12 @@ Here is a list of resources for menu bars, pop-up menus, and dialogs:
Font for menu item text.
@item fontSet
Fontset for menu item text.
@item foreground
Foreground color.
@item background
Background color.
@item buttonForeground
Foreground color for a selected item.
@item foreground
Foreground color.
@ifnottex
@item horizontalSpacing
Horizontal spacing in pixels between items. Default is 3.
@ -403,14 +407,15 @@ Margin of the menu bar, in characters. Default is 1.
If Emacs is compiled with the X toolkit support using Motif or
LessTif widgets, you can use X resources to customize the appearance
of the menu bar, pop-up menus, and dialog boxes. However, the
resources are organized differently from Lucid widgets.
of the menu bar (@pxref{Menu Bar}), pop-up menus, and dialog boxes
(@pxref{Dialog Boxes}). However, the resources are organized
differently from Lucid widgets.
The resource names for the menu bar are in the @samp{pane.menubar}
class, and they must be specified in this form:
@smallexample
Emacs.pane.menubar.@var{subwidget}.@var{resource}: @var{value}
Emacs.pane.menubar.@var{subwidget}.@var{resource}: @var{value}
@end smallexample
@noindent
@ -427,7 +432,7 @@ For example, to specify the font @samp{8x16} for all menu bar items,
including submenus, write this:
@smallexample
Emacs.pane.menubar.*.fontList: 8x16
Emacs.pane.menubar.*.fontList: 8x16
@end smallexample
Each item in a submenu also has its own name for X resources; for
@ -471,7 +476,7 @@ itself, you must first specify the resource for all of them, then
override the value for submenus alone. Here is an example:
@smallexample
Emacs.pane.menubar.*.fontList: 8x16
Emacs.pane.menubar.*.fontList: 9x18
Emacs.pane.menubar.popup_*.fontList: 8x16
@end smallexample
@ -510,7 +515,7 @@ The color for the border shadow, on the top and the left.
@node GTK resources
@appendixsec GTK resources
@cindex GTK+ resources
@cindex resource files for GTK
@cindex resource files for GTK+
@cindex @file{~/.gtkrc-2.0} file
@cindex @file{~/.emacs.d/gtkrc} file
@ -525,7 +530,7 @@ resources are specified in either the file @file{~/.emacs.d/gtkrc}
(for Emacs-specific GTK+ resources), or @file{~/.gtkrc-2.0} (for
general GTK+ resources). We recommend using @file{~/.emacs.d/gtkrc},
since GTK+ seems to ignore @file{~/.gtkrc-2.0} when running GConf with
GNOME@. Note, however, that some GTK themes may override
GNOME@. Note, however, that some GTK+ themes may override
customizations in @file{~/.emacs.d/gtkrc}; there is nothing we can do
about this. GTK+ resources do not affect aspects of Emacs unrelated
to GTK+ widgets, such as fonts and colors in the main Emacs window;
@ -548,15 +553,15 @@ system, see
@menu
* GTK Resource Basics:: Basic usage of GTK+ resources.
* GTK Widget Names:: How GTK+ widgets are named.
* GTK Names in Emacs:: GTK widgets used by Emacs.
* GTK styles:: What can be customized in a GTK widget.
* GTK Names in Emacs:: GTK+ widgets used by Emacs.
* GTK styles:: What can be customized in a GTK+ widget.
@end menu
@node GTK Resource Basics
@appendixsubsec GTK Resource Basics
In a GTK+ 2 resource file (usually @file{~/.emacs.d/gtkrc}), the
simplest kinds of resource settings simply assign a value to a
simplest kind of a resource setting simply assigns a value to a
variable. For example, putting the following line in the resource
file changes the font on all GTK+ widgets to @samp{courier-12}:
@ -612,7 +617,7 @@ widget "*verticalScrollBar*" style "scroll"
@node GTK Widget Names
@appendixsubsec GTK widget names
@cindex GTK widget names
@cindex GTK+ widget names
A GTK+ widget is specified by a @dfn{widget name} and a @dfn{widget
class}. The widget name refers to a specific widget
@ -657,8 +662,8 @@ widget "*" style "my_style"
@node GTK Names in Emacs
@appendixsubsec GTK Widget Names in Emacs
@cindex GTK widget names in Emacs
@cindex GTK widget classes
@cindex GTK+ widget names in Emacs
@cindex GTK+ widget classes
The GTK+ widgets used by an Emacs frame are listed below:
@ -721,7 +726,7 @@ widget_class "*Menu*" style "my_menu_style"
@node GTK styles
@appendixsubsec GTK styles
@cindex GTK styles
@cindex GTK+ styles
Here is an example of two GTK+ style declarations:
@ -770,20 +775,24 @@ possible states are:
@table @code
@item NORMAL
This is the default state for widgets.
@item ACTIVE
This is the state for a widget that is ready to do something. It is
also for the trough of a scroll bar, i.e., @code{bg[ACTIVE] = "red"}
sets the scroll bar trough to red. Buttons that have been armed
(pressed but not released yet) are in this state.
@item PRELIGHT
This is the state for a widget that can be manipulated, when the mouse
pointer is over it---for example when the mouse is over the thumb in
the scroll bar or over a menu item. When the mouse is over a button
that is not pressed, the button is in this state.
@item SELECTED
This is the state for data that has been selected by the user. It can
be selected text or items selected in a list. This state is not used
in Emacs.
@item INSENSITIVE
This is the state for widgets that are visible, but they cannot be
manipulated in the usual way---for example, buttons that can't be
@ -805,14 +814,14 @@ dialog.
@item bg_pixmap[@var{state}] = "@var{pixmap}"
This specifies an image background (instead of a background color).
@var{pixmap} should be the image file name. GTK can use a number of
@var{pixmap} should be the image file name. GTK+ can use a number of
image file formats, including XPM, XBM, GIF, JPEG and PNG@. If you
want a widget to use the same image as its parent, use
@samp{<parent>}. If you don't want any image, use @samp{<none>}.
@samp{<none>} is the way to cancel a background image inherited from a
parent style.
You can't specify the file by its absolute file name. GTK looks for
You can't specify the file by its absolute file name. GTK+ looks for
the pixmap file in directories specified in @code{pixmap_path}.
@code{pixmap_path} is a colon-separated list of directories within
double quotes, specified at the top level in a @file{gtkrc} file

18
doc/lispintro/emacs-lisp-intro.texi
View File

@ -5882,7 +5882,7 @@ find and use again and again.
@node New insert-buffer
@subsection New Body for @code{insert-buffer}
@findex insert-buffer@r{, new version body}
@cindex new version body for insert-buffer
@cindex new version body for @code{insert-buffer}
The body in the GNU Emacs 22 version is more confusing than the original.
@ -13254,7 +13254,7 @@ If you are reading this inside of GNU Emacs and you want to see the
whole function, you can type @kbd{C-h f} (@code{describe-function})
and the name of the function. This gives you the function
documentation and the name of the library containing the function's
source. Place point over the name of the library and press the RET
source. Place point over the name of the library and press the @key{RET}
key; you will be taken directly to the source. (Be sure to install
your sources! Without them, you are like a person who tries to drive
a car with his eyes shut!)
@ -14739,7 +14739,7 @@ In Emacs 22
"Edit file FILENAME.
Switch to a buffer visiting file FILENAME,
creating one if none already exists.
Interactively, the default if you just type RET is the current directory,
Interactively, the default if you just type @key{RET} is the current directory,
but the visited file name is available through the minibuffer history:
type M-n to pull it into the minibuffer.
@ -15917,8 +15917,8 @@ a regular expression, including functions that are not interactive.
What we want to look for is some command that prints or inserts
columns. Very likely, the name of the function will contain either
the word ``print'' or the word ``insert'' or the word ``column''.
Therefore, we can simply type @kbd{M-x apropos RET
print\|insert\|column RET} and look at the result. On my system, this
Therefore, we can simply type @kbd{M-x apropos @key{RET}
print\|insert\|column @key{RET}} and look at the result. On my system, this
command once took quite some time, and then produced a list of 79
functions and variables. Now it does not take much time at all and
produces a list of 211 functions and variables. Scanning down the
@ -18147,7 +18147,7 @@ You can enter the debugger when you call the function by calling
Type:
@smallexample
M-x debug-on-entry RET triangle-bugged RET
M-x debug-on-entry @key{RET} triangle-bugged @key{RET}
@end smallexample
@need 1250
@ -18255,7 +18255,7 @@ To cancel the effect of @code{debug-on-entry}, call
@code{cancel-debug-on-entry} and the name of the function, like this:
@smallexample
M-x cancel-debug-on-entry RET triangle-bugged RET
M-x cancel-debug-on-entry @key{RET} triangle-bugged @key{RET}
@end smallexample
@noindent
@ -18341,7 +18341,7 @@ this by positioning your cursor within or just after the definition
and typing
@smallexample
M-x edebug-defun RET
M-x edebug-defun @key{RET}
@end smallexample
@noindent
@ -18552,7 +18552,7 @@ one of those long, but decipherable functions. You can look up
In this instance, since the code is Lisp, the @file{*Help*} buffer
contains the name of the library containing the function's source.
You can put point over the name of the library and press the RET key,
You can put point over the name of the library and press the @key{RET} key,
which in this situation is bound to @code{help-follow}, and be taken
directly to the source, in the same way as @kbd{M-.}
(@code{find-tag}).

4
doc/lispref/files.texi
View File

@ -3267,7 +3267,7 @@ shown above; the details are crucial for proper behavior in the case of
multiple handlers, and for operations that have two file names that may
each have handlers.
@kindex safe-magic (@r{property})
@kindex safe-magic @r{(property)}
Handlers that don't really do anything special for actual access to the
file---such as the ones that implement completion of host names for
remote file names---should have a non-@code{nil} @code{safe-magic}
@ -3277,7 +3277,7 @@ file names, by prefixing them with @samp{/:}. But if the handler that
would be used for them has a non-@code{nil} @code{safe-magic}
property, the @samp{/:} is not added.
@kindex operations (@r{property})
@kindex operations @r{(property)}
A file name handler can have an @code{operations} property to
declare which operations it handles in a nontrivial way. If this
property has a non-@code{nil} value, it should be a list of

8
doc/lispref/streams.texi
View File

@ -778,6 +778,14 @@ In the second expression, the local binding of
@code{prin1}, but not during the printing of the result.
@end defvar
@defvar print-escape-control-characters
If this variable is non-@code{nil}, control characters in strings are
printed as backslash sequences by the print functions @code{prin1} and
@code{print} that print with quoting. If this variable and
@code{print-escape-newlines} are both non-@code{nil}, the latter takes
precedences for newlines and formfeeds.
@end defvar
@defvar print-escape-nonascii
If this variable is non-@code{nil}, then unibyte non-@acronym{ASCII}
characters in strings are unconditionally printed as backslash sequences

2
doc/lispref/strings.texi
View File

@ -727,7 +727,7 @@ minus sign if the argument is negative.
@result{} "-23.5"
@end example
@cindex int-to-string
@cindex @code{int-to-string}
@code{int-to-string} is a semi-obsolete alias for this function.
See also the function @code{format} in @ref{Formatting Strings}.

2
doc/lispref/text.texi
View File

@ -3862,7 +3862,7 @@ clicks on the link quickly without moving the mouse. This behavior is
controlled by the user option @code{mouse-1-click-follows-link}.
@xref{Mouse References,,, emacs, The GNU Emacs Manual}.
@cindex follow-link (text or overlay property)
@kindex follow-link @r{(text or overlay property)}
To set up the link so that it obeys
@code{mouse-1-click-follows-link}, you must either (1) apply a
@code{follow-link} text or overlay property to the link text, or (2)

66
doc/misc/calc.texi
View File

@ -9710,7 +9710,7 @@ The @kbd{C-x * x} command also turns the Calculator off, no matter which
user interface (standard, Keypad, or Embedded) is currently active.
It also cancels @code{calc-edit} mode if used from there.
@kindex d @key{SPC}
@kindex d SPC
@pindex calc-refresh
@cindex Refreshing a garbled display
@cindex Garbled displays, refreshing
@ -10268,7 +10268,7 @@ information is cleared whenever you give any command that adds new undo
information, i.e., if you undo, then enter a number on the stack or make
any other change, then it will be too late to redo.
@kindex M-@key{RET}
@kindex M-RET
@pindex calc-last-args
@cindex Last-arguments feature
@cindex Arguments, restoring
@ -10906,27 +10906,27 @@ degrees, minutes, and seconds.
@ignore
@mindex @null
@end ignore
@kindex ' (HMS forms)
@kindex ' @r{(HMS forms)}
@ignore
@mindex @null
@end ignore
@kindex " (HMS forms)
@kindex " @r{(HMS forms)}
@ignore
@mindex @null
@end ignore
@kindex h (HMS forms)
@kindex h @r{(HMS forms)}
@ignore
@mindex @null
@end ignore
@kindex o (HMS forms)
@kindex o @r{(HMS forms)}
@ignore
@mindex @null
@end ignore
@kindex m (HMS forms)
@kindex m @r{(HMS forms)}
@ignore
@mindex @null
@end ignore
@kindex s (HMS forms)
@kindex s @r{(HMS forms)}
The default format for HMS values is
@samp{@var{hours}@@ @var{mins}' @var{secs}"}. During entry, the letters
@samp{h} (for ``hours'') or
@ -11125,7 +11125,7 @@ integers but this is not required.
@ignore
@mindex M
@end ignore
@kindex M (modulo forms)
@kindex M @r{(modulo forms)}
@ignore
@mindex mod
@end ignore
@ -11280,7 +11280,7 @@ would indeed have been negligible.
@ignore
@mindex p
@end ignore
@kindex p (error forms)
@kindex p @r{(error forms)}
@tindex +/-
To enter an error form during regular numeric entry, use the @kbd{p}
(``plus-or-minus'') key to type the @samp{+/-} symbol. (If you try actually
@ -11732,8 +11732,8 @@ type, such as numbers, vectors, formulas, and incomplete objects.)
@section Stack Manipulation Commands
@noindent
@kindex @key{RET}
@kindex @key{SPC}
@kindex RET
@kindex SPC
@pindex calc-enter
@cindex Duplicating stack entries
To duplicate the top object on the stack, press @key{RET} or @key{SPC}
@ -11749,7 +11749,7 @@ For example, with @samp{10 20 30} on the stack,
@kbd{C-u - 2 @key{RET}} creates @samp{10 20 30 20}, and
@kbd{C-u 0 @key{RET}} creates @samp{10 20 30 10 20 30}.
@kindex @key{LFD}
@kindex LFD
@pindex calc-over
The @key{LFD} (@code{calc-over}) command (on a key marked Line-Feed if you
have it, else on @kbd{C-j}) is like @code{calc-enter}
@ -11759,7 +11759,7 @@ Thus with @samp{10 20 30} on the stack, @key{LFD} and @kbd{C-u 2 @key{LFD}}
are both equivalent to @kbd{C-u - 2 @key{RET}}, producing
@samp{10 20 30 20}.
@kindex @key{DEL}
@kindex DEL
@kindex C-d
@pindex calc-pop
@cindex Removing stack entries
@ -11777,7 +11777,7 @@ For example, with @samp{10 20 30} on the stack,
@kbd{C-u - 2 @key{DEL}} leaves @samp{10 30}, and
@kbd{C-u 0 @key{DEL}} leaves an empty stack.
@kindex M-@key{DEL}
@kindex M-DEL
@pindex calc-pop-above
The @kbd{M-@key{DEL}} (@code{calc-pop-above}) command is to @key{DEL} what
@key{LFD} is to @key{RET}: It interprets the sign of the numeric
@ -11798,7 +11798,7 @@ specified element of the stack regardless of the cursor position.
Similarly, @key{DEL} will remove the corresponding elements from the
stack.
@kindex @key{TAB}
@kindex TAB
@pindex calc-roll-down
To exchange the top two elements of the stack, press @key{TAB}
(@code{calc-roll-down}). Given a positive numeric prefix argument, the
@ -11812,7 +11812,7 @@ For example, with @samp{10 20 30 40 50} on the stack,
@kbd{C-u - 2 @key{TAB}} creates @samp{40 50 10 20 30}, and
@kbd{C-u 0 @key{TAB}} creates @samp{50 40 30 20 10}.
@kindex M-@key{TAB}
@kindex M-TAB
@pindex calc-roll-up
The command @kbd{M-@key{TAB}} (@code{calc-roll-up}) is analogous to @key{TAB}
except that it rotates upward instead of downward. Also, the default
@ -13075,7 +13075,7 @@ refresh the stack to leave the stack display alone. The word ``Dirty''
will appear in the mode line when Calc thinks the stack display may not
reflect the latest mode settings.
@kindex d @key{RET}
@kindex d RET
@pindex calc-refresh-top
The @kbd{d @key{RET}} (@code{calc-refresh-top}) command reformats the
top stack entry according to all the current modes. Positive prefix
@ -16682,8 +16682,8 @@ or matrix argument, these functions operate element-wise.
@ignore
@mindex v p
@end ignore
@kindex v p (complex)
@kindex V p (complex)
@kindex v p @r{(complex)}
@kindex V p @r{(complex)}
@pindex calc-pack
The @kbd{v p} (@code{calc-pack}) command can pack the top two numbers on
the stack into a composite object such as a complex number. With
@ -16694,8 +16694,8 @@ with an argument of @mathit{-2}, it produces a polar complex number.
@ignore
@mindex v u
@end ignore
@kindex v u (complex)
@kindex V u (complex)
@kindex v u @r{(complex)}
@kindex V u @r{(complex)}
@pindex calc-unpack
The @kbd{v u} (@code{calc-unpack}) command takes the complex number
(or other composite object) on the top of the stack and unpacks it
@ -20234,7 +20234,7 @@ the conjugate transpose of its argument, i.e., @samp{conj(trn(x))}.
@ignore
@mindex A
@end ignore
@kindex A (vectors)
@kindex A @r{(vectors)}
@pindex calc-abs (vectors)
@ignore
@mindex abs
@ -20280,7 +20280,7 @@ exactly three elements.
@ignore
@mindex &
@end ignore
@kindex & (matrices)
@kindex & @r{(matrices)}
@pindex calc-inv (matrices)
@ignore
@mindex inv
@ -21942,7 +21942,7 @@ If you select an element of a vector and press @key{DEL}, that
element is deleted from the vector. If you delete one side of
an equation or inequality, only the opposite side remains.
@kindex j @key{DEL}
@kindex j DEL
@pindex calc-del-selection
The @kbd{j @key{DEL}} (@code{calc-del-selection}) command is like
@key{DEL} but with the auto-selecting behavior of @kbd{j '} and
@ -21950,7 +21950,7 @@ The @kbd{j @key{DEL}} (@code{calc-del-selection}) command is like
indicated by the cursor, or, in the absence of a selection, it
deletes the sub-formula indicated by the cursor position.
@kindex j @key{RET}
@kindex j RET
@pindex calc-grab-selection
(There is also an auto-selecting @kbd{j @key{RET}} (@code{calc-copy-selection})
command.)
@ -35348,13 +35348,13 @@ followed by @kbd{=}, @kbd{&}, @kbd{#}, @kbd{\}, @kbd{/}, @kbd{+} or
@kbd{-} as well as @kbd{*} to start Calc, and so in many cases the last
character of the prefix can simply be typed twice.
Calc is controlled by many variables, most of which can be reset
from within Calc. Some variables are less involved with actual
calculation and can be set outside of Calc using Emacs's
customization facilities. These variables are listed below.
Typing @kbd{M-x customize-variable RET @var{variable-name} RET}
will bring up a buffer in which the variable's value can be redefined.
Typing @kbd{M-x customize-group RET calc RET} will bring up a buffer which
Calc is controlled by many variables, most of which can be reset from
within Calc. Some variables are less involved with actual calculation
and can be set outside of Calc using Emacs's customization facilities.
These variables are listed below. Typing @kbd{M-x customize-variable
@key{RET} @var{variable-name} @key{RET}} will bring up a buffer in
which the variable's value can be redefined. Typing @kbd{M-x
customize-group @key{RET} calc @key{RET}} will bring up a buffer which
contains all of Calc's customizable variables. (These variables can
also be reset by putting the appropriate lines in your .emacs file;
@xref{Init File, ,Init File, emacs, The GNU Emacs Manual}.)

40
doc/misc/cc-mode.texi
View File

@ -356,9 +356,9 @@ Customizing Macros
@cindex BOCM
@cindex history
@cindex awk-mode.el
@cindex c-mode.el
@cindex c++-mode.el
@cindex @file{awk-mode.el}
@cindex @file{c-mode.el}
@cindex @file{c++-mode.el}
Welcome to @ccmode{}, a GNU Emacs mode for editing files containing C,
C++, Objective-C, Java, CORBA IDL (and the variants CORBA PSDL and
@ -577,9 +577,9 @@ for the latest information on Emacs version and package compatibility
@deffn Command c-version
@findex version @r{(c-)}
You can find out what version of @ccmode{} you are using by visiting a C
file and entering @kbd{M-x c-version RET}. You should see this message in
the echo area:
You can find out what version of @ccmode{} you are using by visiting a
C file and entering @kbd{M-x c-version @key{RET}}. You should see
this message in the echo area:
@example
Using CC Mode version 5.XX
@ -920,8 +920,8 @@ must be in column zero. See @ref{Defuns,,,@emacsman{},
@item @kbd{C-M-a} (AWK Mode) (@code{c-awk-beginning-of-defun})
@itemx @kbd{C-M-e} (AWK Mode) (@code{c-awk-end-of-defun})
@kindex C-M-a (AWK Mode)
@kindex C-M-e (AWK Mode)
@kindex C-M-a @r{(AWK Mode)}
@kindex C-M-e @r{(AWK Mode)}
@findex c-awk-beginning-of-defun
@findex awk-beginning-of-defun @r{(c-)}
@findex c-awk-end-of-defun
@ -1521,7 +1521,7 @@ deletion.
@kindex DEL
@findex c-electric-backspace
@findex electric-backspace @r{(c-)}
This command is run by default when you hit the @kbd{DEL} key. When
This command is run by default when you hit the @kbd{@key{DEL}} key. When
hungry delete mode is enabled, it deletes any amount of whitespace in
the backwards direction. Otherwise, or when used with a prefix
argument or in a literal (@pxref{Auto-newlines}), the command just
@ -1567,8 +1567,8 @@ rather than using the minor mode toggling.
@table @asis
@item @kbd{C-c C-@key{DEL}}, or @kbd{C-c @key{DEL}} (@code{c-hungry-delete-backwards})@footnote{This command was formerly known as @code{c-hungry-backspace}.}
@kindex C-c C-<backspace>
@kindex C-c <backspace>
@kindex C-c C-Backspace
@kindex C-c Backspace
@kindex C-c C-DEL
@kindex C-c DEL
@findex c-hungry-delete-backwards
@ -1581,21 +1581,21 @@ a character terminal.
@item @kbd{C-c C-d}, @kbd{C-c C-@key{DELETE}}, or @kbd{C-c @key{DELETE}} (@code{c-hungry-delete-forward})
@kindex C-c C-d
@kindex C-c C-<DELETE>
@kindex C-c <DELETE>
@kindex C-c C-Delete
@kindex C-c Delete
@findex c-hungry-delete-forward
@findex hungry-delete-forward @r{(c-)}
Delete any amount of whitespace in the forward direction (regardless
whether hungry-delete mode is enabled or not). This command is bound
to both @kbd{C-c C-@key{DELETE}} and @kbd{C-c @key{DELETE}} for the
to both @kbd{C-c C-@key{Delete}} and @kbd{C-c @key{Delete}} for the
same reason as for @key{DEL} above.
@end table
@end table
@kindex <delete>
@kindex <backspace>
@kindex Delete
@kindex Backspace
When we talk about @kbd{@key{DEL}}, and @kbd{@key{DELETE}} above, we
When we talk about @kbd{@key{DEL}}, and @kbd{@key{Delete}} above, we
actually do so without connecting them to the physical keys commonly
known as @key{Backspace} and @key{Delete}. The default bindings to
those two keys depends on the flavor of (X)Emacs you are using.
@ -1708,7 +1708,7 @@ nomenclature and treat them as separate words:
@item @kbd{M-b} @tab @code{backward-word} @tab @code{c-backward-subword}
@item @kbd{M-@@} @tab @code{mark-word} @tab @code{c-mark-subword}
@item @kbd{M-d} @tab @code{kill-word} @tab @code{c-kill-subword}
@item @kbd{M-DEL} @tab @code{backward-kill-word} @tab @code{c-backward-kill-subword}
@item @kbd{M-@key{DEL}} @tab @code{backward-kill-word} @tab @code{c-backward-kill-subword}
@item @kbd{M-t} @tab @code{transpose-words} @tab @code{c-transpose-subwords}
@item @kbd{M-c} @tab @code{capitalize-word} @tab @code{c-capitalize-subword}
@item @kbd{M-u} @tab @code{upcase-word} @tab @code{c-upcase-subword}
@ -7250,13 +7250,13 @@ Set the variable @code{c-basic-offset}. @xref{Getting Started}.
@item
@kindex RET
@kindex C-j
@emph{Why does/doesn't the @kbd{RET} key indent the new line?}
@emph{Why does/doesn't the @kbd{@key{RET}} key indent the new line?}
Emacs's convention used to be that @kbd{RET} just adds a newline, and that
@kbd{C-j} adds a newline and indents it. In Emacs-24.4, this convention was
reversed.
If you use an older Emacs and you want @kbd{RET} do this
If you use an older Emacs and you want @kbd{@key{RET}} do this
too, add this to your @code{c-initialization-hook}:
@example

2
doc/misc/dired-x.texi
View File

@ -995,7 +995,7 @@ If there are several Dired buffers for a directory, the most recently
used is chosen.
Dired avoids switching to the current buffer, so that if you have a
normal and a wildcard buffer for the same directory, @kbd{C-x d RET}
normal and a wildcard buffer for the same directory, @kbd{C-x d @key{RET}}
will toggle between those two.
@end table

6
doc/misc/ebrowse.texi
View File

@ -482,7 +482,7 @@ you are working on, some classes will only be known to exist but the
location of their declarations and definitions will not be known.
@item @key{RET}
Works like @kbd{SPC}, except that it finds the class
Works like @kbd{@key{SPC}}, except that it finds the class
declaration rather than viewing it, so that it is ready for
editing.
@end table
@ -886,7 +886,7 @@ the member.
This command finds the declaration of the member the cursor is on.
@item @key{SPC}
This is the same command as @kbd{RET}, but views the member definition
This is the same command as @kbd{@key{RET}}, but views the member definition
instead of finding the member's source file.
@item v
@ -1314,7 +1314,7 @@ the next position stored in the position stack.
@item C-c C-m p
Displays an electric buffer showing all positions saved in the stack.
You can select a position by pressing @kbd{SPC} in a line. You can
You can select a position by pressing @kbd{@key{SPC}} in a line. You can
view a position with @kbd{v}.
@end table

32
doc/misc/ede.texi
View File

@ -160,8 +160,8 @@ First, lets create a directory for our project. For this example,
we'll start with something in @file{/tmp}.
@example
C-x C-f /tmp/myproject/README RET
M-x make-directory RET RET
C-x C-f /tmp/myproject/README @key{RET}
M-x make-directory @key{RET} @key{RET}
@end example
Now put some plain text in your README file to start.
@ -169,7 +169,7 @@ Now put some plain text in your README file to start.
Now, lets create the project:
@example
M-x ede-new RET Automake RET myproject RET
M-x ede-new @key{RET} Automake @key{RET} myproject @key{RET}
@end example
@ -191,8 +191,8 @@ We'll make a more complex project, so use dired to create some more
directories using the @kbd{+} key, and typing in new directories:
@example
+ include RET
+ src RET
+ include @key{RET}
+ src @key{RET}
@end example
Now I'll short-cut in this tutorial. Create the following files:
@ -252,13 +252,13 @@ now create those projects.
With @file{main.cpp} as your current buffer, type:
@example
M-x ede-new RET Automake RET src RET
M-x ede-new @key{RET} Automake @key{RET} src @key{RET}
@end example
and in @file{myproj.hh} as your current buffer, type:
@example
M-x ede-new RET Automake RET include RET
M-x ede-new @key{RET} Automake @key{RET} include @key{RET}
@end example
These steps effectively only create the Project.ede file in which you
@ -272,7 +272,7 @@ Projects. You can create targets either from a buffer, or from a
Note: If for some reason a directory list buffer, or file does not have the
@samp{Project} menu item, or if @ede{} keybindings don't work, just
use @kbd{M-x revert-buffer RET} to force a refresh. Sometimes
use @kbd{M-x revert-buffer @key{RET}} to force a refresh. Sometimes
creating a new project doesn't restart buffers correctly.
Lets start with the header file. In @file{include/myproj.hh}, you
@ -280,7 +280,7 @@ could use the menu, but we will now start using the @ede{} command prefix
which is @kbd{C-c .}.
@example
C-c . t includes RET miscellaneous RET y
C-c . t includes @key{RET} miscellaneous @key{RET} y
@end example
@ -292,7 +292,7 @@ Next, visit the @file{src} directory using dired. There should be a
@samp{Project} menu. You can create a new target with
@example
. t myprogram RET program RET
. t myprogram @key{RET} program @key{RET}
@end example
Note that @kbd{. t} is a command for creating a target. This command
@ -304,7 +304,7 @@ Next, place the cursor on @file{main.cpp}, and use @kbd{. a} to add
that file to your target.
@example
. a myprogram RET
. a myprogram @key{RET}
@end example
Note that these prompts often have completion, so you can just press
@ -316,8 +316,8 @@ all in your dired buffer, and add them all at the same time.
Next, do the same for the library by placing the cursor on @file{mylib.cpp}.
@example
. t mylib RET sharedobject RET
. a mylib RET
. t mylib @key{RET} sharedobject @key{RET}
. a mylib @key{RET}
@end example
@section Step 5: Compile, and fail
@ -350,7 +350,7 @@ To fix the failed compile, we need to add
Visit @file{main.cpp}.
@example
M-x customize-project RET
M-x customize-project @key{RET}
@end example
Select the @samp{[Settings]} subgroup of options. Under
@ -407,7 +407,7 @@ project. This is because variables such as the include path are
treated globally, whereas dependencies for a target are target specific.
@example
M-x customize-target RET
M-x customize-target @key{RET}
@end example
On the first page, you will see an Ldlibs-local section. Add mylib to
@ -437,7 +437,7 @@ C-c . C
You can run your program directly from @ede{}.
@example
C-c . R RET RET
C-c . R @key{RET} @key{RET}
@end example
If your program takes command line arguments, you can type them in

4
doc/misc/ediff.texi
View File

@ -541,12 +541,12 @@ Copies the difference region from buffer C to buffer B@.
The command @kbd{rb} undoes this.
@item p
@itemx DEL
@itemx @key{DEL}
@kindex p
@kindex DEL
Makes the previous difference region current.
@item n
@itemx SPC
@itemx @key{SPC}
@kindex n
@kindex SPC
Makes the next difference region current.

4
doc/misc/edt.texi
View File

@ -195,10 +195,10 @@ EDT Emulation. (Note: In a few rare circumstances this does not work
properly. In particular, it does not work if a subset of the leading
@acronym{ASCII} characters in a key sequence are recognized by Emacs as
having an existing binding. For example, if the keypad 7 (@key{KP7})
key generates the sequence @samp{<ESC>Ow} and @samp{<ESC>O} is already
key generates the sequence @samp{@key{ESC}Ow} and @samp{@key{ESC}O} is already
bound to a function, pressing @key{KP7} when told to do so by
@file{edt-mapper.el} will result in @file{edt-mapper.el} incorrectly
mapping @samp{<ESC>O} to @key{KP7} and @samp{w} to @key{KP8}. If
mapping @samp{@key{ESC}O} to @key{KP7} and @samp{w} to @key{KP8}. If
something like this happens to you, it is probably a bug in the support
for your keyboard within Emacs @strong{or} a bug in the Unix
termcap/terminfo support for your terminal @strong{or} a bug in the

12
doc/misc/efaq.texi
View File

@ -173,7 +173,7 @@ Key sequences longer than one key (and some single-key sequences) are
written inside quotes or on lines by themselves, like this:
@display
@kbd{M-x frobnicate-while-foo RET}
@kbd{M-x frobnicate-while-foo @key{RET}}
@end display
@noindent
@ -201,7 +201,7 @@ Also, on very few keyboards does @kbd{C-?} generate @acronym{ASCII} code 127.
@section What does @file{M-x @var{command}} mean?
@cindex Extended commands
@cindex Commands, extended
@cindex M-x, meaning of
@cindex @kbd{M-x}, meaning of
@kbd{M-x @var{command}} means type @kbd{M-x}, then type the name of the
command, then type @key{RET}. (@xref{Basic keys}, if you're not sure
@ -3808,9 +3808,9 @@ defines the @kbd{M-@key{TAB}} key sequence.
@node Backspace invokes help
@section Why does the @key{Backspace} key invoke help?
@cindex Backspace key invokes help
@cindex Help invoked by Backspace
@cindex DEL key does not delete
@cindex @key{Backspace} key invokes help
@cindex Help invoked by @key{Backspace}
@cindex @key{DEL} key does not delete
The @key{Backspace} key (on most keyboards) generates @acronym{ASCII} code 8.
@kbd{C-h} sends the same code. In Emacs by default @kbd{C-h} invokes
@ -4155,7 +4155,7 @@ This will disable the use of the extra keysyms systemwide, which may be
undesirable if you actually intend to use them.
@node SPC no longer completes file names
@section Why doesn't SPC complete file names anymore?
@section Why doesn't @key{SPC} complete file names anymore?
@cindex @kbd{SPC} file name completion
Starting with Emacs 22.1, @kbd{SPC} no longer completes file names in

6
doc/misc/eieio.texi
View File

@ -1263,13 +1263,13 @@ The @var{parent-instance} slot indicates the instance which is
considered the parent of the current instance. Default is @code{nil}.
@end deftp
@cindex clone
@cindex @code{clone}
To use this class, inherit from it with your own class.
To make a new instance that inherits from and existing instance of your
class, use the @code{clone} method with additional parameters
to specify local values.
@cindex slot-unbound
@cindex @code{slot-unbound}
The @code{eieio-instance-inheritor} class works by causing cloned
objects to have all slots unbound. This class' @code{slot-unbound}
method will cause references to unbound slots to be redirected to the
@ -1395,7 +1395,7 @@ with a minimum of effort.
@deftp {Class} eieio-speedbar buttontype buttonface
Enables base speedbar display for a class.
@cindex speedbar-make-tag-line
@cindex @code{speedbar-make-tag-line}
The slot @var{buttontype} is any of the symbols allowed by the
function @code{speedbar-make-tag-line} for the @var{exp-button-type}
argument @xref{Extending,,,speedbar}.

8
doc/misc/emacs-mime.texi
View File

@ -179,18 +179,18 @@ Emacs source code. This item works only in the groups matching
@code{mm-uu-emacs-sources-regexp}.
@item diff
@vindex diff
@findex diff
@vindex mm-uu-diff-groups-regexp
Patches. This is intended for groups where diffs of committed files
are automatically sent to. It only works in groups matching
@code{mm-uu-diff-groups-regexp}.
@item verbatim-marks
@cindex verbatim-marks
@findex verbatim-marks
Slrn-style verbatim marks.
@item LaTeX
@cindex LaTeX
@findex LaTeX
LaTeX documents. It only works in groups matching
@code{mm-uu-tex-groups-regexp}.
@ -1093,7 +1093,7 @@ If non-@code{nil} a format=flowed article will be displayed flowed.
@node Interface Functions
@chapter Interface Functions
@cindex interface functions
@cindex mail-parse
@cindex @code{mail-parse}
The @code{mail-parse} library is an abstraction over the actual
low-level libraries that are described in the next chapter.

24
doc/misc/epa.texi
View File

@ -281,22 +281,22 @@ The following keys are assigned.
@table @kbd
@item : d
@kindex @kbd{: d}
@kindex : d
@findex epa-dired-do-decrypt
Decrypt marked files.
@item : v
@kindex @kbd{: v}
@kindex : v
@findex epa-dired-do-verify
Verify marked files.
@item : s
@kindex @kbd{: s}
@kindex : s
@findex epa-dired-do-sign
Sign marked files.
@item : e
@kindex @kbd{: e}
@kindex : e
@findex epa-dired-do-encrypt
Encrypt marked files.
@ -322,26 +322,26 @@ interface. Try @kbd{M-x customize-variable epa-global-mail-mode}.
@table @kbd
@item C-c C-e C-d and C-c C-e d
@kindex @kbd{C-c C-e C-d}
@kindex @kbd{C-c C-e d}
@kindex C-c C-e C-d
@kindex C-c C-e d
@findex epa-mail-decrypt
Decrypt OpenPGP armors in the current buffer.
@item C-c C-e C-v and C-c C-e v
@kindex @kbd{C-c C-e C-v}
@kindex @kbd{C-c C-e v}
@kindex C-c C-e C-v
@kindex C-c C-e v
@findex epa-mail-verify
Verify OpenPGP cleartext signed messages in the current buffer.
@item C-c C-e C-s and C-c C-e s
@kindex @kbd{C-c C-e C-s}
@kindex @kbd{C-c C-e s}
@kindex C-c C-e C-s
@kindex C-c C-e s
@findex epa-mail-sign
Compose a signed message from the current buffer.
@item C-c C-e C-e and C-c C-e e
@kindex @kbd{C-c C-e C-e}
@kindex @kbd{C-c C-e e}
@kindex C-c C-e C-e
@kindex C-c C-e e
@findex epa-mail-encrypt
@vindex epa-mail-aliases
Compose an encrypted message from the current buffer.

24
doc/misc/erc.texi
View File

@ -117,10 +117,11 @@ connect to.
If you want to place ERC settings in their own file, you can place them
in @file{~/.emacs.d/.ercrc.el}, creating it if necessary.
If you would rather use the Customize interface to change how ERC works,
do @kbd{M-x customize-group RET erc RET}. In particular, ERC comes with
lots of modules that may be enabled or disabled; to select which ones
you want, do @kbd{M-x customize-variable RET erc-modules RET}.
If you would rather use the Customize interface to change how ERC
works, do @kbd{M-x customize-group @key{RET} erc @key{RET}}. In
particular, ERC comes with lots of modules that may be enabled or
disabled; to select which ones you want, do @kbd{M-x
customize-variable @key{RET} erc-modules @key{RET}}.
@menu
* Sample Session:: Example of connecting to the #emacs channel
@ -269,14 +270,14 @@ This is a summary of keystrokes available in every ERC buffer.
@item C-a or <home> (@code{erc-bol})
Go to beginning of line or end of prompt.
@item RET (@code{erc-send-current-line})
@item @key{RET} (@code{erc-send-current-line})
Send the current line
@item TAB (@code{erc-complete-word})
@item @key{TAB} (@code{erc-complete-word})
If at prompt, complete the current word.
Otherwise, move to the next link or button.
@item M-TAB (@code{ispell-complete-word})
@item M-@key{TAB} (@code{ispell-complete-word})
Complete the given word, using ispell.
@item C-c C-a (@code{erc-bol})
@ -297,7 +298,7 @@ Toggle automatic CTCP replies (like VERSION and PING).
@item C-c C-f (@code{erc-toggle-flood-control})
Toggle use of flood control on sent messages.
@item C-c TAB (@code{erc-invite-only-mode})
@item C-c @key{TAB} (@code{erc-invite-only-mode})
Turn on the invite only mode (+i) for the current channel.
@item C-c C-j (@code{erc-join-channel})
@ -349,8 +350,9 @@ One way to add functionality to ERC is to customize which of its many
modules are loaded.
There is a spiffy customize interface, which may be reached by typing
@kbd{M-x customize-option erc-modules RET}. Alternatively, set
@code{erc-modules} manually and then call @code{erc-update-modules}.
@kbd{M-x customize-option @key{RET} erc-modules @key{RET}}.
Alternatively, set @code{erc-modules} manually and then call
@code{erc-update-modules}.
The following is a list of available modules.
@ -743,7 +745,7 @@ stuff, to the current ERC buffer."
This section is extremely incomplete. For now, the easiest way to
check out all the available options for ERC is to do
@kbd{M-x customize-group erc RET}.
@kbd{M-x customize-group @key{RET} erc @key{RET}}.
@defopt erc-hide-list
If non, @code{nil}, this is a list of IRC message types to hide, e.g.:

10
doc/misc/ert.texi
View File

@ -203,7 +203,7 @@ different Emacs versions.
@findex ert
You can run the tests that are currently defined in your Emacs with
the command @kbd{@kbd{M-x} ert @kbd{RET} t @kbd{RET}}. (For an
the command @kbd{M-x ert @key{RET} t @key{RET}}. (For an
explanation of the @code{t} argument, @pxref{Test Selectors}.) ERT will pop
up a new buffer, the ERT results buffer, showing the results of the
tests run. It looks like this:
@ -262,9 +262,9 @@ for more details.
@kindex TAB@r{, in ert results buffer}
@kindex S-TAB@r{, in ert results buffer}
In the ERT results buffer, @kbd{TAB} and @kbd{S-TAB} cycle between
In the ERT results buffer, @kbd{@key{TAB}} and @kbd{S-@key{TAB}} cycle between
buttons. Each name of a function or macro in this buffer is a button;
moving point to it and typing @kbd{RET} jumps to its definition.
moving point to it and typing @kbd{@key{RET}} jumps to its definition.
@kindex r@r{, in ert results buffer}
@kindex d@r{, in ert results buffer}
@ -273,7 +273,7 @@ moving point to it and typing @kbd{RET} jumps to its definition.
@cindex backtrace of a failed test
Pressing @kbd{r} re-runs the test near point on its own. Pressing
@kbd{d} re-runs it with the debugger enabled. @kbd{.} jumps to the
definition of the test near point (@kbd{RET} has the same effect if
definition of the test near point (@kbd{@key{RET}} has the same effect if
point is on the name of the test). On a failed test, @kbd{b} shows
the backtrace of the failure.
@ -817,7 +817,7 @@ failed. This can be useful to figure out how far it got.
@item
You can instrument tests for debugging the same way you instrument
@code{defun}s for debugging: go to the source code of the test and
type @kbd{@kbd{C-u} @kbd{C-M-x}}. Then, go back to the ERT buffer and
type @kbd{C-u C-M-x}. Then, go back to the ERT buffer and
re-run the test with @kbd{r} or @kbd{d}.
@cindex discard obsolete test results

18
doc/misc/eshell.texi
View File

@ -894,7 +894,7 @@ will happen as it should (albeit slowly).
@item Make sure syntax table is correct in Eshell mode
So that @kbd{M-DEL} acts in a predictable manner, etc.
So that @kbd{M-@key{DEL}} acts in a predictable manner, etc.
@item Allow all Eshell buffers to share the same history and list-dir
@ -908,19 +908,19 @@ output from all subsequent commands is swallowed.
Make it similar to the way that @file{esh-arg.el} is structured.
Then add parsing of @samp{$[?\n]}.
@item After pressing @kbd{M-RET}, redisplay before running the next command
@item After pressing @kbd{M-@key{RET}}, redisplay before running the next command
@item Argument predicates and modifiers should work anywhere in a path
@example
/usr/local/src/editors/vim $ vi **/CVS(/)/Root(.)
Invalid regexp: "Unmatched ( or \\("
/usr/local/src/editors/vim $ vi **/CVS(/)/Root(.) Invalid regexp:
"Unmatched ( or \\("
@end example
With @command{zsh}, the glob above expands to all files named
@file{Root} in directories named @file{CVS}.
@item Typing @samp{echo $@{locate locate@}/bin<TAB>} results in a Lisp error
@item Typing @samp{echo $@{locate locate@}/bin@key{TAB}} results in a Lisp error
Perhaps it should interpolate all permutations, and make that the
globbing result, since otherwise hitting return here will result in
@ -960,7 +960,7 @@ At the moment, this is not supported.
An error should be generated only if @code{eshell-error-if-no-glob} is
non-@code{nil}.
@item @samp{(+ RET SPC TAB} does not cause @code{indent-according-to-mode} to occur
@item @samp{(+ @key{RET} @key{SPC} @key{TAB}} does not cause @code{indent-according-to-mode} to occur
@item Create @code{eshell-auto-accumulate-list}
@ -1172,8 +1172,8 @@ only. That way, it could be listed as a login shell.
@item Make @kbd{/} electric
So that it automatically expands and corrects pathnames. Or make
pathname completion for Pcomplete auto-expand @samp{/u/i/std<TAB>} to
@samp{/usr/include/std<TAB>}.
pathname completion for Pcomplete auto-expand @samp{/u/i/std@key{TAB}} to
@samp{/usr/include/std@key{TAB}}.
@item Write the @command{pushd} stack to disk along with @code{last-dir-ring}
@ -1221,7 +1221,7 @@ If the first thing that I do after entering Emacs is to run
@code{eshell-command} and invoke @command{ls}, and then use @kbd{M-x
eshell}, it doesn't display anything.
@item @kbd{M-RET} during a long command (using smart display) doesn't work
@item @kbd{M-@key{RET}} during a long command (using smart display) doesn't work
Since it keeps the cursor up where the command was invoked.

2
doc/misc/eww.texi
View File

@ -99,7 +99,7 @@ web page hit @kbd{g} (@code{eww-reload}). Pressing @kbd{w}
@findex eww-open-in-new-buffer
@kindex M-RET
The @kbd{M-RET} command (@code{eww-open-in-new-buffer}) opens the
The @kbd{M-@key{RET}} command (@code{eww-open-in-new-buffer}) opens the
URL at point in a new EWW buffer, akin to opening a link in a new
``tab'' in other browsers.

24
doc/misc/forms.texi
View File

@ -263,14 +263,14 @@ prompted for confirmation before the record is deleted unless a numeric
argument has been provided.
@findex forms-search-forward
@kindex C-c C-s @var{regexp} @key{RET}
@kindex C-c C-s @var{regexp} RET
@item C-c C-s @var{regexp} @key{RET}
Search forward for @var{regexp} in all records following this one
(@code{forms-search-forward}). If found, this record is shown.
If you give an empty argument, the previous regexp is used again.
@findex forms-search-backward
@kindex C-c C-r @var{regexp} @key{RET}
@kindex C-c C-r @var{regexp} RET
@item C-c C-r @var{regexp} @key{RET}
Search backward for @var{regexp} in all records following this one
(@code{forms-search-backward}). If found, this record is shown.
@ -334,25 +334,25 @@ The following function key definitions are set up in Forms mode
(whether read-only or not):
@table @kbd
@kindex next
@item next
@kindex NEXT
@item @key{NEXT}
forms-next-record
@kindex prior
@item prior
@kindex PRIOR
@item @key{PRIOR}
forms-prev-record
@kindex begin
@item begin
@kindex BEGIN
@item @key{BEGIN}
forms-first-record
@kindex end
@item end
@kindex END
@item @key{END}
forms-last-record
@kindex S-Tab
@kindex S-TAB
@findex forms-prev-field
@item S-Tab
@item S-@key{TAB}
forms-prev-field
@end table

36
doc/misc/gnus-faq.texi
View File

@ -397,7 +397,7 @@ The ~/ means the home directory where Gnus and Emacs look
for the configuration files. However, you don't really
need to know what this means, it suffices that Emacs knows
what it means :-) You can type
@samp{C-x C-f ~/.gnus.el RET }
@samp{C-x C-f ~/.gnus.el @key{RET}}
(yes, with the forward slash, even on Windows), and
Emacs will open the right file for you. (It will most
likely be new, and thus empty.)
@ -422,7 +422,7 @@ possibility to set environment variables. Create a new one with
name HOME and value C:\myhome. Rebooting is not necessary.
Now to create @file{~/.gnus.el}, say
@samp{C-x C-f ~/.gnus.el RET C-x C-s}.
@samp{C-x C-f ~/.gnus.el @key{RET} C-x C-s}.
in Emacs.
@node FAQ 3-3
@ -459,11 +459,11 @@ subscribe to a group.
@subsubheading Answer
If you know the name of the group say @samp{U
name.of.group RET} in group buffer (use the
name.of.group @key{RET}} in group buffer (use the
tab-completion Luke). Otherwise hit ^ in group buffer,
this brings you to the server buffer. Now place point (the
cursor) over the server which carries the group you want,
hit @samp{RET}, move point to the group
hit @samp{@key{RET}}, move point to the group
you want to subscribe to and say @samp{u}
to subscribe to it.
@ -753,11 +753,11 @@ When I enter a group, all read messages are gone. How to view them again?
@subsubheading Answer
If you enter the group by saying
@samp{RET}
@samp{@key{RET}}
in group buffer with point over the group, only unread and ticked messages are loaded. Say
@samp{C-u RET}
@samp{C-u @key{RET}}
instead to load all available messages. If you want only the 300 newest say
@samp{C-u 300 RET}
@samp{C-u 300 @key{RET}}
Loading only unread messages can be annoying if you have threaded view enabled, say
@ -1019,7 +1019,7 @@ back ends. Gnus thinks ``highest-article-number @minus{}
lowest-article-number = total-number-of-articles''. This
works OK for Usenet groups, but if you delete and move
many messages in mail groups, this fails. To cure the
symptom, enter the group via @samp{C-u RET}
symptom, enter the group via @samp{C-u @key{RET}}
(this makes Gnus get all messages), then
hit @samp{M P b} to mark all messages and
then say @samp{B m name.of.group} to move
@ -1494,8 +1494,8 @@ place them in ~/.emacs:
@end example
@noindent
Now you should be ready to go. Say @samp{M-x bbdb RET
RET} to open a bbdb buffer showing all
Now you should be ready to go. Say @samp{M-x bbdb @key{RET}
@key{RET}} to open a bbdb buffer showing all
entries. Say @samp{c} to create a new
entry, @samp{b} to search your BBDB and
@samp{C-o} to add a new field to an
@ -1734,15 +1734,15 @@ world, you may find tools at
Now you've got to import this mbox file into Gnus. To do
this, create a nndoc group based on the mbox file by
saying @samp{G f /path/file.mbox RET} in
saying @samp{G f /path/file.mbox @key{RET}} in
Group buffer. You now have read-only access to your
mail. If you want to import the messages to your normal
Gnus mail groups hierarchy, enter the nndoc group you've
just created by saying @samp{C-u RET}
just created by saying @samp{C-u @key{RET}}
(thus making sure all messages are retrieved), mark all
messages by saying @samp{M P b} and
either copy them to the desired group by saying
@samp{B c name.of.group RET} or send them
@samp{B c name.of.group @key{RET}} or send them
through nnmail-split-methods (respool them) by saying
@samp{B r}.
@ -1809,7 +1809,7 @@ a Usenet group the easiest solution is probably to ask
@uref{http://groups.google.com, groups.google.com},
if you found the posting there, tell Google to display
the raw message, look for the message-id, and say
@samp{M-^ the@@message.id RET} in a
@samp{M-^ the@@message.id @key{RET}} in a
summary buffer.
Since Gnus 5.10 there's also a Gnus interface for
groups.google.com which you can call with
@ -1853,7 +1853,7 @@ How to get rid of old unwanted mail?
You can of course just mark the mail you don't need
anymore by saying @samp{#} with point
over the mail and then say @samp{B DEL}
over the mail and then say @samp{B @key{DEL}}
to get rid of them forever. You could also instead of
actually deleting them, send them to a junk-group by
saying @samp{B m nnml:trash-bin} which
@ -2089,7 +2089,7 @@ How to find information and help inside Emacs?
@subsubheading Answer
The first stop should be the Gnus manual (Say
@samp{C-h i d m Gnus RET} to start the
@samp{C-h i d m Gnus @key{RET}} to start the
Gnus manual, then walk through the menus or do a
full-text search with @samp{s}). Then
there are the general Emacs help commands starting with
@ -2191,8 +2191,8 @@ The reason for this could be the way Gnus reads its
active file, see the node "The Active File" in the Gnus
manual for things you might try to speed the process up.
An other idea would be to byte compile your @file{~/.gnus.el} (say
@samp{M-x byte-compile-file RET ~/.gnus.el
RET} to do it). Finally, if you have require
@samp{M-x byte-compile-file @key{RET} ~/.gnus.el
@key{RET}} to do it). Finally, if you have require
statements in your .gnus, you could replace them with
@code{with-eval-after-load}, which loads the stuff not at startup
time, but when it's needed. Say you've got this in your

2
doc/misc/gnus-news.texi
View File

@ -324,7 +324,7 @@ messages are deleted again).
@itemize @bullet
@item The tool bar has been updated to use GNOME icons.
You can also customize the tool bars: @kbd{M-x customize-apropos RET
You can also customize the tool bars: @kbd{M-x customize-apropos @key{RET}
-tool-bar$} should get you started. (Only for Emacs, not in XEmacs.)
@c FIXME: Document this in the manual

1551
doc/misc/gnus.texi
View File

File diff suppressed because it is too large Load Diff

6
doc/misc/htmlfontify.texi
View File

@ -1116,7 +1116,7 @@ Some of the (informal) data structures used in Htmlfontify are detailed here:
@table @code
@item hfy-style-assoc
@cindex hfy-style-assoc
@cindex @code{hfy-style-assoc}
@anchor{hfy-style-assoc}
An assoc representing/describing an Emacs face. Properties may be repeated,
@ -1148,7 +1148,7 @@ Some examples:
@end lisp
@item hfy-sheet-assoc
@cindex hfy-sheet-assoc
@cindex @code{hfy-sheet-assoc}
@anchor{hfy-sheet-assoc}
An assoc with elements of the form @samp{(face-name style-name . style-string)}.
@ -1160,7 +1160,7 @@ The actual stylesheet for each page is derived from one of these.
@end lisp
@item hfy-facemap-assoc
@cindex hfy-facemap-assoc
@cindex @code{hfy-facemap-assoc}
@anchor{hfy-facemap-assoc}
An assoc of @code{(point . @var{face-symbol})} or

8
doc/misc/idlwave.texi
View File

@ -172,7 +172,7 @@ Catalogs
@cindex CORBA (Common Object Request Broker Architecture)
@cindex Interface Definition Language
@cindex Interactive Data Language
@cindex cc-mode.el
@cindex @file{cc-mode.el}
@cindex @file{idl.el}
@cindex @file{idl-shell.el}
@cindex Feature overview
@ -935,7 +935,7 @@ IDL code.
@cindex String splitting
@cindex Splitting, of lines
@kindex M-@key{RET}
@kindex M-RET
In IDL, a newline character terminates a statement unless preceded by a
@samp{$}. If you would like to start a continuation line, use
@kbd{M-@key{RET}}, which calls the command @code{idlwave-split-line}.
@ -1523,7 +1523,7 @@ The case-insensitive heading word in doclib headers to locate the
@cindex Function name completion
@cindex Procedure name completion
@kindex M-@key{TAB}
@kindex M-TAB
@kindex C-c C-i
IDLWAVE offers completion for class names, routine names, keywords,
system variables, system variable tags, class structure tags, regular
@ -4064,7 +4064,7 @@ sure you check the following things:
@itemize @bullet
@item When you download the IDLWAVE distribution, make sure you save the
file under the names @file{idlwave.tar.gz}.
@item M-TAB switches among running programs---use Esc-TAB
@item M-@key{TAB} switches among running programs---use @key{ESC}-@key{TAB}
instead.
@item Other issues as yet unnamed...
@end itemize

4
doc/misc/ido.texi
View File

@ -456,14 +456,14 @@ You can toggle display of the hidden buffers and files with @kbd{C-a}
You can customize the @code{ido} group to change Ido functionality:
@example
M-x customize-group RET ido RET
M-x customize-group @key{RET} ido @key{RET}
@end example
@noindent
or customize a certain variable:
@example
M-x customize-variable RET ido-xxxxx
M-x customize-variable @key{RET} ido-xxxxx @key{RET}
@end example
To modify the keybindings, use the @code{ido-setup-hook}. For example:

24
doc/misc/mairix-el.texi
View File

@ -169,13 +169,13 @@ the updates incrementally and hence is very fast.
First, put @code{mairix.el} in your Emacs search path and put
@code{(require 'mairix)} into your @file{.emacs} file. Then, use
@kbd{M-x customize-group mairix RET} to set your preferences for
mairix.el. The most important items are @emph{Mairix File Path},
@emph{Mairix Search File} and @emph{Mairix Mail Program}. The latter
specifies which mail program should be used to display the mairix search
results. Currently, RMail, Gnus with mbox files, and VM are supported.
If you use Gnus with maildir or mh, use the native Gnus back end
nnmairix instead.
@kbd{M-x customize-group @key{RET} mairix @key{RET}} to set your
preferences for mairix.el. The most important items are @emph{Mairix
File Path}, @emph{Mairix Search File} and @emph{Mairix Mail Program}.
The latter specifies which mail program should be used to display the
mairix search results. Currently, RMail, Gnus with mbox files, and VM
are supported. If you use Gnus with maildir or mh, use the native
Gnus back end nnmairix instead.
If you use another Emacs mail program which is not yet supported by
mairix.el, it is pretty easy to integrate it. @xref{Extending},
@ -213,7 +213,6 @@ Here's a description of the available interactive functions:
@table @code
@item mairix-search
@kindex M-x mairix-search
@findex mairix-search
@vindex mairix-search-file
@vindex mairix-file-path
@ -229,7 +228,6 @@ is specified by the variable @code{mairix-command}, together with the options
for making searching faster.
@item mairix-widget-search
@kindex M-x mairix-widget-search
@findex mairix-widget-search
@vindex mairix-widget-fields-list
Creates a mairix query using graphical widgets. Very handy if you're
@ -241,28 +239,24 @@ might want to include some other fields. This can be easily done by
modifying @code{mairix-widget-fields-list}.
@item mairix-widget-search-based-on-article
@kindex M-x mairix-widget-search-based-on-article
@findex mairix-widget-search-based-on-article
Create a mairix query using graphical widgets, but based on the
currently displayed article, i.e., the available fields will be filled
with the current header values.
@item mairix-search-from-this-article
@kindex M-x mairix-search-from-this-article
@findex mairix-search-from-this-article
Search messages from sender of the current article. This is effectively
a shortcut for calling @code{mairix-search} with @code{f:current_from}.
If used with a prefix, include whole threads of the found messages.
@item mairix-search-thread-this-article
@kindex M-x mairix-search-thread-this-article
@findex mairix-search-thread-this-article
Search thread for the current article. This is effectively a shortcut
for calling @code{mairix-search} with @code{m:msgid} of the current article and
enabled threads.
@item mairix-save-search
@kindex M-x mairix-save-search
@findex mairix-save-search
Save the last search for future use. You will have to specify a name
for the search and will then be asked if you want to save your saved
@ -272,13 +266,11 @@ your @file{.emacs}. You can also do this later by using
@code{mairix-edit-saved-searches}.
@item mairix-use-saved-search
@kindex M-x mairix-use-saved-search
@findex mairix-use-saved-search
Call mairix with a previously saved search. You will be asked for the
name of the saved search (use @kbd{TAB} for completion).
@item mairix-edit-saved-searches
@kindex M-x mairix-edit-saved-searches
@findex mairix-edit-saved-searches
Edit your current mairix searches. This is a simple major mode for
editing the contents of the variable @code{mairix-saved-searches}. You
@ -290,14 +282,12 @@ to open different searches at the same time, or if you want to regularly
access certain searches without the need to call mairix.
@item mairix-edit-saved-searches-customize
@kindex M-x mairix-edit-saved-searches-customize
@findex mairix-edit-saved-searches-customize
Edit the variable @code{mairix-saved-searches} in a normal customization
buffer. This function exists more or less for historic reasons, but
maybe you like it.
@item mairix-update-database
@kindex M-x mairix-update-database
@findex mairix-update-database
@vindex mairix-update-options
@vindex mairix-synchronous-update

20
doc/misc/message.texi
View File

@ -104,7 +104,7 @@ sending it.
@end menu
You can customize the Message Mode tool bar, see @kbd{M-x
customize-apropos RET message-tool-bar}. This feature is only available
customize-apropos @key{RET} message-tool-bar}. This feature is only available
in Emacs.
@node New Mail Message
@ -707,14 +707,12 @@ This means that if the recipient supports RFC 2298 she might send you a
notification that she received the message.
@item M-x message-insert-importance-high
@kindex M-x message-insert-importance-high
@findex message-insert-importance-high
@cindex Importance
Insert an @samp{Importance} header with a value of @samp{high},
deleting headers if necessary.
@item M-x message-insert-importance-low
@kindex M-x message-insert-importance-low
@findex message-insert-importance-low
@cindex Importance
Insert an @samp{Importance} header with a value of @samp{low}, deleting
@ -921,7 +919,7 @@ is fully available) @acronym{IDNA} encoding happens automatically.
@findex message-idna-to-ascii-rhs
If you want to experiment with the @acronym{IDNA} encoding, you can
invoke @kbd{M-x message-idna-to-ascii-rhs RET} in the message buffer
invoke @kbd{M-x message-idna-to-ascii-rhs @key{RET}} in the message buffer
to have the non-@acronym{ASCII} domain names encoded while you edit
the message.
@ -1084,7 +1082,7 @@ Since signing and especially encryption often is used when sensitive
information is sent, you may want to have some way to ensure that your
mail is actually signed or encrypted. After invoking the above
sign/encrypt commands, it is possible to preview the raw article by
using @kbd{C-u C-c RET P} (@code{mml-preview}). Then you can
using @kbd{C-u C-c @key{RET} P} (@code{mml-preview}). Then you can
verify that your long rant about what your ex-significant other or
whomever actually did with that funny looking person at that strange
party the other night, actually will be sent encrypted.
@ -1176,7 +1174,7 @@ without some kind of configuration. Especially, you need to tell it
where your private key and your certificate is stored. @acronym{MML}
uses an Emacs interface to OpenSSL, aptly named @code{smime.el}, and it
contain a @code{custom} group used for this configuration. So, try
@kbd{M-x customize-group RET smime RET} and look around.
@kbd{M-x customize-group @key{RET} smime @key{RET}} and look around.
Currently there is no support for talking to a CA (or RA) to create
your own certificate. None is planned either. You need to do this
@ -1222,7 +1220,7 @@ according to two different standards, namely @acronym{PGP} or
@node Passphrase caching
@subsection Passphrase caching
@cindex gpg-agent
@cindex @command{gpg-agent}
Message with EasyPG internally calls GnuPG (the @command{gpg} or
@command{gpgsm} command) to perform
data encryption, and in certain cases (decrypting or signing for
@ -1379,7 +1377,7 @@ end of the message (@code{message-kill-to-signature}).
Delete all text in the body of the message that is outside the region
(@code{message-delete-not-region}).
@item M-RET
@item M-@key{RET}
@kindex M-RET
@findex message-newline-and-reformat
Insert four newlines, and then reformat if inside quoted text.
@ -1390,7 +1388,7 @@ Here's an example:
> This is some quoted text. And here's more quoted text.
@end example
If point is before @samp{And} and you press @kbd{M-RET}, you'll get:
If point is before @samp{And} and you press @kbd{M-@key{RET}}, you'll get:
@example
> This is some quoted text.
@ -1408,12 +1406,12 @@ If point is before @samp{And} and you press @kbd{M-RET}, you'll get:
Rename the buffer (@code{message-rename-buffer}). If given a prefix,
prompt for a new buffer name.
@item TAB
@item @key{TAB}
@kindex TAB
@findex message-tab
@vindex message-tab-body-function
If @code{message-tab-body-function} is non-@code{nil}, execute the
function it specifies. Otherwise use the function bound to @kbd{TAB} in
function it specifies. Otherwise use the function bound to @key{TAB} in
@code{text-mode-map} or @code{global-map}.
@end table

164
doc/misc/mh-e.texi
View File

@ -442,7 +442,7 @@ either @code{customize-option} or @code{add-hook}.
@cindex point
@cindex region
@kindex C-@@
@kindex C-@key{SPC}
@kindex C-SPC
There are several other terms that are used in Emacs that you should
know. The @dfn{point} is where the cursor currently is. You can save
@ -692,7 +692,6 @@ get the big picture, and then you can read the manual as you wish.
@cindex modes, MH-Letter
@cindex sending mail
@findex mh-smail
@kindex M-x mh-smail
Let's start our tour by sending ourselves a message which we can later
read and process. Enter @kbd{M-x mh-smail} to invoke the MH-E program
@ -762,7 +761,6 @@ message. Type @kbd{C-c C-c} now. That's all there is to it!
@cindex modes, MH-Folder
@cindex reading mail
@findex mh-rmail
@kindex M-x mh-rmail
To read the mail you've just sent yourself, enter @kbd{M-x mh-rmail}.
This incorporates the new mail and puts the output from
@ -777,7 +775,6 @@ major mode is MH-Folder.
@findex mh-rmail
@kindex F r
@kindex M-x mh-rmail
@sp 1
@center @strong{NOTE}
@ -790,7 +787,7 @@ use @kbd{F r} to pull all your messages into MH-E.
@end quotation
@sp 1
@kindex @key{RET}
@kindex RET
@kindex n
@kindex p
@ -820,8 +817,8 @@ This is a test message to get the wheels churning...
@end cartouche
@i{After incorporating new messages}
@kindex @key{DEL}
@kindex @key{SPC}
@kindex DEL
@kindex SPC
If you typed a long message, you can view subsequent pages with
@key{SPC} and previous pages with @key{DEL}.
@ -830,7 +827,7 @@ If you typed a long message, you can view subsequent pages with
@section Processing Mail
@cindex processing mail
@kindex @key{RET}
@kindex RET
@kindex r
The first thing we want to do is reply to the message that we sent
@ -883,7 +880,7 @@ Type C-c C-c to send message, C-c ? for help
@kindex C-f
@kindex C-n
@kindex C-p
@kindex @key{BS}
@kindex BS
By default, MH will not add you to the address list of your replies,
so if you find that the @samp{To:} header field is missing, don't
@ -898,7 +895,7 @@ editing your message, send it with @kbd{C-c C-c} as before.
@cindex @command{refile}
@cindex MH commands, @command{refile}
@cindex folders
@kindex @key{SPC}
@kindex SPC
@kindex o
You'll often want to save messages that were sent to you in an
@ -918,7 +915,7 @@ in a moment.
@cindex modes, MH-Folder
@kindex d
@kindex i
@kindex @key{RET}
@kindex RET
@kindex n
@kindex p
@kindex x
@ -935,7 +932,6 @@ command.
@findex mh-smail
@kindex m
@kindex M-x mh-smail
If you want to send another message you can use @kbd{m} instead of
@kbd{M-x mh-smail}. So go ahead, send some mail to your friends!
@ -970,7 +966,6 @@ perform any refiles and deletes that you did there.
@findex mh-rmail
@kindex C-x b
@kindex C-x k
@kindex M-x mh-rmail
@kindex q
If you don't want to leave Emacs, you can type @kbd{q} to bury (hide)
@ -1228,7 +1223,7 @@ Many commands that operate on individual messages, such as
@code{mh-forward} or @code{mh-refile-msg} take a @code{RANGE}
argument. This argument can be used in several ways.
@kindex C-u, with ranges
@kindex C-u@r{, with ranges}
If you provide the prefix argument @kbd{C-u} to these commands, then
you will be prompted for the message range. This can be any valid MH
@ -1552,7 +1547,6 @@ the message numbers from outside of MH-E.
@findex mh-rmail
@kindex F r
@kindex F v
@kindex M-x mh-rmail
The MH-E entry point for reading mail is @kbd{M-x mh-rmail}. This
command incorporates your mail and creates a buffer called
@ -1592,38 +1586,38 @@ Display cheat sheet for the MH-E commands (@code{mh-help}).
@c -------------------------
@cindex @samp{Message > Show Message} menu item
@cindex menu item, @samp{Message > Show Message}
@kindex @key{RET}
@kindex RET
@findex mh-show
@item @key{RET}
Display message (@code{mh-show}).
@c -------------------------
@cindex @samp{Message > Show Message with Header} menu item
@cindex menu item, @samp{Message > Show Message with Header}
@kindex , (comma)
@kindex , @r{(comma)}
@findex mh-header-display
@item , (comma)
Display message with all header fields (@code{mh-header-display}).
@c -------------------------
@cindex @samp{Message > Show Message with Preferred Alternative} menu item
@cindex menu item, @samp{Message > Show Message with Preferred Alternative}
@kindex : (colon)
@kindex : @r{(colon)}
@findex mh-show-preferred-alternative
@item : (colon)
Display message with the default preferred alternative
(@code{mh-show-preferred-alternative}).
@c -------------------------
@kindex ; (semicolon)
@kindex ; @r{(semicolon)}
@findex mh-toggle-mh-decode-mime-flag
@item ; (semicolon)
Toggle the value of @code{mh-decode-mime-flag}
(@code{mh-toggle-mh-decode-mime-flag}).
@c -------------------------
@kindex @key{SPC}
@kindex SPC
@findex mh-page-msg
@item @key{SPC}
Display next page in message (@code{mh-page-msg}).
@c -------------------------
@kindex @key{BS}
@kindex BS
@findex mh-previous-page
@item @key{BS}
Display previous page in message (@code{mh-previous-page}).
@ -1661,12 +1655,12 @@ Delete range (@code{mh-delete-msg}).
Display cheat sheet for the commands of the current prefix in
minibuffer (@code{mh-prefix-help}).
@c -------------------------
@kindex D @key{SPC}
@kindex D SPC
@findex mh-page-digest
@item D @key{SPC}
Display next message in digest (@code{mh-page-digest}).
@c -------------------------
@kindex D @key{BS}
@kindex D BS
@findex mh-page-digest-backwards
@item D @key{BS}
Display previous message in digest (@code{mh-page-digest-backwards}).
@ -1697,12 +1691,12 @@ Delete messages with same subject or thread
Display cheat sheet for the commands of the current prefix in
minibuffer (@code{mh-prefix-help}).
@c -------------------------
@kindex K @key{TAB}
@kindex K TAB
@findex mh-next-button
@item K @key{TAB}
Go to the next button (@code{mh-next-button}).
@c -------------------------
@kindex K S-@key{TAB}
@kindex K S-TAB
@findex mh-prev-button
@item K S-@key{TAB}
Go to the previous button (@code{mh-prev-button}).
@ -1844,7 +1838,7 @@ Move point to mouse event and show message (@code{mh-show-mouse}).
Within the MH-Show buffer, the following command is defined.
@table @kbd
@kindex @key{RET}
@kindex RET
@kindex mouse-1
@kindex mouse-2
@findex mh-press-button
@ -2017,11 +2011,11 @@ detail in the following sections.
@findex mh-previous-page
@findex mh-show
@findex mh-show-mouse
@kindex , (comma)
@kindex . (period)
@kindex @key{BS}
@kindex @key{RET}
@kindex @key{SPC}
@kindex , @r{(comma)}
@kindex . @r{(period)}
@kindex BS
@kindex RET
@kindex SPC
@kindex mouse-2
The command @key{RET} (@code{mh-show}) displays the message that the
@ -2101,9 +2095,9 @@ Emacs 21 and XEmacs. For more information, see
@uref{http://quimby.gnus.org/circus/face/}.}.
@cindex @command{uncompface}
@cindex Emacs, packages, x-face
@cindex Emacs, packages, @samp{x-face}
@cindex Unix commands, @command{uncompface}
@cindex x-face package
@cindex @samp{x-face} package
@vindex mh-show-xface
Next is the traditional @samp{X-Face:} header field@footnote{The
@ -2200,7 +2194,7 @@ highlighting of citations entirely, choose @samp{None}.
@cindex highlighting email addresses
@cindex links, following
@findex goto-address-at-point
@kindex C-c @key{RET}
@kindex C-c RET
@kindex mouse-2
@vindex goto-address-highlight-p
@ -2306,10 +2300,10 @@ System: type @kbd{M-! xterm -e mhshow @var{message-number}}. You can
leave out the @samp{xterm -e} if you use @command{mhlist} or
@command{mhstore}.}.
@cindex Emacs, packages, mm-decode
@cindex mm-decode package
@cindex Emacs, packages, @samp{mm-decode}
@cindex @samp{mm-decode} package
@findex mh-toggle-mh-decode-mime-flag
@kindex ; (semicolon)
@kindex ; @r{(semicolon)}
@vindex mh-decode-mime-flag
MH-E can handle attachments as well if the Gnus @samp{mm-decode}
@ -2334,9 +2328,9 @@ Attachments in MH-E are indicated by @dfn{buttons} like this:
@findex mh-next-button
@findex mh-press-button
@findex mh-prev-button
@kindex @key{RET}
@kindex K @key{TAB}
@kindex K S-@key{TAB}
@kindex RET
@kindex K TAB
@kindex K S-TAB
@kindex mouse-1
@kindex mouse-2
@ -2490,7 +2484,7 @@ the option @code{mm-discouraged-alternatives}, and add
@samp{text/html}. The next best alternative, if any, will be shown.
@findex mh-show-preferred-alternative
@kindex : (colon)
@kindex : @r{(colon)}
Occasionally, though, you might want to see the preferred alternative.
The command @kbd{:} (@code{mh-show-preferred-alternative}) displays
@ -2688,10 +2682,10 @@ buffer, including HTML buffers.
@cindex digests
@findex mh-page-digest
@findex mh-page-digest-backwards
@kindex D @key{BS}
@kindex D @key{SPC}
@kindex @key{BS}
@kindex @key{SPC}
@kindex D BS
@kindex D SPC
@kindex BS
@kindex SPC
A digest is a message that contains other messages. Special MH-E
commands let you read digests conveniently. You can use @key{SPC} and
@ -2904,8 +2898,8 @@ Another related function is the command @kbd{P F}
faces and not. When faces are enabled, the printed message will look
very similar to the message in the MH-Show buffer.
@cindex ps-print package
@cindex Emacs, packages, ps-print
@cindex @samp{ps-print} package
@cindex Emacs, packages, @samp{ps-print}
MH-E uses the @samp{ps-print} package to do the printing, so you can
customize the printing further by going to the @samp{ps-print}
@ -2995,7 +2989,7 @@ like to change the initial default directory, customize the option
directory for storing the content of these messages.
@findex mh-store-buffer
@kindex @key{RET}
@kindex RET
@kindex X s
By the way, @kbd{X s} calls the Emacs Lisp function
@ -3045,7 +3039,7 @@ message with @kbd{M-<} (@code{mh-first-msg}) and @kbd{M->}
@findex previous-line
@kindex C-n
@kindex C-p
@kindex @key{RET}
@kindex RET
You can also use the Emacs commands @kbd{C-p} (@code{previous-line})
and @kbd{C-n} (@code{next-line}) to move up and down the scan lines in
@ -3746,7 +3740,7 @@ The command @kbd{F p} runs @code{mh-pack-folder-hook} after
renumbering the messages. A variable that is useful with this hook
is @code{mh-current-folder}.
@kindex @key{TAB}
@kindex TAB
@vindex mh-recursive-folders-flag
By default, operations on folders work only one level at a time. Set
@ -3850,16 +3844,15 @@ buffers that you would rather remove, you can use both
You can use dired to manipulate the folders themselves. For example, I
renamed my @samp{+out} folder to the more common @samp{+outbox} by
running dired on my mail directory (@kbd{M-x dired RET ~/Mail RET}),
moving my cursor to @samp{out} and using the command @kbd{R}
(@code{dired-do-rename}).
running dired on my mail directory (@kbd{M-x dired @key{RET} ~/Mail
@key{RET}}), moving my cursor to @samp{out} and using the command
@kbd{R} (@code{dired-do-rename}).
@node Sending Mail, Editing Drafts, Folders, Top
@chapter Sending Mail
@cindex sending mail
@findex mh-smail
@kindex M-x mh-smail
You can send a mail message in several ways. You can call @kbd{M-x
mh-smail} directly, or from the command line like this:
@ -4027,8 +4020,6 @@ more detail in the following sections.
@cindex sending mail
@findex mh-smail
@findex mh-smail-other-window
@kindex M-x mh-smail
@kindex M-x mh-smail-other-window
Outside of an MH-Folder buffer, you must call either @kbd{M-x
mh-smail} or @kbd{M-x mh-smail-other-window} to compose a new message.
@ -4390,28 +4381,28 @@ commands in addition to the normal Emacs editing commands to help you
edit your draft. These can also be found in the @samp{Letter} menu.
@table @kbd
@kindex @key{SPC}
@kindex SPC
@findex mh-letter-complete-or-space
@item @key{SPC}
Perform completion or insert space (@code{mh-letter-complete-or-space}).
@c -------------------------
@kindex M-@key{TAB}
@kindex M-TAB
@findex mh-letter-complete
@item M-@key{TAB}
Perform completion on header field or word preceding point
(@code{mh-letter-complete}).
@c -------------------------
@kindex , (comma)
@kindex , @r{(comma)}
@findex mh-letter-confirm-address
@item , (comma)
Flash alias expansion (@code{mh-letter-confirm-address}).
@c -------------------------
@kindex @key{TAB}
@kindex TAB
@findex mh-letter-next-header-field-or-indent
@item @key{TAB}
Cycle to next field (@code{mh-letter-next-header-field-or-indent}).
@c -------------------------
@kindex S-@key{TAB}
@kindex S-TAB
@findex mh-letter-previous-header-field
@item S-@key{TAB}
Cycle to the previous header field
@ -4816,8 +4807,8 @@ draft. @xref{Folder Selection}.
@findex indent-relative
@findex mh-letter-next-header-field-or-indent
@findex mh-letter-previous-header-field
@kindex @key{TAB}
@kindex S-@key{TAB}
@kindex TAB
@kindex S-TAB
@vindex mh-compose-skipped-header-fields
@vindex mh-letter-header-field
@ -4842,9 +4833,9 @@ take point to the last field from anywhere in the body.
@findex mh-letter-complete
@findex mh-letter-complete-or-space
@findex mh-letter-confirm-address
@kindex , (comma)
@kindex @key{SPC}
@kindex M-@key{TAB}
@kindex , @r{(comma)}
@kindex SPC
@kindex M-TAB
@vindex mh-alias-flash-on-comma
@vindex mh-compose-space-does-completion-flag
@vindex mh-letter-complete-function
@ -4997,8 +4988,8 @@ You can also turn on the @code{mh-delete-yanked-msg-window-flag}
option to delete the window containing the original message after
yanking it to make more room on your screen for your reply.
@cindex Emacs, packages, supercite
@cindex supercite package
@cindex Emacs, packages, @samp{supercite}
@cindex @samp{supercite} package
@kindex r
@vindex mail-citation-hook
@vindex mh-yank-behavior
@ -5061,8 +5052,8 @@ and it should leave point and mark around the modified citation text
for the next hook function. The standard prefix
@code{mh-ins-buf-prefix} is not added if this hook is set.
@cindex Emacs, packages, trivial-cite
@cindex trivial-cite package
@cindex Emacs, packages, @samp{trivial-cite}
@cindex @samp{trivial-cite} package
@vindex mh-yank-behavior
For example, if you use the hook function
@ -5499,7 +5490,7 @@ LyogWFBNICovCnN0YXRpYyBjaGFyICogc2V0aWF0aG9tZV94cG1bXSA9IHsKIjQ1IDQ1IDc2N
@end cartouche
@i{MH-E @sc{mime} draft ready to send}
@cindex undo effects of mh-mml-to-mime
@cindex undo effects of @code{mh-mml-to-mime}
This action can be undone by running @kbd{C-_} (@code{undo}).
@ -5507,7 +5498,7 @@ This action can be undone by running @kbd{C-_} (@code{undo}).
@cindex @command{mhn}
@cindex MH commands, @command{mhbuild}
@cindex MH commands, @command{mhn}
@cindex undo effects of mh-mh-to-mime
@cindex undo effects of @code{mh-mh-to-mime}
@findex mh-mh-to-mime
@findex mh-mh-to-mime-undo
@kindex C-c C-e
@ -5723,12 +5714,12 @@ The following commands are available in MH-Letter mode with the
exception of @code{mh-alias-reload} which can be called from anywhere.
@table @kbd
@kindex @key{SPC}
@kindex SPC
@findex mh-letter-complete-or-space
@item @key{SPC}
Perform completion or insert space (@code{mh-letter-complete-or-space}).
@c -------------------------
@kindex M-@key{TAB}
@kindex M-TAB
@findex mh-letter-complete
@item M-@key{TAB}
Perform completion on header field or word preceding point
@ -5800,7 +5791,7 @@ Hook run by @code{mh-alias-reload} after loading aliases (default:
You can use aliases when you are adding recipients to a message.
@findex minibuffer-complete
@kindex @key{TAB}
@kindex TAB
@vindex mh-alias-expand-aliases-flag
@vindex mh-compose-prompt-flag
@ -5814,8 +5805,8 @@ aliases to be expanded to their respective addresses in the draft.
@findex mh-letter-complete
@findex mh-letter-complete-or-space
@kindex @key{SPC}
@kindex M-@key{TAB}
@kindex SPC
@kindex M-TAB
Otherwise, you can complete aliases in the header of the draft with
@kbd{M-@key{TAB}} (@code{mh-letter-complete}) or @key{SPC}
@ -5934,7 +5925,6 @@ executed to generate the password file. For example, use @samp{ypcat
passwd} to obtain the NIS password file.
@findex mh-alias-reload
@kindex M-x mh-alias-reload
@vindex mh-alias-reloaded-hook
Since aliases are updated frequently, MH-E reloads aliases
@ -5950,7 +5940,6 @@ listed in your @samp{Aliasfile:} profile component. MH-E provides
other methods for maintaining your alias file(s).
@findex mh-alias-add-alias
@kindex M-x mh-alias-add-alias
You can use the @kbd{M-x mh-alias-add-alias} command which will prompt
you for the alias and address that you would like to add. If the alias
@ -5985,9 +5974,6 @@ Using prefixes instead of postfixes helps you explore aliases during
completion. If you forget the name of an old dive buddy, you can enter
@samp{div} and then @key{SPC} to get a listing of all your dive buddies.
@kindex M-x mh-alias-add-address-under-point
@kindex M-x mh-alias-grab-from-field
An alias for the sender of the current message is added automatically
by clicking on the @samp{Grab From alias} tool bar button or by running
the @kbd{M-x mh-alias-grab-from-field} command. Aliases for other
@ -6021,7 +6007,6 @@ more appropriate.
@cindex regular expressions, @code{mh-alias-apropos}
@findex mh-alias-apropos
@kindex M-x mh-alias-apropos
If you can't quite remember an alias, you can use @kbd{M-x
mh-alias-apropos} to show all aliases or addresses that match a
@ -6281,7 +6266,6 @@ containing the value for the field is given.
@cindex speedbar
@findex mh-visit-folder
@kindex F v
@kindex M-x speedbar
@kindex mouse-2
You can also use the speedbar
@ -6623,12 +6607,12 @@ Another few commands are available in the MH-Folder buffer resulting
from a search.
@table @kbd
@kindex @key{TAB}
@kindex TAB
@findex mh-index-next-folder
@item @key{TAB}
Jump to the next folder marker (@code{mh-index-next-folder}).
@c -------------------------
@kindex S-@key{TAB}
@kindex S-TAB
@findex mh-index-previous-folder
@item S-@key{TAB}
Jump to the previous folder marker (@code{mh-index-previous-folder}).
@ -6773,8 +6757,8 @@ method with the pick method by running the command @kbd{C-c C-p}
@cindex @samp{+mhe-index}
@findex mh-index-next-folder
@findex mh-index-previous-folder
@kindex @key{TAB}
@kindex S-@key{TAB}
@kindex TAB
@kindex S-TAB
@vindex mh-search-folder
The messages that are found are put in a temporary sub-folder of
@ -7514,7 +7498,6 @@ Mail}).
@cindex sequence, @samp{cur}
@cindex sequence, @samp{tick}
@findex mh-update-sequences
@kindex M-x mh-update-sequences
@kindex q
@kindex x
@vindex mh-tick-seq
@ -8001,7 +7984,6 @@ system.
@cindex MH-E version
@cindex @file{*MH-E Info*}
@cindex version
@kindex M-x mh-version
One command worth noting is @kbd{M-x mh-version}. You can compare the
version this command prints to the latest release (@pxref{Getting
@ -8716,7 +8698,6 @@ I also point out some additional sources of information.
@cindex bugs
@cindex SourceForge
@kindex M-x mh-version
Bug reports should be filed at
@uref{https://sourceforge.net/p/mh-e/bugs/, SourceForge}. You need to
@ -8792,7 +8773,6 @@ instead.
@cindex news
@cindex @samp{MH-E-NEWS}
@cindex @samp{README}
@kindex M-x mh-version
After you download and extract the MH-E tarball, read the
@file{README} file and @file{MH-E-NEWS}. These correspond to the

20
doc/misc/newsticker.texi
View File

@ -239,17 +239,17 @@ The position of groups and feeds within the tree can be changed with these
commands:
@table @kbd
@item M-up
@itemx M-down
@kindex M-up
@kindex M-down
@item M-@key{UP}
@itemx M-@key{DOWN}
@kindex M-UP
@kindex M-DOWN
@findex newsticker-group-shift-feed-up
@findex newsticker-group-shift-feed-down
Shift the currently selected feed up and down within its group.
@item M-S-up
@itemx M-S-down
@kindex M-S-up
@kindex M-S-down
@item M-S-@key{UP}
@itemx M-S-@key{DOWN}
@kindex M-S-UP
@kindex M-S-DOWN
@findex newsticker-group-shift-group-up
@findex newsticker-group-shift-group-down
Shift the currently selected group up and down within its parent group.
@ -397,8 +397,8 @@ Mark current item as immortal. Immortal items are kept forever.
@table @kbd
@cindex Get News
@item v
@itemx RET
@itemx <mouse-1>
@itemx @key{RET}
@itemx mouse-1
@findex newsticker-treeview-browse-url
Open the link to the full article (as contained in the current
headline) in your web browser @code{newsticker-treeview-browse-url}).

1031
doc/misc/org.texi
View File

File diff suppressed because it is too large Load Diff

11
doc/misc/pcl-cvs.texi
View File

@ -63,10 +63,11 @@ modify this GNU manual.''
@node Top
@top PCL-CVS
This manual describes PCL-CVS, the GNU Emacs front-end to CVS@. It
is nowhere near complete, so you are advised to use @kbd{M-x
customize-group RET pcl-cvs @key{RET}} and to look at the documentation strings
of the various commands and major modes for further information.
This manual describes PCL-CVS, the GNU Emacs front-end to CVS@. It is
nowhere near complete, so you are advised to use @kbd{M-x
customize-group @key{RET} pcl-cvs @key{RET}} and to look at the
documentation strings of the various commands and major modes for
further information.
@c This manual is updated to release 2.5 of PCL-CVS.
@insertcopying
@ -1109,7 +1110,7 @@ Tag all selected files by running @samp{cvs tag} on
them (@code{cvs-mode-tag}). It's usually preferable to tag a directory
at a time. Rather than selecting all files (which too often doesn't
select all files but only the few that are displayed), clear the
selection with @kbd{M-DEL} (@code{cvs-mode-unmark-all-files}), position
selection with @kbd{M-@key{DEL}} (@code{cvs-mode-unmark-all-files}), position
the cursor on the directory you want to tag and hit @kbd{t}.
@end table

2
doc/misc/reftex.texi
View File

@ -3335,7 +3335,7 @@ have to rescan the buffer in order to see it.
@findex reftex-arg-index
@findex TeX-arg-index@r{, AUCTeX function}
@findex TeX-insert-macro@r{, AUCTeX function}
@kindex C-c @key{RET}
@kindex C-c RET
@b{@RefTeX{} supplies macro arguments}@* When you insert a macro
interactively with @kbd{C-c @key{RET}}, @AUCTeX{} normally prompts for
macro arguments. Internally, it uses the functions

6
doc/misc/sem-user.texi
View File

@ -1145,7 +1145,7 @@ Typing @kbd{RET} on a reference line jumps to that reference.
@node MRU Bookmarks
@section MRU Bookmarks mode
@cindex semantic-mru-bookmark-mode
@cindex @code{semantic-mru-bookmark-mode}
Semantic MRU Bookmarks mode is a minor mode that keeps track of the
tags you have edited, allowing you to quickly return to them later
@ -1193,7 +1193,7 @@ declarations. Other possible tag classes are @code{variable},
@node Highlight Func Mode
@section Highlight Func Mode
@cindex semantic-highlight-func-mode
@cindex @code{semantic-highlight-func-mode}
Semantic Highlight Function minor mode highlights the declaration line
of the current function or tag (that is to say, the first line that
@ -1220,7 +1220,7 @@ Func mode.
@node Tag Decoration Mode
@section Tag Decoration Mode
@cindex semantic-decoration-mode
@cindex @code{semantic-decoration-mode}
Semantic Tag Decoration mode ``decorates'' each tag based on certain
arbitrary features of that tag. Decorations are specified using the

16
doc/misc/ses.texi
View File

@ -209,7 +209,7 @@ remove blank cells from the returned list, which allows to use
@findex keyboard-quit
To create a new spreadsheet, visit a nonexistent file whose name ends
with ".ses". For example, @kbd{C-x C-f test.ses RET}.
with ".ses". For example, @kbd{C-x C-f test.ses @key{RET}}.
A @dfn{cell identifier} is a symbol with a column letter and a row
@ -310,7 +310,7 @@ To enter something else (e.g., a vector), begin with a digit, then
erase the digit and type whatever you want.
@table @kbd
@item RET
@item @key{RET}
Edit the existing formula in the current cell (@code{ses-edit-cell}).
@item C-c C-c
@ -357,7 +357,7 @@ Basic commands:
@item w
(@code{ses-set-column-width})
@item TAB
@item @key{TAB}
Moves point to the next rightward cell, or inserts a new column if
already at last cell on line, or inserts a new row if at endline
(@code{ses-forward-or-insert}).
@ -639,7 +639,7 @@ or a non-string is displayed as an error by using @code{#} filling.
These commands set both formula and printer to @code{nil}:
@table @kbd
@item DEL
@item @key{DEL}
Clear cell and move left (@code{ses-clear-cell-backward}).
@item C-d
@ -1282,10 +1282,10 @@ avoid virus warnings, each function used in a formula needs
@node Uses of defadvice in @acronym{SES}
@section Uses of defadvice in @acronym{SES}
@cindex defadvice
@cindex undo-more
@cindex copy-region-as-kill
@cindex yank
@findex defadvice
@findex undo-more
@findex copy-region-as-kill
@findex yank
@table @code
@item undo-more

10
doc/misc/sieve.texi
View File

@ -123,7 +123,7 @@ bindings to manage Sieve scripts remotely. @xref{Managing Sieve}.
@table @kbd
@item C-c RET
@item C-c @key{RET}
@kindex C-c RET
@findex sieve-manage
@cindex manage remote sieve script
@ -160,8 +160,8 @@ press RET on <new script> to create a new script.
@end example
One of the scripts are highlighted, and standard point navigation
commands (@kbd{<up>}, @kbd{<down>} etc.)@: can be used to navigate the
list.
commands (@kbd{@key{UP}}, @kbd{@key{DOWN}} etc.)@: can be used to
navigate the list.
The following commands are available in the Manage Sieve buffer:
@ -187,7 +187,7 @@ Deactivates all scripts.
@findex sieve-remove
Remove currently highlighted script.
@item RET
@item @key{RET}
@item mouse-2
@item f
@kindex RET
@ -272,7 +272,7 @@ The @file{sieve-manage.el} library contains low-level functionality
for talking to a server with the @sc{managesieve} protocol.
A number of user-visible variables exist, which all can be customized
in the @code{sieve} group (@kbd{M-x customize-group RET sieve RET}):
in the @code{sieve} group (@kbd{M-x customize-group @key{RET} sieve @key{RET}}):
@table @code

2
doc/misc/smtpmail.texi
View File

@ -354,7 +354,7 @@ directory to hold queued messages. It defaults to
The function @code{smtpmail-send-queued-mail} can be used to send
any queued mail when @code{smtpmail-queue-mail} is enabled. It is
typically invoked interactively with @kbd{M-x
smtpmail-send-queued-mail RET} when you are connected to the internet.
smtpmail-send-queued-mail @key{RET}} when you are connected to the internet.
@node Server workarounds
@chapter Server workarounds

4
doc/misc/speedbar.texi
View File

@ -87,7 +87,7 @@ on. @xref{Basic Navigation}.
@chapter Introduction
@cindex introduction
To start using speedbar use the command @kbd{M-x speedbar RET} or
To start using speedbar use the command @kbd{M-x speedbar @key{RET}} or
select it from the @samp{Options->Show/Hide} sub-menu. This command
will open a new frame to summarize the local files. On X Window
systems or on MS-Windows, speedbar's frame is twenty characters wide,
@ -188,7 +188,7 @@ these are available, some additional common bindings are available.
@cindex common keys
@table @kbd
@item RET
@item @key{RET}
@itemx e
Edit/Open the current group or tag. This behavior is dependent on the
mode. In general, files or buffers are opened in the attached frame,

17
doc/misc/srecode.texi
View File

@ -105,11 +105,11 @@ item should appear.
To toggle @srecode{} minor mode on and off use:
@example
M-x srecode-minor-mode RET
M-x srecode-minor-mode @key{RET}
@end example
or
@example
M-x global-srecode-minor-mode RET
M-x global-srecode-minor-mode @key{RET}
@end example
or add
@ -276,7 +276,8 @@ If the variable @code{srecode-insert-ask-variable-method} is set to
instead create ``fields'' in the buffer. A field-editing layer
provides simple interaction through the fields. Typing in a field
will cause all variable locations that are the same to edit at the
same time. Pressing TAB on a field will move you to the next field.
same time. Pressing @kbd{@key{TAB}} on a field will move you to the
next field.
@node SRecode Minor Mode
@chapter SRecode Minor Mode
@ -284,17 +285,17 @@ same time. Pressing TAB on a field will move you to the next field.
The Semantic Recode minor mode enables a keymap and menu that provides
simple access to different templates or template applications.
The key prefix is @key{C-c /}.
The key prefix is @kbd{C-c /}.
If the variable @code{srecode-takeover-INS-key} is set, then the key
@key{<insert>} can also be used.
@kbd{@key{INSERT}} can also be used.
The most important key is bound to @code{srecode-insert} which is
@key{C-c / /}, or @key{insert insert}. @ref{Quick Start}.
@kbd{C-c / /}, or @kbd{@key{INSERT} @key{INSERT}}. @ref{Quick Start}.
Major keybindings are:
@table @key
@table @kbd
@item C-c / /
Insert a template whose name is typed into the minibuffer.
@item C-c / <lower case letter>
@ -338,7 +339,7 @@ will not be prompted to fill in values while the template is
inserted. Instead, short regions will be highlighted, and the cursor
placed in a field. Typing in the field will then fill in the value.
Several fields might be linked together. In that case, typing in one
area will modify the other linked areas. Pressing TAB will move
area will modify the other linked areas. Pressing @key{TAB} will move
between editable fields in the template.
Once the cursor moves out of the are inserted by the template, all the

14
doc/misc/vhdl-mode.texi
View File

@ -100,7 +100,7 @@ How to customize the indentation engine.
The major version number was incremented to 3 with the addition of
many new features for editing VHDL code to the new indentation engine,
which was introduced in major version 2. To find the minor revision
number of this release, use @kbd{M-x vhdl-version RET}.
number of this release, use @kbd{M-x vhdl-version @key{RET}}.
A special word of thanks goes to Rod Whitby, who wrote the
VHDL Mode indentation engine, and to Barry Warsaw, who wrote
@ -119,7 +119,7 @@ makes everything highly self-explaining.
@cindex Getting Connected
To get started, simply visit a @file{.vhd} file in Emacs; or type
@kbd{M-x vhdl-mode RET}.
@kbd{M-x vhdl-mode @key{RET}}.
@node New Indentation Engine
@chapter New Indentation Engine
@ -302,11 +302,11 @@ being used.
@vindex vhdl-echo-syntactic-information-p
@vindex echo-syntactic-information-p @r{(vhdl-)}
@cindex TAB
@cindex @key{TAB}
To help you configure VHDL Mode, you can set the variable
@code{vhdl-echo-syntactic-information-p} to non-@code{nil} so that the
syntactic component list and calculated offset will always be echoed in
the minibuffer when you hit @kbd{TAB}.
the minibuffer when you hit @kbd{@key{TAB}}.
@ignore
@ -322,7 +322,7 @@ the minibuffer when you hit @kbd{TAB}.
@chapter Customizing Indentation
@cindex Customizing Indentation
@cindex vhdl-set-offset
@cindex @code{vhdl-set-offset}
@cindex set-offset (vhdl-)
The @code{vhdl-offsets-alist} variable is where you customize all your
indentations. You simply need to decide what additional offset you want
@ -334,7 +334,7 @@ pre-defined styles will suit your needs, but if not, this section will
describe how to set up basic editing configurations. @xref{Styles}, for
an explanation of how to set up named styles.
@cindex vhdl-basic-offset
@cindex @code{vhdl-basic-offset}
@cindex basic-offset (vhdl-)
As mentioned previously, the variable @code{vhdl-offsets-alist} is an
association list between syntactic symbols and the offsets to be applied
@ -548,7 +548,7 @@ already built-in. These include:
@findex vhdl-set-style
@findex set-style @r{(vhdl-)}
If you'd like to experiment with these built-in styles you can simply
type @kbd{M-x vhdl-set-style RET} in a VHDL Mode buffer.
type @kbd{M-x vhdl-set-style @key{RET}} in a VHDL Mode buffer.
You will be prompted for one of the above styles (with completion).
Enter one of the styles and hit @kbd{RET}. Note however that setting a

446
doc/misc/vip.texi
View File

File diff suppressed because it is too large Load Diff

436
doc/misc/viper.texi
View File

@ -368,9 +368,9 @@ toggles Viperization of Emacs on and off.
@node States in Viper
@section States in Viper
@kindex @kbd{C-z}
@kindex @key{ESC}
@kindex @kbd{i}
@kindex C-z
@kindex ESC
@kindex i
@cindex Emacs state
@cindex Vi state
@cindex Insert state
@ -474,7 +474,7 @@ to allow Emacs keys in Insert state.
@node Emacs State
@subsection Emacs State
@kindex @kbd{C-z}
@kindex C-z
@cindex Emacs state
@ -514,7 +514,7 @@ exceptions are:
@table @kbd
@item C-x
@kindex @kbd{C-x}
@kindex C-x
@kbd{C-x} is used to invoke Emacs commands, mainly those that do window
management. @kbd{C-x 2} will split a window, @kbd{C-x 0} will close a
window. @kbd{C-x 1} will close all other windows. @kbd{C-xb} is used to
@ -523,14 +523,14 @@ These are about the only necessary keystrokes.
For the rest, see the GNU Emacs Manual.
@item C-c
@kindex @kbd{C-c}
@kindex C-c
For user levels 2 and higher, this key serves as a prefix key for the key
sequences used by various major modes. For users at Viper level 1, @kbd{C-c}
simply beeps.
@item C-g and C-]
@kindex @kbd{C-g}
@kindex @kbd{C-]}
@kindex C-g
@kindex C-]
These are the Emacs @samp{quit} keys.
There will be cases where you will have to
@ -543,7 +543,7 @@ Edit,Recursive Edit,emacs,The GNU Emacs Manual}.
At user level 1, @kbd{C-g} is bound to @code{viper-info-on-file}
function instead.
@item C-\
@kindex @kbd{C-\}
@kindex C-\
@cindex Meta key
Viper uses @key{ESC} as a switch between Insert and Vi states. Emacs uses
@ -569,7 +569,7 @@ about are:
@table @samp
@item Undo
@kindex @kbd{u}
@kindex u
@kbd{u} will undo. Undo can be repeated by the @kbd{.} key. Undo itself
can be undone. Another @kbd{u} will change the direction. The presence
of repeatable undo means that @kbd{U}, undoing lines, is not very
@ -599,7 +599,7 @@ to case-insensitive and back.
@cindex vanilla search
@cindex case-sensitive search
@cindex case-insensitive search
@kindex @kbd{C-c /}
@kindex C-c /
@item Ex commands
@cindex Ex commands
@ -1083,7 +1083,7 @@ remembered (This is called ``learn mode'' in some editors.)
where @samp{register} is any character from @samp{a} through @samp{z}. Then
you can execute this macro using @kbd{@@register}. It is, of course,
possible to yank some text into a register and execute it using
@kbd{@@register}. Typing @kbd{@@@@}, @kbd{@@RET}, or @kbd{@@C-j} will
@kbd{@@register}. Typing @kbd{@@@@}, @kbd{@@@key{RET}}, or @kbd{@@C-j} will
execute the last macro that was executed using @kbd{@@register}.
Viper will automatically lowercase the register, so that pressing the
@ -1302,8 +1302,8 @@ These commands have no Vi analogs.
@table @kbd
@item C-x, C-c
@kindex @kbd{C-x}
@kindex @kbd{C-c}
@kindex C-x
@kindex C-c
These two keys invoke many important Emacs functions. For example, if you
hit @kbd{C-x} followed by @kbd{2}, then the current window will be split
into 2. Except for novice users, @kbd{C-c} is also set to execute an Emacs
@ -1313,11 +1313,11 @@ configure @key{ESC} as Meta by setting @code{viper-no-multiple-ESC} to
@kbd{C-\} in Insert, Replace, or Vi states will make Emacs think
@kbd{Meta} has been hit.
@item \
@kindex @kbd{\}
@kindex \
Escape to Emacs to execute a single Emacs command. For instance,
@kbd{\ @key{ESC}} will act like a Meta key.
@item Q
@kindex @kbd{Q}
@kindex Q
@cindex query replace
@kbd{Q} is for query replace. By default,
each string to be replaced is treated as a regular expression. You can use
@ -1327,16 +1327,16 @@ that @kbd{:se nomagic} turns Regexps off completely, unlike Vi).
@item v
@itemx V
@itemx C-v
@kindex @kbd{v}
@kindex @kbd{V}
@kindex @kbd{C-v}
@kindex v
@kindex V
@kindex C-v
These keys are used to visit files. @kbd{v} will switch to a buffer
visiting file whose name can be entered in the minibuffer. @kbd{V} is
similar, but will use a window different from the current window.
@kbd{C-v} is like @kbd{V}, except that a new frame (X window) will be used
instead of a new Emacs window.
@item #
@kindex @kbd{#}
@kindex #
If followed by a certain character @var{ch}, it becomes an operator whose
argument is the region determined by the motion command that follows
(indicated as <move>).
@ -1344,34 +1344,34 @@ Currently, @var{ch} can be one of @kbd{c}, @kbd{C}, @kbd{g}, @kbd{q}, and
@kbd{s}. For instance, @kbd{#qr} will prompt you for a string and then
prepend this string to each line in the buffer.
@item # c
@kindex @kbd{#c<move>}
@kindex #c<move>
@cindex changing case
Change upper-case characters in the region to lower-case
(@code{downcase-region}).
Emacs command @kbd{M-l} does the same for words.
@item # C
@kindex @kbd{#C<move>}
@kindex #C<move>
Change lower-case characters in the region to upper-case. For instance,
@kbd{# C 3 w} will capitalize 3 words from the current point
(@code{upcase-region}).
Emacs command @kbd{M-u} does the same for words.
@item # g
@kindex @kbd{#g<move>}
@kindex #g<move>
Execute last keyboard macro for each line in the region
(@code{viper-global-execute}).
@item # q
@kindex @kbd{#q<move>}
@kindex #q<move>
Insert specified string at the beginning of each line in the region
(@code{viper-quote-region}). The default string is composed of the comment
character(s) appropriate for the current major mode.
@item # s
@kindex @kbd{#s<move>}
@kindex #s<move>
Check spelling of words in the region (@code{spell-region}).
The function used for spelling is determined from the variable
@code{viper-spell-function}.
@vindex viper-spell-function
@item *
@kindex @kbd{*}
@kindex *
Call last keyboard macro.
@item m .
Set mark at point and push old mark off the ring
@ -1382,41 +1382,41 @@ Set mark at beginning and end of buffer, respectively.
Jump to mark and pop mark off the ring. @xref{Mark,,Mark,emacs,The GNU
Emacs Manual}, for more info.
@item ] register
@kindex @kbd{]<a-z>}
@kindex ]<a-z>
View contents of register
@item [ textmarker
@kindex @kbd{[<a-z>}
@kindex [<a-z>
View filename and position of textmarker
@item @@#
@item @@register
@item @@!
@kindex @kbd{@@#}
@kindex @kbd{@@<a-z>}
@kindex @kbd{@@!}
@kindex @@#
@kindex @@<a-z>
@kindex @@!
@cindex keyboard macros
@cindex register execution
Begin/end keyboard macro. @@register has a different meaning when used after
a @kbd{@@#}. @xref{Macros and Registers}, for details
@item []
@kindex @kbd{[]}
@kindex []
Go to end of heading.
@item g <@emph{movement command}>
Search buffer for text delimited by movement command. The canonical
example is @kbd{gw} to search for the word under the cursor.
@xref{Improved Search}, for details.
@item C-g and C-]
@kindex @kbd{C-g}
@kindex @kbd{C-]}
@kindex C-g
@kindex C-]
Quit and Abort Recursive edit. These may be necessary on occasion.
@xref{Vi State}, for a reason.
@item C-c C-g
@kindex @kbd{C-c C-g}
@kindex C-c C-g
Hitting @kbd{C-c} followed by @kbd{C-g} will display the information on the
current buffer. This is the same as hitting @kbd{C-g} in Vi, but, as
explained above, @kbd{C-g} is needed for other purposes in Emacs.
@item C-c /
@kindex @kbd{C-c /}
@kindex C-c /
Without a prefix argument, this command toggles
case-sensitive/case-insensitive search modes and plain vanilla/regular
expression search. With the prefix argument 1, i.e.,
@ -1429,21 +1429,21 @@ this function.
@cindex case-insensitive search
@item M-p and M-n
@kindex @kbd{M-p}
@kindex @kbd{M-n}
@kindex M-p
@kindex M-n
In the minibuffer, these commands navigate through the minibuffer
histories, such as the history of search strings, Ex commands, etc.
@item C-s
@kindex @kbd{C-s}
@kindex C-s
If the minibuffer is entered via a Viper search commands @kbd{/} or @kbd{?},
then typing this key inserts the last search string used by the
Emacs incremental search command (that is bound to @kbd{C-s} everywhere
except in this case).
@item C-c M-p and C-c M-n
@kindex @kbd{C-c M-p}
@kindex @kbd{C-c M-n}
@kindex C-c M-p
@kindex C-c M-n
@cindex Insertion history
@cindex Insertion ring
@cindex Command history
@ -2669,10 +2669,10 @@ purpose of mouse search and mouse insert. By default, this is set to
@code{double-click-time} in Emacs and to
@code{mouse-track-multi-click-time} milliseconds in XEmacs.
@end table
@kindex @kbd{S-mouse-1}
@kindex @kbd{S-mouse-2}
@kindex @kbd{meta shift button1up}
@kindex @kbd{meta shift button2up}
@kindex S-mouse-1
@kindex S-mouse-2
@kindex META SHIFT button1up
@kindex META SHIFT button2up
@vindex viper-multiclick-timeout
@findex viper-mouse-click-insert-word
@findex viper-mouse-click-search-word
@ -3383,60 +3383,60 @@ don't want this macro, put
in your Viper customization file.
@end table
@kindex @kbd{%}
@kindex @kbd{C-c /}
@kindex @kbd{N}
@kindex @kbd{n}
@kindex @kbd{?<cr>}
@kindex @kbd{/<cr>}
@kindex @kbd{?<string>}
@kindex @kbd{/<string>}
@kindex @kbd{''}
@kindex @kbd{``}
@kindex @kbd{]<a-z>}
@kindex @kbd{[<a-z>}
@kindex @kbd{'<a-z>}
@kindex @kbd{`<a-z>}
@kindex @kbd{m<a-z>}
@kindex @kbd{[]}
@kindex @kbd{[[}
@kindex @kbd{]]}
@kindex @kbd{@{}
@kindex @kbd{@}}
@kindex @kbd{(}
@kindex @kbd{)}
@kindex @kbd{M}
@kindex @kbd{L}
@kindex @kbd{H}
@kindex @kbd{G}
@kindex @kbd{E}
@kindex @kbd{e}
@kindex @kbd{B}
@kindex @kbd{b}
@kindex @kbd{W}
@kindex @kbd{w}
@kindex @kbd{,}
@kindex @kbd{;}
@kindex @kbd{T<char>}
@kindex @kbd{F<char>}
@kindex @kbd{t<char>}
@kindex @kbd{f<char>}
@kindex @kbd{|}
@kindex @kbd{0}
@kindex @kbd{<cr>}
@kindex @kbd{+}
@kindex @kbd{-}
@kindex @kbd{^}
@kindex @kbd{$}
@kindex @kbd{C-p}
@kindex @kbd{<lf>}
@kindex @kbd{<sp>}
@kindex @kbd{C-n}
@kindex @kbd{C-h}
@kindex @kbd{h}
@kindex @kbd{j}
@kindex @kbd{k}
@kindex @kbd{l}
@kindex %
@kindex C-c /
@kindex N
@kindex n
@kindex ?<cr>
@kindex /<cr>
@kindex ?<string>
@kindex /<string>
@kindex ''
@kindex ``
@kindex ]<a-z>
@kindex [<a-z>
@kindex '<a-z>
@kindex `<a-z>
@kindex m<a-z>
@kindex []
@kindex [[
@kindex ]]
@kindex @{
@kindex @}
@kindex (
@kindex )
@kindex M
@kindex L
@kindex H
@kindex G
@kindex E
@kindex e
@kindex B
@kindex b
@kindex W
@kindex w
@kindex ,
@kindex ;
@kindex T<char>
@kindex F<char>
@kindex t<char>
@kindex f<char>
@kindex |
@kindex 0
@kindex CR
@kindex +
@kindex -
@kindex ^
@kindex $
@kindex C-p
@kindex LF
@kindex SPC
@kindex C-n
@kindex C-h
@kindex h
@kindex j
@kindex k
@kindex l
@vindex viper-parse-sexp-ignore-comments
@node Marking
@ -3478,18 +3478,18 @@ Go to specified Viper mark.
@item `<a-z>
Go to specified Viper mark and go to the first CHAR on line.
@end table
@kindex @kbd{m<a-z>}
@kindex @kbd{m.}
@kindex @kbd{m>}
@kindex @kbd{m<}
@kindex @kbd{m,}
@kindex @kbd{m^}
@kindex m<a-z>
@kindex m.
@kindex m>
@kindex m<
@kindex m,
@kindex m^
@findex @kbd{Ex mark}
@findex @kbd{Ex k}
@kindex @kbd{''}
@kindex @kbd{``}
@kindex @kbd{`<a-z>}
@kindex @kbd{'<a-z>}
@kindex ''
@kindex ``
@kindex `<a-z>
@kindex '<a-z>
@node Appending Text
@subsection Appending Text
@ -3556,22 +3556,22 @@ Since typing the above sequences of keys may be tedious, the
functions doing the perusing can be bound to unused keyboard keys in the
Viper customization file. @xref{Viper Specials}, for details.
@end table
@kindex @kbd{C-c M-p}
@kindex @kbd{C-c M-n}
@kindex @kbd{.}
@kindex @kbd{]<a-z>}
@kindex @kbd{[<a-z>}
@kindex @kbd{P}
@kindex @kbd{p}
@kindex @kbd{"<a-z1-9>p}
@kindex @kbd{"<a-z1-9>P}
@kindex @kbd{>>}
@kindex @kbd{><move>}
@kindex @kbd{O}
@kindex @kbd{o}
@kindex @kbd{i}
@kindex @kbd{A}
@kindex @kbd{a}
@kindex C-c M-p
@kindex C-c M-n
@kindex .
@kindex ]<a-z>
@kindex [<a-z>
@kindex P
@kindex p
@kindex "<a-z1-9>p
@kindex "<a-z1-9>P
@kindex >>
@kindex ><move>
@kindex O
@kindex o
@kindex i
@kindex A
@kindex a
@node Editing in Insert State
@subsection Editing in Insert State
@ -3595,9 +3595,9 @@ Back to the begin of the change on the
current line.
@end table
@kindex @kbd{C-u}
@kindex @kbd{C-w}
@kindex @kbd{C-v}
@kindex C-u
@kindex C-w
@kindex C-v
@node Deleting Text
@subsection Deleting Text
@ -3634,13 +3634,13 @@ shiftwidth to the left (layout!).
@item <count> <<
Shift <count> lines one shiftwidth to the left.
@end table
@kindex @kbd{<<}
@kindex @kbd{<<move>}
@kindex @kbd{D}
@kindex @kbd{dd}
@kindex @kbd{d<move>}
@kindex @kbd{X}
@kindex @kbd{x}
@kindex <<
@kindex <<move>
@kindex D
@kindex dd
@kindex d<move>
@kindex X
@kindex x
@node Changing Text
@subsection Changing Text
@ -3727,28 +3727,28 @@ In Vi state, these keys are bound to functions that peruse the history of
destructive Vi commands.
@xref{Viper Specials}, for details.
@end table
@kindex @kbd{C-c M-p}
@kindex @kbd{C-c M-n}
@kindex @kbd{#q<move> }
@kindex @kbd{#C<move>}
@kindex @kbd{#c<move>}
@kindex @kbd{&}
@kindex @kbd{\&}
@kindex C-c M-p
@kindex C-c M-n
@kindex #q<move>
@kindex #C<move>
@kindex #c<move>
@kindex &
@kindex \&
@findex @kbd{Ex substitute/<pat>/<repl>/<f>}
@findex @kbd{Ex s/<pat>/<repl>/<f>}
@findex @kbd{Ex copy [z]}
@findex @kbd{Ex t [z]}
@findex @kbd{Ex move [z]}
@kindex @kbd{J}
@kindex @kbd{~}
@kindex @kbd{=<move>}
@kindex @kbd{C}
@kindex @kbd{cc}
@kindex @kbd{c<move>}
@kindex @kbd{S}
@kindex @kbd{s}
@kindex @kbd{R}
@kindex @kbd{r<char>}
@kindex J
@kindex ~
@kindex =<move>
@kindex C
@kindex cc
@kindex c<move>
@kindex S
@kindex s
@kindex R
@kindex r<char>
@node Search and Replace
@subsection Search and Replace
@ -3817,21 +3817,21 @@ Execute <ex-command> on all lines that match <pattern>.
@itemx :v /<pattern>/<ex-command>
Execute <ex-command> on all lines that do not match <pattern>.
@end table
@kindex @kbd{&}
@kindex &
@findex @kbd{Ex substitute/<pat>/<repl>/<f>}
@kindex @kbd{Q}
@kindex @kbd{#g<move>}
@kindex Q
@kindex #g<move>
@findex @kbd{Ex v}
@findex @kbd{Ex g}
@findex @kbd{Ex global}
@findex @kbd{Ex vglobal}
@findex @kbd{Ex tag <name>}
@kindex @kbd{%}
@kindex @kbd{N}
@kindex @kbd{n}
@kindex @kbd{g<move>}
@kindex @kbd{?<string>}
@kindex @kbd{/<string>}
@kindex %
@kindex N
@kindex n
@kindex g<move>
@kindex ?<string>
@kindex /<string>
@node Yanking
@subsection Yanking
@ -3865,19 +3865,19 @@ be automatically down-cased.
Put the contents of the (default undo) buffer
<count> times before the cursor. The register will
@end table
@kindex @kbd{P}
@kindex @kbd{p}
@kindex @kbd{"<a-z1-9>p}
@kindex @kbd{"<a-z1-9>P}
@kindex @kbd{]<a-z>}
@kindex @kbd{[<a-z>}
@kindex @kbd{m<a-z>}
@kindex @kbd{Y}
@kindex @kbd{yy}
@kindex @kbd{"<A-Z>y<move>}
@kindex @kbd{"<a-z>y<move>}
@kindex @kbd{y<move>}
@kindex @kbd{yank}
@kindex P
@kindex p
@kindex "<a-z1-9>p
@kindex "<a-z1-9>P
@kindex ]<a-z>
@kindex [<a-z>
@kindex m<a-z>
@kindex Y
@kindex yy
@kindex "<A-Z>y<move>
@kindex "<a-z>y<move>
@kindex y<move>
@kindex yank
@findex @kbd{Ex yank}
@node Undoing
@ -3902,9 +3902,9 @@ that have a @samp{~} appended to them.
@findex @kbd{Ex rec}
@findex @kbd{Ex e!}
@findex @kbd{Ex q!}
@kindex @kbd{.}
@kindex @kbd{U}
@kindex @kbd{u}
@kindex .
@kindex U
@kindex u
@node Display
@section Display
@ -3948,21 +3948,21 @@ Put line <count> at the bottom of the window
Put line <count> in the center of the window
(default the current line).
@end table
@kindex @kbd{zM}
@kindex @kbd{zL}
@kindex @kbd{zH}
@kindex @kbd{z<cr>}
@kindex @kbd{z.}
@kindex @kbd{z-}
@kindex @kbd{z<cr>}
@kindex @kbd{C-b}
@kindex @kbd{C-f}
@kindex @kbd{C-u}
@kindex @kbd{C-d}
@kindex @kbd{C-y}
@kindex @kbd{C-e}
@kindex @kbd{C-l}
@kindex @kbd{C-g}
@kindex zM
@kindex zL
@kindex zH
@kindex z<cr>
@kindex z.
@kindex z-
@kindex z<cr>
@kindex C-b
@kindex C-f
@kindex C-u
@kindex C-d
@kindex C-y
@kindex C-e
@kindex C-l
@kindex C-g
@node File and Buffer Handling
@ -4078,11 +4078,11 @@ Read the file <name> into the buffer after the line <address>.
Edit a file in current or another window, or in another frame. File name
is typed in minibuffer. File completion and history are supported.
@end table
@kindex @kbd{v}
@kindex @kbd{V}
@kindex v
@kindex V
@findex @kbd{Ex args}
@findex @kbd{Ex rew}
@kindex @kbd{C-^}
@kindex C-^
@findex @kbd{Ex e!@: [<files>]}
@findex @kbd{Ex e [<files>]}
@findex @kbd{Ex edit [<files>]}
@ -4096,7 +4096,7 @@ is typed in minibuffer. File completion and history are supported.
@findex @kbd{Ex r}
@findex @kbd{Ex read}
@findex @kbd{Ex pre}
@kindex @kbd{ZZ}
@kindex ZZ
@findex @kbd{Ex wq}
@findex @kbd{Ex w <file>}
@findex @kbd{Ex w!@: <file>}
@ -4171,14 +4171,14 @@ Show contents of textmarker.
@item ]<a-z>
Show contents of register.
@end table
@kindex @kbd{]<a-z>}
@kindex @kbd{[<a-z>}
@kindex @kbd{#g<move>}
@kindex @kbd{*}
@kindex @kbd{@@!<a-z>}
@kindex @kbd{@@#}
@kindex @kbd{@@@@}
@kindex @kbd{@@<a-z>}
@kindex ]<a-z>
@kindex [<a-z>
@kindex #g<move>
@kindex *
@kindex @@!<a-z>
@kindex @@#
@kindex @@@@
@kindex @@<a-z>
@findex @kbd{Ex unmap <char>}
@findex @kbd{Ex map <char> <seq>}
@findex @kbd{Ex unmap!@: <char>}
@ -4410,16 +4410,16 @@ Undoes the last @kbd{C-y} and puts another kill from the kill ring.
Using this command, you can try may different kills until you find the one
you need.
@end table
@kindex @kbd{M-y}
@kindex @kbd{C-y}
@kindex @kbd{C-xC-f}
@kindex @kbd{C-xo}
@kindex @kbd{C-x2}
@kindex @kbd{C-x1}
@kindex @kbd{C-x0}
@kindex @kbd{C-z}
@kindex @kbd{C-\}
@kindex @kbd{C-c\}
@kindex M-y
@kindex C-y
@kindex C-x C-f
@kindex C-x o
@kindex C-x 2
@kindex C-x 1
@kindex C-x 0
@kindex C-z
@kindex C-\
@kindex C-c\
@node Mouse-bound Commands
@section Mouse-bound Commands
@ -4445,10 +4445,10 @@ Note: Viper sets this binding only if this mouse action is not
already bound to something else.
@xref{Viper Specials}, for more details.
@end table
@kindex @kbd{S-mouse-1}
@kindex @kbd{S-mouse-2}
@kindex @kbd{meta button1up}
@kindex @kbd{meta button2up}
@kindex S-mouse-1
@kindex S-mouse-2
@kindex META button1up
@kindex META button2up
@node GNU Free Documentation License
@appendix GNU Free Documentation License

10
etc/NEWS.26
View File

@ -1219,7 +1219,7 @@ backend", which has been updated to benefit from the new UI features.
** Term
---
*** `term-char-mode' now makes its buffer read-only.
*** 'term-char-mode' now makes its buffer read-only.
The buffer is made read-only to prevent changes from being made by
anything other than the process filter; and movements of point away
@ -1228,8 +1228,8 @@ correct position after each command. This is needed to avoid states
which are inconsistent with the state of the terminal understood by
the inferior process.
New user options `term-char-mode-buffer-read-only' and
`term-char-mode-point-at-process-mark' control these behaviors, and
New user options 'term-char-mode-buffer-read-only' and
'term-char-mode-point-at-process-mark' control these behaviors, and
are non-nil by default. Customize these options to nil if you want
the previous behavior.
@ -1746,6 +1746,10 @@ instead of 0.8, to avoid rounding glitches.
when a symbol's value is changed. This is used to implement the new
debugger command 'debug-on-variable-change'.
+++
** New variable 'print-escape-control-characters' causes 'prin1' and
'print' to output control characters as backslash sequences.
+++
** Time conversion functions that accept a time zone rule argument now
allow it to be OFFSET or a list (OFFSET ABBR), where the integer

2
lisp/emulation/viper.el
View File

@ -300,6 +300,8 @@
;;; Code:
(require 'cl-lib)
;; compiler pacifier
(defvar mark-even-if-inactive)
(defvar quail-mode)

3
src/fns.c
View File

@ -4953,6 +4953,9 @@ extract_data_from_object (Lisp_Object spec,
#endif
}
if (!STRINGP (object))
signal_error ("Invalid object argument",
NILP (object) ? build_string ("nil") : object);
return SSDATA (object);
}