Skip to content
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

[D] Invalid comment block when /** syntax is used. #1058

Closed
Soulsbane opened this issue Jun 28, 2017 · 3 comments
Closed

[D] Invalid comment block when /** syntax is used. #1058

Soulsbane opened this issue Jun 28, 2017 · 3 comments

Comments

@Soulsbane
Copy link

I use this type of comment style in dlang:
/**
My Description
*/
Notice the two asterisks in the first line. This causes the entire block to be highlighted pink. This is a valid dlang style since two asterisks are needed in order to generate documentation.

Tldr:
Pink
/**
My Description
*/

Highlights correctly but dlang can't generate documentation files from this block.
/*
My Description
*/

Thanks!

@keith-hall
Copy link
Collaborator

It looks like the D syntax definition just includes the JavaDoc one, so this is essentially the same issue as jskinner/DefaultPackages#151 on the old repo.

I believe we can use the same logic as discussed at #68 (comment), to terminate the JavaDoc context and continue with the regular block comment context when a line without an asterisk as its first non-whitespace character is encountered.

@rwols
Copy link
Contributor

rwols commented Jun 28, 2017

Leading asterisks are optional both in Doxygen as well as in JavaDoc, so I suggest to remove the invalid.illegal scopes actually.

@keith-hall
Copy link
Collaborator

this has been fixed by #1351

@wbond wbond closed this as completed Feb 12, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

4 participants