John,

This seems like a good idea. I wanted to prove and vet the decorators first,
shake out any emergent issues, and then consider enhancements that the new
structure might enable.

While I was working through this, I was surprised when I saw how the kwdocd
was assembled from the various modules and magically seemed to have the
right values by the time the docstrings needed them... but after thinking
about it for a bit, it occurred to me that it probably works because when a
module depends on certain keys being present, it probably has already
imported the module that provides those keys.  Therefore, synchronization
issues aren't really issues.

Would you like me to implement these suggestions?

Jason

> -----Original Message-----
> From: John Hunter [mailto:jdh2...@gmail.com]
> 
> Another thing to consider while cleaning this up is to not just put
> the artist props into the kwdocd, but *anything* that needs
> interpolating.  So we could have one docstring.interpd into which all
> keys 'Line2D', 'Patch', 'AvailableArrowstyles', 'PSD', 'scale_docs',
> etc...  Right now we have a hodge-podge of doc interpolation strings,
> and it might make sense to simplify this by putting them all into a
> single interp dict that can be used anywhere in mpl.
> 
> Jason, I hope we don't exhaust you with these suggestions -- this will
> be a very nice cleanup and a big help for people using mpl in
> installers like py2exe which strip out docs with the optimization
> flags.  But as Darren said we need to get this right and keep the
> interface as simple as possible while preserving all the current
> functionality.  Thanks for all your efforts.
> 
> JDH

Attachment: smime.p7s
Description: S/MIME cryptographic signature

------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day 
trial. Simplify your report design, integration and deployment - and focus on 
what you do best, core application coding. Discover what's new with 
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

Reply via email to