From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#75366: [PATCH] Improve the doc of key-valid-p Date: Sat, 04 Jan 2025 22:49:37 +0200 Message-ID: <864j2eb8ym.fsf@gnu.org> References: <20250104203955.139589-1-hong@topbug.net> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="357"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 75366@debbugs.gnu.org To: Hong Xu Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Jan 04 21:51:19 2025 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1tUB79-000AX7-Fu for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 04 Jan 2025 21:51:19 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tUB6w-0007Lr-6C; Sat, 04 Jan 2025 15:51:06 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tUB6u-0007Le-8Z for bug-gnu-emacs@gnu.org; Sat, 04 Jan 2025 15:51:04 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tUB6s-0000rF-QG for bug-gnu-emacs@gnu.org; Sat, 04 Jan 2025 15:51:04 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=References:In-Reply-To:From:Date:To:Subject; bh=wATXh/IW4cVz92YDXe2TAUp5CUxyLUSEQlYFbVT2nGc=; b=dhgGfr/XUkZAG80M4qMBcbPWtewfMFEbI6jL8TJmg4iYEXnljf0pbDXyl+VNaP0dgJNK/OOfU+hjM9SGJDg8BajNbeMDnSVIgmWwBIJ1KgiDo3LmIjcDJPOX+8dvFFnAspuEV80wK+Rawfsd3nK/XD1wODDCnzX+k3tig3b2kvFKRTgnM86NnYvBuE3J7VfgNMAEbcCbw2H5SsdhnQm612BzxHxwwoqtxVzd2uLLt/pkr4u4/e3ZwuN4sIrGSd5v8+92fmJSxDCcu526lG4JbcIHRGr4ZOgZ+pBiV02MB8SqLTIVYqlbzYxqwUDXjpwXCdD4B78T5W/MH7meEr1w6w==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1tUB6s-0004IM-9s for bug-gnu-emacs@gnu.org; Sat, 04 Jan 2025 15:51:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 04 Jan 2025 20:51:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 75366 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 75366-submit@debbugs.gnu.org id=B75366.173602382816463 (code B ref 75366); Sat, 04 Jan 2025 20:51:02 +0000 Original-Received: (at 75366) by debbugs.gnu.org; 4 Jan 2025 20:50:28 +0000 Original-Received: from localhost ([127.0.0.1]:57615 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tUB6K-0004HT-1V for submit@debbugs.gnu.org; Sat, 04 Jan 2025 15:50:28 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55886) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1tUB6F-0004HA-0q for 75366@debbugs.gnu.org; Sat, 04 Jan 2025 15:50:26 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tUB68-0000p1-Rv; Sat, 04 Jan 2025 15:50:16 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=wATXh/IW4cVz92YDXe2TAUp5CUxyLUSEQlYFbVT2nGc=; b=I/iDPoM3cqs8 Y4qQpyE0evohnSiNXMs2feGkYNUxPN7b0fRTVgDtPiQNnibQ41uczRGFg3JtT0r0Xr6Er9ulvsF80 /GYLIOjLvD8ckPsrDjQWcEQAgttuqdOqpMbKRC1dHthl0P2RNYXpqCjUbqVlx9z6eEC+JGhNoOL5T aIgcZWeUOrW94yKzNhueb/7segJZlN8wj03IYYdufgizOX8TaaEzljU99CJjRvChU6ZFyejOEf/cV xm4iPNKzeiaNzL5abSRVEJ22Fy1GKWElfpqGXgIdubPmrRuCFVYmTH4cm5pxaKx4eqrb2M6IzDm7B I/75pPOrQ9jyEozXbm04Vg==; In-Reply-To: <20250104203955.139589-1-hong@topbug.net> (message from Hong Xu on Sat, 4 Jan 2025 12:37:53 -0800) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:298472 Archived-At: > From: Hong Xu > Date: Sat, 4 Jan 2025 12:37:53 -0800 > > * lisp/keymap.el (key-valid-p): Add an function key example. Mention > as a cursor control key instead of a function key. Rename > some "characters" to "key strokes" to be consistent with the terminology > in the first paragraph. Briefly explain what an event may be. Thanks, but the changes you suggest to make are not really correct or at least inaccurate (with the exception of adding ""). For example, saying that "event may be a key stroke or a menu item" is inaccurate, because is neither and so is . What is wrong with the current text that you think it needs these changes? > -These are the characters that have special shorthand syntax: > +These key strokes have special shorthand syntax: > NUL, RET, TAB, LFD, ESC, SPC, DEL. They are all characters, not key strokes.