Tools Suggestions for Easy Documentation

Recommended Posts

Hi. I already been using a coding standard for years, and I just wanted to know if there are any tools or plug-ins for visual studio that will aid me in putting properly formatted documentation code on my source codes. It can be as simple as key strokes. Here are examples of what I put in on my source codes:
// this is at the top of header files
///////////////////////////////////////////////////////////////////////////////
/// Player class
/// @author: Andrei Victor (xxx@xxxxxxx.net)
/// This class is blah blah
///////////////////////////////////////////////////////////////////////////////

// ...

///////////////////////////////////////////////////////////////////////////////
/// SwitchPlayers function
/// This function helps two players switch their situations and states in the
/// game.
/// @param  p_first - the pointer to the first player to switch with player 2
/// @param  p_second - the pointer to the second player to switch with player 1
/// @return true if the operation is successful, otherwise false.
///////////////////////////////////////////////////////////////////////////////


As you can see, I put in headers for my class definitions, functions, and methods like the one above. I wish to have some kind of keystroke to paste in those formatted remarks on my code.

Share on other sites
It's not too difficult to write a quick plugin; I did one for work (which unfortunately I can't share) in about a week that includes intelligent comment-template placement and a few other nifty features.

Share on other sites
You know what. You're right.

Doh! Now, my problem shifted to whether I should go out and buy Visual Studio 2008 or just stick with my beloved Visual C++ Express 2008.

P.S. I just realized how VC++ 2008 Express can't support plug-ins. Double-Doh!

Create an account

Register a new account

• Partner Spotlight

• Forum Statistics

• Total Topics
627682
• Total Posts
2978613

• 13
• 12
• 10
• 12
• 22