Add documentation to Table methods. Fixes #951.
Merge pull request #1670 from astrofrog/issue-951

Add documentation to Table methods. Fixes #951.