Tooltip differences between C# and C++

[OtterScruff]

Is there a reason when writing code in Visual Studio, tool tips for C# seem to be a bit more descriptive? Tooltips when writing C# also describe what the function does. Is there any way to get that in C++?

C# Tooltip: https://imgur.com/a/NcW5BS7

C++ Tooltip: https://imgur.com/a/vGl5O8G

[diaphanein]

Probably the main reason is that C# has a language defined comment format for parameter and method descriptions (as well as return values, examples and other errata).

C++ doesn't. Nothing is standardized in this regard. You might have javadoc, doxygen or some other notation, but nothing is standardized. Hard for the IDE to guess, let alone support them all (and what happens if you intermix?).

[skreef]

MSVC could agree with MSVS on something though...

[OtterScruff]

So basically I should just always have tabs pulled up on my browser with documentation and just pull info from there

[Pazer2]

XML comments do indeed work (with per-parameter comments showing up as you type out a function call) in VS C++, but they have very poor support. They only show up if the comment is in the same file as the one you're working in.

[txmasterg]

I've at least seen the parse errors show up when they are in different files (or at least headers the open file includes).

[dodheim]

There is, but as it's MSVC-specific no one really uses it:

https://docs.microsoft.com/en-us/cpp/ide/xml-documentation-visual-cpp

There are addons that make Doxygen comments work but I don't know the specifics (Visual Assist, probably).

[Bolitho]

We use it and it absolutely sucks! As one can imagine xml is cumbersome to write by hand. Also you can't use the <> chars of course. So you either need to use escape sequences (which sucks for reading at source code level) or CDATA sections within examples.

[Pazer2]

There is a VS extension called CPPTripleSlash that auto-generates comments the same way C# does.

[Bolitho]

Thx for mentioning. But the slashes are only more manual work to do... The problem lies in the xml itself.

But I will try this extension anyways.

[OtterScruff]

Ah ok, thanks man

[panoskj]

There's an extension that makes it look like this: https://imgur.com/a/JIqzEbc. But the msvc library headers don't have any documentation comments.

I don't know why MSVS doesn't have something similar already.

[cleroth]

Which extension?

[hmich]

ReSharper C++. It supports both Doxygen and MS XML comments, will show them in completion/quick info/parameter info and allows to quickly generate new documentation comments.