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

Dejan Lekic via Digitalmars-d digitalmars-d at puremagic.com
Tue Mar 24 07:24:03 PDT 2015


On Tuesday, 24 March 2015 at 14:17:26 UTC, Dejan Lekic wrote:
> On Wednesday, 18 March 2015 at 18:48:53 UTC, 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 could take this task, with help of Brian's scanner I could 
> easily find that methods to document...
>
> Let me know should I take it or not.

Actually, I just realised what the issue is... :) I apologise. I 
thought the task is to document those functions that are not yet 
documented.

Why would you want DDoc to issue those errors? I would rather 
setup a git hook which is using Brian's dfmt, or implement 
something similar to Checkstyle in Java world, and use it in git 
hook to prevent undocumented functions creeping into the D code...


More information about the Digitalmars-d mailing list