Moved PIL.Image.Image docs from comments to docstrings

This patch transforms the documentation that was living as a commentary above the methods definition of the PIL.Image.Image class.

The text was maintained and it was only modified to use Sphinx format, for example `@param foo` was replaced with `:param foo:`

The existing "one-line" docstrings were removed in favor of more complete documentation