【问题标题】:QT special comments //: //[num] etcQT 特别注释 //: //[num] 等
【发布时间】:2011-09-30 06:17:33
【问题描述】:

qt示例文件夹中这个特殊的cmets是什么意思?

我知道“//:”这是一个注释,如果下一行包含 tr(""),则该注释将被带到翻译程序中。

//[] 之间的代码似乎被带到了生成的 html 文档中。

是否有完整描述特殊 cmets 的文档?

【问题讨论】:

  • 我在 qt /examples 文件夹的几乎所有来源中都看到了像 // [10] 这样的 cmets。我认为10 是一个标签。并且还认为这个 cmets 由 help-creation 解析器解析,以剪切与标签相关的内容并将其粘贴到文档中。

标签: c++ qt comments


【解决方案1】:

Qt 在其代码 cmets 中使用 Doxygen Special Commands。 [好吧,没错,Doxygen 扩展了 Qt 的注释特殊命令。] 特殊命令用于控制在代码上运行时文档的生成。维护 Qt 的 Trolls 拥有自己的工具,用于从代码生成文档。 Doxygen 旨在为凡人提供我们可以使用的工具。

您可以使用 Doxygen(我假设是 Qt 的工具)做的一件事是在文档中包含示例代码。通常,只需要部分代码,因此可以使用一些特殊命令来控制显示文件的哪个部分(例如 \line)。他们依赖于在代码中查找标记。恕我直言,// [xx] 就是那些标记。

【讨论】:

    【解决方案2】:

    This is the document for translation comments,虽然没有提到//[num]....

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 2017-09-09
      • 2015-03-25
      • 1970-01-01
      • 1970-01-01
      • 2011-03-04
      • 1970-01-01
      • 2015-05-29
      • 2012-07-05
      相关资源
      最近更新 更多