在Qt中带有括号数字的注释是什么意思？

Question

我可以帮助您翻译中文，涉及IT技术相关内容。以下是您需要翻译的内容：

我正在尝试熟悉Qt 5。为此，我开始查看提供的示例。我注意到代码中充满了//! [0]和类似数字的注释，有时一个接着一个。

例如：来自calculator.cpp的代码片段：

//! [1]
    display = new QLineEdit("0");
//! [1] //! [2]
    display->setReadOnly(true);
    display->setAlignment(Qt::AlignRight);
    display->setMaxLength(15);

    QFont font = display->font();
    font.setPointSize(font.pointSize() + 8);
    display->setFont(font);
//! [2]

//! [4]

我在文档中没有找到解释，相应帮助文件中的代码解释也没有涉及这些标签。

有人知道它们的作用吗？我的意思是，我知道它们只是注释，但它们是否在Qt内部有实际用途，比如某种标记？

谢谢,

Jan

- legrojan

---

看起来注释是一些书签，指向http://qt-project.org/doc/qt-4.8/widgets-calculator.html的文档，以便确定应该在哪里显示代码。每个`//! [n]`块的内容大多与网站上引用的代码相匹配。 - Zaiborg

这有点说得通，这也是我预期的，但它与网站/文档中的实际代码不匹配。这只是一种近似，而且还有一些缺失的标签，比如上面例子中的//! [3]。不过我刚刚意识到，这可能是由于多个代码修订造成的。 - legrojan

是的，也有可能。如果这些类似于书签，它们不必连续，只需要唯一即可从Web服务器中解析（如果引号中的内容从实际代码文件中读取）。 - Zaiborg

Answer 1

根据this来源，它们是doxygen文档的标记。

- TheDarkKnight