__traits(documentation, X)

[Patrick Schluter]

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.