Merge pull request #1931 from wiredfool/pngquant-docs

Additional docs for libimagequant

docs/installation.rst

@@ -140,8 +140,6 @@ Many of Pillow's features require external libraries:
 
 * **libfreetype** provides type related services
 
-* **libimagequant** provides improved color quantization
-
 * **littlecms** provides color management
 
   * Pillow version 2.2.1 and below uses liblcms1, Pillow 2.3.0 and
@@ -161,6 +159,15 @@ Many of Pillow's features require external libraries:
   * Pillow does **not** support the earlier **1.5** series which ships
     with Ubuntu and Debian.
 
+* **libimagequant** provides improved color quantization
+  
+  * Pillow has been tested with libimagequant **2.6.0**
+  * Libimagequant is licenced GPLv3, which is more restrictive than
+    the Pillow license, therefore we will not be distributing binaries
+    with libimagequant support enabled.
+  * Windows support: Libimagequant requires VS2013/MSVC 18 to compile,
+    so it is unlikely to work with any Python prior to 3.5 on Windows.
+
 Once you have installed the prerequisites, run::
 
     $ pip install Pillow

docs/releasenotes/3.3.0.rst

@@ -0,0 +1,27 @@
+3.3.0
+-----
+
+Libimagequant support
+=====================
+
+There is now support for using libimagequant as a higher quality
+quantization option in ``Image.quantize()`` on unixlike
+platforms. This support requires building Pillow from source against
+libiamgequant.  We cannot distribute binaries due to licensing
+differences.
+
+New Setup.py options
+====================
+
+There are three new options to control the ``build_ext`` task in ``setup.py``:
+
+  * ``--debug`` dumps all of the directories and files that are
+    checked when searching for libraries or headers when building the
+    extensions.
+  * ``--disable-platform-guessing`` removes many of the directories
+    that are checked for libraries and headers for build systems or
+    cross compilers that specify that information in via environment
+    variables.
+  * ``--disable-osx-tcltk-framework`` prevents automatically linking
+    against the system Tcl/Tk frameworks to allow building against
+    vendor provided libraries.

docs/releasenotes/index.rst

@@ -6,6 +6,7 @@ Release Notes
 .. toctree::
   :maxdepth: 2
 
+  3.3.0
   3.2.0
   3.1.2
   3.1.1