[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Proposal for an improved `help-for-help'
From: |
Eli Zaretskii |
Subject: |
Re: Proposal for an improved `help-for-help' |
Date: |
Mon, 22 Feb 2021 18:12:49 +0200 |
> From: Stefan Kangas <stefan@marxist.se>
> Date: Sun, 21 Feb 2021 17:27:51 -0600
> Cc: emacs-devel@gnu.org
>
> Eli Zaretskii <eliz@gnu.org> writes:
>
> > So it _is_ about the order. But then I think we should discuss the
> > underlying principles, and then order the commands accordingly.
> >
> > The rationale for the order in the manual was to show the discovery
> > commands first, and the commands for focused help later.
>
> To be honest, I didn't yet think very hard about this problem. But
> sure, we can discuss it. Any suggestions or ideas are welcome.
>
> My preliminary thinking here is that we should probably start with
> something like `describe-mode' and perhaps `describe-bindings' -- things
> that are about the basic commands to find help about the task that the
> user is engaged in right now. Maybe together with `describe-key', and
> `describe-command'.
Since there can be different use cases, and each one could favor a
different order, perhaps we should precede a short guide to the list?
Like
If you look for some feature, try "discovery" group.
If you look for documentation of a command or a variable or a mode,
try ...
etc.
- Re: Consistent face for keys in *Help* and `substitute-command-keys', (continued)
Re: Proposal for an improved `help-for-help', Eli Zaretskii, 2021/02/21
Re: Proposal for an improved `help-for-help', Howard Melman, 2021/02/21
Re: Proposal for an improved `help-for-help', Yuri Khan, 2021/02/22