doc_check updates

doc checker now checks for ":type  PARAM:" in addition to ":param PARAM:".

Note that there are two spaces after "type" so it lines up with "param" in code
blocks.
add doc check for return and return type

If a return statement is in a function, ensure  the function has :return: and
:rtype: in the docstring.