DOC : add documentation to Polygon methods

closes #3035
What is the easiest way to do that?  I was hoping sphinx would auto-magically do that for this...