@cindex mode, MSB
@cindex MSB mode
@findex mouse-buffer-menu
-@kindex C-Down-Mouse-1
+@kindex C-Down-mouse-1
MSB global minor mode (``MSB'' stands for ``mouse select buffer'')
provides a different and customizable mouse buffer menu which you may
prefer. It replaces the bindings of @code{mouse-buffer-menu},
-normally on @kbd{C-Down-Mouse-1} and @kbd{C-@key{F10}}, and the menu
+normally on @kbd{C-Down-mouse-1} and @kbd{C-@key{F10}}, and the menu
bar buffer menu. You can customize the menu in the @code{msb} Custom
group.
@cindex fringes, for debugging
@table @asis
-@item @kbd{Mouse-1} (in fringe)
+@item @kbd{mouse-1} (in fringe)
Set or clear a breakpoint on that line.
-@item @kbd{C-Mouse-1} (in fringe)
+@item @kbd{C-mouse-1} (in fringe)
Enable or disable a breakpoint on that line.
-@item @kbd{Mouse-3} (in fringe)
+@item @kbd{mouse-3} (in fringe)
Continue execution to that line.
-@item @kbd{C-Mouse-3} (in fringe)
+@item @kbd{C-mouse-3} (in fringe)
Jump to that line.
@end table
- On a graphical display, you can click @kbd{Mouse-1} in the fringe of
+ On a graphical display, you can click @kbd{mouse-1} in the fringe of
a source buffer, to set a breakpoint on that line (@pxref{Fringes}).
A red dot appears in the fringe, where you clicked. If a breakpoint
-already exists there, the click removes it. A @kbd{C-Mouse-1} click
+already exists there, the click removes it. A @kbd{C-mouse-1} click
enables or disables an existing breakpoint; a breakpoint that is
disabled, but not unset, is indicated by a gray dot.
A solid arrow in the left fringe of a source buffer indicates the
line of the innermost frame where the debugged program has stopped. A
hollow arrow indicates the current execution line of a higher-level
-frame. If you drag the arrow in the fringe with @kbd{Mouse-1}, that
+frame. If you drag the arrow in the fringe with @kbd{mouse-1}, that
causes execution to advance to the line where you release the button.
-Alternatively, you can click @kbd{Mouse-3} in the fringe to advance to
-that line. You can click @kbd{C-Mouse-3} in the fringe to jump to
+Alternatively, you can click @kbd{mouse-3} in the fringe to advance to
+that line. You can click @kbd{C-mouse-3} in the fringe to jump to
that line without executing the intermediate lines. This command
allows you to go backwards, which can be useful for running through
code that has already executed, in order to examine its execution in
Visit the source line for the current breakpoint
(@code{gdb-goto-breakpoint}).
-@item Mouse-2
-@kindex Mouse-2 @r{(GDB Breakpoints buffer)}
+@item mouse-2
+@kindex mouse-2 @r{(GDB Breakpoints buffer)}
Visit the source line for the breakpoint you click on.
@end table
@vindex gdb-show-threads-by-default
When @code{gdb-many-windows} is non-@code{nil}, the GDB Breakpoints
buffer shares its window with the GDB Threads buffer. To switch from
-one to the other click with @kbd{Mouse-1} on the relevant button in
+one to the other click with @kbd{mouse-1} on the relevant button in
the header line. If @code{gdb-show-threads-by-default} is
non-@code{nil}, the GDB Threads buffer is the one shown by default.
debugged program. @xref{Threads, Threads, Debugging programs with
multiple threads, gdb, The GNU debugger}. To select a thread, move
point there and press @key{RET} (@code{gdb-select-thread}), or click on
-it with @kbd{Mouse-2}. This also displays the associated source
+it with @kbd{mouse-2}. This also displays the associated source
buffer, and updates the contents of the other GDB buffers.
You can customize variables under @code{gdb-buffers} group to select
arrow in the fringe. On text terminals, or when fringes are disabled,
the selected stack frame is displayed in reverse contrast. To select
a stack frame, move point in its line and type @key{RET}
-(@code{gdb-frames-select}), or click @kbd{Mouse-2} on it. Doing so
+(@code{gdb-frames-select}), or click @kbd{mouse-2} on it. Doing so
also updates the Locals buffer
@ifnottex
(@pxref{Other GDB Buffers}).
This buffer displays the values of local variables of the current
frame for simple data types (@pxref{Frame Info, Frame Info,
Information on a frame, gdb, The GNU debugger}). Press @key{RET} or
-click @kbd{Mouse-2} on the value if you want to edit it.
+click @kbd{mouse-2} on the value if you want to edit it.
Arrays and structures display their type only. With GDB 6.4 or later,
you can examine the value of the local variable at point by typing
-@key{RET}, or with a @kbd{Mouse-2} click. With earlier versions of
-GDB, use @key{RET} or @kbd{Mouse-2} on the type description
+@key{RET}, or with a @kbd{mouse-2} click. With earlier versions of
+GDB, use @key{RET} or @kbd{mouse-2} on the type description
(@samp{[struct/union]} or @samp{[array]}). @xref{Watch Expressions}.
@item Registers Buffer
@findex toggle-gdb-all-registers
This buffer displays the values held by the registers
(@pxref{Registers,,, gdb, The GNU debugger}). Press @key{RET} or
-click @kbd{Mouse-2} on a register if you want to edit its value. With
+click @kbd{mouse-2} on a register if you want to edit its value. With
GDB 6.4 or later, recently changed register values display with
@code{font-lock-warning-face}.
@item Memory Buffer
The memory buffer lets you examine sections of program memory
(@pxref{Memory, Memory, Examining memory, gdb, The GNU debugger}).
-Click @kbd{Mouse-1} on the appropriate part of the header line to
+Click @kbd{mouse-1} on the appropriate part of the header line to
change the starting address or number of data items that the buffer
displays. Alternatively, use @kbd{S} or @kbd{N} respectively. Click
-@kbd{Mouse-3} on the header line to select the display format or unit
+@kbd{mouse-3} on the header line to select the display format or unit
size for these data items.
@end table
When @code{gdb-many-windows} is non-@code{nil}, the locals buffer
shares its window with the registers buffer, just like breakpoints and
threads buffers. To switch from one to the other, click with
-@kbd{Mouse-1} on the relevant button in the header line.
+@kbd{mouse-1} on the relevant button in the header line.
@node Watch Expressions
@subsubsection Watch Expressions
address as a tooltip to help identify the frame in which they were
defined.
- To expand or contract a complex data type, click @kbd{Mouse-2} or
+ To expand or contract a complex data type, click @kbd{mouse-2} or
press @key{SPC} on the tag to the left of the expression. Emacs asks
for confirmation before expanding the expression if its number of
immediate children exceeds the value of the variable
@findex gdb-edit-value
To edit a variable with a simple data type, or a simple element of a
complex data type, move point there in the speedbar and type @key{RET}
-(@code{gdb-edit-value}). Or you can click @kbd{Mouse-2} on a value to
+(@code{gdb-edit-value}). Or you can click @kbd{mouse-2} on a value to
edit it. Either way, this reads the new value using the minibuffer.
@vindex gdb-show-changed-values
calendar. The calendar uses its own buffer, whose major mode is
Calendar mode.
- @kbd{Mouse-3} in the calendar brings up a menu of operations on a
-particular date; @kbd{Mouse-2} brings up a menu of commonly used
+ @kbd{mouse-3} in the calendar brings up a menu of operations on a
+particular date; @kbd{mouse-2} brings up a menu of commonly used
calendar features that are independent of any particular date. To exit
the calendar, type @kbd{q}.
and can display them. You can add your own holidays to the default list.
@table @kbd
-@item Mouse-3 Holidays
+@item mouse-3 Holidays
@itemx h
Display holidays for the selected date
(@code{calendar-cursor-holidays}).
@vindex calendar-view-holidays-initially-flag
To see if any holidays fall on a given date, position point on that
date in the calendar window and use the @kbd{h} command. Alternatively,
-click on that date with @kbd{Mouse-3} and then choose @kbd{Holidays}
+click on that date with @kbd{mouse-3} and then choose @kbd{Holidays}
from the menu that appears. Either way, this displays the holidays for
that date, in the echo area if they fit there, otherwise in a separate
window.
times of sunrise and sunset for any date.
@table @kbd
-@item Mouse-3 Sunrise/sunset
+@item mouse-3 Sunrise/sunset
@itemx S
Display times of sunrise and sunset for the selected date
(@code{calendar-sunrise-sunset}).
@findex sunrise-sunset
Within the calendar, to display the @emph{local times} of sunrise and
sunset in the echo area, move point to the date you want, and type
-@kbd{S}. Alternatively, click @kbd{Mouse-3} on the date, then choose
+@kbd{S}. Alternatively, click @kbd{mouse-3} on the date, then choose
@samp{Sunrise/sunset} from the menu that appears. The command @kbd{M-x
sunrise-sunset} is available outside the calendar to display this
information for today's date or a specified date. To specify a date
@table @kbd
@kindex p @r{(Calendar mode)}
@findex calendar-print-other-dates
-@item Mouse-3 Other calendars
+@item mouse-3 Other calendars
@itemx p o
Display the selected date in various other calendars.
(@code{calendar-print-other-dates}).
appropriate command starting with @kbd{p} from the table above. The
prefix @kbd{p} is a mnemonic for ``print'', since Emacs ``prints'' the
equivalent date in the echo area. @kbd{p o} displays the
-date in all forms known to Emacs. You can also use @kbd{Mouse-3} and
+date in all forms known to Emacs. You can also use @kbd{mouse-3} and
then choose @kbd{Other calendars} from the menu that appears. This
displays the equivalent forms of the date in all the calendars Emacs
understands, in the form of a menu. (Choosing an alternative from
following, key bindings refer to the Calendar buffer.
@table @kbd
-@item Mouse-3 Diary
+@item mouse-3 Diary
@itemx d
Display all diary entries for the selected date
(@code{diary-view-entries}).
entries for the selected date and for the following day.
Another way to display the diary entries for a date is to click
-@kbd{Mouse-3} on the date, and then choose @kbd{Diary entries} from
+@kbd{mouse-3} on the date, and then choose @kbd{Diary entries} from
the menu that appears. If the variable
@code{calendar-view-diary-initially-flag} is non-@code{nil}, creating the
calendar lists the diary entries for the current date (provided the
Visit the file described on the current line, and display the buffer in
another window, but do not select that window (@code{dired-display-file}).
-@item Mouse-1
-@itemx Mouse-2
+@item mouse-1
+@itemx mouse-2
@findex dired-mouse-find-file-other-window
Visit the file whose name you clicked on
(@code{dired-mouse-find-file-other-window}). This uses another window
@findex flyspell-auto-correct-word
@findex flyspell-correct-word-before-point
When Flyspell mode highlights a word as misspelled, you can click on
-it with @kbd{Mouse-2} (@code{flyspell-correct-word}) to display a menu
+it with @kbd{mouse-2} (@code{flyspell-correct-word}) to display a menu
of possible corrections and actions. In addition, @kbd{C-.} or
@kbd{@key{ESC}-@key{TAB}} (@code{flyspell-auto-correct-word}) will
propose various successive corrections for the word at point, and
@cindex mouse buttons (what they do)
@cindex mouse, selecting text using
-@kindex Mouse-1
-@kindex Mouse-2
-@kindex Mouse-3
+@kindex mouse-1
+@kindex mouse-2
+@kindex mouse-3
@table @kbd
-@item Mouse-1
+@item mouse-1
Move point to where you click (@code{mouse-set-point}).
-@item Drag-Mouse-1
+@item Drag-mouse-1
Activate the region around the text selected by dragging, and put the
text in the primary selection (@code{mouse-set-region}).
-@item Mouse-2
+@item mouse-2
Move point to where you click, and insert the contents of the primary
selection there (@code{mouse-yank-primary}).
-@item Mouse-3
+@item mouse-3
If the region is active, move the nearer end of the region to the
click position; otherwise, set mark at the current value of point and
point at the click position. Save the resulting region in the kill
@findex mouse-set-point
The most basic mouse command is @code{mouse-set-point}, which is
-invoked by clicking with the left mouse button, @kbd{Mouse-1}, in the
+invoked by clicking with the left mouse button, @kbd{mouse-1}, in the
text area of a window. This moves point to the position where you
clicked. If that window was not the selected window, it becomes the
selected window.
@cindex mouse, dragging
@findex mouse-set-region
- Holding down @kbd{Mouse-1} and dragging the mouse over a stretch
+ Holding down @kbd{mouse-1} and dragging the mouse over a stretch
of text activates the region around that text
(@code{mouse-set-region}), placing the mark where you started holding
down the mouse button, and point where you release it (@pxref{Mark}).
@findex mouse-yank-primary
@findex mouse-yank-at-click
- Clicking with the middle mouse button, @kbd{Mouse-2}, moves point to
+ Clicking with the middle mouse button, @kbd{mouse-2}, moves point to
the position where you clicked and inserts the contents of the primary
selection (@code{mouse-yank-primary}). @xref{Primary Selection}.
This behavior is consistent with other X applications. Alternatively,
-you can rebind @kbd{Mouse-2} to @code{mouse-yank-at-click}, which
+you can rebind @kbd{mouse-2} to @code{mouse-yank-at-click}, which
performs a yank at the position you click.
@vindex mouse-yank-at-point
If you change the variable @code{mouse-yank-at-point} to a
-non-@code{nil} value, @kbd{Mouse-2} does not move point; it inserts
+non-@code{nil} value, @kbd{mouse-2} does not move point; it inserts
the text at point, regardless of where you clicked or even which of
the frame's windows you clicked on. This variable affects both
@code{mouse-yank-primary} and @code{mouse-yank-at-click}.
@findex mouse-save-then-kill
- Clicking with the right mouse button, @kbd{Mouse-3}, runs the
+ Clicking with the right mouse button, @kbd{mouse-3}, runs the
command @code{mouse-save-then-kill}. This performs several actions
depending on where you click and the status of the region:
@itemize @bullet
@item
-If no region is active, clicking @kbd{Mouse-3} activates the region,
+If no region is active, clicking @kbd{mouse-3} activates the region,
placing the mark where point was and point at the clicked position.
@item
-If a region is active, clicking @kbd{Mouse-3} adjusts the nearer end
+If a region is active, clicking @kbd{mouse-3} adjusts the nearer end
of the region by moving it to the clicked position. The adjusted
region's text is copied to the kill ring; if the text in the original
region was already on the kill ring, it replaces it there.
@item
If you originally specified the region using a double or triple
-@kbd{Mouse-1}, so that the region is defined to consist of entire
+@kbd{mouse-1}, so that the region is defined to consist of entire
words or lines (@pxref{Word and Line Mouse}), then adjusting the
-region with @kbd{Mouse-3} also proceeds by entire words or lines.
+region with @kbd{mouse-3} also proceeds by entire words or lines.
@item
-If you use @kbd{Mouse-3} a second time consecutively, at the same
+If you use @kbd{mouse-3} a second time consecutively, at the same
place, that kills the region already selected. Thus, the simplest way
-to kill text with the mouse is to click @kbd{Mouse-1} at one end, then
-click @kbd{Mouse-3} twice at the other end. To copy the text into the
-kill ring without deleting it from the buffer, press @kbd{Mouse-3}
-just once---or just drag across the text with @kbd{Mouse-1}. Then you
+to kill text with the mouse is to click @kbd{mouse-1} at one end, then
+click @kbd{mouse-3} twice at the other end. To copy the text into the
+kill ring without deleting it from the buffer, press @kbd{mouse-3}
+just once---or just drag across the text with @kbd{mouse-1}. Then you
can copy it elsewhere by yanking it.
@end itemize
@node Word and Line Mouse
@section Mouse Commands for Words and Lines
- These variants of @kbd{Mouse-1} select entire words or lines at a
+ These variants of @kbd{mouse-1} select entire words or lines at a
time. Emacs activates the region around the selected text, which is
also copied to the kill ring.
@table @kbd
-@item Double-Mouse-1
+@item Double-mouse-1
Select the text around the word which you click on.
Double-clicking on a character with symbol syntax (such as
constant (Emacs uses heuristics to figure out whether that character
is the beginning or the end of it).
-@item Double-Drag-Mouse-1
+@item Double-Drag-mouse-1
Select the text you drag across, in the form of whole words.
-@item Triple-Mouse-1
+@item Triple-mouse-1
Select the line you click on.
-@item Triple-Drag-Mouse-1
+@item Triple-Drag-mouse-1
Select the text you drag across, in the form of whole lines.
@end table
@node Mouse References
@section Following References with the Mouse
-@kindex Mouse-1 @r{(on buttons)}
-@kindex Mouse-2 @r{(on buttons)}
+@kindex mouse-1 @r{(on buttons)}
+@kindex mouse-2 @r{(on buttons)}
@cindex hyperlinks
@cindex links
@cindex text buttons
highlighting.
You can activate a button by moving point to it and typing
-@key{RET}, or by clicking either @kbd{Mouse-1} or @kbd{Mouse-2} on the
+@key{RET}, or by clicking either @kbd{mouse-1} or @kbd{mouse-2} on the
button. For example, in a Dired buffer, each file name is a button;
activating it causes Emacs to visit that file (@pxref{Dired}). In a
@file{*Compilation*} buffer, each error message is a button, and
activating it visits the source code for that error
(@pxref{Compilation}).
- Although clicking @kbd{Mouse-1} on a button usually activates the
+ Although clicking @kbd{mouse-1} on a button usually activates the
button, if you hold the mouse button down for a period of time before
releasing it (specifically, for more than 450 milliseconds), then
Emacs moves point where you clicked, without activating the button.
activating it. Dragging the mouse over or onto a button has its usual
behavior of setting the region, and does not activate the button.
- You can change how @kbd{Mouse-1} applies to buttons by customizing
+ You can change how @kbd{mouse-1} applies to buttons by customizing
the variable @code{mouse-1-click-follows-link}. If the value is a
positive integer, that determines how long you need to hold the mouse
button down for, in milliseconds, to cancel button activation; the
default is 450, as described in the previous paragraph. If the value
-is @code{nil}, @kbd{Mouse-1} just sets point where you clicked, and
+is @code{nil}, @kbd{mouse-1} just sets point where you clicked, and
does not activate buttons. If the value is @code{double}, double
clicks activate buttons but single clicks just set point.
@vindex mouse-1-click-in-non-selected-windows
- Normally, @kbd{Mouse-1} on a button activates the button even if it
+ Normally, @kbd{mouse-1} on a button activates the button even if it
is in a non-selected window. If you change the variable
@code{mouse-1-click-in-non-selected-windows} to @code{nil},
-@kbd{Mouse-1} on a button in an unselected window moves point to the
+@kbd{mouse-1} on a button in an unselected window moves point to the
clicked position and selects that window, without activating the
button.
bring up menus.
@table @kbd
-@item C-Mouse-1
-@kindex C-Mouse-1
+@item C-mouse-1
+@kindex C-mouse-1
This menu is for selecting a buffer.
The MSB (``mouse select buffer'') global minor mode makes this
menu smarter and more customizable. @xref{Buffer Menus}.
-@item C-Mouse-2
-@kindex C-Mouse-2
+@item C-mouse-2
+@kindex C-mouse-2
This menu contains entries for examining faces and other text
properties, and well as for setting them (the latter is mainly useful
when editing enriched text; @pxref{Enriched Text}).
-@item C-Mouse-3
-@kindex C-Mouse-3
+@item C-mouse-3
+@kindex C-mouse-3
This menu is mode-specific. For most modes if Menu-bar mode is on,
this menu has the same items as all the mode-specific menu-bar menus
put together. Some modes may specify a different menu for this
ones---so that you can access them without having to display the menu
bar.
-@item S-Mouse-1
+@item S-mouse-1
This menu is for changing the default face within the window's buffer.
@xref{Text Scale}.
@end table
- Some graphical applications use @kbd{Mouse-3} for a mode-specific
-menu. If you prefer @kbd{Mouse-3} in Emacs to bring up such a menu
+ Some graphical applications use @kbd{mouse-3} for a mode-specific
+menu. If you prefer @kbd{mouse-3} in Emacs to bring up such a menu
instead of running the @code{mouse-save-then-kill} command, rebind
-@kbd{Mouse-3} by adding the following line to your init file
+@kbd{mouse-3} by adding the following line to your init file
(@pxref{Init Rebinding}):
@c FIXME: `mouse-popup-menubar-stuff' is obsolete since 23.1.
section's commands do not apply in those areas.
@table @kbd
-@item Mouse-1
-@kindex Mouse-1 @r{(mode line)}
-@kbd{Mouse-1} on a mode line selects the window it belongs to. By
-dragging @kbd{Mouse-1} on the mode line, you can move it, thus
+@item mouse-1
+@kindex mouse-1 @r{(mode line)}
+@kbd{mouse-1} on a mode line selects the window it belongs to. By
+dragging @kbd{mouse-1} on the mode line, you can move it, thus
changing the height of the windows above and below. Changing heights
with the mouse in this way never deletes windows, it just refuses to
make any window smaller than the minimum height.
-@item Mouse-2
-@kindex Mouse-2 @r{(mode line)}
-@kbd{Mouse-2} on a mode line expands that window to fill its frame.
+@item mouse-2
+@kindex mouse-2 @r{(mode line)}
+@kbd{mouse-2} on a mode line expands that window to fill its frame.
-@item Mouse-3
-@kindex Mouse-3 @r{(mode line)}
-@kbd{Mouse-3} on a mode line deletes the window it belongs to. If the
+@item mouse-3
+@kindex mouse-3 @r{(mode line)}
+@kbd{mouse-3} on a mode line deletes the window it belongs to. If the
frame has only one window, it does nothing.
-@item C-Mouse-2
+@item C-mouse-2
@kindex C-mouse-2 @r{(mode line)}
-@kbd{C-Mouse-2} on a mode line splits that window, producing two
+@kbd{C-mouse-2} on a mode line splits that window, producing two
side-by-side windows with the boundary running through the click
position (@pxref{Split Window}).
@end table
-@kindex Mouse-1 @r{(scroll bar)}
- Furthermore, by clicking and dragging @kbd{Mouse-1} on the divider
+@kindex mouse-1 @r{(scroll bar)}
+ Furthermore, by clicking and dragging @kbd{mouse-1} on the divider
between two side-by-side mode lines, you can move the vertical
boundary to the left or right.
@cindex Vertical Scroll Bar
On graphical displays, there is a @dfn{vertical scroll bar} on the
-side of each Emacs window. Clicking @kbd{Mouse-1} on the scroll bar's
+side of each Emacs window. Clicking @kbd{mouse-1} on the scroll bar's
up and down buttons scrolls the window by one line at a time. Clicking
-@kbd{Mouse-1} above or below the scroll bar's inner box scrolls the
+@kbd{mouse-1} above or below the scroll bar's inner box scrolls the
window by nearly the entire height of the window, like @kbd{M-v} and
@kbd{C-v} respectively (@pxref{Moving Point}). Dragging the inner box
scrolls continuously.
If Emacs is compiled on the X Window System without X toolkit
-support, the scroll bar behaves differently. Clicking @kbd{Mouse-1}
+support, the scroll bar behaves differently. Clicking @kbd{mouse-1}
anywhere on the scroll bar scrolls forward like @kbd{C-v}, while
-@kbd{Mouse-3} scrolls backward like @kbd{M-v}. Clicking @kbd{Mouse-2}
+@kbd{mouse-3} scrolls backward like @kbd{M-v}. Clicking @kbd{mouse-2}
in the scroll bar lets you drag the inner box up and down.
@findex scroll-bar-mode
@cindex Horizontal Scroll Bar mode
On graphical displays with toolkit support, Emacs may also supply a
@dfn{horizontal scroll bar} on the bottom of each window. Clicking
-@kbd{Mouse-1} on the that scroll bar's left and right buttons scrolls
-the window horizontally by one column at a time. Clicking @kbd{Mouse-1}
+@kbd{mouse-1} on the that scroll bar's left and right buttons scrolls
+the window horizontally by one column at a time. Clicking @kbd{mouse-1}
on the left or right of the scroll bar's inner box scrolls the window by
four columns. Dragging the inner box scrolls the window continuously.
the use of menu bars at startup, customize the variable
@code{menu-bar-mode}.
-@kindex C-Mouse-3 @r{(when menu bar is disabled)}
+@kindex C-mouse-3 @r{(when menu bar is disabled)}
Expert users often turn off the menu bar, especially on text
terminals, where this makes one additional line available for text.
If the menu bar is off, you can still pop up a menu of its contents
-with @kbd{C-Mouse-3} on a display which supports pop-up menus.
+with @kbd{C-mouse-3} on a display which supports pop-up menus.
@xref{Menu Mouse Clicks}.
@xref{Menu Bar}, for information on how to invoke commands with the
For more information about a function definition, variable or symbol
property listed in an apropos buffer, you can click on it with
-@kbd{Mouse-1} or @kbd{Mouse-2}, or move there and type @key{RET}.
+@kbd{mouse-1} or @kbd{mouse-2}, or move there and type @key{RET}.
When you specify more than one word in the apropos pattern, a name
must contain at least two of the words in order to match. Thus, if
Move point forward to the next hyperlink (@code{forward-button}).
@item S-@key{TAB}
Move point back to the previous hyperlink (@code{backward-button}).
-@item Mouse-1
-@itemx Mouse-2
+@item mouse-1
+@itemx mouse-2
Follow a hyperlink that you click on.
@item C-c C-c
Show all documentation about the symbol at point
appears in the documentation in the help buffer, it is normally an
underlined @dfn{hyperlink}. To view the associated documentation,
move point there and type @key{RET} (@code{help-follow}), or click on
-the hyperlink with @kbd{Mouse-1} or @kbd{Mouse-2}. Doing so replaces
+the hyperlink with @kbd{mouse-1} or @kbd{mouse-2}. Doing so replaces
the contents of the help buffer; to retrace your steps, type @kbd{C-c
C-b} (@code{help-go-back}). While retracing your steps, you can go
forward by using @kbd{C-c C-b} (@code{help-go-forward}).
@table @kbd
@findex mouse-set-secondary
-@kindex M-Drag-Mouse-1
+@kindex M-Drag-mouse-1
@cindex secondary-selection face
-@item M-Drag-Mouse-1
+@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
(@code{mouse-set-secondary}). The selected text is highlighted, using
This command does not alter the kill ring.
@findex mouse-start-secondary
-@kindex M-Mouse-1
-@item M-Mouse-1
+@kindex M-mouse-1
+@item M-mouse-1
Set one endpoint for the @dfn{secondary selection}
(@code{mouse-start-secondary}).
@findex mouse-secondary-save-then-kill
-@kindex M-Mouse-3
-@item M-Mouse-3
+@kindex M-mouse-3
+@item M-mouse-3
Set the secondary selection, with one end at the position clicked and
-the other at the position specified with @kbd{M-Mouse-1}
+the other at the position specified with @kbd{M-mouse-1}
(@code{mouse-secondary-save-then-kill}). This also puts the selected
-text in the kill ring. A second @kbd{M-Mouse-3} at the same place
+text in the kill ring. A second @kbd{M-mouse-3} at the same place
kills the secondary selection just made.
@findex mouse-yank-secondary
-@kindex M-Mouse-2
-@item M-Mouse-2
+@kindex M-mouse-2
+@item M-mouse-2
Insert the secondary selection where you click, placing point at the
end of the yanked text (@code{mouse-yank-secondary}).
@end table
-Double or triple clicking of @kbd{M-Mouse-1} operates on words and
-lines, much like @kbd{Mouse-1}.
+Double or triple clicking of @kbd{M-mouse-1} operates on words and
+lines, much like @kbd{mouse-1}.
-If @code{mouse-yank-at-point} is non-@code{nil}, @kbd{M-Mouse-2} yanks
+If @code{mouse-yank-at-point} is non-@code{nil}, @kbd{M-mouse-2} yanks
at point. Then it does not matter precisely where you click, or even
which of the frame's windows you click on. @xref{Mouse Commands}.
@code{ns-alternate-modifier}; a value of @code{none} tells Emacs to
ignore them.
- @kbd{S-Mouse-1} adjusts the region to the click position,
-just like @kbd{Mouse-3} (@code{mouse-save-then-kill}); it does not pop
-up a menu for changing the default face, as @kbd{S-Mouse-1} normally
+ @kbd{S-mouse-1} adjusts the region to the click position,
+just like @kbd{mouse-3} (@code{mouse-save-then-kill}); it does not pop
+up a menu for changing the default face, as @kbd{S-mouse-1} normally
does (@pxref{Text Scale}). This change makes Emacs behave more like
other Mac / GNUstep applications.
On a graphical display, you can move the mouse over this mode line
indicator to pop up a tool-tip, which displays a more verbose
-description of the version control status. Pressing @kbd{Mouse-1}
+description of the version control status. Pressing @kbd{mouse-1}
over the indicator pops up a menu of VC commands, identical to
@samp{Tools / Version Control} on the menu bar.
@cindex stashes in version control
@cindex shelves in version control
The above commands are also available via the menu bar, and via a
-context menu invoked by @kbd{Mouse-2}. Furthermore, some VC backends
+context menu invoked by @kbd{mouse-2}. Furthermore, some VC backends
use the menu to provide extra backend-specific commands. For example,
Git and Bazaar allow you to manipulate @dfn{stashes} and @dfn{shelves}
(where are a way to temporarily put aside uncommitted changes, and
the same name), the command shows the candidate definitions in a
@file{*xref*} buffer, together with the files in which these
definitions are found. Selecting one of these candidates by typing
-@kbd{@key{RET}} or clicking @kbd{Mouse-2} will pop a buffer showing
+@kbd{@key{RET}} or clicking @kbd{mouse-2} will pop a buffer showing
the corresponding definition.
When entering the identifier argument to @kbd{M-.}, the usual
@table @kbd
@item @key{RET}
-@itemx Mouse-2
+@itemx mouse-2
Display the reference on the current line and bury the @file{*xref*}
buffer.
@item n
@item C-x C-x
Set the mark at point, and activate it; then move point where the mark
used to be (@code{exchange-point-and-mark}).
-@item Drag-Mouse-1
+@item Drag-mouse-1
Set point and the mark around the text you drag across.
-@item Mouse-3
+@item mouse-3
Set the mark at point, then move point to where you click
(@code{mouse-save-then-kill}).
@item @samp{Shifted cursor motion keys}
@findex minibuffer-inactive-mode
When not active, the minibuffer is in @code{minibuffer-inactive-mode},
-and clicking @kbd{Mouse-1} there shows the @file{*Messages*} buffer.
+and clicking @kbd{mouse-1} there shows the @file{*Messages*} buffer.
If you use a dedicated frame for minibuffers, Emacs also recognizes
certain keys there, for example @kbd{n} to make a new frame.
@table @kbd
@findex mouse-choose-completion
-@item Mouse-1
-@itemx Mouse-2
+@item mouse-1
+@itemx mouse-2
Clicking mouse button 1 or 2 on a completion alternative chooses it
(@code{mouse-choose-completion}).
the copy before resubmitting it. If you use this command on an output
line, it copies that line to the end of the buffer.
-@item Mouse-2
+@item mouse-2
If @code{comint-use-prompt-regexp} is @code{nil} (the default), copy
the old input command that you click on, inserting the copy at the end
of the buffer (@code{comint-insert-input}). If
@end table
Moving to a previous input and then copying it with @kbd{C-c
-@key{RET}} or @kbd{Mouse-2} produces the same results---the same
+@key{RET}} or @kbd{mouse-2} produces the same results---the same
buffer contents---that you would get by using @kbd{M-p} enough times
to fetch that previous input from the history list. However, @kbd{C-c
@key{RET}} copies the text from the buffer, which can be different
@file{*Printing Interface*} buffer, similar to a customization buffer,
where you can set the printing options. After selecting what and how
to print, you start the print job using the @samp{Print} button (click
-@kbd{Mouse-2} on it, or move point over it and type @key{RET}). For
+@kbd{mouse-2} on it, or move point over it and type @key{RET}). For
further information on the various options, use the @samp{Interface
Help} button.
is enabled, it finds all the URLs in the buffer, highlights them, and
turns them into clickable buttons. You can follow the URL by typing
@kbd{C-c @key{RET}} (@code{goto-address-at-point}) while point is on
-its text; or by clicking with @kbd{Mouse-2}, or by clicking
-@kbd{Mouse-1} quickly (@pxref{Mouse References}). Following a URL is
+its text; or by clicking with @kbd{mouse-2}, or by clicking
+@kbd{mouse-1} quickly (@pxref{Mouse References}). Following a URL is
done by calling @code{browse-url} as a subroutine
(@pxref{Browse-URL}).
@code{ffap-dired-other-frame}, analogous to @code{dired-other-frame}.
@item M-x ffap-next
Search buffer for next file name or URL, then find that file or URL.
-@item S-Mouse-3
-@kindex S-Mouse-3 @r{(FFAP)}
+@item S-mouse-3
+@kindex S-mouse-3 @r{(FFAP)}
@code{ffap-at-mouse} finds the file guessed from text around the position
of a mouse click.
-@item C-S-Mouse-3
-@kindex C-S-Mouse-3 @r{(FFAP)}
+@item C-S-mouse-3
+@kindex C-S-mouse-3 @r{(FFAP)}
Display a menu of files and URLs mentioned in current buffer, then
find the one you select (@code{ffap-menu}).
@end table
(@pxref{Menu Bar}).
@end ifnottex
Scroll bars don't work in MS-DOS Emacs. PC mice usually have only
-two buttons; these act as @kbd{Mouse-1} and @kbd{Mouse-2}, but if you
-press both of them together, that has the effect of @kbd{Mouse-3}. If
+two buttons; these act as @kbd{mouse-1} and @kbd{mouse-2}, but if you
+press both of them together, that has the effect of @kbd{mouse-3}. If
the mouse does have 3 buttons, Emacs detects that at startup, and all
the 3 buttons function normally, as on X.
of the current row and uses it as input.
@key{TAB} in these Chinese input methods displays a buffer showing
-all the possible characters at once; then clicking @kbd{Mouse-2} on
+all the possible characters at once; then clicking @kbd{mouse-2} on
one of them selects that alternative. The keys @kbd{C-f}, @kbd{C-b},
@kbd{C-n}, @kbd{C-p}, and digits continue to work as usual, but they
do the highlighting in the buffer showing the possible characters,
the current buffer (i.e., the coding system to use when saving or
reverting the file). You specify which coding system using the
minibuffer. You can also invoke this command by clicking with
-@kbd{Mouse-3} on the coding system indicator in the mode line
+@kbd{mouse-3} on the coding system indicator in the mode line
(@pxref{Mode Line}).
If you specify a coding system that cannot handle all the characters
@kindex C-c @@ C-M-s
@kindex C-c @@ C-r
@kindex C-c @@ C-l
-@kindex S-Mouse-2
+@kindex S-mouse-2
@table @kbd
@item C-c @@ C-h
Hide the current block (@code{hs-hide-block}).
Show the current block (@code{hs-show-block}).
@item C-c @@ C-c
Either hide or show the current block (@code{hs-toggle-hiding}).
-@item S-Mouse-2
+@item S-mouse-2
Toggle hiding for the block you click on (@code{hs-mouse-toggle-hiding}).
@item C-c @@ C-M-h
Hide all top-level blocks (@code{hs-hide-all}).
@end example
@noindent
-Then you can browse these URLs by clicking on them with @kbd{Mouse-2}
-(or @kbd{Mouse-1} quickly) or by moving to one and typing @kbd{C-c
+Then you can browse these URLs by clicking on them with @kbd{mouse-2}
+(or @kbd{mouse-1} quickly) or by moving to one and typing @kbd{C-c
@key{RET}}. @xref{Goto Address mode, Activating URLs, Activating URLs}.
@node Rmail Coding
@cindex incremental search, edit search string
@cindex interactively edit search string
@kindex M-e @r{(Incremental search)}
-@kindex Mouse-1 @r{in the minibuffer (Incremental Search)}
+@kindex mouse-1 @r{in the minibuffer (Incremental Search)}
To edit the current search string in the minibuffer without
replacing it with items from the search ring, type @kbd{M-e} or click
-@kbd{Mouse-1} in the minibuffer. Type @key{RET}, @kbd{C-s} or
+@kbd{mouse-1} in the minibuffer. Type @key{RET}, @kbd{C-s} or
@kbd{C-r} to finish editing the string and search for it. Type
@kbd{C-f} or @kbd{@key{RIGHT}} to add to the search string characters
following point from the buffer from which you started the search.
@kindex C-y @r{(Incremental search)}
@kindex M-y @r{(Incremental search)}
-@kindex Mouse-2 @r{in the minibuffer (Incremental search)}
+@kindex mouse-2 @r{in the minibuffer (Incremental search)}
@findex isearch-yank-kill
@findex isearch-yank-pop
@findex isearch-yank-x-selection
appends the current kill to the search string. @kbd{M-y}
(@code{isearch-yank-pop}), if called after @kbd{C-y}, replaces that
appended text with an earlier kill, similar to the usual @kbd{M-y}
-(@code{yank-pop}) command (@pxref{Yanking}). Clicking @kbd{Mouse-2}
+(@code{yank-pop}) command (@pxref{Yanking}). Clicking @kbd{mouse-2}
in the echo area appends the current X selection (@pxref{Primary
Selection}) to the search string (@code{isearch-yank-x-selection}).
folds, and for showing and hiding text:
@table @asis
-@item @kbd{C-M-Mouse-1} zooms in on the heading clicked on
+@item @kbd{C-M-mouse-1} zooms in on the heading clicked on
@itemize @w{}
@item
single click: expose body.
@item
quad click: expose entire subtree.
@end itemize
-@item @kbd{C-M-Mouse-2} exposes text under the heading clicked on
+@item @kbd{C-M-mouse-2} exposes text under the heading clicked on
@itemize @w{}
@item
single click: expose body.
@item
quad click: expose entire subtree.
@end itemize
-@item @kbd{C-M-Mouse-3} hides text under the heading clicked on or exits fold
+@item @kbd{C-M-mouse-3} hides text under the heading clicked on or exits fold
@itemize @w{}
@item
single click: hide subtree.
The easiest way to alter properties is with the @samp{Text
Properties} menu. You can get to this menu from the @samp{Edit} menu
-in the menu bar (@pxref{Menu Bar}), or with @kbd{C-Mouse-2}
+in the menu bar (@pxref{Menu Bar}), or with @kbd{C-mouse-2}
(@pxref{Menu Mouse Clicks}). Some of the commands in the @samp{Text
Properties} menu are listed below (you can also invoke them with
@kbd{M-x}):
@item C-x 3
Split the selected window into two windows, positioned side by side
(@code{split-window-right}).
-@item C-Mouse-2
+@item C-mouse-2
In the mode line of a window, split that window.
@end table
On text terminals, side-by-side windows are separated by a vertical
divider which is drawn using the @code{vertical-border} face.
-@kindex C-Mouse-2 @r{(mode line)}
-@kindex C-Mouse-2 @r{(scroll bar)}
- If you click @kbd{C-Mouse-2} in the mode line of a window, that
+@kindex C-mouse-2 @r{(mode line)}
+@kindex C-mouse-2 @r{(scroll bar)}
+ If you click @kbd{C-mouse-2} in the mode line of a window, that
splits the window, putting a vertical divider where you click.
Depending on how Emacs is compiled, you can also split a window by
-clicking @kbd{C-Mouse-2} in the scroll bar, which puts a horizontal
+clicking @kbd{C-mouse-2} in the scroll bar, which puts a horizontal
divider where you click (this feature does not work when Emacs uses
GTK+ scroll bars).
Select another window (@code{other-window}).
@item C-M-v
Scroll the next window (@code{scroll-other-window}).
-@item Mouse-1
-@kbd{Mouse-1}, in the text area of a window, selects the window and
+@item mouse-1
+@kbd{mouse-1}, in the text area of a window, selects the window and
moves point to the position clicked. Clicking in the mode line
selects the window without moving point in it.
@end table
@item follow-link
@kindex follow-link @r{(button property)}
-The follow-link property, defining how a @key{Mouse-1} click behaves
+The follow-link property, defining how a @key{mouse-1} click behaves
on this button, @xref{Clickable Text}.
@item button
@code{button-buffer-map} as a parent keymap for its keymap.
If the button has a non-@code{nil} @code{follow-link} property, and
-@code{mouse-1-click-follows-link} is set, a quick @key{Mouse-1} click
+@code{mouse-1-click-follows-link} is set, a quick @key{mouse-1} click
will also activate the @code{push-button} command.
@xref{Clickable Text}.
Implementing a link involves three separate steps: (1) indicating
clickability when the mouse moves over the link; (2) making @key{RET}
-or @kbd{Mouse-2} on that link do something; and (3) setting up a
+or @kbd{mouse-2} on that link do something; and (3) setting up a
@code{follow-link} condition so that the link obeys
@code{mouse-1-click-follows-link}.
help-echo "mouse-2: visit this file in other window")))
@end smallexample
- To make the link clickable, bind @key{RET} and @kbd{Mouse-2} to
+ To make the link clickable, bind @key{RET} and @kbd{mouse-2} to
commands that perform the desired action. Each command should check
to see whether it was called on a link, and act accordingly. For
-instance, Dired's major mode keymap binds @kbd{Mouse-2} to the
+instance, Dired's major mode keymap binds @kbd{mouse-2} to the
following command:
@smallexample
@noindent
With this method, you can easily define different commands for
different links. Furthermore, the global definition of @key{RET} and
-@kbd{Mouse-2} remain available for the rest of the text in the buffer.
+@kbd{mouse-2} remain available for the rest of the text in the buffer.
@vindex mouse-1-click-follows-link
- The basic Emacs command for clicking on links is @kbd{Mouse-2}.
+ The basic Emacs command for clicking on links is @kbd{mouse-2}.
However, for compatibility with other graphical applications, Emacs
-also recognizes @kbd{Mouse-1} clicks on links, provided the user
+also recognizes @kbd{mouse-1} clicks on links, provided the user
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}.
property). The value of the @code{follow-link} property, or the
binding for the @code{follow-link} event, acts as a condition for
the link action. This condition tells Emacs two things: the
-circumstances under which a @kbd{Mouse-1} click should be regarded as
+circumstances under which a @kbd{mouse-1} click should be regarded as
occurring inside the link, and how to compute an action code
-that says what to translate the @kbd{Mouse-1} click into. The link
+that says what to translate the @kbd{mouse-1} click into. The link
action condition can be one of the following:
@table @asis
a link if there is a non-@code{nil} @code{mouse-face} property at that
position. The action code is always @code{t}.
-For example, here is how Info mode handles @key{Mouse-1}:
+For example, here is how Info mode handles @key{mouse-1}:
@smallexample
(define-key Info-mode-map [follow-link] 'mouse-face)
non-@code{nil}. The value returned by @var{func} serves as the action
code.
-For example, here is how pcvs enables @kbd{Mouse-1} to follow links on
+For example, here is how pcvs enables @kbd{mouse-1} to follow links on
file names only:
@smallexample
@end table
@noindent
-The action code tells @kbd{Mouse-1} how to follow the link:
+The action code tells @kbd{mouse-1} how to follow the link:
@table @asis
@item a string or vector
-If the action code is a string or vector, the @kbd{Mouse-1} event is
+If the action code is a string or vector, the @kbd{mouse-1} event is
translated into the first element of the string or vector; i.e., the
-action of the @kbd{Mouse-1} click is the local or global binding of
+action of the @kbd{mouse-1} click is the local or global binding of
that character or symbol. Thus, if the action code is @code{"foo"},
-@kbd{Mouse-1} translates into @kbd{f}. If it is @code{[foo]},
-@kbd{Mouse-1} translates into @key{foo}.
+@kbd{mouse-1} translates into @kbd{f}. If it is @code{[foo]},
+@kbd{mouse-1} translates into @key{foo}.
@item anything else
-For any other non-@code{nil} action code, the @kbd{Mouse-1} event is
-translated into a @kbd{Mouse-2} event at the same position.
+For any other non-@code{nil} action code, the @kbd{mouse-1} event is
+translated into a @kbd{mouse-2} event at the same position.
@end table
- To define @kbd{Mouse-1} to activate a button defined with
+ To define @kbd{mouse-1} to activate a button defined with
@code{define-button-type}, give the button a @code{follow-link}
property. The property value should be a link action condition, as
described above. @xref{Buttons}. For example, here is how Help mode
-handles @kbd{Mouse-1}:
+handles @kbd{mouse-1}:
@smallexample
(define-button-type 'help-xref
'action #'help-button-action)
@end smallexample
- To define @kbd{Mouse-1} on a widget defined with
+ To define @kbd{mouse-1} on a widget defined with
@code{define-widget}, give the widget a @code{:follow-link} property.
The property value should be a link action condition, as described
above. For example, here is how the @code{link} widget specifies that
-a @key{Mouse-1} click shall be translated to @key{RET}:
+a @key{mouse-1} click shall be translated to @key{RET}:
@smallexample
(define-widget 'link 'item
when the mouse moves over a sensitive region.
@cindex context menu
-A click with @kbd{Mouse-3} on a mouse-sensitive region opens a context
+A click with @kbd{mouse-3} on a mouse-sensitive region opens a context
menu. In addition to this, each buffer also has a buffer-specific menu
-that is opened with a click with @kbd{Mouse-3} somewhere in the buffer
+that is opened with a click with @kbd{mouse-3} somewhere in the buffer
where no highlight is displayed.
@end table
The same functionality is available from the menu opened with
-@kbd{Mouse-3} on the class name.
+@kbd{mouse-3} on the class name.
@end table
These lists are also available from the class' context menu invoked with
-@kbd{Mouse-3} on the class name.
+@kbd{mouse-3} on the class name.
class declaration or definition has been found, or when it is not found.
All the commands described above can also be found in the context menu
-displayed when clicking @kbd{Mouse-2} on a member name.
+displayed when clicking @kbd{mouse-2} on a member name.
the source. Type @kbd{C-x `} to step through the offending lines one by
one (starting with Emacs 22, you can also use @kbd{M-g M-p} and
@kbd{M-g M-n} to go to the previous and next matches directly). Click
-@kbd{Mouse-2} or press @key{RET} on a message text in the
+@kbd{mouse-2} or press @key{RET} on a message text in the
@file{*compilation*} buffer to go to the line whose number is mentioned
in that message.
Not all modifiers are permitted in all situations. @key{Hyper},
@key{Super}, and @key{Alt} are not available on Unix character
terminals. Non-@acronym{ASCII} keys and mouse events (e.g., @kbd{C-=} and
-@kbd{Mouse-1}) also fall under this category.
+@kbd{mouse-1}) also fall under this category.
@end itemize
@kindex M-?
In any IDL program (or, as with most IDLWAVE commands, in the IDL
Shell), press @kbd{M-?} (@code{idlwave-context-help}), or click with
-@kbd{S-Mouse-3} to access context sensitive online help. The following
+@kbd{S-mouse-3} to access context sensitive online help. The following
locations are recognized context for help:
@cindex Context, for online help
@itemize @bullet
@item
Online help for routines and keywords can be accessed through the
-Routine Info display. Click with @kbd{Mouse-3} on an item to see the
+Routine Info display. Click with @kbd{mouse-3} on an item to see the
corresponding help (@pxref{Routine Info}).
@item
When using completion and Emacs pops up a @file{*Completions*} buffer
-with possible completions, clicking with @kbd{Mouse-3} on a completion
+with possible completions, clicking with @kbd{mouse-3} on a completion
item invokes help on that item (@pxref{Completion}). Items for which
help is available in the online system documentation (vs. just the
program source itself) will be emphasized (e.g., colored blue).
If the list of completions is too long to fit in the
@file{*Completions*} window, the window can be scrolled by pressing
@kbd{M-@key{TAB}} repeatedly. Online help (if installed) for each
-possible completion is available by clicking with @kbd{Mouse-3} on the
+possible completion is available by clicking with @kbd{mouse-3} on the
item. Items for which system online help (from the IDL manual) is
available will be emphasized (e.g., colored blue). For other items, the
corresponding source code or DocLib header will be used as the help
In recent IDLWAVE versions, the breakpoint line is highlighted when the
mouse is moved over it, and a tooltip pops up describing the break
-details. @kbd{Mouse-3} on the breakpoint line pops up a menu of
+details. @kbd{mouse-3} on the breakpoint line pops up a menu of
breakpoint actions, including clearing, disabling, and adding or
changing break conditions or ``after'' break count.
For added speed and convenience, there are mouse bindings which allow
you to click on expressions and examine their values. Use
-@kbd{S-Mouse-2} to print an expression and @kbd{C-M-Mouse-2} to invoke
+@kbd{S-mouse-2} to print an expression and @kbd{C-M-mouse-2} to invoke
help (i.e., you need to hold down @key{META} and @key{CONTROL} while
clicking with the middle mouse button). If you simply click, the
nearest expression will be selected in the same manner as described
key and mouse bindings.
The most powerful and flexible mouse examine command of all is
-available on @kbd{C-S-Mouse-2}. Just as for all the other mouse
+available on @kbd{C-S-mouse-2}. Just as for all the other mouse
examine commands, it permits click or drag expression selection, but
instead of sending hard-coded commands to the shell, it pops-up a
customizable selection list of examine functions to choose among,
that subtopic's node.
@cindex mouse support in Info mode
-@kindex Mouse-2 @r{(Info mode)}
+@kindex mouse-2 @r{(Info mode)}
If your terminal supports a mouse, you have yet another way of going
to a subtopic. Move your mouse pointer to the subtopic line,
somewhere between the beginning @samp{*} and the colon @samp{:} which
change its appearance (usually, its background color will change), and
the shape of the mouse pointer will change if your platform supports
that. After a while, if you leave the mouse on that spot, a small
-window will pop up, saying ``Mouse-2: go to that node,'' or the same
+window will pop up, saying ``mouse-2: go to that node,'' or the same
message may appear at the bottom of the screen.
- @kbd{Mouse-2} is the second button of your mouse counting from the
+ @kbd{mouse-2} is the second button of your mouse counting from the
left---the middle button on a 3-button mouse. (On a 2-button mouse,
you may have to press both buttons together to ``press the middle
-button''.) The message tells you pressing @kbd{Mouse-2} with the
+button''.) The message tells you pressing @kbd{mouse-2} with the
current position of the mouse pointer (on subtopic in the menu) will
go to that subtopic.
@findex Info-mouse-follow-nearest-node
- More generally, @kbd{Mouse-2} in an Info buffer finds the nearest
+ More generally, @kbd{mouse-2} in an Info buffer finds the nearest
link to another node and goes there. For example, near a cross
reference it acts like @kbd{f}, in a menu it acts like @kbd{m}, on the
node's header line it acts like @kbd{n}, @kbd{p}, or @kbd{u}, etc. At
-end of the node's text @kbd{Mouse-2} moves to the next node, or up if
+end of the node's text @kbd{mouse-2} moves to the next node, or up if
there's no next node.
@format
readers may put you at the @emph{front} of the node instead---to get
back to where you were reading, you have to type some @key{SPC}s.)
- Another way to go Up is to click @kbd{Mouse-2} on the @samp{Up}
+ Another way to go Up is to click @kbd{mouse-2} on the @samp{Up}
pointer shown in the header line (provided that you have a mouse).
@format
@findex Info-follow-reference
You can follow a cross reference by moving the cursor to it and
press @key{RET}, just as in a menu. In Emacs, you can also click
-@kbd{Mouse-1} on a cross reference to follow it; you can see that the
+@kbd{mouse-1} on a cross reference to follow it; you can see that the
cross reference is mouse-sensitive by moving the mouse pointer to the
reference and watching how the underlying text and the mouse pointer
change in response.
@findex display-time
@vindex read-mail-command
-There are some commands that need to read mail, such as @kbd{Mouse-2}
+There are some commands that need to read mail, such as @kbd{mouse-2}
over the @samp{Mail} button that @code{display-time} adds to the mode
line. You can configure Emacs to have these commands use MH-E by
setting the option @code{read-mail-command} to @samp{mh-rmail}.
Unpack message created with @command{uudecode} or @command{shar}
(@code{mh-store-msg}).
@c -------------------------
-@kindex Mouse-2
+@kindex mouse-2
@findex mh-show-mouse
-@item Mouse-2
+@item mouse-2
Move point to mouse event and show message (@code{mh-show-mouse}).
@end table
@table @kbd
@kindex @key{RET}
-@kindex Mouse-1
-@kindex Mouse-2
+@kindex mouse-1
+@kindex mouse-2
@findex mh-press-button
@item @key{RET}
-@itemx Mouse-1
-@itemx Mouse-2
+@itemx mouse-1
+@itemx mouse-2
View contents of button (@code{mh-press-button}).
@end table
@kindex @key{BS}
@kindex @key{RET}
@kindex @key{SPC}
-@kindex Mouse-2
+@kindex mouse-2
The command @key{RET} (@code{mh-show}) displays the message that the
-cursor is on while @kbd{Mouse-2} (@code{mh-show-mouse}) displays the
+cursor is on while @kbd{mouse-2} (@code{mh-show-mouse}) displays the
message that the mouse cursor is on. If the message is already
displayed, it scrolls to the beginning of the message. Use @key{SPC}
(@code{mh-page-msg}) and @key{BS} (@code{mh-previous-page}) to move
@cindex links, following
@findex goto-address-at-point
@kindex C-c @key{RET}
-@kindex Mouse-2
+@kindex mouse-2
@vindex goto-address-highlight-p
Email addresses and URLs in the message are highlighted if the option
@code{goto-address-highlight-p} is on, which it is by default. To view
the web page for a highlighted URL or to send a message using a
-highlighted email address, use @kbd{Mouse-2} or @kbd{C-c @key{RET}}
+highlighted email address, use @kbd{mouse-2} or @kbd{C-c @key{RET}}
(@code{goto-address-at-point}). @xref{Sending Mail}, to see how to
configure Emacs to send the message using MH-E.
@kindex @key{RET}
@kindex K @key{TAB}
@kindex K S-@key{TAB}
-@kindex Mouse-1
-@kindex Mouse-2
+@kindex mouse-1
+@kindex mouse-2
-To view the contents of the button, use either @kbd{Mouse-1} or
-@kbd{Mouse-2} on the button or @key{RET} (@code{mh-press-button}) when
+To view the contents of the button, use either @kbd{mouse-1} or
+@kbd{mouse-2} on the button or @key{RET} (@code{mh-press-button}) when
the cursor is over the button. This command is a toggle so if you use
it again on the same attachment, it is hidden. If Emacs does not know
how to display the attachment, then Emacs offers to save the
@table @asis
@cindex browser, @samp{w3m}
@cindex @samp{w3m}
-@kindex Mouse-2
+@kindex mouse-2
@item @samp{w3m} 7
The @samp{w3m} browser requires an external program. It's quick,
produces pretty nice output, and best of all, it's the only browser
-that highlights links. These can be clicked with @kbd{Mouse-2} to view
+that highlights links. These can be clicked with @kbd{mouse-2} to view
the content of the link in @samp{w3m}. The @samp{w3m} browser handles
tables well and actually respects the table's width parameter (which
can cause text to wrap if the author didn't anticipate that the page
@cindex @file{.emacs}
@cindex files, @file{.emacs}
@findex browse-url-at-mouse
-@kindex S-Mouse-2
+@kindex S-mouse-2
A useful key binding that you can add to @file{~/.emacs} is the
following which displays an HTML link or textual URL in an external
@findex mh-visit-folder
@kindex F v
@kindex M-x speedbar
-@kindex Mouse-2
+@kindex mouse-2
You can also use the speedbar
@ifnothtml
to view your folders. To bring up the speedbar, run @kbd{M-x speedbar
@key{RET}}. You will see a new frame appear with all of your MH
folders. Folders with unseen messages appear in boldface. Click on a
-folder name with @kbd{Mouse-2} to visit that folder in a similar
+folder name with @kbd{mouse-2} to visit that folder in a similar
fashion to the command @kbd{F v} (@code{mh-visit-folder})
(@pxref{Folders}). Click on the @samp{+} icon to expand and view the
sub-folders of that folder.
@findex delete-frame
@kindex C-x 5 0
-@kindex Mouse-3
+@kindex mouse-3
-You can click on @kbd{Mouse-3} to bring up a context menu that
+You can click on @kbd{mouse-3} to bring up a context menu that
contains these items. Dismiss the speedbar with @kbd{C-x 5 0}
(@code{delete-frame}).
text area. This allows you to keep that declaration line in view at
all times, even if it is scrolls off the ``top'' of the screen.
-In addition, clicking @kbd{Mouse-1} on the header line opens a context
+In addition, clicking @kbd{mouse-1} on the header line opens a context
menu that contains menu items for copying, killing, or narrowing to
that tag.
of the current function or tag (that is to say, the first line that
describes the rest of the construct).
-In addition, clicking @kbd{Mouse-3} on the highlighted declaration
+In addition, clicking @kbd{mouse-3} on the highlighted declaration
line opens a context menu that contains menu items for copying,
killing, or narrowing to that tag.
the needs of that mode.
Throughout this manual, activities are defined as ``clicking on'', or
-``expanding'' items. Clicking means using @kbd{Mouse-2} on a
+``expanding'' items. Clicking means using @kbd{mouse-2} on a
button. Expanding refers to clicking on an expansion button to display
an expanded summary of the entry the expansion button is
on. @xref{Basic Navigation}.
The mouse bindings are:
@table @kbd
-@item Mouse-1
+@item mouse-1
Move cursor to that location.
-@item Mouse-2
-@itemx Double-Mouse-1
-Activate the current button. @kbd{Double-Mouse-1} is called a @dfn{double
+@item mouse-2
+@itemx Double-mouse-1
+Activate the current button. @kbd{Double-mouse-1} is called a @dfn{double
click} on other platforms, and is useful for windows users with two
button mice.
-@c Isn't it true that with two-button mice, the right button is Mouse-2?
-@c On GNU/Linux, the right button is Mouse-3.
-@item S-Mouse-2
-@itemx S-Double-Mouse-1
+@c Isn't it true that with two-button mice, the right button is mouse-2?
+@c On GNU/Linux, the right button is mouse-3.
+@item S-mouse-2
+@itemx S-Double-mouse-1
@cindex power click
-This has the same effect as @kbd{Mouse-2}, except it is called a power
+This has the same effect as @kbd{mouse-2}, except it is called a power
click. This means that if a group with an expansion button @samp{+} is
clicked, any caches are flushed, and subitems re-read. If it is a name,
it will be opened in a new frame.
-@item Mouse-3
+@item mouse-3
Activate the speedbar menu. The item selected affects the line clicked,
not the line where the cursor was.
-@item Mouse-1 @r{(mode line)}
+@item mouse-1 @r{(mode line)}
Activate the menu. This affects the item the cursor is on before the
click, since the mouse was not clicked on anything.
-@item C-Mouse-1
+@item C-mouse-1
Buffers sub-menu. The buffer in the attached frame is switched.
@end table
specialized modes make it easier to navigate the relevant pieces of
information, such as files and directories, or buffers.
-In the main menu, found by clicking @kbd{Mouse-3}, there is a submenu
+In the main menu, found by clicking @kbd{mouse-3}, there is a submenu
labeled @samp{Displays}. This submenu lets you easily choose between
different display modes.
Note: while loading initially, Viper binds this mouse action only if it is
not already bound to something else. If you want to use the mouse-search
-feature, and the @kbd{Meta-Shift-Mouse-1} mouse action is already bound to
+feature, and the @kbd{Meta-Shift-mouse-1} mouse action is already bound to
something else, you can rebind the mouse-search feature by setting
@code{viper-mouse-search-key} to something else in
your Viper customization file:
@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{S-mouse-1}
+@kindex @kbd{S-mouse-2}
@kindex @kbd{meta shift button1up}
@kindex @kbd{meta shift button2up}
@vindex @code{viper-multiclick-timeout}
insert commands in of Viper:
@table @kbd
-@item S-Mouse-1
+@item S-mouse-1
Holding Shift and clicking mouse button 1 will
initiate search for
a region under the mouse pointer.
already bound to something else.
@xref{Viper Specials}, for more information.
-@item S-Mouse-2
+@item S-mouse-2
Holding Shift and clicking button 2 of the mouse will
insert a region surrounding the mouse pointer.
This command can also take a prefix argument.
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{S-mouse-1}
+@kindex @kbd{S-mouse-2}
@kindex @kbd{meta button1up}
@kindex @kbd{meta button2up}
@code{widget-global-map} (by default the global map).
@end deffn
-@kindex Mouse-2 @r{(on button widgets})
-@item Mouse-2
+@kindex mouse-2 @r{(on button widgets})
+@item mouse-2
@deffn Command widget-button-click @var{event}
Invoke the button at the location of the mouse pointer. If the mouse
pointer is located in an editable text field, invoke the binding in
@findex widget-button-click
@defvr Const widget-keymap
@key{TAB} and @kbd{C-@key{TAB}} are bound to @code{widget-forward} and
-@code{widget-backward}, respectively. @key{RET} and @kbd{Mouse-2}
+@code{widget-backward}, respectively. @key{RET} and @kbd{mouse-2}
are bound to @code{widget-button-press} and
@code{widget-button-click}.
@end defvr
easily be directed to follow the reference, i.e., to find and format the
man page. When the mouse is passed over a correctly formatted reference
it is highlighted, in which case clicking the middle button
-@kbd{Mouse-2} will cause WoMan to follow the reference. Alternatively,
+@kbd{mouse-2} will cause WoMan to follow the reference. Alternatively,
when point is over such a reference the key @key{RET} will follow the
reference.
Any word in the buffer can be used as a reference by clicking
-@kbd{Mouse-2} over it provided the Meta key is also used (although in
+@kbd{mouse-2} over it provided the Meta key is also used (although in
general such a ``reference'' will not lead to a man page).
Alternatively, the key @kbd{r} allows completion to be used to select a
reference to follow, based on the word at point as default.
@table @kbd
-@item @kbd{Mouse-2}
-@kindex Mouse-2
+@item @kbd{mouse-2}
+@kindex mouse-2
@findex woman-mouse-2
Run WoMan with word under mouse as topic (@code{woman-mouse-2}). The
word must be mouse-highlighted unless @code{woman-mouse-2} is used with
projects / emacs.git / commitdiff