-
Notifications
You must be signed in to change notification settings - Fork 1.3k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Double Square Bracket – somewhere – stops Doxygen #8914
Comments
Doxygen sees, even in comment, the consecutive double open square brackets as the start of a C++11 attribute. Defining specific rule for C++ and starting square bracket in a string.
I've just pushed a proposed patch, pull request #8915 |
I cannot comment on the proposed Pull Request (I do not understand the commit message), nevertheless, many thanks for taking over! |
Maybe you can build an master version with the proposed patch or use one of the "artifacts" from https://github.com/doxygen/doxygen/actions/runs/1508040340 otherwise you have to wait to till it is integrated into an official release. |
issue #8914 Double Square Bracket – somewhere – stop Doxygen
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', |
should give “return value '0' of main has multiple documentation sections” when I use
as configuration. However, the above gives no error/warning at all.
Analysis:
The problem are the two opening square quotes. For example, if I write
a)
puts("[[]]");
closing both quotesb)
puts("[");
just a single open quotec)
puts("[\0x5b");
one as hexadezimald)
puts("[\133");
one as octalinstead, all these four alternatives work and Doxygen gives the error/warning as expected. For me, looks like Doxygen simply quits parsing (or be more precise: ignores) the remainder of the document when somewhere in the document two consecutive opening square quotes are found. Even worse, the following two examples do not work as expected either:
2.
puts("[[]");
3.
puts("[[Hello]World]!");
Consequently, to close such an ‘exceptional’ section, I have to place two closing square brackets consecutively (or avoiding two consecutive opening square brackets).
Version:
1.9.1 on Ubuntu 21.10, re-tested with current binary release (1.9.2)
The text was updated successfully, but these errors were encountered: