Populate rtype docstrings and update some params

Updated the rtype docstring for a few methods in a couple of modules and
provided a param description for interface_mapping.