我正在使用plantuml生成UML数据,并对注释样式有疑问。
重现我的问题的步骤:
我创建了一个名为mainpage.dox的文件并写下这些内容:
/** \mainpage Sender class
* Sender class. Can be used to send a command to the server.
* The receiver will acknowledge the command by calling Ack().
* \startuml
* Sender->Receiver : Command()
* Sender<--Receiver : Ack()
* \enduml
*/
然后,我创建doxyfile来设置输出优化的java或C#,has_dot和PLANTUML_JAR_PATH。运行doxygen后可以生成UML图。
但是,当我将评论样式更改为C#时,没有任何主页和警告消息的内容:
/// \mainpage Sender class
/// Sender class. Can be used to send a command to the server.
/// The receiver will acknowledge the command by calling Ack().
/// \startuml
/// Sender->Receiver : Command()
/// Sender<--Receiver : Ack()
/// \enduml
///
但是当我删除uml注释
时会生成主页面(显示下面的文本)/// \mainpage Sender class
/// Sender class. Can be used to send a command to the server.
/// The receiver will acknowledge the command by calling Ack().
\ startuml是否必须使用C风格的注释?谢谢你的任何建议。
这是我的DoxyFile:http://pastebin.com/hjEFz8b0
编辑:
我刚用另一种评论方式再次测试。 \ startuml正在使用这种风格
/*! \mainpage Sender class
Sender class. Can be used to send a command to the server.
The receiver will acknowledge the command by calling Ack().
\startuml
Sender->Receiver : Command()
Sender<--Receiver : Ack()
\enduml
*/
答案 0 :(得分:3)
我怕你发现了一个bug。
与此同时,我发布了以下修复程序: https://github.com/doxygen/doxygen/commit/4df52916170bb81179697d0fa78c7d81fd95415f