helpful VS emacs-which-key

If you want to programmatically create files, write to them, etc, then read the fine manual, it comes with your Emacs, has index, search and web-like navigation. It is well worth your time investing in looking up the manual, both for Emacs and for Elisp. You access the manual via C-h i. Another good thing to learn how to use is Emacs built-in help. As a minimal basic, C-h f will display information about functions, and C-h v will display the documentation for variables. You can also see where things are declared, open the source code, etc. A good alternative to built-in help is Helpful, which I suggest installing and start using too.

It tweaks Emacs GC. You can run M-x describe-variable while your cursor is at gc-cons-threshold to learn about it. If you opted-in for using "Vim bindings" (Evil mode), you can press K while in normal mode. Note that K doesn't run the describe- command in Doom, but it runs helpful-command from (https://github.com/Wilfred/helpful), which provides more context that describe- commands usually do.

The packages helpful and elisp-demos are super useful because they enhance Emacs' built-in documentation.

You can try to actually use helpful for a while. There was also a package with examples, I don't remember the name, perhaps someone else knows which I mean, that shows usage of a function where available. I remember using it and found it very useful for a while when I was learning elisp more actively. I still use helpful sometimes.

Once you got the hang of keybindings, which-key is a helpful extension (aka package) to Emacs. At this stage, there are other helpful packages and keybindings.

helpful for better help buffers

Since you seem interested, have a look at elisp-demos , too. It works in tandem with helpful.

Elisp Docs are fantastic they have documented everything while with CL most documentation is missing or only on the Web. With Emacs, one need to learn about C-h f (describe-function), C-h k (describe-key), helpful.el and elisp-demos and a new world opens. Terminology is always different, simple example: Microsoft terminology sounds like bullshit, to a Unix person.

Your primary source of knowledge will be the manual and the built-in discoverability (describe-* functions, or helpful) and of course reading the code. I'm not a manual person myself, but Emacs is one of the examples where it is truly excellent and has answers for almost everything.

I think which-key already solves exactly that: https://github.com/justbur/emacs-which-key

As for the "complicated keybindings general" -- I assume because remembering things like C-x C-s is hard because of the shifted keystrokes? I get that, and there is in fact a solution for less used keybindings which I love, called 'which-key' https://github.com/justbur/emacs-which-key

I would recommend installing the which-key package, which is a fantastic discoverability aid. If you ever want an example config to get some inspiration, I have one here: Emacs Bedrock

Make sure you have which-key installed and turned on. When using a keybinding that has a prefix (like C-x or C-c), it displays all the keybindings that start with that prefix.

which-key for the shortcut menus

there are some packages to help with the keybings, which-key shows a list of keybind and its command and (guru-mode)[https://github.com/bbatsov/guru-mode] enforces to use the "best" keybind, for exemple, it forces you to use C-n to move the cursor, blocking you to use the down key, and if you press the down key, it show a text in minibuffer to the best keybind.

Thanks for confirming, I think it's an issue in which-key itself: https://github.com/justbur/emacs-which-key/pull/166

If you haven't already, definitely check out the package which-key.

> even though I'm a terminal user ... I really like the discoverability of GUIs, and that's where a good GUI is unbeatable by CLI.

CLI has poor discoverability? Sure; but even on the terminal, discoverability can still be good:

A couple of nice examples of discoverability in keyboard-focused programs:

- emacs' which-key[0]; there's a vim port[1] too. This shows you (some) of the available keybindings for the next input, and a short label. So you don't have to remember what `SPC h p ...` or all the options under `SPC f...`.. but it still helps to recall that `SPC h` is for 'help' related commands, `SPC f` for file related commands.

- emacs' magit[2][3]. Magit is so good at discoverability, that I'd rate it as the best tool for using git with. I've learned more about git from using it.

[0] https://github.com/justbur/emacs-which-key

[1] https://github.com/liuchengxu/vim-which-key

[2] https://magit.vc/

[3] https://emacsair.me/2017/09/01/magit-walk-through/

Am I right in thinking this is quite similar to which-key?