From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Robert Pluim Newsgroups: gmane.emacs.bugs Subject: bug#74903: [PATCH] Add function to show table of keys when describing keymap variable Date: Mon, 16 Dec 2024 18:28:58 +0100 Message-ID: <87bjxb5yg5.fsf@gmail.com> References: <87v7vktu7s.fsf@posteo.de> <86zfkvpqn9.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="17755"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Mekeor Melire , Andrea Corallo , Stefan Kangas , 74903@debbugs.gnu.org, Stefan Monnier To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Dec 16 18:31:21 2024 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 1tNEwC-0004RB-Iu for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 16 Dec 2024 18:31:20 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tNEw0-0002LW-4l; Mon, 16 Dec 2024 12:31:08 -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 1tNEvw-0002DC-7e for bug-gnu-emacs@gnu.org; Mon, 16 Dec 2024 12:31: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 1tNEvv-0002fx-UD for bug-gnu-emacs@gnu.org; Mon, 16 Dec 2024 12:31:03 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:References:In-Reply-To:From:To:Subject; bh=OvG9bArxPj7ZuWo76MkqE66a5WtlnHI5Gh8nIJq2F0c=; b=ufMbbdCdfzZp0oUXFnkqecwI/jYHm4u9wcvQye5+veuBSD1hpn8Hc4f547IJDrA54OsgsWBSvLYWYz8diGUmoGESQneCayIE4/j6pi66e4wxluWy1cjLPxsQdOLwDyNZoU9SFdGCnFDuTPYwm1qJJhV38hS0WOq3z14ZTeNK4ejeQOrdNO+lKffgg8/dqyrcvRupPAWGfjI2N9Qu32LqD4nkoMZz1WMEBuXb3X/OGMFASd4k7yyvyfqS4EtsCH9HvTi0VFjxmb3GP5xRhlpKWWMO85y0/MSSoM8tsmkM69xfUqpX0Pe3hmpyGM/Jq09Umw2DkJYWXBzzA3R24UIdvw==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1tNEvv-0006ZD-3X for bug-gnu-emacs@gnu.org; Mon, 16 Dec 2024 12:31:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Robert Pluim Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 16 Dec 2024 17:31:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 74903 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 74903-submit@debbugs.gnu.org id=B74903.173437021124724 (code B ref 74903); Mon, 16 Dec 2024 17:31:02 +0000 Original-Received: (at 74903) by debbugs.gnu.org; 16 Dec 2024 17:30:11 +0000 Original-Received: from localhost ([127.0.0.1]:55912 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tNEv3-0006Qf-K0 for submit@debbugs.gnu.org; Mon, 16 Dec 2024 12:30:10 -0500 Original-Received: from mail-wr1-f41.google.com ([209.85.221.41]:56346) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tNEuz-0006PM-Po for 74903@debbugs.gnu.org; Mon, 16 Dec 2024 12:30:07 -0500 Original-Received: by mail-wr1-f41.google.com with SMTP id ffacd0b85a97d-385ef8b64b3so3991542f8f.0 for <74903@debbugs.gnu.org>; Mon, 16 Dec 2024 09:30:05 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1734370140; x=1734974940; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:from:to:cc:subject:date:message-id :reply-to; bh=OvG9bArxPj7ZuWo76MkqE66a5WtlnHI5Gh8nIJq2F0c=; b=irgu4zej4Z7BY+zukAyn+fuqGoZgEXw9gemg2zrDQOEurS1joWrVO5Zz6P0I4fn4r9 78eSB3DHQMgx/9trpTVc7k8ouZ01g0rcORgkJi84ZpduvQUJWJjemJXvulA7+/WjQ8Fq ZFtXiwLOYBiRTIMTYsfWsnnQXxMvjC6ts67bDl1T/np9A/EYrxIXu5ElCmPsacNWbeMy /QJcn9/6vuosqqYsH+7lxOcAyhBE4QY31gftKVnuF3EYEAQtJxOXKX8EVug3P8UO8Tde LuRNjQsiC+ZKT8jN8+qLZqrv6xjSaGGSmL+wR8RTbjf/prqTJ5oMtZfhdmOe7qB+G3E0 A3ow== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1734370140; x=1734974940; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=OvG9bArxPj7ZuWo76MkqE66a5WtlnHI5Gh8nIJq2F0c=; b=n9OCZxfiuWQH2XJyKmMXT9FDk/fTX6J1jSM7+h5+nacHzNf+aheGldYnJDdgRRYJfW 1TexZt4eApuy4nr7z5Q6ZArc7EpSI2kJBth4lS4c+mKFeP0STkUwWz9Vp/1ZTObCfIAB E2HOl4X+N1LC4EvGDo54GZcEvHJiyM9BEk1AaBEZlzEuC4b0WIE2fbaNKWSJdFL7mg39 V810U+KslUC6GqR0pTLwQe1XnV9zIgQJWOdikfZM4fVMy+npprtyCpm8CZjR9cf24fP6 ueK6RhdDxXjMWzFaJKRYz1xJj3+YW/5CFFbdinc1axkcuxtbwnW91ZgWInJf7urrIWZI S/dg== X-Forwarded-Encrypted: i=1; AJvYcCXLlRddHzqnVcRT0Eq+TLhCNIwnfg3z7Q4tc2hQSsp/NA/r4bitZ5RP8p6Dpe3VnehBIph2Hw==@debbugs.gnu.org X-Gm-Message-State: AOJu0Yy+nTb7wypOPrnkWlSE2+IUNQu7hYVwCQAW2Fu9xntveRD7BjpF DXD+pj/Ivdp3a5hVxgXC0NBHrkrIkKXKvmOCo9kfk3VnbM6RbImfrBE9TQ== X-Gm-Gg: ASbGnctO5rifb8vaB7jEs+6WmlVrT1hFsfwLFnEJpgEJDtVrAtfhLHvuQhllMr+NOi8 06p5XW36YYDZoJqTJHSIVyyFc+BpQgpl/usq4fAciT6WW/+syLQuAu+Vv6tpFPd9Jcs/rmo9D34 XmoEyhRwOzMN/5khB/qMIaIENhtq7snNcVpOL2AcAT8nb7aU7Nmngz+inwYpTQVnELBpZCr4Q9s g5SAFBxIq0Hqc0ltg7CTYbOgIZKUaVAA903VpDZvfA= X-Google-Smtp-Source: AGHT+IH0dg1ifGnBiZYeCLK0D078l6xE0wKwhRQ/YKO1OH4l5s6QRQibwXXL8j3OqAURP/bU0tP6xw== X-Received: by 2002:a05:6000:154e:b0:385:ddd2:6ab7 with SMTP id ffacd0b85a97d-3889ad35628mr9231066f8f.52.1734370139561; Mon, 16 Dec 2024 09:28:59 -0800 (PST) Original-Received: from rltb ([2a01:e0a:3f3:fb51:a104:d8c:5af4:8136]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-436362b64b0sm92515125e9.30.2024.12.16.09.28.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 16 Dec 2024 09:28:58 -0800 (PST) In-Reply-To: <86zfkvpqn9.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 16 Dec 2024 17:57:14 +0200") 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:297196 Archived-At: >>>>> On Mon, 16 Dec 2024 17:57:14 +0200, Eli Zaretskii said: >> From: Mekeor Melire >> Date: Sun, 15 Dec 2024 23:14:15 +0000 >>=20 >> It'd be nice if users could opt in to have C-h v some-map RET show a >> nice table of key bindings for that keymap. I wrote a function that= can >> be added to help-fns-describe-variable-functions so that this happen= s. >>=20 >> What do you think? >>=20 >> Alternatively, we can also add a key binding to help-mode so that us= ers >> can easily "switch" from describe-variable to describe-keymap, e.g. = per >> "K": >>=20 >> C-h v message-mode-map RET K Eli> We have "C-h b" and "C-h m" which show the bindings, albeit not by Eli> keymap. Is that not enough for some reason? "C-h b" shows all the bindings split out by major and minor mode already. I guess we could add the name of the relevant keymap as well, but the people who need to know the name of the keymap generally know enough about Emacs to figure it out (eg via "C-h k"). Eli> Adding yet another help command related to key bindings needs to be Eli> justified, since we already have at least two with overlapping Eli> functionalities. Eli> What do others think about this? I really don=CA=BCt see the need for more functionality here. Robert --=20