Any way to force XML doc comments?

Hello, is there any way to force Resharper C++ to always use XML style doc comments? I'm working on an Azure Sphere project and when I enter the triple forward slashes (///) I sometimes get XML style and other times it C style. What I would like is to have XML style doc comments all the time. When I disable Resharper and restart VS then it works exactly like I want but when I re-enable it, it reverts back to a mix of both styles, even in the same file.

3 comments
Comment actions Permalink

Hello,

This is strange, could you please help us reproduce this behavior? You should always get the same style of comments. The body of the comment is generated from the 'doc' live template in R#. You can edit this template yourself and change it to output XML-style comments.

Thanks!

0
Comment actions Permalink

Hi Igor!

Thanks for getting back to me so quickly. I have a suspicion that this behaviour is perhaps inherited from included source from a git sub module but I can't confirm that. Does Resharper C++ inspect the entire source tree and attempt to adjust the doc comments accordingly?

 

0
Comment actions Permalink

No. I guess this might happen for some files where R# is inactive for some reason and VS doc generation support kicks in, but in this case the style of generated comments should be consistent inside a single file - either R# does not work in a file and you always get XML-style VS comments, or R# works and you' always get Doxygen-style comments.

0

Please sign in to leave a comment.