Allow XML documentation to be generated for Pinta.Core.

This should be helpful for people building addins.
- Disabled warning 1591, which resulted in thousands of warnings about
every undocumented public member.
- Cleaned up a bunch of out-of-date documentation that was caught by the
compiler.