Fix docs formatting for surface_control.h

This change
 - adds \params, so the parameter descriptions
get formatted as a table
 - replaces |name| with \a name, when used for
function args. This way they appear in itallic
in the documentation and w/o vertical bars.
 - changes /* to /**, so docs can be generated
 - fixes several typos

Test: development/tools/ndk/build_ndk_docs.py
Change-Id: I738b04c9e26a6b5604182a3d452787976a7f6043