PDA

View Full Version : What does this mean?



LearnerNM
4th November 2009, 15:26
I like learning from examples, and for the most part I can figure things out on my own. But really don't know what to make of " //! [0]" or "//! [1]," etc. I've seen these in several Qt 4.5 samples but I cannot find their meaning. Could someone who knows please tell me? Thanks.

JD2000
4th November 2009, 15:43
They are comments.

In most 'C' type languages anything following '//' on a line (to the end of the line) will be ignored by the compiler and hence does not form part of the programme.

Comments spanning one or more lines can be enclosed in /* .......................*/

Ginsengelf
5th November 2009, 08:05
Hi, Qt uses a special type of comments (and I think //! is one of them) to generate the documentation from the source files.

See www.doxygen.org for something similar.

Ginsengelf

squidge
5th November 2009, 08:36
I sure these are used to indicate which part of the sources are extracted and placed into the documentation as examples or snippets.

Like Ginsengelf says, the bulk of the documentation is created from the source files automatically, as it would be almost impossible to keep the documentation upto date otherwise.

LearnerNM
5th November 2009, 17:18
Thanks everyone. Very supportive.