remove undocumented matplotlib/mpl.py

ivanov · ivanov · commit 7d20295fdc30 · 2012-11-26T00:30:13.000-08:00
`matplotlib/mpl.py` is a file which gets imported via ipython's
`%pyplot` interface as module named `mpl`, yet it isn't clear at all
what it's role is.

Given that in our own code, and in the rest of our python neighborhood,
we often do `import matplotlib as mpl`, it's quite a bit confusing to
have something with the `mpl` name within matplotlib not be the
`matplotlib` module itself.

This module was only used in `pylab` interface, where it was simply
imported in one line via `from matplotlib import mpl` and never used
again.
diff --git a/CHANGELOG b/CHANGELOG
@@ -1,3 +1,7 @@
+
+2012-11-26 removed matplotlib/mpl.py, which was used only in pylab.py and was
+           now replaced by the more suitable `import matplotlib as mpl`. - PI
+
 2012-11-13 Add a symmetric log normalization class to colors.py.
            Also added some tests for the normalization class.
            Till Stensitzki
diff --git a/lib/matplotlib/mpl.py b/lib/matplotlib/mpl.py
diff --git a/lib/matplotlib/pylab.py b/lib/matplotlib/pylab.py
@@ -219,7 +219,7 @@
 from cbook import flatten, is_string_like, exception_to_str, \
      silent_list, iterable, dedent
 
-from matplotlib import mpl  # pulls in most modules
+import matplotlib as mpl
 
 from matplotlib.dates import date2num, num2date,\
         datestr2num, strpdate2num, drange,\
