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

deadalnix via Digitalmars-d digitalmars-d at puremagic.com
Thu Mar 19 02:40:32 PDT 2015


On Wednesday, 18 March 2015 at 19:28:44 UTC, Jacob Carlborg wrote:
> On 2015-03-18 19:48, Walter Bright wrote:
>> I'm fed up with this problem. It is actively hurting us every 
>> day.
>>
>> https://issues.dlang.org/show_bug.cgi?id=14307
>>
>> Anyone want to take this on? Shouldn't be particularly 
>> difficult.
>
> I'm not so sure about this. I think there's a big chance that 
> users will just add an empty documentation comment to silence 
> the error.
>

It is not a good chance, it is 100% guaranteed.

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


More information about the Digitalmars-d mailing list