[SciPy-dev] some problems with optimize.py docstrings
Tue Aug 28 00:58:08 CDT 2007
Jarrod Millman wrote:
> On 8/27/07, dmitrey <email@example.com> wrote:
>>>> So do you want me to commit the changes I done to svn right now, before
>>>> tomorrow scipy 0.6 release?
>>> You are talking *only* about documentation improvements,
>>> even though incomplete? Is that right? Then unless Jarrod
>>> objects, that seems OK.
>> Despite I have add meaning of some input/output parameters, the
>> optimize.py documentation still remains incomplete, because I don't know
>> ALL parameters (from whole optimize.py) meaning. However, I still
>> suppose that some enhancements is better than nothing at all, and others
>> could be added by Travis and/or other authors of the file.
> Hey Dmitrey,
> I would like to have your improvements to the docstrings for the
> optimization code included in the 0.6 release. They don't have to be
> complete as long as they are better than what we currently have.
I don't know when 0.6 will be released, maybe I will commit the changes
and some minutes later it will be already released - then it could turn
out to have some problems. I mean: I didn't check how
__docformat__="restructuredtext en" works, because if I put the line in
start of optimize.py file my epydoc (v 2.1) says "unknown docformat" and
So maybe epydoc will just crush on optimize.py file.
Also, I suppose that it would be better to clean optimize.py html output
from all those auxiliary files like rosenbrock, but I don't know how to
Ok, so I committed it 1 min ago but it requires someone to check epydoc
output (and maybe uncomment __docformat__="restructuredtext en" in the
More information about the Scipy-dev