From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#32970: 26; doc string of `this-command-keys-vector' (minor) Date: Sun, 7 Oct 2018 15:00:14 +0000 (UTC) Message-ID: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1538924349 10622 195.159.176.226 (7 Oct 2018 14:59:09 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 7 Oct 2018 14:59:09 +0000 (UTC) To: 32970@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Oct 07 16:59:05 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1g9AWO-0002eb-Mg for geb-bug-gnu-emacs@m.gmane.org; Sun, 07 Oct 2018 16:59:04 +0200 Original-Received: from localhost ([::1]:42641 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g9AYV-00052q-5C for geb-bug-gnu-emacs@m.gmane.org; Sun, 07 Oct 2018 11:01:15 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53884) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g9AYO-00052H-Em for bug-gnu-emacs@gnu.org; Sun, 07 Oct 2018 11:01:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g9AYI-0008DK-NS for bug-gnu-emacs@gnu.org; Sun, 07 Oct 2018 11:01:08 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:35268) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1g9AYI-0008DG-J5 for bug-gnu-emacs@gnu.org; Sun, 07 Oct 2018 11:01:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1g9AYI-0005bK-D1 for bug-gnu-emacs@gnu.org; Sun, 07 Oct 2018 11:01:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 07 Oct 2018 15:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 32970 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.153892443721488 (code B ref -1); Sun, 07 Oct 2018 15:01:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 7 Oct 2018 15:00:37 +0000 Original-Received: from localhost ([127.0.0.1]:39526 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1g9AXt-0005aW-2u for submit@debbugs.gnu.org; Sun, 07 Oct 2018 11:00:37 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:44216) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1g9AXq-0005aJ-FF for submit@debbugs.gnu.org; Sun, 07 Oct 2018 11:00:35 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g9AXj-0007wS-1h for submit@debbugs.gnu.org; Sun, 07 Oct 2018 11:00:29 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:55718) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1g9AXi-0007wB-GM for submit@debbugs.gnu.org; Sun, 07 Oct 2018 11:00:26 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53825) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g9AXh-0004vK-Iz for bug-gnu-emacs@gnu.org; Sun, 07 Oct 2018 11:00:26 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g9AXb-0007qF-S6 for bug-gnu-emacs@gnu.org; Sun, 07 Oct 2018 11:00:25 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:49964) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1g9AXZ-0007ls-VV for bug-gnu-emacs@gnu.org; Sun, 07 Oct 2018 11:00:19 -0400 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w97EwjqC092873 for ; Sun, 7 Oct 2018 15:00:16 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=27C5BxLFFaZScejKS2alw8lcTAome1eggENHD60IzQs=; b=BLM0jPczwPgNbzeg4cwPWpzFUebT6DKUoU5t+nr0+tXywO2UM+IXE44WYSvfc+/9ZyrS HkFsXDA52r9jMvZBZp+lEtfMZWTvogzb03ffwLHPJRH2KhhqfwrPRubBUcU9MUn+LnLd hn+w7kg7ffds2tHWMtRQ5WloOMM5JUl3Co+ZcZJPsEfiFsl/kul2qKM7PhculR2b9yep PV0ABgSfUMznSUyWdwu0JVjPdDjeOvOy3y9Zzu1n5y+unzrT3FmmHClCiJ9bG0kFTTPV 4CzVVU8QiLemIaL1kiYHe2zTmNqzMaWV+6a9PJLSqovK9KfFuGoDvsQi8WF5kRrPnG8S rg== Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp2130.oracle.com with ESMTP id 2mxmftay7x-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 07 Oct 2018 15:00:16 +0000 Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id w97F0FOq014630 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 7 Oct 2018 15:00:15 GMT Original-Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id w97F0FQh032121 for ; Sun, 7 Oct 2018 15:00:15 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4735.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9038 signatures=668706 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1810070154 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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: 208.118.235.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:150983 Archived-At: Doc string: this-command-keys-vector is a built-in function in 'C source code'. (this-command-keys-vector) Return the key sequence that invoked this command, as a vector. However, if the command has called 'read-key-sequence', it returns the last key sequence that has been read. See also 'this-command-keys'. This function does not change global state, including the match data. It would be clearer, I think, if the order of the last two sentences were reversed. And perhaps they should not even be in the same paragraph. The current order can lead to thinking that "this function" means `this-command-keys', and that it is only `this-command-keys', not also `this-command-keys-vector', that does not change global state. In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32) of 2018-05-30 Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea Windowing system distributor `Microsoft Corp.', version 10.0.16299 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''