If you're writing doxygen-comments, use @param and @return to describe parameters and return values.