DOC: move usage tutorial info to Users guide rst [skip actions] [skip azp] [skip appveyor]

Author: jklymak

doc/users/getting_started.rst

@@ -22,14 +22,9 @@ Installation
 
             conda install matplotlib
 
-Further details are available in the :doc:`Installation Guide </users/installing>`.
-
-Choosing a backend
-------------------
-
-Matplotlib needs a "backend" to render your figure, either in its own GUI window,
-as part of a notebook, or saved as an image to disk.  If you need more information on 
-choosing a backend, see :ref:`backends`.
+Further details are available in the :doc:`Installation Guide </users/installing>`.  If a 
+plot does not show up, we probably could not automatically find an appropriate backend; please 
+check :ref:`troubleshooting-faq`.  
 
 Draw a first plot
 -----------------

lib/matplotlib/artist.py

@@ -300,7 +300,7 @@ def stale(self, val):
         if val and self.stale_callback is not None:
             self.stale_callback(self, val)
 
-    def get_window_extent(self, renderer):
+    def get_window_extent(self, renderer=None):
         """
         Get the axes bounding box in display space.
 

lib/matplotlib/collections.py

@@ -303,7 +303,7 @@ def get_datalim(self, transData):
                     return bbox
         return transforms.Bbox.null()
 
-    def get_window_extent(self, renderer):
+    def get_window_extent(self, renderer=None):
         # TODO: check to ensure that this does not fail for
         # cases other than scatter plot legend
         return self.get_datalim(transforms.IdentityTransform())

lib/matplotlib/image.py

@@ -1409,12 +1409,11 @@ def __init__(self, bbox,
         self.bbox = bbox
 
     def get_window_extent(self, renderer=None):
-        if renderer is None:
-            renderer = self.get_figure()._cachedRenderer
-
         if isinstance(self.bbox, BboxBase):
             return self.bbox
         elif callable(self.bbox):
+            if renderer is None:
+                renderer = self.get_figure()._cachedRenderer    
             return self.bbox(renderer)
         else:
             raise ValueError("Unknown type of bbox")

lib/matplotlib/lines.py

@@ -619,7 +619,7 @@ def set_picker(self, p):
             self.pickradius = p
         self._picker = p
 
-    def get_window_extent(self, renderer):
+    def get_window_extent(self, renderer=None):
         bbox = Bbox([[0, 0], [0, 0]])
         trans_data_to_xy = self.get_transform().transform
         bbox.update_from_data_xy(trans_data_to_xy(self.get_xydata()),