Doc improvements and line wrapping.

Author: pelson

lib/matplotlib/lines.py

@@ -448,7 +448,8 @@ def recache(self, always=False):
     def _transform_path(self, subslice=None):
         """
         Puts a TransformedPath instance at self._transformed_path,
-        all invalidation of the transform is then handled by the TransformedPath instance.
+        all invalidation of the transform is then handled by the 
+        TransformedPath instance.
         """
         # Masked arrays are now handled by the Path class itself
         if subslice is not None:

lib/matplotlib/patches.py

@@ -168,13 +168,19 @@ def get_transform(self):
 
     def get_data_transform(self):
         """
-        Return the :class:`~matplotlib.transforms.Transform` ... I'm not sure
+        Return the :class:`~matplotlib.transforms.Transform` instance which
+        maps data coordinates to physical coordinates.
         """
         return artist.Artist.get_transform(self)
 
     def get_patch_transform(self):
         """
-        Return the :class:`~matplotlib.transforms.Transform` ... I'm not sure
+        Return the :class:`~matplotlib.transforms.Transform` instance which
+        takes patch coordinates to data coordinates.
+        
+        For example, one may define a patch of a circle which represents a
+        radius of 5 by providing coordinates for a unit circle, and a
+        transform which scales the coordinates (the patch coordinate) by 5.
         """
         return transforms.IdentityTransform()