Re: Generate docs for generated code?
On Friday, 23 July 2021 at 10:54:33 UTC, Adam D Ruppe wrote: On Friday, 23 July 2021 at 10:04:55 UTC, wjoe wrote: Is there a way for the compiler to consider doc comments in auto generated, mixed in code? If you use my adrdox generator (which runs on the dpldocs.info website), it handles mixin templates. See http://dpldocs.info/experimental-docs/std.net.curl.HTTP.html#mixed-in-members for example. Mine also actually handles mixin(q{ /// code void foo() {} }); as if it was direct. But my generator only handles mixin templates and mixin string literals, not actually generated code returned from a function. Cool! I take it. Thanks for making adrdox :)
Re: Generate docs for generated code?
On Friday, 23 July 2021 at 10:42:22 UTC, user1234 wrote: On Friday, 23 July 2021 at 10:04:55 UTC, wjoe wrote: Is there a way for the compiler to consider doc comments in auto generated, mixed in code? E.g. ```D string fooImpl = q{ /// Bar does fancy things. const void bar() { /*do something fancy*/ } }; /// This is Foo struct Foo(A, B, C) { mixin(fooImpl); } ``` So that the documentation for ```struct Foo``` has that of the member ```bar()``` ? unfortunately no and this is considered as a [bug](https://issues.dlang.org/show_bug.cgi?id=2420) bummer but thanks for the link.
Re: Generate docs for generated code?
On Friday, 23 July 2021 at 10:04:55 UTC, wjoe wrote: Is there a way for the compiler to consider doc comments in auto generated, mixed in code? If you use my adrdox generator (which runs on the dpldocs.info website), it handles mixin templates. See http://dpldocs.info/experimental-docs/std.net.curl.HTTP.html#mixed-in-members for example. Mine also actually handles mixin(q{ /// code void foo() {} }); as if it was direct. But my generator only handles mixin templates and mixin string literals, not actually generated code returned from a function.
Re: Generate docs for generated code?
On Friday, 23 July 2021 at 10:04:55 UTC, wjoe wrote: Is there a way for the compiler to consider doc comments in auto generated, mixed in code? E.g. ```D string fooImpl = q{ /// Bar does fancy things. const void bar() { /*do something fancy*/ } }; /// This is Foo struct Foo(A, B, C) { mixin(fooImpl); } ``` So that the documentation for ```struct Foo``` has that of the member ```bar()``` ? unfortunately no and this is considered as a [bug](https://issues.dlang.org/show_bug.cgi?id=2420)