From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#26626: 24.5; doc of `last-command-event' and `last-nonmenu-event' Date: Fri, 26 Jul 2019 11:33:07 +0200 Message-ID: <87v9vpnnsc.fsf@mouse.gnus.org> References: <036c27e0-4509-45e8-942e-9b454b34b0ef@default> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="101530"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: 26626@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jul 26 11:34:15 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hqwcA-000QJ0-Mr for geb-bug-gnu-emacs@m.gmane.org; Fri, 26 Jul 2019 11:34:14 +0200 Original-Received: from localhost ([::1]:37760 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hqwc8-0004OG-Jd for geb-bug-gnu-emacs@m.gmane.org; Fri, 26 Jul 2019 05:34:12 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:42650) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hqwc4-0004Ms-IN for bug-gnu-emacs@gnu.org; Fri, 26 Jul 2019 05:34:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hqwc0-0006EK-B8 for bug-gnu-emacs@gnu.org; Fri, 26 Jul 2019 05:34:05 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:60277) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hqwc0-0006DP-6h for bug-gnu-emacs@gnu.org; Fri, 26 Jul 2019 05:34:04 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hqwbx-00035O-W4 for bug-gnu-emacs@gnu.org; Fri, 26 Jul 2019 05:34:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 26 Jul 2019 09:34:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 26626 X-GNU-PR-Package: emacs Original-Received: via spool by 26626-submit@debbugs.gnu.org id=B26626.156413359711798 (code B ref 26626); Fri, 26 Jul 2019 09:34:01 +0000 Original-Received: (at 26626) by debbugs.gnu.org; 26 Jul 2019 09:33:17 +0000 Original-Received: from localhost ([127.0.0.1]:40860 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hqwbF-00034E-Ka for submit@debbugs.gnu.org; Fri, 26 Jul 2019 05:33:17 -0400 Original-Received: from quimby.gnus.org ([80.91.231.51]:58256) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hqwbB-000340-JP for 26626@debbugs.gnu.org; Fri, 26 Jul 2019 05:33:17 -0400 Original-Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hqwb6-0004y0-HQ; Fri, 26 Jul 2019 11:33:11 +0200 In-Reply-To: <036c27e0-4509-45e8-942e-9b454b34b0ef@default> (Drew Adams's message of "Sun, 23 Apr 2017 10:35:19 -0700 (PDT)") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:163756 Archived-At: Drew Adams writes: > The doc is not very clear - both (elisp) `Command Loop Info' and the doc > strings. I think the manual is pretty clear: --- @defvar last-command-event This variable is set to the last input event that was read by the command loop as part of a command. The principal use of this variable is in @code{self-insert-command}, which uses it to decide which character to insert. @example @group last-command-event ;; @r{Now use @kbd{C-u C-x C-e} to evaluate that.} @result{} 5 @end group @end example @noindent The value is 5 because that is the @acronym{ASCII} code for @kbd{C-e}. @end defvar --- The example helps a lot. > The essential difference in the descriptions seems to be the last input > event read "as part of a key sequence" versus read "as part of a > command". But "read as part of a command" is unclear. Does it mean > read by a command (e.g., by a call to `read-char' within the command > definition)? No. But that's all I can think of, when reading that > description. > > The doc of `last-nonmenu-event' is pretty clear. Or at least it is > before reading also the doc of `last-command-event' and trying to make > sense of that. Even the name of the latter is unclear - what's a > "command event"? > > The example given for `last-command-event' suggests that what is meant > is the last event in the key sequence that invoked/initiated a command. > I think that's closer to what the meaning/behavior is. The variable doc string isn't very helpful; no. I've now changed it to the following on the trunk: Last input event that was part of a command key sequence. See Info node `(elisp)Command Loop Info'. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no