Doxygen：自 1.8.15-git 以来，部分 ID 仅包含字母数字

Question

我正在做这个项目：https://sbl.inria.fr/doc，文档是用 doxygen.

完成的

我们习惯用符号“-”来分隔单词，例如：

\section sec-intro Introduction

但是，自 doxygen 1.8.15-git 以来，惯例似乎发生了变化，只接受了 alpha-numerical 个字符，几乎打破了我们文档中的所有页面。

不幸的是，我们有大量的页面，在查看整个文档之前，我想知道是否有任何我遗漏的东西，比如打开/关闭的 doxygen 选项

[编辑]

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

/**
\mainpage My Main Page

Abstract

\section home-intro Introduction

Intro
*/

//! Documented class test
class test{
};

我只是创建配置文件，然后在包含我的 .hpp 文件的目录中创建运行 doxygen（这样就不需要指定我的 header 的路径）：

doxygen -g; doxygen

输出 html 上的主页包含 "Abstract"，但不包含该部分，并且在 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

Doxygen : Section id only alphanumerical since 1.8.15-git