From f8e3c448ed0dc0a3745f268eeacde35a7f3426bb Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Fri, 1 Mar 2019 15:39:39 +0100
Subject: [PATCH] Backport PR #13560: Improve GridSpec doc

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

diff --git a/lib/matplotlib/gridspec.py b/lib/matplotlib/gridspec.py
index bf2f6f67fb83..53d8e36a1fec 100644
--- a/lib/matplotlib/gridspec.py
+++ b/lib/matplotlib/gridspec.py
@@ -204,21 +204,27 @@ def __init__(self, nrows, ncols, figure=None,
         ncols : int
             Number or columns in grid.
 
-        figure : ~.figure.Figure, optional
+        figure : `~.figure.Figure`, optional
 
-        left, right, top, bottom : float
+        left, right, top, bottom : float, optional
             Extent of the subplots as a fraction of figure width or height.
             Left cannot be larger than right, and bottom cannot be larger than
             top.
 
-        wspace : float
+        wspace : float, optional
             The amount of width reserved for space between subplots,
             expressed as a fraction of the average axis width.
 
-        hspace : float
+        hspace : float, optional
             The amount of height reserved for space between subplots,
             expressed as a fraction of the average axis height.
 
+        width_ratios : length *ncols* iterable, optional
+            Width ratios of the columns.
+
+        height_ratios : length *nrows* iterable, optional
+            Height ratios of the rows.
+
         Notes
         -----
         See `~.figure.SubplotParams` for descriptions of the layout parameters.