删除 doxygen 的 \copydoc 的点？

【问题标题】：Remove the dot of doxygen's \copydoc?删除 doxygen 的 \copydoc 的点？
【发布时间】：2015-03-16 09:42:06
【问题描述】：

我对 doxygen 的 \copydoc 有疑问。示例

file1.h

/*!
 * \file
 * FileOne
 */

file2.h

/*!
 * \file
 * This is similar to the \copydoc file1.h file.
 */

文档总是说：

这类似于。

文件一。文件。

我不想添加这个点（和换行符）。怎么去掉？

原因是，我希望它从该文件中读取组名。如果它添加一个点，则找不到该组。新示例：

file1.h

/*!
 * \defgroup FileOne
 */
/*!
 * \file
 * FileOne
 */

file2.h

/*!
 * \file
 * \ingroup \copydoc file1.h
 */

文档总是说：

\.

文件未添加到组中，因为它在\ingroup 命令中输入了FileOne.。

【问题讨论】：

标签： c++ c doxygen

【解决方案1】：

这不是\copydoc 的用途。您试图用它来代替文件的“名称”，但实际上您正在做的是用 documentation 代替文件，这是一个段落。

我认为您应该只命名文件 - 使用正确的设置，Doxygen will auto-generate a link to that file's documentation。

/*!
 * \file
 * This is similar to the file1.h file.
 */

【讨论】：