From 69ff457f2e22994848eed7373ac83e25f05a0052 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Mon, 3 Oct 2016 07:05:03 -0700
Subject: [PATCH] release notes, docs

---
 docs/handbook/image-file-formats.rst |  8 +++++++-
 docs/releasenotes/3.4.0.rst          | 29 ++++++++++++++++++++++++++++
 2 files changed, 36 insertions(+), 1 deletion(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 61c7ed607..f03bb6bb8 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -540,6 +540,11 @@ Saving Tiff Images
 
 The :py:meth:`~PIL.Image.Image.save` method can take the following keyword arguments:
 
+**save_all**
+    If true, Pillow will save all frames of the image to a multiframe tiff document.
+    
+    .. versionadded:: 3.4.0
+
 **tiffinfo**
     A :py:class:`~PIL.TiffImagePlugin.ImageFileDirectory_v2` object or dict
     object containing tiff tags and values. The TIFF field type is
@@ -659,9 +664,10 @@ DDS
 
 DDS is a popular container texture format used in video games and natively
 supported by DirectX.
-Currently, only DXT1 and DXT5 pixel formats are supported and only in ``RGBA``
+Currently, DXT1, DXT3, and DXT5 pixel formats are supported and only in ``RGBA``
 mode.
 
+.. versionadded:: 3.4.0 DXT3
 
 FLI, FLC
 ^^^^^^^^
diff --git a/docs/releasenotes/3.4.0.rst b/docs/releasenotes/3.4.0.rst
index ef4db3322..a6512fc12 100644
--- a/docs/releasenotes/3.4.0.rst
+++ b/docs/releasenotes/3.4.0.rst
@@ -14,6 +14,20 @@ two times shorter window than ``BILINEAR``. It can be used for image reduction
 providing the image downscaling quality comparable to ``BICUBIC``.
 Both new filters don't show good quality for the image upscaling.
 
+Deprecation Warning when Saving JPEGs
+=====================================
+
+JPEG images cannot contain an alpha channel. Pillow prior to 3.4.0
+silently drops the alpha channel. With this release Pillow will now
+issue a ``DeprecationWarning`` when attempting to save a ``RGBA`` mode
+image as a JPEG. This will become an error in Pillow 3.7.
+
+New DDS Decoders
+================
+
+Pillow can now decode DXT3 images, as well as the previously support
+DXT1 and DXT5 formats. All three formats are now decoded in C code for
+better performance.
 
 Append images to GIF
 ====================
@@ -26,3 +40,18 @@ Note that the ``append_images`` argument is only used if ``save_all`` is also
 in effect, e.g.::
 
     im.save(out, save_all=True, append_images=[im1, im2, ...])
+
+Save multiple frame TIFF
+========================
+
+Multiple frames can now be saved in a TIFF file by using the ``save_all`` option. 
+e.g.::
+
+    im.save("filename.tiff", format="TIFF", save_all=True)
+
+Image.core.open_ppm removed
+===========================
+
+The nominally private/debugging function ``Image.core.open_ppm`` has
+been removed. If you were using this function, please use
+``Image.open`` instead.