[Emacs-diffs] /srv/bzr/emacs/trunk r106970: Mark tooltip-use-echo-area as obsolete.

[Chong Yidong]

------------------------------------------------------------
revno: 106970
fixes bug(s): http://debbugs.gnu.org/6595
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Sat 2012-01-28 13:02:02 +0800
message:
  Mark tooltip-use-echo-area as obsolete.
  
  * lisp/tooltip.el (tooltip-mode): Doc fix.
  (tooltip-use-echo-area): Mark as obsolete.
modified:
  etc/NEWS
  lisp/ChangeLog
  lisp/tooltip.el

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-01-27 21:19:13 +0000
+++ b/etc/NEWS  2012-01-28 05:02:02 +0000
@@ -436,6 +436,10 @@
 This is handy for minibuffer-only frames, and is also used for the "mouse-1
 pops up *Messages*" feature, which can now easily be changed.
 
+---
+** `tooltip-use-echo-area' is obsolete.
+Rather than setting this to t, disable Tooltip mode instead.
+
 
 * Editing Changes in Emacs 24.1
 

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2012-01-28 03:21:04 +0000
+++ b/lisp/ChangeLog    2012-01-28 05:02:02 +0000
@@ -1,5 +1,8 @@
 2012-01-28  Chong Yidong  <address@hidden>
 
+       * tooltip.el (tooltip-mode): Doc fix.
+       (tooltip-use-echo-area): Mark as obsolete (Bug#6595).
+
        * frame.el (set-cursor-color): Doc fix (Bug#352).
 
        * mail/rmail.el (rmail-start-mail): Add send-action again (Bug#10625).

=== modified file 'lisp/tooltip.el'
--- a/lisp/tooltip.el   2012-01-19 07:21:25 +0000
+++ b/lisp/tooltip.el   2012-01-28 05:02:02 +0000
@@ -39,18 +39,15 @@
 ;;; Switching tooltips on/off
 
 (define-minor-mode tooltip-mode
-  "Toggle use of graphical tooltips (Tooltip mode).
-With a prefix argument ARG, enable Tooltip mode if ARG is
-positive, and disable it otherwise.  If called from Lisp, enable
-it if ARG is omitted or nil.
-
-When Tooltip mode is enabled, Emacs displays help text in a
-pop-up window for buttons and menu items that you put the mouse
-on.  \(However, if `tooltip-use-echo-area' is non-nil, this and
-all pop-up help appears in the echo area.)
-
-When Tooltip mode is disabled, Emacs displays one line of
-the help text in the echo area, and does not make a pop-up window."
+  "Toggle Tooltip mode.
+With ARG, turn Tooltip mode on if and only if ARG is positive.
+
+When this global minor mode is enabled, Emacs displays help
+text (e.g. for buttons and menu items that you put the mouse on)
+in a pop-up window.
+
+When Tooltip mode is disabled, Emacs displays help text in the
+echo area, instead of making a pop-up window."
   :global t
   ;; Even if we start on a text-only terminal, make this non-nil by
   ;; default because we can open a graphical frame later (multi-tty).
@@ -144,11 +141,14 @@
 
 (defcustom tooltip-use-echo-area nil
   "Use the echo area instead of tooltip frames for help and GUD tooltips.
-To display multi-line help text in the echo area, set this to t
-and enable `tooltip-mode'."
+This variable is obsolete; instead of setting it to t, disable
+`tooltip-mode' (which has a similar effect)."
   :type 'boolean
   :group 'tooltip)
 
+(make-obsolete-variable 'tooltip-use-echo-area
+                       "disable Tooltip mode instead" "24.1")
+
 
 ;;; Variables that are not customizable.