On Thu, Mar 31, 2011 at 14:08, Ralf Gommers <[email protected]> wrote: > On Thu, Mar 31, 2011 at 8:52 PM, Robert Kern <[email protected]> wrote:
>> Linux distributions start to complain when data files (especially >> documentation data files not used at runtime) are placed into the >> Python packages. I would argue that it's the wrong place for them on >> *any* platform. > > But they're not documentation files. The line is a bit blurry, but > something like the numpy.i SWIG interface face is meant for using > numpy, not documenting usage of SWIG and numpy (maybe most similar to > what's in core/include/ ?). Yeah, and they hate that, too. As the originator of that idea, I'm loathe to push it any further. :-) > The actual documentation of how to use > numpy.i is included in the reference guide, and is not present in that > dir. > > Perhaps to make clear this is not documentation, put it in something > like numpy/interfacing/swig/, etc.? Well, they're meant to be copied into your own code, which is why they end up under a doc/ directory. Lots of things like this tend to end up in doc/ directories. -- Robert Kern "I have come to believe that the whole world is an enigma, a harmless enigma that is made terrible by our own mad attempt to interpret it as though it had an underlying truth." -- Umberto Eco _______________________________________________ NumPy-Discussion mailing list [email protected] http://mail.scipy.org/mailman/listinfo/numpy-discussion
