Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread Darren Dale
On Tuesday 25 March 2008 07:07:33 pm Gael Varoquaux wrote: > On Tue, Mar 25, 2008 at 06:04:41PM -0500, bryce hendrix wrote: > > How stable is the API? We (Enthought) use endo, a custom tool build on > > top of docutils, to generate our docs currently. We have talked about > > changing tools in the

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread Darren Dale
I am planning on starting to overhaul the documentation using Sphinx next week. I have been experimenting with Sphinx to create some documentation for a project at work (http://dale.chess.cornell.edu/~darren/xpaxs/index.xml and http://dale.chess.cornell.edu/~darren/temp/XPaXS.pdf). I'm really im

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread John Hunter
On Thu, May 22, 2008 at 8:15 AM, Darren Dale <[EMAIL PROTECTED]> wrote: > I am planning on starting to overhaul the documentation using Sphinx next > week. I have been experimenting with Sphinx to create some documentation for > a project at work (http://dale.chess.cornell.edu/~darren/xpaxs/index.x

Re: [matplotlib-devel] Fix for figsize not being honored in WXAgg & WX - How to contribute?

2008-05-22 Thread Stan West
Thanks, John. Here is the patch for the v0_91_maint branch. As far as I can tell, analogous changes can be made to the trunk. Also, I believe that this resolves bug 1287318 for the WX* backends. fix_figsize_wx.patch Description: Binary data -

Re: [matplotlib-devel] svnmerge.py - keeping the maintenance branch and trunk in sync

2008-05-22 Thread John Hunter
On Sat, May 17, 2008 at 4:40 PM, John Hunter <[EMAIL PROTECTED]> wrote: > - Michael advises making the change on the branch and committing >it. Make sure you svn upped on the trunk and have no local >modifications, and then from the svn trunk do ichael -- what if someone has

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread Michael Droettboom
Just something to keep in mind: many of the docstrings are pieced together at import time (to avoid rewriting descriptions of common parameters). Any tool that extracts docstrings by parsing Python rather than importing Python may choke on that approach. Cheers, Mike -

Re: [matplotlib-devel] svnmerge.py - keeping the maintenance branch and trunk in sync

2008-05-22 Thread Michael Droettboom
I haven't initialized it for that direction. In a lot of ways, svnmerge is far less useful in that case because there are many more things going on the trunk that you don't want in the branch than vice versa. I think in this case, a vanilla 'svn merge' (i.e. not using svnmerge.py) is probably

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread Darren Dale
On Thursday 22 May 2008 09:56:04 am John Hunter wrote: > On Thu, May 22, 2008 at 8:15 AM, Darren Dale <[EMAIL PROTECTED]> wrote: > > I am planning on starting to overhaul the documentation using Sphinx next > > week. I have been experimenting with Sphinx to create some documentation > > for a proj

Re: [matplotlib-devel] zooming related bug? fades to white.

2008-05-22 Thread Eric Firing
[EMAIL PROTECTED] wrote: > Hi Eric, > > This goes back a bit, but did you get any resolution to the fading problem? > I'm having the same problem at the moment, with the latest versions of > matplotlib using wxagg on windows. > > Thanks > John > > > John, http://www.mail-archive.com/ma

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread Darren Dale
On Thursday 22 May 2008 01:23:53 pm Michael Droettboom wrote: > Just something to keep in mind: many of the docstrings are pieced > together at import time (to avoid rewriting descriptions of common > parameters). Any tool that extracts docstrings by parsing Python rather > than importing Python m

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread John Hunter
On Thu, May 22, 2008 at 12:48 PM, Darren Dale <[EMAIL PROTECTED]> wrote: > You're right, that sounds easier. Here's a taste, it has a bit taken from the > users guide, I marked up the CODING_GUIDE, and I used the autodoc extension > to document the API of texmanager and dviread: How do you envisi

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread Darren Dale
On Thursday 22 May 2008 02:05:14 pm John Hunter wrote: > On Thu, May 22, 2008 at 12:48 PM, Darren Dale <[EMAIL PROTECTED]> wrote: > > You're right, that sounds easier. Here's a taste, it has a bit taken from > > the users guide, I marked up the CODING_GUIDE, and I used the autodoc > > extension to

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread John Hunter
On Thu, May 22, 2008 at 1:44 PM, Darren Dale <[EMAIL PROTECTED]> wrote: > We have a lot of flexibility here. I prefer to pull from a few smaller > documents using rest include statements or table of contents directives. > Ipython, on the other hand, has the whole guide included in one file. I wou

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread Paul Kienzle
On Thu, May 22, 2008 at 02:44:43PM -0400, Darren Dale wrote: > Here is the docstring for the texmanager module: I saw this package for math markup mentioned in the docutils FAQ: http://docutils.sourceforge.net/sandbox/jensj/latex_math/ It should allow you to include latex markup in the docstr

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread Darren Dale
I just committed the beginnings of a Sphinx-based documentation to svn. It includes a section explaining how to get up and running with sphinx, its *really easy*: http://dale.chess.cornell.edu/~darren/temp/matplotlib/Users_Guide/documenting_mpl.xml Here is the same documentation in plain text:

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread Darren Dale
On Thursday 22 May 2008 5:03:31 pm Paul Kienzle wrote: > On Thu, May 22, 2008 at 02:44:43PM -0400, Darren Dale wrote: > > Here is the docstring for the texmanager module: > > I saw this package for math markup mentioned in the docutils FAQ: > >http://docutils.sourceforge.net/sandbox/jensj/latex

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread Paul Kienzle
On Thu, May 22, 2008 at 06:12:15PM -0400, Darren Dale wrote: > http://dale.chess.cornell.edu/~darren/temp/XPaXS/reflectivity.xml#matrix-method > > There is a "show source" link on the left that shows the original ReST wource > for the current page, here is the math markup: > > :math:`sin(x_n^2)`

[matplotlib-devel] matplotlib developers needed

2008-05-22 Thread Paul Kienzle
Hi, We are developing an application for analysing and displaying neutron scattering data in Python, and a big part of this requires good graphics. We are looking for a user interface developer with a science background to help us. Some of this effort will be to improve the matplotlib backend.

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread Ted Drain
Darren, I think this is a GREAT idea. I've been trying to free up some resources to work on a better MPL user's guide for our users this year. If I can swing it, perhaps we can help contribute some sections. Given that we use the units system extensively, we'd probably have some sections that ar

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread John Hunter
On Thu, May 22, 2008 at 6:34 PM, Ted Drain <[EMAIL PROTECTED]> wrote: > Darren, > I think this is a GREAT idea. I've been trying to free up some resources to > work on a better MPL user's guide for our users this year. If I can swing > it, perhaps we can help contribute some sections. That would

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread John Hunter
On Thu, May 22, 2008 at 6:08 PM, Paul Kienzle <[EMAIL PROTECTED]> wrote: > It looks okay in Firefox 2.0.0.14 (though it did complain about missing the > mathml > fonts). > > IE 7 displays the xml tree. I don't mind using latex for math where is really helps but I think we should try to keep it t

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread John Hunter
On Thu, May 22, 2008 at 4:59 PM, Darren Dale <[EMAIL PROTECTED]> wrote: > I just committed the beginnings of a Sphinx-based documentation to svn. It > includes a section explaining how to get up and running with sphinx, its > *really easy*: Darren, thanks a lot for getting this going. I think thi

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread Robert Kern
John Hunter wrote: > On Thu, May 22, 2008 at 6:08 PM, Paul Kienzle <[EMAIL PROTECTED]> wrote: > >> It looks okay in Firefox 2.0.0.14 (though it did complain about missing the >> mathml >> fonts). >> >> IE 7 displays the xml tree. > > I don't mind using latex for math where is really helps but I

Re: [matplotlib-devel] future of mpl documentation

2008-05-22 Thread John Hunter
On Thu, May 22, 2008 at 9:21 PM, Robert Kern <[EMAIL PROTECTED]> wrote: > jsMath! > > http://www.math.union.edu/~dpvc/jsmath/ > > It's unfortunate that whenever "LaTeX math on the web" gets brought up, MathML > is what everyone thinks of. > > I guess someone has to write the docutils code for it