【发布时间】:2010-05-29 18:16:35
【问题描述】:
我使用 Doxygen 的三斜杠语法来标记我的 C++ 代码。有 出现的两个重要案例:
1) 块标记 cmets,它是行上的唯一元素,并且可以 或者可能不会开始向左冲洗;例如
class foo
/// A one sentence brief description of foo. The elaboration can
/// continue on for many lines.
{
...
};
void foo::bar
/// A one sentence brief description of bar. The elaboration can
/// continue on for many lines.
() const
{
...
}
2) 总是跟随一些 C++ 的尾随标记 cmets 第一行较早的标记,但仍可能溢出到 后续行;例如
class foo
{
int _var1; ///< A brief description of _var1.
int _var2; ///< A brief description of _var2
///< requiring additional lines.
}
void foo::bar
( int arg1 ///< A brief description of arg1.
, int arg2 ///< A brief description of arg2
///< requiring additional lines.
) const
{
...
}
我想知道有哪些隐藏/显示支持来处理这些约定。 最重要的情况是块标记 cmets。理想情况下我会 希望能够完全消除这些,这意味着我会 不想浪费一条线来简单地表示折叠的存在 阻止标记注释,更喜欢边缘标记,例如 hideshowvis.el。
【问题讨论】: