Proposal: __traits(getComment, symbol)
Eugene Wissner
belka at caraus.de
Wed Aug 28 09:04:06 UTC 2019
On Wednesday, 28 August 2019 at 08:51:24 UTC, FeepingCreature
wrote:
> I propose a way to get the comment on a symbol at compile time.
> I believe this was already rejected, though I don't know why;
> I'd expect it to be something like "code should not change
> behavior due to a comment." I think that now that we have
> user-defined annotations there is a much lower risk of that.
>
> Why do I want this? Generating special documentation/annotated
> interfaces from D code is a *lot* easier if you can get the
> compiler to do your introspection work for you. I want to
> generate Swagger files documenting our REST services, and I
> want to use D comments to document them. Right now, I will have
> to do a weird hybrid dance where I generate the D type graph on
> the D side with compiletime introspection, output it to a file,
> simultaneously generate the Ddoc JSON file with -D -X to fish
> out the comments, then fuse the two together. There is no need
> for this, but for the absence of __traits(getComment).
I think the languages that have "comment reflection", use this
instead of custom attributes. In PHP for example
/**
* @ORM\Entity(...)
*/
class MyEntity { ... }
Because there are no attributes. Why can't you just use UDAs
instead of comments?
More information about the Digitalmars-d
mailing list