From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Sun, 18 Jul 2021 16:18:03 +0000 (+0200)
Subject: Clarify event-convert-list doc string
X-Git-Tag: emacs-28.0.90~1817
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=48dfaa734be15e22f2a30a8cac73353e4649ce0a;p=emacs.git

Clarify event-convert-list doc string

* src/keyboard.c (Fevent_convert_list): Clarify that the base type
returned isn't always the same (bug#7631).
---

diff --git a/src/keyboard.c b/src/keyboard.c
index 6174a4aad92..77d6bbba623 100644
--- a/src/keyboard.c
+++ b/src/keyboard.c
@@ -6622,8 +6622,11 @@ DEFUN ("event-convert-list", Fevent_convert_list, Sevent_convert_list, 1, 1, 0,
 EVENT-DESC should contain one base event type (a character or symbol)
 and zero or more modifier names (control, meta, hyper, super, shift, alt,
 drag, down, double or triple).  The base must be last.
-The return value is an event type (a character or symbol) which
-has the same base event type and all the specified modifiers.  */)
+
+The return value is an event type (a character or symbol) which has
+essentially the same base event type and all the specified modifiers.
+(Some compatibility base types, like symbols that represent a
+character, are not returned verbatim.)  */)
   (Lisp_Object event_desc)
 {
   Lisp_Object base = Qnil;