Doxygen .dox 文件中的注释

Question

我有一个 .dox 文件，并且想要插入一些不会插入的 cmets 显示在实际文档中。

尝试仅使用//，Horever，当我尝试时，所有文本都被删除了。

/// \defgroup desc_polyhedra Polyhedra
///
// If you want to prevent that a word that corresponds to a 
// documented class is replaced by a link you should put a % in 
// front of the word.
///
/// \section Polyhedron 
///
/// A polyhedron is a solid in three dimensions with flat faces, 
/// straight edges and sharp corners or vertices. 
///
/// Amongst the many examples of polyhedra, the Cuboid and 
/// Prismatoid structures will be considered in more detail. 
/// Here is a brief summary of cuboids and prismatoids.

Answer 1

这里有几个选项：

1. 用\cond...\endcond包围你想单独留下的文字

2. 有一个完全独立的评论部分，只有 // - 即不要在/// 部分的中间混合//。您看到的是第一个 // 结束了 doxygen 注释块，因此它停止在输出中出现。

3. 在 doxygen 部分使用 HTML 注释语法/// <--! A comment is here -->