Re: docstrings and elisp reference

[Joost Kremers]

On Tue, Jun 06 2017, Stephen Leake wrote:
> Doc strings are for short reference information for single 
> functions/variables.
>
> texinfo docs are for more indepth explanations of several 
> related functions/features.
>
> They are complementary; they should not duplicate each other.

And yet, the Elisp manual documents a large number of functions 
and variables / options in a format that is very reminiscent of 
doc strings and which provides basically the same information. I 
kinda see the point in making the doc string and that description 
identical. Obviously, the manual gives a lot more background info 
and groups the functions and variables together in a meaningful 
way, but wouldn't it make sense / be possible to extract the 
descriptions in the manual directly from the source?


--
Joost Kremers
Life has its moments