ALIAS for @endcode fails with warning: reached end of file while inside a 'code' block! The command that should end the block seems to be missing!

[scott-zhong]

ALIAS for @endcode fails with warning: reached end of file while inside a 'code' block! The command that should end the block seems to be missing! on trunk (6822b2f*). Does not fail with 1.10.0.

/**
 * \starttest
 * Something
 * \endtest
 *
 */
class Test
{
};

with configurations

# Difference with default Doxyfile 1.11.0 (6822b2f151227e144f699990929afe6dbf667fee*)
ALIASES                = "starttest=\par testing ^^\code" \
                         endtest=\endcode

produces warning

test.h:10: warning: reached end of file while inside a 'code' block! The command that should end the block seems to be missing!

testcase:

testcase.zip

[albert-github]

This is a very mean problem.
After resolving the \starttest the code reads like \par testing \ilinebr \code and doxygen starts to parse this and search for the matching \endcode, but will never find it as it is not yet inserted from the \endtest ALIASES.
There is a workaround for this as we have the internal commands \icode and \endicode that behave similar to the tie \code / \endicode (they are used in the markdown processing to indicate ``` code parts).
So you could write your ALIASES as:

ALIASES                = "starttest=\par testing ^^\icode" \
                         endtest=\endicode

Note there is a disadvantage on this usage though, the part between the \icode / \endicode are probably not always seen as literal code.

@doxygen would there be possibilities to fix this (it is not just the \code command but probably all "verbatim block" commands e.g. also ``` / \dot ... \enddot / \f$ ... \f$ ....

[doxygen]

@albert-github The best I can think of is to evaluate aliases also inside \code, but only push their expansion back into the parse stream when it contains an \endcode. The same can be done for the other verbatim blocks. This keeps the "verbatim" property of these commands, without missing an end command hidden in an alias.

[albert-github]

@doxygen that would probably be the only possibility but it will probably be quite complicated especially with recursive ALIASES etc.

[doxygen]

@scott-zhong Please verify if the referenced commit fixes the problem for you. Do not close the issue, this will be done automatically when the next official release becomes available.

[albert-github]

@doxygen I think the verbatim block ``` (and ~~~) are not taken into consideration.

Example: example.tar.gz

[doxygen]

@doxygen I think the verbatim block ``` (and ~~~) are not taken into consideration.

Example: example.tar.gz

They are taken into account, but this seems to be problem with ^^ which causes the start of the verbatim block to appear after a \ilinebr whereas later processing expects it at the start of a real newline. This was already an issue with earlier versions as well. I'll look into a fix.

[doxygen]

@albert-github Should hopefully be fixed now.

[albert-github]

@doxygen Looks good, thanks.

[scott-zhong]

@doxygen Yes, the commit addresses the problem. Thank you!!!