Re: [ELPA] New package: transient

[Eli Zaretskii]

> From: Jean-Christophe Helary <address@hidden>
> Date: Tue, 5 May 2020 17:23:24 +0900
> 
> >> Would you consider that a tutorial on the information search system 
> >> provided by emacs would help in that matter ?
> > 
> > Maybe.  I don't think I understand well enough what would such a
> > tutorial include.  You didn't say.
> 
> What a tutorial usually includes is step-by-step help with practical 
> examples. I'll be putting that on my todo list.

If you mean a tutorial for the Info mode, then we already have it:
info.info.  You can get to it if you type 'h' in Info mode.

> > We already have some of that ion the Emacs tutorial
> 
> Very little in fact:
> 
> C-h t
> C-h i
> C-h f
> C-h v
> M-. → "requires running etags to record all the manuals nodes"
> C-h p in a quote from the Emacs manual
> M-x apropos
> C-h a → the example Chassell gives produces 211 results

I think you are looking at the Introduction to Programming in Emacs
Lisp, not at the tutorial.

> > and then we have the "Help" chapter in the Emacs manual.
> 
> The Help chapter provides a "summary of help commands for accessing the 
> built-in documentation."

That's just the summary section.  The next sections describe the
commands in detail.

> That summary does not group the information by topic but merely lists the 
> commands in the alphabetical order of the keys.
> 
> Let me attach a patch that groups the commands by topic (tables) in that 
> summary. I am not sure adding a @subsection is the best way to label such 
> groups (tables) but I could not find a better solution.

Thanks, but in long lists of loosely-related items, it is usually
better to arrange them in alphabetical order, since it makes it easier
to find what you need.