dfmt options

Rikki Cattermole via Digitalmars-d digitalmars-d at puremagic.com
Sun Mar 15 17:13:51 PDT 2015


On 16/03/2015 8:08 a.m., Walter Bright wrote:
> On 3/14/2015 8:32 PM, Rikki Cattermole wrote:
>> This might be a bit of a out of scope, but auto generating of DDOC
>> comments for
>> symbols would be nice. Basically to enforce before e.g. committing that
>> everything has been explained.
>
> Autogeneration of documentation is by definition useless. Documentation
> is for 'why' and 'how'. Autogeneration can never be more than
> reformatted source code.

It is yes. No disagreement there.

Its just a real pain to create these stubs by hand. Atleast this way, 
people will moan about documentation being empty and it'll seem less 
work to do.


More information about the Digitalmars-d mailing list