I use javadoc format, which seems to work OK:
/**
* Summary of method.
*
* A bit more detail, if you really must know stuff.
*
* @code
* Some sample code.
* @endcode
*
* @see http://stackoverflow.com
*
* @param p1 A parameter, no less.
* @param p2 Another parameter.
*
* @return YES if it's Wednesday, else NO.
*/
See this article for more.