|
From: | Dmitry Gutov |
Subject: | Re: Trunk still not open |
Date: | Sat, 15 Mar 2014 08:30:13 +0200 |
User-agent: | Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.3.0 |
On 14.03.2014 17:39, Stephen J. Turnbull wrote:
If you have XEmacs docstrings, in many cases, yes, but Emacs generally doesn't put enough semantic information in docstrings to define the corner cases where tests actually make a big difference. You need the manual level of detail.
If the docstring doesn't describe the corner cases, they're usually not important for the user to know (what will they be doing in the manual, then?), or it's a bug in the docstring.
This is probably different for some large/core features, but on most of the features I've worked with, the manual rarely provides a lot of value.
Some context here and there perhaps, but nothing like describing the corner cases more than docstrings and comments do.
[Prev in Thread] | Current Thread | [Next in Thread] |