Use standard wording for function docs. Use valid
QDoc commands (\a instead of \param, for example).

Change-Id: I556fdbf686f2f54138617d6784c650a1d973513c
Reviewed-by: Eike Ziller <eike.ziller@digia.com>