From fbf4008d49dda51b43d4937f785c582b031bae5a Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Fri, 16 Feb 2018 13:15:29 +0000
Subject: [PATCH] Backport PR #10490: DOC: added bounds and more description to
margins
---
lib/matplotlib/axes/_base.py | 13 ++++++++-----
1 file changed, 8 insertions(+), 5 deletions(-)
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 4f9cfbd5b1d4..48e42cb2bb87 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -2320,11 +2320,14 @@ def margins(self, *args, **kw):
All three forms above set the xmargin and ymargin parameters.
All keyword parameters are optional. A single argument
- specifies both xmargin and ymargin. The *tight* parameter
- is passed to :meth:`autoscale_view`, which is executed after
- a margin is changed; the default here is *True*, on the
- assumption that when margins are specified, no additional
- padding to match tick marks is usually desired. Setting
+ specifies both xmargin and ymargin. The padding added to the end of
+ each interval is *margin* times the data interval. The *margin* must
+ be a float in the range [0, 1].
+
+ The *tight* parameter is passed to :meth:`autoscale_view`
+ , which is executed after a margin is changed; the default here is
+ *True*, on the assumption that when margins are specified, no
+ additional padding to match tick marks is usually desired. Setting
*tight* to *None* will preserve the previous setting.
Specifying any margin changes only the autoscaling; for example,