From 895de5727181cd2609070ed604f3038ef513d1ff Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Wed, 15 May 2019 11:33:16 +0100
Subject: [PATCH 1/2] Update plt.show() doc

---
 lib/matplotlib/pyplot.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 19476ca75f11..40e511000eb8 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -244,7 +244,7 @@ def switch_backend(newbackend):
 
 def show(*args, **kw):
     """
-    Display a figure.
+    Display figures.
 
     When running in ipython with its pylab mode, display all
     figures and return to the ipython prompt.
@@ -255,9 +255,11 @@ def show(*args, **kw):
     non-interactive to interactive mode (not recommended).  In
     that case it displays the figures but does not block.
 
-    A single experimental keyword argument, *block*, may be
-    set to True or False to override the blocking behavior
-    described above.
+    Parameters
+    ----------
+    block : bool, optional
+        This is experimental, and may be set to ``True`` or ``False`` to
+        override the blocking behavior described above.
     """
     global _show
     return _show(*args, **kw)

From 534e85eb3f5bc7239275dfee11b6ebed4917dc2f Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Wed, 15 May 2019 16:56:29 +0100
Subject: [PATCH 2/2] Update lib/matplotlib/pyplot.py

Co-Authored-By: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 lib/matplotlib/pyplot.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 40e511000eb8..5756576a9cee 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -244,7 +244,7 @@ def switch_backend(newbackend):
 
 def show(*args, **kw):
     """
-    Display figures.
+    Display all figures.
 
     When running in ipython with its pylab mode, display all
     figures and return to the ipython prompt.