pike-object-documentation:

/*
**! module <module_name>
**! <description>        
**! class <class_name>
**! <description>        
**!  
**! method <return_type> <pike_function>(<args-declaration>)     - multiple
**! <description>
**! returns <returns>
**!
**! arg <type> <name>     - multiple for a method
**! <description>        /
**!
**! note
**! <note>
**! 
**! see also: <references separated by comma and whitespace>
*/

 double newline is treated as new paragraph, <ref> and <pre> are allowed