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