update package and version module docstrings

Co-authored-by: gnbl <gnbl@github>

src/PIL/__init__.py

@@ -1,15 +1,18 @@
-#
+"""Pillow {} (Fork of the Python Imaging Library)
-# The Python Imaging Library.
-# $Id$
-#
-# package placeholder
-#
-# Copyright (c) 1999 by Secret Labs AB.
-#
-# See the README file for information on usage and redistribution.
-#
 
-# ;-)
+Pillow is the friendly PIL fork by Alex Clark and Contributors.
+    https://github.com/python-pillow/Pillow/
+
+Pillow is forked from PIL 1.1.7.
+
+PIL is the Python Imaging Library by Fredrik Lundh and Contributors.
+Copyright (c) 1999 by Secret Labs AB.
+
+Use PIL.__version__ for this Pillow version.
+PIL.VERSION is the old PIL version and will be removed in the future.
+
+;-)
+"""
 
 from . import _version
 
@@ -21,6 +24,9 @@ PILLOW_VERSION = __version__ = _version.__version__
 
 del _version
 
+__doc__ = __doc__.format(__version__)  # include version in docstring
+
+
 _plugins = ['BlpImagePlugin',
             'BmpImagePlugin',
             'BufrStubImagePlugin',