__traits(documentation, X)

[Steven Schveighoffer]

On 1/16/18 9:19 PM, Seb wrote:
> What
> ----
> 
> ```
> /// my fancy string
> enum documentedEnum = 1;
> enum funcDoc = __traits(documentation, documentedFunc);
> assert(funcDoc == "my fancy string")
> ```
> 
> See https://github.com/dlang/dmd/pull/6872 for better examples
> 
> 
> Status
> -------
> 
> The naive implementation leads to a small, but noticeable increase of 
> DMD's compilation time.
> 
> Andrei's words:
> 
>> I'd say keep it on the back burner until we find a couple of good 
>> ideas for using it. Discussing it in the forum may help.
> 
> So do you have a good use cases for this?
> If this is a useful feature, the implementation can be improved to be 
> zero-cost for normal runs.
> 
> Post here or at https://github.com/dlang/dmd/pull/6872

I shudder at the thought of compiled code being affected by documentation.

I don't like it, sorry.

-Steve