[Numpy-discussion] 1.2 tasks

[David Huard]

On Mon, Aug 4, 2008 at 1:45 PM, Jarrod Millman <millman at 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
that
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 at scipy.org
> http://projects.scipy.org/mailman/listinfo/numpy-discussion
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/numpy-discussion/attachments/20080804/d30fbccc/attachment.html>