DOC : add documentation to Polygon methods

closes #3035
You should probably cross-ref the Path class.