On 4/26/2015 11:38 AM, Baz wrote:
Hi, is it worth documenting stdc ?
No. In general, D should not be re-documenting APIs where the documentation
exists elsewhere, because:
1. have to rewrite it because of copyright
2. such rewrites introduce errors and ambiguities
3. documentation always gets out of date
4. a user would be foolish to use re-documentation rather than the official
documentation
5. our time is much better expended on more productive things.
I'm about to copy all the docs from offical sources, e.g
http://www.cplusplus.com/reference/cctype/.
There's been a post from W.B a few weeks ago about undocumented sources.
I don't remember if it included stdc.
It doesn't include API interfaces.
Thanks for asking before doing the work. I'd sure hate for you to expend a lot
of effort on this only to have it rejected. We can't afford to waste effort like
that.
