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

[Christopher Dimech <dimech@gmx.com>]

Lars mentioned that although using :documentation works, "(:documentation <foo>)" is
a non-standard way of setting things up in contrast to something like
"(declare (documentation ...))"

What do you think?

> Sent: Thursday, June 03, 2021 at 11:11 AM
> From: "Stefan Monnier" <monnier@iro.umontreal.ca>
> To: "Christopher Dimech" <dimech@gmx.com>
> Cc: "Drew Adams" <drew.adams@oracle.com>, "help-gnu-emacs@gnu.org" <help-gnu-emacs@gnu.org>
> Subject: Re: [External] : Supplying DOC string in a `defun' using `defvar'
>
> > How long will you allow users to move to the new dialect?
>
> I don't know.  Emacs-24 introduced the new dialect back in 2012.
> The conversion of Emacs's own ELisp code was just finished a couple
> months ago, so I expect it'll quite a few more years.
>
> > And after that time, the lexical binding declaration would no longer
> > be necessary, right?
>
> That's right.  Most likely we'll first have a transition period where
> the absence of a lexical-binding declaration will trigger a warning.
>
>
>         Stefan
>
>