Re: On keybindings and the slow erosion of help's utility

Richard Stallman <[email protected]> Thu, 30 Jul 2026 18:50:06 -0400
Newsgroups gmane.emacs.devel
Message-ID <[email protected]>
[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > >   > >> - nil → not applicable; try the next function
  > >   > >> - =#'command= → run this command interactively
  > >   > >> - =#'keymap= → return this keymap (Emacs enters it for further lookup)
  > >   > >> - ='keymap-variable= → a symbol whose value is returned as a keymap
  > >   > >
  > >   > > Not completely sure what you mean by the above notation.
  > >   > > Do you mean that the function should return values of the form
  > >   > > `(function CMD)` and `(quote VAR)`?
  > > 
  > > I ask the same question about the syntaxes cited above.
  > > 
  > >   > I meant that the return value could be similar to what we already have
  > >   > inside keymaps (as in 23.3 Format of Keymaps section of Elisp manual):
  > >   > a command to run, another keymap, etc.
  > > 
  > > That section describes Lisp objects, not syntax using `='.

  > I think this might be a misunderstanding.  The '+' characters in the
  > likes of "=#'command=" are left-overs from Org markup.  They should be
  > ignored when reading the above text.

I don't follow that at all.

Could someone say what this text intend to mean?

 - nil → not applicable; try the next function
 - =#'command= → run this command interactively
 - =#'keymap= → return this keymap (Emacs enters it for further lookup)
 - ='keymap-variable= → a symbol whose value is returned as a keymap

-- 
Dr Richard Stallman (https://stallman.org)
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)