X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/5ed99d3685cc8d13f8e4c63ad449a6e4d63c8eb0..08974112ae68aefba658a8516c8faa3374edc924:/lisp/t-mouse.el

diff --git a/lisp/t-mouse.el b/lisp/t-mouse.el
index 059024c4bc..5ea1bdd344 100644
--- a/lisp/t-mouse.el
+++ b/lisp/t-mouse.el
@@ -1,10 +1,11 @@
 ;;; t-mouse.el --- mouse support within the text terminal
 
 ;; Author: Nick Roberts <nickrob@gnu.org>
-;; Maintainer: FSF
+;; Maintainer: emacs-devel@gnu.org
 ;; Keywords: mouse gpm linux
 
-;; Copyright (C) 1994-1995, 1998, 2006-2011  Free Software Foundation, Inc.
+;; Copyright (C) 1994-1995, 1998, 2006-2016 Free Software Foundation,
+;; Inc.
 
 ;; This file is part of GNU Emacs.
 
@@ -33,7 +34,7 @@
 ;; mev.  Now the interface with gpm is directly through a Unix socket, so this
 ;; file is reduced to a single minor mode macro call.
 
-;; 
+;;
 
 ;;; Code:
 
@@ -65,13 +66,18 @@
 (define-obsolete-function-alias 't-mouse-mode 'gpm-mouse-mode "23.1")
 ;;;###autoload
 (define-minor-mode gpm-mouse-mode
-  "Toggle gpm-mouse mode to use the mouse in GNU/Linux consoles.
-With prefix arg, turn gpm-mouse mode on if arg is positive,
-otherwise turn it off.
+  "Toggle mouse support in GNU/Linux consoles (GPM Mouse mode).
+With a prefix argument ARG, enable GPM Mouse mode if ARG is
+positive, and disable it otherwise.  If called from Lisp, enable
+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))