Polish the RST we generate for params.

Add a link-tag for each param for easy cross-referencing using
	(:ref:`ref_param_$param`)
Update the param descriptions
Reference parameters in the reference manual directly
Limit depth of toc
add a missing va_end()

Spotted by: Coverity