Another use case for __traits(docComment)

Jab jab_293 at gmall.com
Tue Nov 19 05:30:46 UTC 2019


On Friday, 15 November 2019 at 17:57:59 UTC, Dennis wrote:
> On Friday, 15 November 2019 at 17:15:12 UTC, Jab wrote:
>> Struct settings I've used look more like this, that you 
>> usually can't see in one full screen window when everything is 
>> on one line:
>
> As you get more and more struct members the chance that the 
> documentation comment can actually double as user-facing 
> comments becomes smaller and smaller.
> Trying to keep everything simple and compact like that is not 
> going to scale, as soon as e.g. your application gets localized 
> and supports foreign languages your one-liner multi-purpose 
> documentation comments have to go anyway.

Docs don't really ever get localized. Otherwise phobos, D, and 
basically all programming languages all have the same problem.


More information about the Digitalmars-d mailing list