[Numpy-discussion] Structure of polynomial module

[Stéfan van der Walt]

Hi all,

I noticed the following docstring on ``np.polynomial.polyval``:

In [116]: np.polynomial.polyval?
File:       /home/stefan/src/numpy/numpy/lib/utils.py
Definition: np.polynomial.polyval(*args, **kwds)
Docstring:
`polyval` is deprecated!
Please import polyval from numpy.polynomial.polynomial


I guess we don't expect users to do "from numpy.polynomial.polynomial
import polyval, Polynomial", so what is the suggested API for getting
hold of the polynomial functions?  Also, why is
numpy.polynomial.polynomial.polyfit different from numpy.polyfit?

Regards
Stéfan