doc: harmonize doxygen documentation

[jerome-jutteau]

We currently have a mix of @param param_name and @param_name and we should harmonize it.

@param_name seem to be the preferred norm.

Also, we need to replace all git grep "0 on error" with "NULL on error"