fix failing doctests
Updated message about string initialization deprecation to be more verbose
Cleaned up return value docstrings for SkyCoord.match_to_catalog_*
added note info to docstrings that the matching functions support SkyCoord
turned comment into TODO notice