Thanks for "biting this bullet" Ralf. A couple comments (directed more to the "peanut gallery" than to Ralf): obviously, if anyone else besides David C. has the expertise, please help him, Ralf, and indeed all of us, on this; B) I looked at this a little while ago, and reference/distutils.rst just now, and IMO the main "large" thing that strikes me as lacking is an "integrative" example, i.e., a "sample package," (perhaps numpy itself?) described, in distutils.rst, perhaps, and used as a common example across attributes. FWIW,
DG On Sat, Oct 24, 2009 at 8:17 AM, Ralf Gommers <[email protected]>wrote: > This request is mainly addressed to David Cournapeau I guess. > > I wrote docstrings for pretty much all the distutils items not marked > "unimportant" in the doc wiki. Pretty much all the info I got from reading > the code and comments in it, plus a little bit from reading the > distutils.rst file and the Python distutils docs. This was not the easiest > code to understand, so I would like to ask for a review and some help > filling in the blanks. > > The main items that I could not finish are: > - VariableSet.interpolate (if you could throw in an accurate description of > exactly what it does, I can polish it up) > - CCompiler_compile (could use more details I'm sure) > - UnixCCompiler__compile (same) > - UnixCCompiler_create_static_lib (same) > > Also, I left some comment about either things I was not sure about or > things like unused parameters. You can find them here: > http://docs.scipy.org/numpy/changes/ , at the top (made them today or > yesterday). Could you please have a look at those? > > Finally, there are some items that could be important to document, but are > marked as unimportant (Configuration class and methods, exec_command, ...). > Would you mind looking through those items on > http://docs.scipy.org/numpy/docs/ and change the status of the ones you > think are important to "needs editing"? Then I'll try to finish those too. > > Thanks, > Ralf > > > > _______________________________________________ > NumPy-Discussion mailing list > [email protected] > http://mail.scipy.org/mailman/listinfo/numpy-discussion > >
_______________________________________________ NumPy-Discussion mailing list [email protected] http://mail.scipy.org/mailman/listinfo/numpy-discussion
