DOC : whole bunch of documentation clean up

I think the key thing is that it is movement away from the --pylab option
to ipython. Explicitly saying "from pylab import *" is better than --pylab.
In fact, at the matplotlib BoF, I plan to play devil's advocate and argue
for keeping pylab around.


On Wed, Jul 2, 2014 at 2:10 PM, Varoquaux <notifications@github.com> wrote:

> In doc/faq/usage_faq.rst:
>
> >
> > -The pyplot interface is generally preferred for non-interactive plotting
> > -(i.e., scripting). The pylab interface is convenient for interactive
> > -calculations and plotting, as it minimizes typing. Note that this is
> > -what you get if you use the *ipython* shell with the *-pylab* option,
> > -which imports everything from pylab and makes plotting fully interactive.
> > +    .. sourcecode:: ipython
> > +
> > +       In [1]: from pylab import *
>
> from pylab import *
>
> —
> Reply to this email directly or view it on GitHub
> <https://github.com/matplotlib/matplotlib/pull/3170/files#r14473583>.
>