From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#34784: 26.1; Doc of pseudofunction key `' Date: Fri, 8 Mar 2019 08:52:46 -0800 (PST) Message-ID: References: <247b0874-cbb1-40e1-996f-5f931c142616@default> <83imwta3t0.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="192977"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 34784@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Mar 08 17:53:12 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.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1h2IkB-000o6Y-No for geb-bug-gnu-emacs@m.gmane.org; Fri, 08 Mar 2019 17:53:11 +0100 Original-Received: from localhost ([127.0.0.1]:46783 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h2IkA-00035K-PF for geb-bug-gnu-emacs@m.gmane.org; Fri, 08 Mar 2019 11:53:10 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:59918) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h2Ik3-000334-PV for bug-gnu-emacs@gnu.org; Fri, 08 Mar 2019 11:53:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1h2Ik2-0005Be-Vv for bug-gnu-emacs@gnu.org; Fri, 08 Mar 2019 11:53:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:51288) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1h2Ik2-0005BR-S7 for bug-gnu-emacs@gnu.org; Fri, 08 Mar 2019 11:53:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1h2Ik2-0005oX-Jv for bug-gnu-emacs@gnu.org; Fri, 08 Mar 2019 11:53:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 08 Mar 2019 16:53:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34784 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug Original-Received: via spool by 34784-submit@debbugs.gnu.org id=B34784.155206397722338 (code B ref 34784); Fri, 08 Mar 2019 16:53:02 +0000 Original-Received: (at 34784) by debbugs.gnu.org; 8 Mar 2019 16:52:57 +0000 Original-Received: from localhost ([127.0.0.1]:36599 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h2Ijw-0005oD-VW for submit@debbugs.gnu.org; Fri, 08 Mar 2019 11:52:57 -0500 Original-Received: from userp2130.oracle.com ([156.151.31.86]:35444) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h2Ijv-0005nz-EA for 34784@debbugs.gnu.org; Fri, 08 Mar 2019 11:52:56 -0500 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x28Gmo5W128322; Fri, 8 Mar 2019 16:52:49 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=+Mtg9CIgAhoUp3K84dfLv8RlZVe9Tjw5AjAR1S/zAbM=; b=Uh3kfyBlzqMUjvLUvJnOvvS+CmQu0Kp16jKaVsI0CgOkc1SNFYO4geZwfiicczfkFLsE jPReGHti3xyq5H41u2psQ3eBVPe3Wt3hm07J4RPRtaS2UFpOE8rclrf//oYZKKHEl0TU HOMga5FWp2EWCtJglPjvadb7CfMRqX9x8E+PlpG1Jee0H7L6GoFl21V8D5KwxnvU/YxF YO2QQDt7AGUDkRheTA+Np0khY1pjGE/21DhqyZU7GYBNZE1vUdoA0wgADRQ6rWAXLPLl h09rz6Gbk1muyYmas9uoTv7WOheoTqtjuUxRDyplxoxx57WT4Yo+Sno/avLW74N+zoAg Dw== Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp2130.oracle.com with ESMTP id 2qyh8usbky-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 08 Mar 2019 16:52:49 +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 x28Gqmsr000362 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 8 Mar 2019 16:52:48 GMT Original-Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x28GqlcF016988; Fri, 8 Mar 2019 16:52:48 GMT In-Reply-To: <83imwta3t0.fsf@gnu.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4810.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9189 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1903080117 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:156150 Archived-At: > tags 34784 notabug > thanks >=20 > > There is apparently a function key and a `timeout' > > function-key event? >=20 > There's no timeout function key, it's an event that CUA invented, a > symbol, that's all. See cua-base.el. Any Lisp program can invent > events of its liking and then inject those events and bind commands to > them. I thought that might be the case. But according to how the Elisp manual talks about function keys, "fake function keys", and events this _is_ a function key: one that corresponds to the `timeout' "event that CUA invented". It's not a function key that exists or is used outside CUA, perhaps (that I wasn't sure about), but it is a function key, at least in terms of how the manual talks about such things. Anyway, back to the point of this bug report: How is a user to know this info about `', without digging into the code? The doc speaks of "_fake_ function keys" for use in menu items (only). But the doc really doesn't guide users when it comes to things like this. Yes, it talks, in the doc about events, about function-key events, saying that the event is represented by the function-key symbol. But I don't see where the doc describes the kind of thing that is happening with `C-c '. And I don't see how a user would find out what that function key (and it apparently is a function key and not a fake function key) does, without digging into the CUA code. Maybe CUA needs, itself, to provide some help/doc for users about this? Or maybe Emacs can provide some general mechanism for users to discover what such an event does/means? Keys in a key sequence that we present to a user should be clear - including function keys. We document those that are common. We don't document `'. At least CUA should document it, I think. There should be some way for a user to find out more about it, when `C-c C-h' shows it. How does a user type/use a key sequence such as `C-c '? How does a user find that out? Some user help is missing here. You may have a different/better idea of what is missing and where it belongs, but don't you agree that something is missing in terms of user help here?