# HG changeset patch
# User Dave Love <fx@gnu.org>
# Date 952884898 0
# Node ID eef598a6a330886745d140ad08f581102f45f47f
# Parent  6e2e72ee55a6246f9bf14be51d673015f1527401
(Mouse Avoidance): New section.

diff -r 6e2e72ee55a6 -r eef598a6a330 man/frames.texi
--- a/man/frames.texi	Sun Mar 12 18:13:30 2000 +0000
+++ b/man/frames.texi	Sun Mar 12 18:14:58 2000 +0000
@@ -60,6 +60,7 @@
 * Highlight Changes::   Using colors to show where you changed the buffer.
 * Trailing Whitespace:: Showing possibly-spurious trailing whitespace.
 * Tooltips::            Showing `tooltips', AKA `ballon help' for active text.
+* Mouse Avoidance::     Moving the mouse pointer out of the way.
 * Misc X::	        Iconifying and deleting frames.
 * Non-Window Terminals::  Multiple frames on terminals that show only one.
 * XTerm Mouse::         Using the mouse in an XTerm terminal emulator.
@@ -1128,6 +1129,7 @@
 @section Trailing Whitespace
 
 @cindex trailing whitespace
+@cindex whitespace, trailing
 @vindex show-trailing-whitespace
 The option @code{show-trailing-whitespace} can be customized so that
 Emacs displays trailing whitespace in the face
@@ -1137,7 +1139,7 @@
 line containing the whitespace.
 
 @node Tooltips
-@section Tooltips (or `Ballon Help')
+@section Tooltips (or `Balloon Help')
 
 @cindex balloon help
 @findex tooltip-mode
@@ -1148,6 +1150,34 @@
 The customization group @code{tooltip} controls various aspects of their
 display.
 
+@node Mouse Avoidance
+@section Mouse Avoidance
+
+Mouse Avoidance mode keeps the window system mouse pointer away from
+point to avoid obscuring text.  Whenever the mouse is moved, the frame
+is also raised.  To use it, customize the option
+@code{mouse-avoidance-mode}.  You can set this to various values to move
+the mouse in several ways:
+
+@table @code
+@item banish
+Move the mouse to the upper-right corner on any keypress;
+@item exile
+Move the mouse to the corner only if the cursor gets too close,
+and allow it to return once the cursor is out of the way;
+@item jump
+If the cursor gets too close to the mouse, displace the mouse
+a random distance & direction;
+@item animate
+As @code{jump}, but shows steps along the way for illusion of motion;
+@item cat-and-mouse
+The same as @code{animate};
+@item proteus
+As @code{animate}, but changes the shape of the mouse pointer too.
+@end table
+
+You can also use the command @kbd{M-x mouse-avoidance-mode} to turn on
+the mode.
 
 @node Misc X
 @section Miscellaneous X Window Features
@@ -1210,6 +1240,8 @@
 
 @node XTerm Mouse
 @section Using a Mouse in Terminal Emulators
+@cindex xterm, mouse support
+@cindex terminal emulators, mouse support
 
 Some terminal emulators under X support mouse clicks in the terminal
 window.  In a terminal emulator which is compatible with @code{xterm},