Re: Some ideas with Emacs

[Emanuel Berg]

Richard Stallman wrote:

>> It might be a good idea to encourage the
>> addition of examples either in docstrings or
>> in the Elisp manual (or both).
>
> The general intention is to make doc strings
> somewhat terse, and speak at greater length
> in the manual. So the place for these
> examples is the manual, not the doc strings.

But the docstrings are much more interactive
and have a faster and more natural
work-flow access!

As long as the basic info is topmost and in the
intuitive order according to the rules (with
arguments etc) why can't one have a second (and
third etc) paragraph with more elaborate info,
and yes, examples?

BTW as you know there are already examples in
many docstrings, even Elisp - do like this, not
like this.

Great stuff IMO!

-- 
underground experts united
http://user.it.uu.se/~embe8573
https://dataswamp.org/~incal