Doxygen 乳胶误解预处理器定义答案

【问题标题】：Doxygen latex misinterpreting preprocessor definitionDoxygen 乳胶误解预处理器定义
【发布时间】：2013-08-13 21:33:48
【问题描述】：

好的，让我在 SO 而不是 Tex 上再试一次。

所以我正在尝试使用 Doxygen 创建一些 PDF。

我已经在我的 Windows 7 机器上安装了 MiKTeX，并设法获得了让 Doxygen 生成 PDF 所需的所有样式。

问题是无论我重新运行多少次，它都不会解决 1 个交叉引用。（第一次重新运行往往会得到除此之外的所有内容）

交叉引用是一个看起来像这样的类。

/*!
 * @class CLASSESREALNAME CLASSESREALNAME.h "CLASSESREALNAME.h"
 * @brief Brief description of CLASSESREALNAME 
 */
class __declspec (dllexport) CLASSESREALNAME { 

//Stuff

}

我已将模板配置为读取“/*！”根据 Doxygens 文档Here，因为 Doxygen cmets 和 '@' 或 '\' 都是有效的转义字符。

我发现this 部分有助于在生成 HTML 时消除错误，但似乎乳胶 .tex 文件中没有正确的引用来解析此类。我认为它与__declspec (dllexport) 有关，因为它是我用它记录的唯一类，也是唯一导致问题的类。

这是 Doxygen 中的错误吗？

或者更有可能我需要定义或做一些事情来使这个问题按预期解决？

提前谢谢。

注意：

我还注意到所有文件引用都是 '??'而不是在pdf中。我猜是因为这个类在它没有生成后会炸掉所有东西。

【问题讨论】：

标签： pdf latex doxygen documentation-generation preprocessor-directive

【解决方案1】：

原来这与在代码中其他位置的注释中的 \LaTeXonly 部分中定义 \documentclass、\begin{document} 和 \end{document} 有关。

Doxygen 讨厌。或者更准确地说，MiKTeX 读取文件的方式或 Doxygen 使文件不允许这些标签。

所以这个错误原来是由其他地方的问题引起的，但我没有迹象表明日志中的所有内容都指向这个类。

【讨论】：