> Vaclav Petras wrote... ... > > Petr Prikryl wrote... > >> But when I put exclamation mark at the beginning of docstring, > >> Doxygen commands are interpreted as for other languages or ## > >> comments (example [3]). > >> """!My comment. > >> > >> More here. > >> """ > > > > This could be a kind of experiment. Or it is simply a bug. > > [...]It is likely that interpreting the exclamation mark in a docstring is > > an unwanted side effect. > > I hope that it is not a bug I want my comments to be processed by > Doxygen as rich comments not only verbatim text. It could be done by > exclamation mark (as it is now) or some settings in Doxygen > configuration file.
This should be answered by Dimitri. Anyway, I would be for adding another configuration settings that says how the docstrings should be treated. The user can choose in the case. > > In my opinion, if one wants to use Doxygen for documentation of a > > project, that fact should not affect the documented project. > > In other words, the Doxygen related details should not be visible > > when running a Python program. > > Interesting idea. This would mean that you either cannot use Doxygen > (or at least doxygen markup) for Python at all or that Doxygen should > support reStructuredText. Because, according to PEP 287, > reStructuredText is the the standard way how to format Python > docstrings. > > So in my opinion there is one bug > * ! is not mentioned in documentation > and two enhancements > * turn on markup interpretation in Python docstrings from Doxyfile > * support at least basic reStructuredText because it is in PEP 287 The Doxyfile setting should be designed the way that allows to add a reStructuredText parser in future. But the Doxygen filters can also be used for the purpose. So, this is the question for the designer. I am sure that Dimitri would like to have a good analysis of the problem if anything should be "fixed". Petr ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ _______________________________________________ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users
