bug#46627: [PATCH] Add new help command 'describe-command'

[Stefan Kangas]

Richard Stallman <rms@gnu.org> writes:

>   > It would be like `describe-function' but show only commands.
>
> Are you perhaps talking about limiting the candidates for completion?

Yes.

> If the only difference between these commands is completion of the
> argument, here's an idea.
>
> * Make TAB and ?, when a completion list is displayed, toggle the
> completion mode between commands-only and all-functions.
>
> * Arrange a way to show on the screen which completion mode is in use.
> Perhaps in the completions list buffer.
>
> * Make C-h f start out with completion in commands-only mode.  That
> will be good for beginners.  If you want to complete a noninteractive
> function name, toggle the completion mode.
>
> This interface involves no new commands, and no new bindings, and it
> is easy to discover.

To me, it certainly sounds more complicated to learn, and harder to use,
than just having two separate commands.  If your concern is complexity,
the above is the more complex UI.

Just compare the above explanation with this:

- `C-h f' for any function
- `C-h x' for commands

Also, the patch is really not that big.