Re: [Matplotlib-users] Exact semantics of ion()??

On Tue, Jun 7, 2011 at 5:01 PM, Eric Firing <ef...@ha...> wrote:

> On 06/07/2011 11:46 AM, Benjamin Root wrote:
> > On Saturday, June 4, 2011, Eric Firing<ef...@ha...>  wrote:
> >>
> >>
> >>
> https://github.com/efiring/matplotlib/blob/faq_show_draw/doc/faq/usage_faq.rst
> >>
> >> Eric, Ben,
> >>
> >> See if the section "What is interactive mode" makes sense to you.  I
> have just added it to a feature branch (which includes some other faq
> madifications, mainly moving the backend section from installation to
> usage), but have not yet generated a pull request.  It doesn't go into every
> detail, or into the underlying machinery.  It is intended to provide just
> enough understanding to clear up user-level confusion about interactive
> mode, show, and draw, and let most relatively new users get on with their
> work.
> >>
> >> Eric
> >>
> >
> > Eric,
> >
> > I see where you are going with this, and this is valuable information
> > to include in the docs. However, the interactive mode and backend info
> > doesn't seem to fit properly with everything else on the page.  I am
>
> I don't see why not.  A FAQ is a place for answers to questions, and
> this is the usage section of the FAQ, so I don't see any inherent reason
> why information about backends and interactive mode, both of which
> involve mpl usage, can't go there.  There may be better places, to which
> the FAQ could refer, but I think the FAQ is better than nothing.  I
> moved the backend piece from the installation part of the FAQ, where it
> *really* didn't belong.  (And the remaining installation part is also an
> out-of-date worm jar.)
>

I am looking at doc/faq/installing_faq.rst on your branch, and I can't tell
what is out-of-date (although the Mac part might be, I don't know).  If you
are referring to doc/users/installing.rst, that should have been removed in
the big set of commits I made recently when I merged from v1.0.x-maint to
master (the INSTALL file is now used in master for the installation docs).

The problem I do see with installation_faq.rst is that the section titles
are not questions, but that is a minor issue here.

Ben Root