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

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

bug#22336: 25.0.50; cl-generic.el features are not documented in ELisp m


From: Stefan Monnier
Subject: bug#22336: 25.0.50; cl-generic.el features are not documented in ELisp manual
Date: Sun, 24 Jan 2016 18:00:58 -0500
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux)

> ':method' is in the doc string, which for me was a clear sign it
> should be documented.

I consider that the docstring should be a "reference" documenting as
much of the supported behavior as possible, whereas the manual should be
more accessible (give context and examples) and less exhaustive.

> Such dynamically-updated doc string would be very good to have, I
> think, but I needed to work with what was there, and of course
> couldn't use the kind of intimate knowledge of the implementation that
> you have.

I definitely understand that, and I thank you for doing this work.


        Stefan





reply via email to

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