- Some Emacs buffers display lists of various sorts. These include
-lists of files, of buffers, of possible completions, of matches for
-a pattern, and so on.
-
- Since yanking text into these buffers is not very useful, most of them
-define @kbd{Mouse-2} specially, as a command to use or view the item you
-click on.
-
- For example, if you click @kbd{Mouse-2} on a file name in a Dired
-buffer, you visit that file. If you click @kbd{Mouse-2} on an error
-message in the @samp{*Compilation*} buffer, you go to the source code
-for that error message. If you click @kbd{Mouse-2} on a completion in
-the @samp{*Completions*} buffer, you choose that completion.
-
- You can usually tell when @kbd{Mouse-2} has this special sort of
-meaning because the sensitive text highlights when you move the mouse
-over it.
+ Some read-only Emacs buffers include references you can follow, or
+commands you can activate. These include names of files, of buffers,
+of possible completions, of matches for a pattern, as well as the
+buttons in Help buffers and customization buffers. You can follow the
+reference or activate the command by moving point to it and typing
+@key{RET}. You can also do this with the mouse, using either
+@kbd{Mouse-1} or @kbd{Mouse-2}.
+
+ Since yanking text into a read-only buffer is not allowed, these
+buffers generally define @kbd{Mouse-2} to follow a reference or
+activate a command. For example, if you click @kbd{Mouse-2} on a file
+name in a Dired buffer, you visit that file. If you click
+@kbd{Mouse-2} on an error message in the @samp{*Compilation*} buffer,
+you go to the source code for that error message. If you click
+@kbd{Mouse-2} on a completion in the @samp{*Completions*} buffer, you
+choose that completion.
+
+ However, most applications use @kbd{Mouse-1} to do this sort of
+thing, so Emacs implements this too. If you click @kbd{Mouse-1}
+quickly on a reference or button, it follows or activates. If you
+click slowly, it moves point as usual. Dragging, meaning moving the
+mouse while it is held down, also has its usual behavior of setting
+the region.
+
+@vindex mouse-1-click-in-non-selected-windows
+ Normally, the @kbd{Mouse-1} click behavior is performed on links in
+any window. The variable @code{mouse-1-click-in-non-selected-windows}
+controls whether @kbd{Mouse-1} has this behavior even in non-selected
+windows, or only in the selected window.
+
+@vindex mouse-highlight
+ You can usually tell when @kbd{Mouse-1} and @kbd{Mouse-2} have this
+special sort of meaning because the sensitive text highlights when you
+move the mouse over it. The variable @code{mouse-highlight} controls
+whether to do this highlighting always (even when such text appears
+where the mouse already is), never, or only immediately after you move
+the mouse.
+
+@vindex mouse-1-click-follows-link
+ In Emacs versions before 22, only @kbd{Mouse-2} follows links and
+@kbd{Mouse-1} always sets point. If you prefer this older behavior,
+set the variable @code{mouse-1-click-follows-link} to @code{nil}.
+This variable also lets you choose various other alternatives for
+following links with the mouse. Type @kbd{C-h v
+mouse-1-click-follows-link @key{RET}} for more details.