From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jeremy Bryant via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#68929: [PATCH] Copy which-key from GNU ELPA into core Date: Thu, 08 Feb 2024 22:25:39 +0000 Message-ID: <87zfwar3qd.fsf@jeremybryant.net> References: <871q9rvqbi.fsf@jeremybryant.net> <86wmrj148c.fsf@gnu.org> <87ttmkrlc5.fsf@jeremybryant.net> <86fry3xzae.fsf@gnu.org> Reply-To: Jeremy Bryant Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="36305"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 68929@debbugs.gnu.org, justin@burkett.cc, monnier@iro.umontreal.ca To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Feb 08 23:29:09 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 1rYCtJ-0009GI-BW for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 08 Feb 2024 23:29:09 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rYCt2-0001wt-2g; Thu, 08 Feb 2024 17:28:52 -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 1rYCsx-0001wg-T6 for bug-gnu-emacs@gnu.org; Thu, 08 Feb 2024 17:28:47 -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 1rYCsx-0004Hn-Gw for bug-gnu-emacs@gnu.org; Thu, 08 Feb 2024 17:28:47 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rYCtC-00088S-4f for bug-gnu-emacs@gnu.org; Thu, 08 Feb 2024 17:29:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Jeremy Bryant Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 08 Feb 2024 22:29:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 68929 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 68929-submit@debbugs.gnu.org id=B68929.170743128531072 (code B ref 68929); Thu, 08 Feb 2024 22:29:02 +0000 Original-Received: (at 68929) by debbugs.gnu.org; 8 Feb 2024 22:28:05 +0000 Original-Received: from localhost ([127.0.0.1]:36238 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rYCsF-00084z-Qn for submit@debbugs.gnu.org; Thu, 08 Feb 2024 17:28:05 -0500 Original-Received: from out-179.mta1.migadu.com ([95.215.58.179]:48157) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rYCsD-00083x-2b for 68929@debbugs.gnu.org; Thu, 08 Feb 2024 17:28:02 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=jeremybryant.net; s=key1; t=1707431265; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=g1rO8cUU0UY3xKgKAX3MjCikNM7i14q7jNZTDr01HhQ=; b=CN03dVHb1n8DsefiK1JNsTXFSJBTV0ZG5pIfFdM0nPFnxGUBSrGbqPdvwNteyUYfj1C8f2 zY8bYsWOfdrtDoLVyqAC4T2F5EOqYTm5hx2yN5GsbFgIv9vxwWmP3qiyhV4rKOpZkC0Lr7 ZkA/s5o40tHZCFUlzImr66HJeZ2uWfKOZYgxF186Tz5dpbHIV+IN2T9gnMFed2VFKDaQYy VESleOgobUOUzoGhvvYfNU2wx2cMH9/mIDJS8EEERerDvYZRiZ3I6OsKfwcBRiq7gpb7OY 9dEiEHiUavBYaCoZZi9v8reHV3SRig+Y2Cv42WCYRs4MvDoQ7+u+7motZaINyQ== X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. In-reply-to: <86fry3xzae.fsf@gnu.org> X-Migadu-Flow: FLOW_OUT 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:279663 Archived-At: Eli Zaretskii writes: >> From: Jeremy Bryant >> Cc: Eli Zaretskii , 68929@debbugs.gnu.org, >> monnier@iro.umontreal.ca >> Date: Wed, 07 Feb 2024 21:53:55 +0000 >> >> Is there a natural place in the Emacs manual (Perhaps "Other Help >> Commands"?) to add a new section on M-x which-key? WDYT? > > Will the section be very long? How long? > > If it's not very long, I think the right place is in "Key Help", > perhaps as a separate subsection below it. Also, I think which-key > should be briefly mentioned in "Display Custom", where echo-keystrokes > is described. > > If the section about which-key you envision is supposed to be long and > detailed, perhaps it would be better to have a separate manual with > all that stuff, whereas the Emacs user manual should have only a short > description of the main features, and a cross-reference to the > separate manual. I would propose to make a new section short enough to belong in the main Emacs manual, as which-key's "keymay discovery" perspective should be easier to find. I can volunteer to write a draft and confer with Justin, the actual author, for completeness.