Doxygen

to comment before the object, “/ / /” for single line comment or “/** */” for multiline comments

to comment after the object (eg on the same line), “/ / / <” for single line comment

put a '%' sign before a name to prevent automatic link to a class or namespace name

to put a link to function, write its full signature including const, eg ImageReader::loadImage(unsigned int, image::Image&) const