Extend gpm-mouse-mode's doc string and doc to point out limitations.

* lisp/t-mouse.el (gpm-mouse-mode): Extend doc string to indicate the
inability to transfer text between Emacs and other programs which use GPM.

* doc/emacs/frames.texi (Text-Only Mouse): Note the inability to transfer text
between Emacs and other progrmas which use GPM.

2 files changed, 9 insertions, 2 deletions

diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi
index 5fbe0fc5774..35b3f83ab33 100644
--- a/doc/emacs/frames.texi
+++ b/doc/emacs/frames.texi
@@ -1275,7 +1275,10 @@ again.
 @findex gpm-mouse-mode
   In the console on GNU/Linux, you can use @kbd{M-x gpm-mouse-mode} to
 enable mouse support.  You must have the gpm server installed and
-running on your system in order for this to work.
+running on your system in order for this to work.  Note that when
+this mode is enabled, you cannot use the mouse to transfer text
+between Emacs and other programs which use GPM.  This is due to
+limitations in GPM and the Linux kernel.
 
 @iftex
 @xref{MS-DOS Mouse,,,emacs-xtra,Specialized Emacs Features},
diff --git a/lisp/t-mouse.el b/lisp/t-mouse.el
index bbdd08a1df0..5ea1bdd3449 100644
--- a/lisp/t-mouse.el
+++ b/lisp/t-mouse.el
@@ -73,7 +73,11 @@ the mode if ARG is omitted or nil.
 
 This allows the use of the mouse when operating on a GNU/Linux console,
 in the same way as you can use the mouse under X11.
-It relies on the `gpm' daemon being activated."
+It relies on the `gpm' daemon being activated.
+
+Note that when `gpm-mouse-mode' is enabled, you cannot use the
+mouse to transfer text between Emacs and other programs which use
+GPM.  This is due to limitations in GPM and the Linux kernel."
   :global t :group 'mouse :init-value t
   (dolist (terminal (terminal-list))
     (when (and (eq t (terminal-live-p terminal))