DDK code commenting?

Why the code in DDK have comment like this beginning "/*++" and "--*/" as end?
/*++
 
			Routine Description:
...
 
			STATUS_SUCCESS if successful
 
			--*/

Open in new window

fxp007Asked:
Who is Participating?
 
DanRollinsCommented:
OK, All I can give you is a couple of guesses:
1) It is possible to write custom tools that do things like re-fplow ,ulti-line comments
     http://www.codeproject.com/KB/macros/commentreflower.aspx
and that tool can do something specific when it sees /*++
2) You can use (for instanxce) /* TODO as a marker to make a comment into a tasklist itee.  No customized token can contain a + so that usage guaratees that the header like that won't end up in the TaskList.
0
 
DanRollinsCommented:
that idiom lets the IDE display it as a collapsible block
ide.JPG
0
 
fxp007Author Commented:
But it can be collapsed if I only use /* and */


pic.png
0
Question has a verified solution.

Are you are experiencing a similar issue? Get a personalized answer when you ask a related question.

Have a better answer? Share it in a comment.

All Courses

From novice to tech pro — start learning today.