Re: Enhancement: issue error on all public functions that are missing ddoc sections

[Walter Bright via Digitalmars-d]

On 3/19/2015 3:27 PM, deadalnix wrote:

On Thursday, 19 March 2015 at 22:05:51 UTC, Walter Bright wrote:

On 3/19/2015 2:40 AM, deadalnix wrote:

And I'm sorry, but if most function require DDoc, your code probably sucks quite
badly and some renaming should be considered.

I've never seen any code that self-documented "why".

Indeed, that is why comment are useful. If all your method
require a why, you probably should consider refactoring instead
of adding comments all over the place.

I suppose:

    http://dlang.org/phobos/std_math.html#.sin

could be renamed to:

    real returnSineOfArumentInRadians_ReturnNanIfNan_
ReturnNanIfInfinity_InvalidIfArgumentIsNanOrInfinity(real x);