changeset 99040:b9877df5d1a8

Use @kbd instead of @key for mouse commands throughout.

--- a/doc/emacs/frames.texi	Wed Oct 22 19:10:03 2008 +0000
+++ b/doc/emacs/frames.texi	Wed Oct 22 19:11:14 2008 +0000
@@ -76,7 +76,7 @@
 @kindex Mouse-1
 @kindex Mouse-2
 @kindex Mouse-3
-@table @key
+@table @kbd
 @item Mouse-1
 Move point to where you click (@code{mouse-set-point}).
 
@@ -97,7 +97,7 @@
 
 @findex mouse-set-point
   The most basic mouse command is @code{mouse-set-point}, which is
-called by clicking with the left mouse button, @key{Mouse-1}, in the
+called 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.
 
@@ -115,7 +115,7 @@
 
 @findex mouse-set-region
 @vindex mouse-drag-copy-region
-  Holding down @key{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}).  @xref{Mark}.  Emacs places the mark where
 you started holding down the mouse button, and point where you release
@@ -133,7 +133,7 @@
 
 @findex mouse-yank-at-click
 @vindex mouse-yank-at-point
-  Clicking with the middle mouse button, @key{Mouse-2}, moves point to
+  Clicking with the middle mouse button, @kbd{Mouse-2}, moves point to
 the position where you clicked and performs a yank
 (@code{mouse-yank-at-click}).  @xref{Yanking}.  If you change the
 variable @code{mouse-yank-at-point} to a non-@code{nil} value,
@@ -143,35 +143,35 @@
 primary and secondary selections (@pxref{Cut/Paste Other App}).
 
 @findex mouse-save-then-kill
-  Clicking with the right mouse button, @key{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 @key{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.
 In addition, the text in the region is copied to the kill ring.
 
 @item
-If a region is active, clicking @key{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
-@key{Mouse-1}, so that the region is defined to consist of entire
-words or lines, then adjusting the region with @key{Mouse-3} also
+@kbd{Mouse-1}, so that the region is defined to consist of entire
+words or lines, then adjusting the region with @kbd{Mouse-3} also
 proceeds by entire words or lines.
 
 @item
-If you use @key{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 @key{Mouse-1} at one end, then
-click @key{Mouse-3} twice at the other end.  To copy the text into the
-kill ring without deleting it from the buffer, press @key{Mouse-3}
-just once---or just drag across the text with @key{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
 
@@ -202,7 +202,7 @@
 time.  Emacs activates the region around the selected text, which is
 also copied to the kill ring.
 
-@table @key
+@table @kbd
 @item Double-Mouse-1
 Select the text around the word which you click on.
 
@@ -242,7 +242,7 @@
   Under X, whenever you select some text in Emacs by dragging or
 clicking the mouse (@pxref{Mouse Commands}), it is also saved in the
 primary selection.  You can then @dfn{paste} that text into any other
-X application, usually by clicking @key{Mouse-2} in that application.
+X application, usually by clicking @kbd{Mouse-2} in that application.
 Unlike the Emacs kill ring (@pxref{Kill Ring}), the primary selection
 has no ``memory'': each time you save something in the primary
 selection, either in Emacs or in another X application, the previous
@@ -275,7 +275,7 @@
 of @code{x-cut-buffer-max} (the default is 20000 characters).
 
   You can yank the primary selection into Emacs using the usual yank
-commands, such as @kbd{C-y} (@code{yank}) and @key{Mouse-2}
+commands, such as @kbd{C-y} (@code{yank}) and @kbd{Mouse-2}
 (@code{mouse-yank-at-click}).  These commands actually check the
 primary selection before referring to the kill ring; if no primary
 selection is available, the kill ring contents are used.  To prevent
@@ -299,7 +299,7 @@
 Nowadays, few X applications make use of the secondary selection, but
 you can access it using the following Emacs commands:
 
-@table @key
+@table @kbd
 @findex mouse-set-secondary
 @kindex M-Drag-Mouse-1
 @item M-Drag-Mouse-1
@@ -324,8 +324,8 @@
 Set the secondary selection, with one end at the position clicked and
 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-@key{Mouse-3}} at the same
-place kills the secondary selection just made.
+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
@@ -334,10 +334,10 @@
 end of the yanked text (@code{mouse-yank-secondary}).
 @end table
 
-Double or triple clicking of @key{M-Mouse-1} operates on words and
-lines, much like @key{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}, @key{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}.
 
@@ -398,7 +398,7 @@
 the @samp{*Completions*} buffer chooses that completion
 (@pxref{Completion}).
 
-  Although clicking @key{Mouse-1} on a button usually activates that
+  Although clicking @kbd{Mouse-1} on a button usually activates that
 button, if you hold the mouse button down for a short period of time
 before releasing it (specifically, for more than 450 milliseconds),
 then Emacs moves point where you clicked instead.  This behavior
@@ -408,10 +408,10 @@
 onto a button.
 
 @vindex mouse-1-click-in-non-selected-windows
-  Normally, clicking @key{Mouse-1} on a button activates the button
+  Normally, clicking @kbd{Mouse-1} on a button activates the button
 even if it is in a nonselected window.  If you change the variable
 @code{mouse-1-click-in-non-selected-windows} to @code{nil}, clicking
-@key{Mouse-1} on a button in an un-selected window moves point to the
+@kbd{Mouse-1} on a button in an un-selected window moves point to the
 clicked position and selects that window, without activating the
 button.
 
@@ -429,7 +429,7 @@
   Several mouse clicks with the @key{CTRL} and @key{SHIFT} modifiers
 bring up menus.
 
-@table @key
+@table @kbd
 @item C-Mouse-1
 @kindex C-Mouse-1
 This menu is for selecting a buffer.
@@ -846,20 +846,20 @@
   When Emacs is compiled with GTK+ support on the X window system, or
 in operating systems such as Microsoft Windows or Mac OS, you can use
 the scroll bar as you do in other graphical applications.  If you
-click @key{Mouse-1} on the scroll bar's up and down buttons, that
-scrolls the window by one line at a time.  Clicking @key{Mouse-1}
+click @kbd{Mouse-1} on the scroll bar's up and down buttons, that
+scrolls the window by one line at a time.  Clicking @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 with
-@key{Mouse-1} scrolls the window continuously.
+@kbd{Mouse-1} scrolls the window continuously.
 
   If Emacs is compiled without GTK+ support on the X window system,
 the scroll bar behaves differently.  The scroll bar's inner box is
 drawn to represent the portion of the buffer currently displayed, with
 the entire height of the scroll bar representing the entire length of
-the buffer.  @key{Mouse-1} anywhere on the scroll bar scrolls forward
-like @kbd{C-v}, and @key{Mouse-3} scrolls backward like @kbd{M-v}.
-Clicking @key{Mouse-2} in the scroll bar lets you move or drag the
+the buffer.  @kbd{Mouse-1} anywhere on the scroll bar scrolls forward
+like @kbd{C-v}, and @kbd{Mouse-3} scrolls backward like @kbd{M-v}.
+Clicking @kbd{Mouse-2} in the scroll bar lets you move or drag the
 inner box up and down.
 
   You can also click @kbd{C-Mouse-2} in the scroll bar to split a