Re: __traits(documentation, X)

[Patrick Schluter via Digitalmars-d]

On Thursday, 18 January 2018 at 18:31:28 UTC, Steven 
Schveighoffer wrote:
On 1/18/18 11:48 AM, Adam D. Ruppe wrote:
[...]

This is how I'd imagine doing something like this. I don't see 
it being a huge pain, just an extra build step.

[...]

Did you mean not really harmful?

But in any case, the idea that comments affect the file you are 
compiling *right now*, and not some other tool-generated file 
makes me very nervous. Comments are supposed to not affect the 
code. Consider that with this feature, the documentation now 
becomes part of the API.

While I'm on your side of the issue, it is a fact that ddoc (or 
doxygen, javadoc) comments are more a language within a language 
(i.e. there is syntax in them) than simple comments.