C++ Comment Convention

[CaptnJunks]

Hello,

This might be a dumb question, but I am looking at some c++ example code and am seeing a comment convention I do not understand. Maybe it is only useful to the programmer who wrote the code, but I'm not sure.

I've googled and searched here, can anyone tell me what the following convention is for?

  //! [5]
void MainWindow::newFile()
//! [5] //! [6]
{
    if (maybeSave()) {
        textEdit->clear();
        setCurrentFile("");
    }
}
//! [6] 

My question is around the //! [6] and so on. The document starts at 0 and goes to the last function in the document. I am assuming this has something to do with profiling? or possible optimization?

Either way I have no idea and would love to know.

Thanks all

[GRex2595]

It sort of looks like it relates to some sort of text. 5 would be a header, and 6 would be the code block.

[Peter87]

It's probably used by some tool. Doxygen uses //! but it doesn't look like doxygen comments to me.

http://www.star.bnl.gov/public/comp/sofi/doxygen/docblocks.html