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
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.
>> 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
> 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.
More information about the Digitalmars-d