doc: document preferred Doxygen syntax and make patcheck detect it