From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: =?UTF-8?Q?Cl=c3=a9ment_Pit-Claudel?= Newsgroups: gmane.emacs.devel Subject: Re: describe-mode bindings (was: [ELPA] New package: disk-usage) Date: Tue, 19 Feb 2019 16:29:38 -0500 Message-ID: References: <87imxgmacr.fsf@ambrevar.xyz> <874l8z7cmi.fsf@gmx.de> <874l8zr0cs.fsf@ambrevar.xyz> <87zhqr5x81.fsf@gmx.de> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="12926"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.4.0 To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Feb 19 22:30:52 2019 Return-path: Envelope-to: ged-emacs-devel@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 1gwCya-0003DP-5P for ged-emacs-devel@m.gmane.org; Tue, 19 Feb 2019 22:30:52 +0100 Original-Received: from localhost ([127.0.0.1]:55229 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gwCyY-00068u-VY for ged-emacs-devel@m.gmane.org; Tue, 19 Feb 2019 16:30:50 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:33390) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gwCyM-00068l-GE for emacs-devel@gnu.org; Tue, 19 Feb 2019 16:30:40 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gwCyK-0005dh-PB for emacs-devel@gnu.org; Tue, 19 Feb 2019 16:30:38 -0500 Original-Received: from mail-qk1-x72e.google.com ([2607:f8b0:4864:20::72e]:40284) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gwCyK-0005JU-Bx for emacs-devel@gnu.org; Tue, 19 Feb 2019 16:30:36 -0500 Original-Received: by mail-qk1-x72e.google.com with SMTP id h28so638537qkk.7 for ; Tue, 19 Feb 2019 13:29:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-language:content-transfer-encoding; bh=paHmrDErLxS8AxUeOqYAr/nP+rCUSZXKOuPG/kC0icA=; b=iXbLtjdH9NPha1I/ZUJTYqaY8TAdtQieoWfjs9gGovrqbuI3fik/kAbpJ4Zesh4TPl YyhU6izlppLEUUeJEDRnlJjWJPpVUn9EG8lvGJWk+dfi0x0T2Or8IJUeXMb0nj/vPr3B 8lvLq/Ui96uuFNmlirR/NbrN6BCoxLSG5Ba1knUCMFlzckSzuwz/beEoWFZlP/kYLB5V nGonBNAO7JCebpFsC+Yxi0Llx2KYXfDFxjvZtbq/WeQIrjZjYmRLB0x07GPWhGEXQrj8 jj3L1emj1Ewi+/DEgYxHEqdSTeDeQy9n2AjDsh3Ybzj2BoL7eDI/dePYdNH8/EJSCu67 8RHA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=paHmrDErLxS8AxUeOqYAr/nP+rCUSZXKOuPG/kC0icA=; b=JYc61WX0xBf9L/SJKopyAyW9MOciFiy1CsVF1+3igKMa7CXIyGTNnYrexebjdo3xFg xzv7vpwcvGgZLOzbxjR0MmgHG+jetGB1+4hRlMpkcW1ub1viQA6gdY9WbuvawtJGuho6 Bru0PiQV05g1dV2MAA7XjeM/ua/sKCuJPLftNIUMQheOg7PPUJLN810/PsfXHP/1ehWh B56q5Ar+gpZtYPxMI9GMIU5AyfZEqb+e/SvAUY/ESO7Vwf019kgZfTpSXwQeuivg8H09 C5S/G50aMAUdvco3VPtKXt+rdLJIJJn6y9QIb0sHJhNqqQbbBLG3gIOGE1xhYeu9ToaV ZjuA== X-Gm-Message-State: AHQUAuYTYTZjCdHc0+T/2pbbBCxpgK7SXkNXuQu6V15Zt++25nvXLUqf 4WhRYrCmSpOLWSxWB7lP8Gqkvqzd X-Google-Smtp-Source: AHgI3IYxbq3N9Ykb4UIFY/qWw7R8N2pVQVGC/I2uWhyCu3FVTPIEF0KzPGrGRQI4TTHknzTfDlJ3bg== X-Received: by 2002:a37:8d01:: with SMTP id p1mr22763073qkd.91.1550611785225; Tue, 19 Feb 2019 13:29:45 -0800 (PST) Original-Received: from ?IPv6:2601:184:4180:66e7:7153:e8ef:c4f6:5d09? ([2601:184:4180:66e7:7153:e8ef:c4f6:5d09]) by smtp.googlemail.com with ESMTPSA id y11sm16166670qky.2.2019.02.19.13.29.44 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 19 Feb 2019 13:29:44 -0800 (PST) In-Reply-To: Content-Language: en-GB X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:4864:20::72e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:233475 Archived-At: On 19/02/2019 15.58, Stefan Monnier wrote: >> Of course, and I did. But a menue is more convenient. 'C-h m' returns: > [...] >> --8<---------------cut here---------------end--------------->8--- >> A longer list than needed; the relevant keys must be found. > > Maybe `C-h m` should be improved to distinguish the mode's own bindings > from the ones inherited from the parent keymap!? An overhaul of C-h m would be nice. In biblio.el I list the docstrings along with the commands, so h gives this: Help with ‘biblio-selection-mode’ ‘C-p’, ‘’ (biblio--selection-previous) Move to previous search result. ‘C-n’, ‘’ (biblio--selection-next) Move to next search result. ‘RET’ (biblio--selection-browse) Open the web page of the current entry in a web browser. ‘C-RET’, ‘’ (biblio--selection-browse-direct) Open the full text of the current entry in a web browser. ‘c’, ‘M-w’ (biblio--selection-copy) Copy BibTeX of current entry at point. ‘C’, ‘C-w’ (biblio--selection-copy-quit) Copy BibTeX of current entry at point and close results. … etc. … while C-h m gives this: Bibliographic search results (→ magit: mpd) mode defined in ‘biblio-core.el’: Browse bibliographic search results. key binding --- ------- RET biblio--selection-browse C-n biblio--selection-next C-p biblio--selection-previous C-w biblio--selection-copy-quit C-y biblio--selection-insert-quit ESC Prefix Command ? biblio--selection-help C biblio--selection-copy-quit I biblio--selection-insert-quit b biblio--selection-change-buffer c biblio--selection-copy h biblio--selection-help i biblio--selection-insert q quit-window x biblio--selection-extended-action C-RET biblio--selection-browse-direct biblio--selection-browse-direct (that binding is currently shadowed by another mode) biblio--selection-next biblio--selection-previous M-w biblio--selection-copy