namespace recommendation in scipy tutorial and docs for np.emath

I'm going through some scipy tickets and I found http://projects.scipy.org/scipy/ticket/882 I don't know much about the old usage of mixing (mixed up) namespaces. But I think it would be good if someone could check the namespace convention/recommendation in the basic scipy tutorial http://docs.scipy.org/doc/scipy/reference/tutorial/basic.html When I tried to figure out the difference between scipy.* and numpy.*, I also found that the functions in numpy.emath (numpy.scipy) have good docstrings, but they are not included in the docs (at least I don't find them), because http://docs.scipy.org/numpy/docs/numpy-docs/reference/routines.emath.rst/#nu... is still a stub page without function links. http://docs.scipy.org/doc/numpy/reference/routines.emath.html Josef

On Sun, Jan 3, 2010 at 8:40 AM, <josef.pktd@gmail.com> wrote:
I'm going through some scipy tickets and I found http://projects.scipy.org/scipy/ticket/882
I don't know much about the old usage of mixing (mixed up) namespaces. But I think it would be good if someone could check the namespace convention/recommendation in the basic scipy tutorial
http://docs.scipy.org/doc/scipy/reference/tutorial/basic.html
When I tried to figure out the difference between scipy.* and numpy.*, I also found that the functions in numpy.emath (numpy.scipy) have good docstrings, but they are not included in the docs (at least I don't find them), because
http://docs.scipy.org/numpy/docs/numpy-docs/reference/routines.emath.rst/#nu... is still a stub page without function links. http://docs.scipy.org/doc/numpy/reference/routines.emath.html
Josef
Hi, Josef; I found this going through all my old unread emails. I don't understand how/why http://docs.scipy.org/numpy/docs/numpy-docs/reference/routines.emath.rst/#nu... "still as stub w/out function links" is the cause of the good docstrings in numpy.emath (numpy.scipy) not being included in "the docs" (and to which "docs" are you referring exactly). Please elaborate. Thanks! DG

On Sat, May 15, 2010 at 2:09 AM, David Goldsmith <d.l.goldsmith@gmail.com> wrote:
On Sun, Jan 3, 2010 at 8:40 AM, <josef.pktd@gmail.com> wrote:
I'm going through some scipy tickets and I found http://projects.scipy.org/scipy/ticket/882
I don't know much about the old usage of mixing (mixed up) namespaces. But I think it would be good if someone could check the namespace convention/recommendation in the basic scipy tutorial
http://docs.scipy.org/doc/scipy/reference/tutorial/basic.html
When I tried to figure out the difference between scipy.* and numpy.*, I also found that the functions in numpy.emath (numpy.scipy) have good docstrings, but they are not included in the docs (at least I don't find them), because
http://docs.scipy.org/numpy/docs/numpy-docs/reference/routines.emath.rst/#nu... is still a stub page without function links. http://docs.scipy.org/doc/numpy/reference/routines.emath.html
Josef
Hi, Josef; I found this going through all my old unread emails. I don't understand how/why http://docs.scipy.org/numpy/docs/numpy-docs/reference/routines.emath.rst/#nu... being "still as stub w/out function links" is the cause of the good docstrings in numpy.emath (numpy.scipy) not being included in "the docs" (and to which "docs" are you referring exactly). Please elaborate. Thanks!
this is empty http://docs.scipy.org/doc/numpy/reference/routines.emath.html e.g. this is not included in the docs http://docs.scipy.org/numpy/docs/numpy.lib.scimath.arctanh/ only functions that are included with an autosummary or automodule are included in the docs since there is no autosummary statement in emath, none of the numpy.lib.scimath.* docs are in the rendered documentation. At least that was my impression, and it still looks this way. Josef
DG _______________________________________________ SciPy-Dev mailing list SciPy-Dev@scipy.org http://mail.scipy.org/mailman/listinfo/scipy-dev
participants (2)
-
David Goldsmith
-
josef.pktd@gmail.com