Re: Upcoming loss of usability of Emacs source files and Emacs.

[Dmitry Gutov]

On 06/24/2015 01:22 AM, Richard Stallman wrote:

> I just looked at the main lisp directory and found no example
> of a confusing doc string.  In lisp/emacs-lisp, the one
> case in advice.el seems to be the only one.

See the docstrings in macroexp-progn, macroexp-let* and macroexp-let2, 
for instance. Rewriting them like that would make them worse.