[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
http://user.it.uu.se/~embe8573
https://dataswamp.org/~incal
- Re: Some ideas with Emacs, (continued)
- Re: Some ideas with Emacs, Elias MÃ¥rtenson, 2019/12/05
- Re: Some ideas with Emacs, Richard Stallman, 2019/12/05
- Re: Some ideas with Emacs, Elias MÃ¥rtenson, 2019/12/06
- Librepay, Richard Stallman, 2019/12/08
- Re: Librepay, VanL, 2019/12/08
- Re: Some ideas with Emacs, Richard Stallman, 2019/12/03
- Re: Some ideas with Emacs, Richard Stallman, 2019/12/02
- Re: Some ideas with Emacs, Marcin Borkowski, 2019/12/03
- Re: Some ideas with Emacs, Richard Stallman, 2019/12/04
Re: Some ideas with Emacs, Richard Stallman, 2019/12/01
- Re: Some ideas with Emacs,
Emanuel Berg <=
Re: Some ideas with Emacs, Richard Stallman, 2019/12/01
Re: Some ideas with Emacs, Emanuel Berg, 2019/12/01
Re: Some ideas with Emacs, Emanuel Berg, 2019/12/01
Re: Some ideas with Emacs, Emanuel Berg, 2019/12/01
Re: Some ideas with Emacs, Emanuel Berg, 2019/12/01
Re: Some ideas with Emacs, Emanuel Berg, 2019/12/01