[Numpy-discussion] 1.2 tasks

David Huard david.huard@gmail....
Mon Aug 4 13:41:18 CDT 2008

On Mon, Aug 4, 2008 at 1:45 PM, Jarrod Millman <millman@berkeley.edu> wrote:

> Here are the remaining tasks that I am aware of that need to be done
> before tagging 1.2.0b1 on the 8th.
> Median
> ======
> The call signature for median needs to change from
>  def median(a, axis=0, out=None, overwrite_input=False):
> to
>  def median(a, axis=None, out=None, overwrite_input=False):
> in both numpy/ma/extras.py and numpy/lib/function_base.py
> Histogram
> ========
> The call signature for histogram needs to change from
>  def histogram(a, bins=10, range=None, normed=False, weights=None,
> new=False):
> to
>  def histogram(a, bins=10, range=None, normed=False, weights=None,
> new=True):
> in numpy/lib/function_base.py

Question: Should histogram raise a warning by default (new=True) to warn
users that the behaviour has changed ? Or warn only if new=False to remind
the old behaviour will be deprecated in 1.3 ?  I think that users will
prefer being annoyed at warnings than surprised by an unexpected change, but
repeated warnings
can become a nuisance.

To minimize annoyance, we could also offer three possibilities:

new=None (default) : Equivalent to True, print warning about change.
new=True : Don't print warning.
new=False : Print warning about future deprecation.

So those who have already set new=True don't get warnings, and all others
are warned. Feedback ?

David H.

> Documentation
> ============
> The documentation project needs to merge in its changes.  Stefan will
> take care of this on the 5th.
> Please let me know ASAP if there is anything I am missing.
> Thanks,
> --
> Jarrod Millman
> Computational Infrastructure for Research Labs
> 10 Giannini Hall, UC Berkeley
> phone: 510.643.4014
> http://cirl.berkeley.edu/
> _______________________________________________
> Numpy-discussion mailing list
> Numpy-discussion@scipy.org
> http://projects.scipy.org/mailman/listinfo/numpy-discussion
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://projects.scipy.org/pipermail/numpy-discussion/attachments/20080804/d30fbccc/attachment.html 

More information about the Numpy-discussion mailing list