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#68236: [PATCH] help.el: allow help-quick to use local commands/quick-sections Date: Thu, 04 Jan 2024 15:57:38 +0200 Message-ID: <83sf3dw699.fsf@gnu.org> References: <1B0F351A-C393-4C1B-B883-814F2C33E802@gmail.com> <83a5ply2ca.fsf@gnu.org> <721ABC11-E691-43F9-9034-F375240C2E20@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="37523"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 68236@debbugs.gnu.org To: JD Smith Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jan 04 14:59:18 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 1rLOFi-0009Ug-GY for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 04 Jan 2024 14:59:18 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rLOFR-0006vx-Oy; Thu, 04 Jan 2024 08:59:01 -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 1rLOFO-0006tj-Lr for bug-gnu-emacs@gnu.org; Thu, 04 Jan 2024 08:58:59 -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 1rLOFO-0004Et-Dq for bug-gnu-emacs@gnu.org; Thu, 04 Jan 2024 08:58:58 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rLOFR-0002v3-QE for bug-gnu-emacs@gnu.org; Thu, 04 Jan 2024 08:59:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 04 Jan 2024 13:59:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 68236 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 68236-submit@debbugs.gnu.org id=B68236.170437668811158 (code B ref 68236); Thu, 04 Jan 2024 13:59:01 +0000 Original-Received: (at 68236) by debbugs.gnu.org; 4 Jan 2024 13:58:08 +0000 Original-Received: from localhost ([127.0.0.1]:53908 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rLOEZ-0002tu-I2 for submit@debbugs.gnu.org; Thu, 04 Jan 2024 08:58:07 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53932) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rLOEU-0002tK-M1 for 68236@debbugs.gnu.org; Thu, 04 Jan 2024 08:58:05 -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 1rLOEL-000483-Kw; Thu, 04 Jan 2024 08:57:53 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=2pl5KubNjGb8HorVVGdjY3jqnPO2metXzrOjxytGksQ=; b=WZ/i2iI4t16wULcFqoP5 i/I5YJ2gb7rWZc2l0fy5OfgH6hbippO3YhG5LpPUVPwS50snx2a/ONXibkxP6NGOQWXFmBE0cKlZl 7VQwz99c9y2wpylOHQdy0RI50lziwHQ33PRlR1e9m9gDA8xUsqXUUk3VdsoksMOMWS/zWRniyV2yo rVbLlxKVnTVRwH/x8jV58jQDpP7DRkXS1n8D/84NwFxikSESFVSePlRf+4fLoohRmTX51D9ozs5TD Ygwnwb7Xiq1oa0vubYSyG8I1TmvjX/9n/ssU1+gEVxpb9KO+oO9ftWhLpAiYz2FQP39Hgvc+ZMOVo 3jP0nZHdPr/d9Q==; In-Reply-To: <721ABC11-E691-43F9-9034-F375240C2E20@gmail.com> (message from JD Smith on Thu, 4 Jan 2024 08:45:50 -0500) 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:277313 Archived-At: > From: JD Smith > Date: Thu, 4 Jan 2024 08:45:50 -0500 > Cc: 68236@debbugs.gnu.org > > On Jan 4, 2024, at 2:39 AM, Eli Zaretskii wrote: > > Please describe in more detail how would people use this for their > personal "quick help", because I don't think I understand well enough > what you have in mind. > > For example, an org user may > > (add-to-list 'help-quick-sections > '("Org" > (org-ctrl-c-star . "Compute table/change heading ") > (org-ctrl-c-ret . "Table hline/insert heading"))) > > so that from org-buffers, C-h C-q adds a new section: > > Org > C-c * Compute table/change heading > C-c RET Table hline/insert heading > > Most likely users willing to customize `help-quick-sections’ would remove existing sections with > commands they know well. > > In any case, such a change will need suitable changes for > documentation. > > Do you mean documentation for the `help-quick-sections' variable? How about turning this into a > defcustom? This would allow more advanced users to fully customize what “quick help” they want. If we are going to expose help-quick-sections as a defcustom, then I don't understand why we need to change the code at all. Is the idea that sections will depend on the current buffer? If so, then we just need to add an element to the list members which will store the major-mode for which the member is relevant. Or what am I missing?