Mercurial > emacs
diff lisp/tooltip.el @ 99213:33f78208d5f0
Rename `tooltip-hook' to `tooltip-functions'.
* tooltip.el (tooltip-functions): Rename from `tooltip-hook',
to follow naming conventions for abnormal hooks. Doc fix.
(tooltip-mode, tooltip-timeout): Use it.
(tooltip-hook): New obsolete alias.
(tooltip-help-tips): Doc fix.
* progmodes/gud.el (gud-tooltip-mode): Use `tooltip-functions'.
author | Juanma Barranquero <lekktu@gmail.com> |
---|---|
date | Wed, 29 Oct 2008 12:10:20 +0000 |
parents | 68a220b546b7 |
children | 563e71d339f2 |
line wrap: on
line diff
--- a/lisp/tooltip.el Wed Oct 29 11:00:51 2008 +0000 +++ b/lisp/tooltip.el Wed Oct 29 12:10:20 2008 +0000 @@ -59,10 +59,10 @@ (if tooltip-mode (progn (add-hook 'pre-command-hook 'tooltip-hide) - (add-hook 'tooltip-hook 'tooltip-help-tips)) + (add-hook 'tooltip-functions 'tooltip-help-tips)) (unless (and (boundp 'gud-tooltip-mode) gud-tooltip-mode) (remove-hook 'pre-command-hook 'tooltip-hide)) - (remove-hook 'tooltip-hook 'tooltip-help-tips)) + (remove-hook 'tooltip-functions 'tooltip-help-tips)) (setq show-help-function (if tooltip-mode 'tooltip-show-help 'tooltip-show-help-non-mode))) @@ -146,10 +146,14 @@ ;;; Variables that are not customizable. -(defvar tooltip-hook nil +(defvar tooltip-functions nil "Functions to call to display tooltips. -Each function is called with one argument EVENT which is a copy of -the last mouse movement event that occurred.") +Each function is called with one argument EVENT which is a copy +of the last mouse movement event that occurred. If one of these +functions displays the tooltip, it should return non-nil and the +rest are not called.") + +(define-obsolete-variable-alias 'tooltip-hook 'tooltip-functions "23.1") (defvar tooltip-timeout-id nil "The id of the timeout started when Emacs becomes idle.") @@ -193,7 +197,7 @@ (defun tooltip-timeout (object) "Function called when timer with id `tooltip-timeout-id' fires." - (run-hook-with-args-until-success 'tooltip-hook + (run-hook-with-args-until-success 'tooltip-functions tooltip-last-mouse-motion-event)) @@ -337,7 +341,6 @@ (setq tooltip-previous-message nil))) (t (message nil))))) - (defun tooltip-show-help (msg) "Function installed as `show-help-function'. @@ -360,8 +363,8 @@ (defun tooltip-help-tips (event) "Hook function to display a help tooltip. -This is installed on the hook `tooltip-hook', which is run when -the timer with id `tooltip-timeout-id' fires. +This is installed on the hook `tooltip-functions', which +is run when the timer with id `tooltip-timeout-id' fires. Value is non-nil if this function handled the tip." (when (stringp tooltip-help-message) (tooltip-show tooltip-help-message tooltip-use-echo-area)