DOC added kwargs and tight_layout description in plt.figure

NelleV · NelleV · commit cc7e3a43dc63 · 2020-01-23T09:15:15.000+01:00
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -450,6 +450,16 @@ def figure(num=None,  # autoincrement if None, else integer from 1-N
     clear : bool, default: False
         If True and the figure already exists, then it is cleared.
 
+    tight_layout : bool or dict, default: :rc:`figure.autolayout`
+        If ``False`` use *subplotpars*. If ``True`` adjust subplot
+        parameters using `.tight_layout` with default padding.
+        When providing a dict containing the keys ``pad``, ``w_pad``,
+        ``h_pad``, and ``rect``, the default `.tight_layout` paddings
+        will be overridden.
+
+    **kwargs : optional
+        See `~.matplotlib.figure.Figure` for other possible arguments.
+
     Returns
     -------
     figure : `~matplotlib.figure.Figure`
