From f19e3ec1246d28bab3092d3c53cc4b17b55cdafd Mon Sep 17 00:00:00 2001
From: nulano <nulano@nulano.eu>
Date: Sun, 14 Jun 2020 13:46:52 +0200
Subject: [PATCH] promote JpegPresets from autodoc section

---
 docs/PIL.rst                   |  8 --------
 docs/reference/JpegPresets.rst | 11 +++++++++++
 docs/reference/index.rst       |  1 +
 src/PIL/JpegPresets.py         |  9 +++++----
 4 files changed, 17 insertions(+), 12 deletions(-)
 create mode 100644 docs/reference/JpegPresets.rst

diff --git a/docs/PIL.rst b/docs/PIL.rst
index 21adc5a16..e7939554d 100644
--- a/docs/PIL.rst
+++ b/docs/PIL.rst
@@ -70,14 +70,6 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:mod:`JpegPresets` Module
--------------------------
-
-.. automodule:: PIL.JpegPresets
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
 :mod:`PaletteFile` Module
 -------------------------
 
diff --git a/docs/reference/JpegPresets.rst b/docs/reference/JpegPresets.rst
new file mode 100644
index 000000000..bf93f891f
--- /dev/null
+++ b/docs/reference/JpegPresets.rst
@@ -0,0 +1,11 @@
+.. py:currentmodule:: PIL.JpegPresets
+
+:py:mod:`JpegPresets` Module
+============================
+
+.. automodule:: PIL.JpegPresets
+
+    .. data:: presets
+        :annotation:
+
+        A dict of all supported presets.
diff --git a/docs/reference/index.rst b/docs/reference/index.rst
index 25c84126d..9f9e7142b 100644
--- a/docs/reference/index.rst
+++ b/docs/reference/index.rst
@@ -28,6 +28,7 @@ Reference
    ImageWin
    ExifTags
    TiffTags
+   JpegPresets
    PSDraw
    PixelAccess
    PyAccess
diff --git a/src/PIL/JpegPresets.py b/src/PIL/JpegPresets.py
index 118dab061..09691d79d 100644
--- a/src/PIL/JpegPresets.py
+++ b/src/PIL/JpegPresets.py
@@ -1,9 +1,11 @@
 """
 JPEG quality settings equivalent to the Photoshop settings.
+Can be used when saving JPEG files.
 
-More presets can be added to the presets dict if needed.
-
-Can be use when saving JPEG file.
+The following presets are available by default:
+``web_low``, ``web_medium``, ``web_high``, ``web_very_high``, ``web_maximum``,
+``low``, ``medium``, ``high``, ``maximum``.
+More presets can be added to the :py:data:`presets` dict if needed.
 
 To apply the preset, specify::
 
@@ -21,7 +23,6 @@ Example::
 
   im.save("image_name.jpg", quality="web_high")
 
-
 Subsampling
 -----------