Question

我正在研究这个项目：https://sbl.inria.fr/doc，其中的文档使用 doxygen 完成。

我们习惯用符号“-”来定义各节的ID，以分隔单词，例如：

\section sec-intro Introduction

但是，自doxygen 1.8.15-git以来，惯例似乎已发生变化，并且仅接受字母数字字符，从而破坏了文档中的几乎所有页面。

不幸的是，我们有很多页面，在阅读整个文档之前，我想知道是否缺少任何东西，例如使用doxygen选项打开/关闭

[编辑]

这是一个对我不起作用的最小示例，doxygen 1.8.15-git：

/**
\mainpage My Main Page

Abstract

\section home-intro Introduction

Intro
*/

//! Documented class test
class test{
};

我只是创建配置文件，然后在包含我的.hpp文件的目录上运行doxygen（这样就不必指定我的标头的路径了）：

doxygen -g; doxygen

输出html的主页上包含“摘要”，但没有该部分，并且在doxygen日志中有一个警告：

test.hpp:6: warning: Invalid section id `home'; ignoring section

[编辑2]

它与Doxygen 1.8.14一起使用。我从git仓库中克隆了项目，所以我有了最新版本。使用1.8.14的标记版本，可以正常工作。我更改了标题。

Answer 1

我找到了问题的原因，它是基于以下因素的回归： Bug 740046 - Negative sign in -Foo::Bar ruins hyperlink in generated output

该问题已在建议的补丁程序中解决：https://github.com/doxygen/doxygen/pull/6388