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

Don via Digitalmars-d digitalmars-d at puremagic.com
Thu Mar 19 03:02:41 PDT 2015


On Wednesday, 18 March 2015 at 22:05:18 UTC, Brian Schott 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.
>
> D-Scanner has had this feature for a while. Here's the list for 
> Phobos:
>
> http://dpaste.dzfl.pl/7d018aad2b10

That's a very interesting list. Things like this:

std/regex/package.d(320:13)[warn]: Public declaration 'regexImpl' 
is undocumented.

appear to be public only as an workaround (necessary for mixins 
or something). Perhaps such things shouldn't actually be 
documented. But we don't have a mechanism for that.


More information about the Digitalmars-d mailing list