In C/C++, you can force doxygen to recognize that a comment applies to the text preceding it on a line. Any of these:
int my_variable; /*!< This is my variable */
int my_variable; /**< This is my variable */
int my_variable; //!< This is my variable
int my_variable; ///< This is my variable
adds the string to the documentation for my_variable. Trying the equivalent in Python doesn't seem to work. This works:
## This is my variable
my_variable = None
This:
my_variable = None ## This is my variable
my_other_variable = None
attaches the documentation to my_other_variable, as you'd expect, but both of these:
my_variable = None ##< This is my variable
my_variable = None #!< This is my variable
seem to just discard the documentation. Is there a way to do the equivalent of //!< in Python?
##<variant).