Add parameter documentation check

This patch adds a new check to ensure that parameters
to classes are documented. It will ensure there is a
block of the form:

[*<parameter_name>*]
(<Optional|Required>) <description>

and if optional will check for:
Defaults to <default value>