如何解决Doxygen对Python声明的行尾注释
| 在C / C ++中,您可以强制doxygen识别注释适用于一行前面的文本。以下任何一项: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
将字符串添加到文档“ 1”。尝试在Python中进行等效操作似乎无效。这有效:
## This is my variable
my_variable = None
这个:
my_variable = None ## This is my variable
my_other_variable = None
正如您所期望的那样,将文档附加到“ 4”,但这两个都:
my_variable = None ##< This is my variable
my_variable = None #!< This is my variable
似乎只是丢弃文档。有没有办法在Python中做等同于ѭ6的事情?
解决方法
不,目前不支持此功能。
Python的解析器由几个学生提供。尽管他们在整体上做得很好,但他们并未实现C / C ++可用的所有功能。
缺少的两个最值得注意的功能是:
支持在定义后记录材料
https://bugzilla.gnome.org/show_bug.cgi?id=361813
支持交叉引用和调用图
http://old.nabble.com/Python-callgraph-td24224054.html
希望以后能添加这些内容,但是欢迎您提供任何帮助。
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。