On Tue, Jun 7, 2011 at 5:01 PM, Eric Firing <efir...@hawaii.edu> wrote:
> On 06/07/2011 11:46 AM, Benjamin Root wrote:
> > On Saturday, June 4, 2011, Eric Firing<efir...@hawaii.edu> 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
------------------------------------------------------------------------------
EditLive Enterprise is the world's most technically advanced content
authoring tool. Experience the power of Track Changes, Inline Image
Editing and ensure content is compliant with Accessibility Checking.
http://p.sf.net/sfu/ephox-dev2dev
_______________________________________________
Matplotlib-users mailing list
Matplotlib-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-users
