ddox empty public methods/interfaces etc

Steven Schveighoffer schveiguy at yahoo.com
Tue Nov 7 14:02:28 UTC 2017


On 11/6/17 11:01 PM, Andrey wrote:
> Hello is there way to automatically generate documentation for public 
> methods, interfaces, fields etc.? e.g. now I should write somethink like 
> this to generate documentation for enum Bacgkround:
>> ///
>> enum Background {
>>     transparent,  ///
>>     light,  ///
>>     dark,  ///
>>     action,  /// Background for action panel, e.g. with buttons OK, 
>> Cancel etc.
>> }
> 
> I would like to write insted this:
>> enum Background {
>>     transparent,
>>     light,
>>     dark,
>>     action,  /// Background for action panel, e.g. with buttons OK, 
>> Cancel etc.
>> }
> 
> and avoid all redundant comments.

Sorry, this isn't possible. Ddoc requires opt-in for public 
documentation. The alternative would be opt-out, which would look even 
worse I think.

-Steve


More information about the Digitalmars-d-learn mailing list