Messages in this thread | | | Subject | Re: Improving documentation for programming interfaces | From | Markus Elfring <> | Date | Wed, 8 Jan 2020 13:40:45 +0100 |
| |
> hmm, maybe we could add some kinda-OOP-style metadata into the type documentation ?
I hope so.
> Or maybe extend doxygen to crossref types vs functions operating on them.
An advanced cross-reference variant would be nice (besides the “Elixir”).
>>> It seems that no customised attributes are supported at the moment. >>> Thus I imagine to specify helpful annotations as macros. > > Do you mean _attribute__(...) or comments ?
I propose to encode helpful information into macro calls as needed for the C programming language.
> I guess he's thinking about some kind of meta-language for expressing > common things we know from oop-world, like ctors, dtors, getters, etc.
This feedback fits also to my imaginations for a better taxonomy.
Regards, Markus
| |