Doxygen : Section id only alphanumerical since 1. 8.15-git

标签 doxygen

我正在研究这个项目: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(这样就不需要指定我的 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的标签版本,工作正常。我改了标题。

最佳答案

我找到了问题的原因,它是回归: 错误 740046 - -Foo::Bar 中的负号会破坏生成输出中的超链接

导致该问题的 github 问题是 https://github.com/doxygen/doxygen/pull/5677和拉取请求 https://github.com/doxygen/doxygen/pull/704 .

该问题已在建议的补丁中修复:https://github.com/doxygen/doxygen/pull/6388

关于Doxygen : Section id only alphanumerical since 1. 8.15-git,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/51259115/

相关文章:

css - Doxygen 图像边框

德尔福 Pas2Dox + Doxygen

documentation - 生成文档 doxygen 风格,无需注释代码

c - Doxygen 文档结构成员与属性

Doxygen EXCLUDE_PATTERNS 正则表达式

visual-studio - 让 Doxygen 和 MSVC TODO 标签协同工作

c - 扩展 makefile 以使用 doxygen 生成库和文档

doxygen - 构建 doxygen1.8.6 时出错

latex - 如何在doxygen配置中禁用 latex

c++ - 如何在 doxygen 文档中获取我的 .cpp 文件?