Hi I'm making an API for a web service, and have a small collection of endpoints where I'd basically be creating copy+paste functions (a small enough number that this isn't really that important for this project). I thought I'd generate them via a mixin, but haven't seen that I can generate documentation for the mixin'd functions with either ddoc or ddox:
--- string GenerateSimpleEndpoint(string endpoint, string type) { return "MyServiceObj " ~ endpoint ~ "(MyServiceObj service) {\n" ~ " service.addQueryType(" ~ type ~ ");\n" ~ " return service;\n" ~ "}"; } /** My documentation goes here. No function shows up. */ mixin(GenerateSimpleEndpoint("endp", "EndpointType.MyType")); /+ // If I write the function instead, everything's good. MyServiceObj endp(MyServiceObj service) { service.addQueryType(EndpointType.MyType); return service; } +/ --- The doc generators don't see anything created via the mixin. `dmd -X` does have the generated function, but its "file" is "file.d-mixin-172" rather than just "file.d". My guess is that this is the problem for ddoc, but ddox doesn't appear to use this json file so it would be a different problem. Is this intended behaviour? Am I able to document generated functions? Thank you for your time --Ryan