The register_parser decorator function is one of the most important
public functions in the codebase.  Improve its documentation by adhering
to Python docstring standards, including parameter documentation.

Change-Id: Ibbde495e799dcd550810635e591b24e9eba8cb28