[External] : Supplying DOC string in a `defun' using `defvar'

[Christopher Dimech]

> Sent: Thursday, June 03, 2021 at 3:59 AM
> From: "Drew Adams" <drew.adams@oracle.com>
> To: "Help-Gnu-Emacs (help-gnu-emacs@gnu.org)" <help-gnu-emacs@gnu.org>
> Cc: "Stefan Monnier" <monnier@iro.umontreal.ca>
> Subject: FW: [External] : Supplying DOC string in a `defun' using `defvar'
>
> [Forwarding to the list, which got dropped from
> `Reply All' for some reason.]
> ___
>
> Sent: Tuesday, June 1, 2021 9:36 AM To: 'Stefan Monnier'
>
> > You most likely used the old dynamically scoped ELisp dialect.
> > In Emacs-28 you should see in the modeline "ELisp/d" where the "/d" is
> > highlighted in orange to bring your attention to your use of that old
> > dialect and encourage you to change it (e.g. by clicking on it).
>
> Why is `:documentation' supported only for lexical-binding buffers?

Reason in terms of user expectation behavior?  Yes

Reason in terms of implementation ease/feasiblity?
If the implementation is difficult or unfeasible, the design might be at fault.