linux 下开源软件的注释 的小问题

/**
 * write stuff:Objects
 * this is a single event.
 *
 * @param writer
 * @param event
 * @param algtype
 * @param ss_level
 * @param eventindex
 *
 * @retval PTS_SUCCESS
 * @retval PTS_INTERNAL_ERROR
 *
 *
 */

对于这个 ，是一个函数的注释 ，@param 是什么意思 。@retval 这个应该是返回值 。

参数吧

对编译器来说是注释，
但可以用其它工具提取出来生成文档。