[Numpy-discussion] numpydoc: "Other Parameters" section
Michael Droettboom
mdroe@stsci....
Thu Sep 30 14:13:04 CDT 2010
Is the solution as simple as the attached diff? It works for me, but I
don't understand all the implications.
Mike
On 09/29/2010 06:52 PM, Joe Harrington wrote:
>> It seems that the "Other parameters" section is not
>> getting included in the output.
>>
> The "Other parameters" is not often used in numpy because there are
> not generally dozens of "tweaking" parameters in its basic numerical
> routines. It will probably be more common in certain scipy pages, and
> if other packages adopted the format, it could get used a lot.
> Plotting packages, for example, often have a ton of "tweaking"
> parameters (line width, line color, line pattern, major axis tick
> interval, minor axis tick interval, x axis label, y axis label, title,
> axis font, title font, tick strings, etc.) and could use this section
> to good effect to sort those out from the parameters of primary
> interest. This would keep the output section and so forth near the
> top of the docstring for easy reading.
>
> So, it would be better to fix the problem than deprecate the section.
>
> --jh--
> _______________________________________________
> NumPy-Discussion mailing list
> NumPy-Discussion@scipy.org
> http://mail.scipy.org/mailman/listinfo/numpy-discussion
>
--
Michael Droettboom
Science Software Branch
Space Telescope Science Institute
Baltimore, Maryland, USA
-------------- next part --------------
A non-text attachment was scrubbed...
Name: other_parameters.diff
Type: text/x-patch
Size: 1989 bytes
Desc: not available
Url : http://mail.scipy.org/pipermail/numpy-discussion/attachments/20100930/2c6c2396/attachment.bin
More information about the NumPy-Discussion
mailing list