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

Brad Roberts via Digitalmars-d digitalmars-d at puremagic.com
Mon Mar 23 12:24:07 PDT 2015


Anyone want to do a rough draft version of a script to build with some 
version of what Walter has suggested that produes just a simple number 
for each of druntime and phobos that are the number of undocumented 
functions?

Bonus points for generating a output doc (preferably json) that contains 
useful data about what's missing to facilitate a website for navigating 
through the results.

I'll set it up to run daily and graph and view the results.

On 3/23/2015 12:04 PM, Steven Schveighoffer via Digitalmars-d wrote:
> On 3/18/15 2:48 PM, 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.
>
> If the idea is to force it on all users, I'm with deadalnix 100%.
>
> But what if -w makes ddoc do this, so you have a choice? Or some other
> switch?
>
> I would also find handy a switch to simply display publicly undocumented
> functions in the documentation. I recently went through and documented
> all core.stdc items with empty docs so they would just show up. Was
> actually quite monotonous.
>
> -Steve


More information about the Digitalmars-d mailing list