DOC : add documentation to Polygon methods

closes #3035
Updated and forced.