[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Docstrings and manuals
From: |
Michael Albinus |
Subject: |
Re: Docstrings and manuals |
Date: |
Sun, 17 Apr 2016 14:19:41 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux) |
Dmitry Gutov <address@hidden> writes:
> I'm not arguing in favor of leaving mistakes in the manual. But I
> think it should be strictly a derivative work. I.e. the docstrings
> must contain the complete information (if maybe presented in a terse
> fashion), and the manual could rephrase that, only to make it more
> accessible (but not more informative).
I still don't understand what problem you discuss. There are docstrings,
and there are manuals. Both have their reasons to exist.
What do you want else? Nobody urges you to read the manuals, if you
don't want.
I believe it would be good if vc-* functions are covered in a
manual. What is the problem with this?
Best regards, Michael.
- Docstrings and manuals, was: Re: bug#20637: incompatible, undocumented change to vc-working-revision, Dmitry Gutov, 2016/04/16
- Re: Docstrings and manuals, Michael Albinus, 2016/04/17
- Re: Docstrings and manuals, Dmitry Gutov, 2016/04/17
- Re: Docstrings and manuals, Michael Albinus, 2016/04/17
- Re: Docstrings and manuals, Dmitry Gutov, 2016/04/17
- Re: Docstrings and manuals,
Michael Albinus <=
- Re: Docstrings and manuals, Dmitry Gutov, 2016/04/17
- Re: Docstrings and manuals, Eli Zaretskii, 2016/04/17
- Re: Docstrings and manuals, Michael Albinus, 2016/04/17
- Re: Docstrings and manuals, Dmitry Gutov, 2016/04/17
- Re: Docstrings and manuals, Eli Zaretskii, 2016/04/17
- RE: Docstrings and manuals, Drew Adams, 2016/04/17
- Re: Docstrings and manuals, Dmitry Gutov, 2016/04/17
- Re: Docstrings and manuals, Eli Zaretskii, 2016/04/17
- Re: Docstrings and manuals, Phillip Lord, 2016/04/18
- Re: Docstrings and manuals, Marcin Borkowski, 2016/04/18