Vscode: doxygen syntax highlight error with @param[in]

Created on 5 Feb 2020  路  8Comments  路  Source: microsoft/vscode

Issue Type: Bug

When use the doxygen tag @param[in/out], the variable couldn't highlihght normally.

My code such as:

/**
 * @brief xxx
 * 
 * @param[in] par1 xxxx
 */
void Function_1(void par1) {
xxx
}

When I add '[in]' after the '@param', 'par1' could highlight.

When I change the format as '@param[IN]', '@param[in]', '@param [in]', 'par1' couldn't highlight as well.

Am I mistaken the usage of doxygen?

VS Code version: Code 1.41.1 (26076a4de974ead31f97692a0d32f90d735645c0, 2019-12-18T14:58:56.166Z)
OS version: Windows_NT x64 10.0.18362

*as-designed needs more info

Most helpful comment

Ah my bad, I tested running out of source and I just pulled in the latest C++ grammar this week. This is fixed in master and you'll start seeing the fix in insiders with version 1.43.

All 8 comments

Please also provide a screen shot of what you're seeing and what you expect to see.

Please also provide a screen shot of what you're seeing and what you expect to see.

image

Okay. This is what I seeing.

I expect to see 'par1' wihch in Unnormal Condition change the color same as in Normal Condition.

By the way, my theme is "One Dark Pro".

I don't see anything in the manual about Doxygen supporting [IN] instead of [in]. If you can point me to somewhere this says it's supported then I'll pass the bug on to the owners of the C++ syntax highlighting grammar.

The described behavior is how it is expected to work. If you disagree, please explain what is expected and what is not in more detail. See also our issue reporting guidelines.

Happy Coding!

Doxygen Manual: Special Commands

Please see Doxygen Manual - Special Commands - param '['dir']' { parameter description }

In my screen shot, you can see when I use @param[in], it also couldn't work.

Ah my bad, I tested running out of source and I just pulled in the latest C++ grammar this week. This is fixed in master and you'll start seeing the fix in insiders with version 1.43.

@alexr00
hey, I noticed that this bug is fixed in v1.43.0. But today I update to v1.43.1, this bug happend again.....What wrong with it??

The version of the C++ grammar we used in 1.43.0 caused a freeze, so for 1.43.1 we reverted back to the version without the freeze. If the freeze is fixed in the C++ grammar, then I'll update it again and you'll get this fix back. In the meantime, we get our grammar from https://github.com/jeff-hykin/cpp-textmate-grammer. You can get this grammar yourself by installing the Better C++ Syntax extension.

Was this page helpful?
0 / 5 - 0 ratings

Related issues

borekb picture borekb  路  3Comments

omidgolparvar picture omidgolparvar  路  3Comments

lukehoban picture lukehoban  路  3Comments

chrisdias picture chrisdias  路  3Comments

biij5698 picture biij5698  路  3Comments