On Thu, May 28, 2009 at 3:32 PM, Reinier Heeres <rein...@heeres.eu> wrote:
> Hi all,
>
> While trying to work on some docs for mplot3d I ran into trouble
> building them. I started with the stock ubuntu sphinx (0.5.2), but
> that ran into errors. Following the documentation suggestion I tried
> the repository at http://svn.python.org/projects/doctools/trunk
> sphinx, but that seems to be deprecated (and also didn't work for me).
> Apparently the new location is a mercurial repo at
> http://bitbucket.org/birkenfeld/sphinx/ and that's a version that did
> the trick for me.
>

Hey Reiner,

I just did an svn up and noticed the new examples for mplot3d --
thanks for adding these.  May I suggest you rename them?  Having file
names like contour, when mpl has a module contour, can lead to subtle
import bugs.  We try and avoid these by doing fully qualified imports
inside mpl like 'import matplotlib.contour as contour' but to keep
things clear and simple I like to post fix '_demo' or something like
that on examples when the same is potentially ambiguous.  Some
something like
contour3d_demo.py, scatter3d_demo.py, etc, would be preferable to me
to clearly disambiguate the modules and examples, with judicious use
of 3d to make it clear what the examples are.

Thanks,
JDH

------------------------------------------------------------------------------
Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT 
is a gathering of tech-side developers & brand creativity professionals. Meet
the minds behind Google Creative Lab, Visual Complexity, Processing, & 
iPhoneDevCamp as they present alongside digital heavyweights like Barbarian 
Group, R/GA, & Big Spaceship. http://p.sf.net/sfu/creativitycat-com 
_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

Reply via email to