[Top][All Lists]

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

Re: Some ideas with Emacs

From: Emanuel Berg
Subject: Re: Some ideas with Emacs
Date: Sun, 01 Dec 2019 07:15:49 +0100
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux)

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

reply via email to

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