C++ Doxygen命令段落(悬挂)缩进限制?
在多行(段落)命令上可以使用多少缩进有限制吗 考虑函数上下文中C++ Doxygen命令段落(悬挂)缩进限制?,c++,doxygen,indentation,restrictions,C++,Doxygen,Indentation,Restrictions,在多行(段落)命令上可以使用多少缩进有限制吗 考虑函数上下文中@details的典型用例: /** * @brief Do foo. * @details Lorem ipsum dolor sit amet, mentitum rationibus nec an. * Usu magna eirmod et, aperiri discere volumus pri ex. * * Te pro alii vidit, cu nonumes medi
@details
的典型用例:
/**
* @brief Do foo.
* @details Lorem ipsum dolor sit amet, mentitum rationibus nec an.
* Usu magna eirmod et, aperiri discere volumus pri ex.
*
* Te pro alii vidit, cu nonumes mediocritatem duo.
* Paulo detracto tincidunt id vim, ad has oblique percipit.
*
* @tparam T The argument type.
* @param param1 The first parameter.
* @param param2 The second parameter.
* @return The return value.
*/
template< typename T >
inline
T foo( T const& param1, T const& param2 );
/**
*@brief-Do-foo。
*@详细信息请参阅《自然资源法》和《自然资源法》。
*通常情况下,我们会先讨论体积。
*
*这是一对平庸的二重唱。
*保罗贬低tincidunt id vim,ad有倾斜的感知能力。
*
*@tparam不是参数类型。
*@param param1是第一个参数。
*@param param2是第二个参数。
*@返回返回值。
*/
模板
内联
T foo(T const¶m1,T const¶m2);
长的@details
段落必须被包装,这就导致了这样一个问题:此缩进是否有任何限制
我知道Doxygen使用Markdown,它有特定的缩进限制/使用,例如代码块的“4空间缩进”。在我想插入代码的情况下,上面的缩进是否会混淆或冲突
更一般地说,是否有我不知道的其他缩进用法和可能的冲突
@托马斯·马修斯,这是一个关于技术限制的问题,而不是关于审美风格的问题。非常粗糙的建议,但这对我来说是有效的-
/**
* @brief Do foo.
* @details Lorem ipsum dolor sit amet, mentitum rationibus nec an.
*
* Usu magna eirmod et, aperiri discere volumus pri ex.
*
* Te pro alii vidit, cu nonumes mediocritatem duo.
* Paulo detracto tincidunt id vim, ad has oblique percipit.
*
* @tparam T The argument type.
* @param param1 The first parameter.
* @param param2 The second parameter.
* @return The return value.
*/
@托马斯·马修斯,这是一个关于技术限制的问题,而不是关于审美风格的问题。@thomas matthews,“……以前问过,现在已经有了答案。”是不正确的;还没有人回答其他问题。对于任何要求重新打开此文档的人:谢谢。我没有确定的答案,但我建议不要使用此缩进,因为根据我的经验,不需要太多时间来混淆口译员,尤其是启用了降价支持。对于美观,请考虑启用<代码> JavaDoCuto AutoBiRef。这样就不需要在源注释中进行任何缩进。