Add an @import Doxygen command
We already have a @version
command that allows to write @version 1.0
, it would be nice to have something similar for import statements, like @import
.
I managed to create something similar with
ALIASES += "import{2}=\par Import Statement^^\code import \1 \endcode^^\par Version^^\2"
Which can then be used like @import{org.kde.kirigami,2.20}
, for example. Same result as in !16 (merged).
To make the version optional, one could use overloading:
ALIASES += "import{1}=\par Import Statement^^\code import \1 \endcode"
ALIASES += "import{2}=\par Import Statement^^\code import \1 \endcode^^\par Version^^\2"
So it could be used as @import{org.kde.kirigami}
or @import{org.kde.kirigami,2.20}
.
This could be implemented in the Doxyfile.global of https://invent.kde.org/frameworks/kapidox but this would only apply to KDE API, and it's not as nice to use without spaces like @import org.kde.kirigami 2.20
or @import org.kde.kirigami
.
There's also the matter of how import statements and versions should be shown. For instance, we could have:
- @import, with the version after the name
- @import and @version
- @import and @since
CC @redstrate