funny looking comments - c++
when i read through source files of opensource projects i often come across some weird phrases in the comments
开发者_如何学C/*
@brief ......
@usage.....
@remarks....
@par....
*/
questions
1.What are they?(were not mentioned when i was learning c++) 2.Do they have any documentation(where)They are just comments and as such have no special meaning in C++. They are probably to allow a documentation generator (For example Doxygen) to extract the data from the comments.
Those are for some flavour of automatic documentation generator. Another program runs through the code looking for comments of like you see there. The @...
keywords identify how the documentation should be laid out, and that program generates pretty HTML or printed documentation directly from the source code. It's a way to keep the docs up-to-date with the code more easily.
精彩评论