changeset 57709:fd2c192afcd3

(describe-key): Describe both down-event and up-event for a mouse click.
author Kim F. Storm <storm@cua.dk>
date Tue, 26 Oct 2004 12:59:44 +0000
parents 012a0b5cf591
children a18ff071e655
files lisp/help.el
diffstat 1 files changed, 13 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/lisp/help.el	Tue Oct 26 12:59:20 2004 +0000
+++ b/lisp/help.el	Tue Oct 26 12:59:44 2004 +0000
@@ -573,14 +573,14 @@
 			 (if (symbolp defn) defn (prin1-to-string defn)))))))))
 
 
-(defun describe-key (key &optional untranslated)
+(defun describe-key (key &optional untranslated up-event)
   "Display documentation of the function invoked by KEY.
 KEY should be a key sequence--when calling from a program,
 pass a string or a vector.
 If non-nil UNTRANSLATED is a vector of the untranslated events.
 It can also be a number in which case the untranslated events from
 the last key hit are used."
-  (interactive "kDescribe key: \np")
+  (interactive "kDescribe key: \np\nU")
   (if (numberp untranslated)
       (setq untranslated (this-single-command-raw-keys)))
   (save-excursion
@@ -608,6 +608,17 @@
 	    (prin1 defn)
 	    (princ "\n   which is ")
 	    (describe-function-1 defn)
+	    (when up-event
+	      (let ((defn (or (string-key-binding up-event) (key-binding up-event))))
+		(unless (or (null defn) (integerp defn) (equal defn 'undefined))
+		  (princ "\n\n-------------- up event ---------------\n\n")
+		  (princ (key-description up-event))
+		  (if (windowp window)
+		      (princ " at that spot"))
+		  (princ " runs the command ")
+		  (prin1 defn)
+		  (princ "\n   which is ")
+		  (describe-function-1 defn))))
 	    (print-help-return-message)))))))