int c;//! loop Counter

/**
 * compares (XOR) two Types
 * return boolean result
 */
bool compare(Type l,Type r);

它的doxygen格式.有一些populer格式用于在Comment中记录代码. Doxygen是一个,另一个是naturaldocs.还有更多.它的味道.你甚至可能喜欢naturaldocs格式.

/*
   Function: Compare
   Compares two Types
   Parameters:
      l - lhs
      r - rhs.
   Returns:
      boolean result

*/
bool compare(Type l,Type r);

DOC格式也像similer一样.

/** Comparison
    Compare two Types

    @param l Type lhs
    @param r Type rhs
    @return boolean result
*/
bool compare(Type l,Type r);

只使用一种格式并坚持下去.