noisecore at October 6th, 2011 10:57 — #1
This may sound like a really dumb question. But I can't seem to find it anywhere on the internet.
Say that you are coding in Visual Studio, sometimes when you select a method, and InteliSense pops up, you can see which parameters are needed in a yellow-ish box.
Sometimes though, there is a text commenting the method in this same box.
How do you write these comments?
I'm writing some generic library for some friends of mine (for easy use) and
I would like to comment my code decently. It would be nice if they could see this comment by just hovering over it in InteliSense
reedbeta at October 6th, 2011 12:12 — #2
It just extracts it from the header file where the method is defined; if there's a comment above the method, or on the same line as the method, it'll (hopefully) pick that up.
alphadog at October 7th, 2011 07:57 — #3
Depends on your version of VS (Esp. Express vs not) and language.
For c#, it's old, but a good start.
For C++, it's a bit harder.
noisecore at October 7th, 2011 18:48 — #4
Wauw. I had never seen the xml documentation before. This is really handy !
noisecore at October 8th, 2011 16:23 — #5
Anyone has any recomendations for which program to use to transform the XML file into useful help/docu file?
thenut at October 9th, 2011 07:46 — #6
Doxygen is one of the best ones out there. It supports many forms of commenting formats and programming languages. If you install graphviz in addition to Doxygen, you can produce class relationship diagrams. By default Doxygen will write HTML files, but you can export to RTF or my personal fav, CHM (compiled HTML).
noisecore at October 9th, 2011 10:47 — #7
Doxygen did the trick. Thanks alot !
serapth at November 29th, 2011 13:39 — #8
Frankly this can be acheived as easily as a triple slash ( /// ) which will automatically expand to the format required, then you just fill in the blanks.