Doxygen: Markdown anchors do not work with special symbols in path

Created on 3 Nov 2020  ยท  3Comments  ยท  Source: doxygen/doxygen

Describe the bug
Have at least two markdown files that just have a header with an anchor

# Header 1 {#anchor1}

```markdown

Header 2 {#anchor2}


Additionally, the Doxyfile is in another directory that has the directory of the markdown files as INPUT.
A simple version looks like
```console
.
โ”œโ”€โ”€ build
โ”‚ย ย  โ””โ”€โ”€ Doxyfile
โ”œโ”€โ”€ md1.md
โ””โ”€โ”€ md2.md

If the path to the markdown files contains . or +, a warning will be emitted, e.g.

/dev/shm/example_1.0/md2.md:1: warning: multiple use of section label 'md__dev_shm_example_1' while adding anchor, (first occurrence: /dev/shm/example_1.0/md1.md, line 1)

Expected behavior
No warning, anchor works as expected.

To Reproduce
example_1.0.tar.gz
example+ds.tar.gz
example_1.0+ds.tar.gz

All cases trigger the bug, the INPUT path assumes /dev/shm/example_1.0 etc.
If you extract to a different path, adjust the INPUT in the build/Doxyfile.

Version
Happens in 1.8.20 and on master.
Seems to have worked in 1.8.17 (did not confirm).

Additional context
https://github.com/seqan/seqan3/issues/2011

Markdown bug

Most helpful comment

Problem surfaced first time in version 1.8.19.

I've just pushed a proposed patch, pull request #8157

All 3 comments

Problem surfaced first time in version 1.8.19.

I've just pushed a proposed patch, pull request #8157

Code has been integrated in master on github (please don't close the issue as this will be done at the moment of an official release).

This issue was previously marked 'fixed but not released',
which means it should be fixed in doxygen version 1.9.0.
Please verify if this is indeed the case. Reopen the
issue if you think it is not fixed and please include any additional information
that you think can be relevant (preferably in the form of a self-contained example).

Was this page helpful?
0 / 5 - 0 ratings

Related issues

eseiler picture eseiler  ยท  4Comments

dhebbeker picture dhebbeker  ยท  4Comments

aster94 picture aster94  ยท  3Comments

Alphastrick picture Alphastrick  ยท  6Comments

doxygen picture doxygen  ยท  4Comments