bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#48779: [External] : bug#48779: (:documentation mydoc) not working


From: Drew Adams
Subject: bug#48779: [External] : bug#48779: (:documentation mydoc) not working
Date: Tue, 1 Jun 2021 15:47:07 +0000

> This undocumented feature only works in lexical-binding buffers.

My questions here would be:

1. Why is it undocumented?
2. Why does it work only for lexical-binding buffers?

___

:documentation is documented in the Elisp manual,
but only for `cl-defgeneric'.

(Grepping the Lisp source code shows there are :doc,
:doc-spec, and :documentation.  :doc is documented
in the Elisp manual, in the context of defcustom.
:doc-spec seems to be documented in no manual.)

We don't document everything, of course.  But should
:documentation be documented for defun, as well as
for cl-defgeneric?

Yes, the latter is an emulation of Common Lisp's
`defgeneric', which has :documentation.  But defun
also has it now, apparently.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]