[SciPy-dev] cephes docstrings editable?

[Ralf Gommers]

On Fri, Jan 1, 2010 at 12:04 AM, <josef.pktd@gmail.com> wrote:

> is it possible to edit the cephes doc strings in scipy.special?
>
> for example:
>
> http://docs.scipy.org/scipy/docs/scipy.special._cephes.chdtr/#scipy-special-chdtr
>
> The doc editor allows editing, but doesn't show the source. Are edits
> propagated back to wherever the generated (?) doc strings are hiding?
>
>
>
The patch generation indeed has a problem, so it would need some manual work
when merging the wiki edit. But don't let that stop you from editing that
docstring, the edits will land in svn at some point anyway.

There's already an edit made to cephes.erf
http://docs.scipy.org/scipy/docs/scipy.special._cephes.erf/ , which will
result in the patch below at the moment.

Cheers,
Ralf


ERROR: scipy.special._cephes.erf: source location for docstring is not known

--- unknown-source-location/scipy.special._cephes.erf.py.old
+++ unknown-source-location/scipy.special._cephes.erf.py
@@ -1,3 +1,39 @@
 # scipy.special._cephes.erf: Source location for docstring not known
 def erf():
+    """
+    erf(x[, out])
+
+    Returns the error function of complex argument.
+
+    It is defined as :
+
+    ..math:: 2/\\sqrt(\\pi)*\\int_{t=0..x}(\\exp(-t^2))
+
+    Parameters
+    ----------
+    x : ndarray
+        the error function is computed for each item of x
+
+    Returns
+    -------
+    res : ndarray
+        the values of the error function at the given points x.
+
+    Notes
+    -----
+    The cumulative of the unit normal distribution is given by:
+
+    ..math:: \\Phi(z) = \\frac{1}{2}[1 + erf(\\frac{z}{\\sqrt{2}})]
+
+    References
+    ----------
+    .. [1] http://en.wikipedia.org/wiki/Error_function
+    .. [2] Milton Abramowitz and Irene A. Stegun, eds.
+        Handbook of Mathematical Functions with Formulas,
+        Graphs, and Mathematical Tables. New York: Dover,
+        1972. http://www.math.sfu.ca/~cbm/aands/page_297.htm
+
+    See : erfc, erfinv, erfcinv
+
+    """
     pass
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.scipy.org/pipermail/scipy-dev/attachments/20100101/9c9a284f/attachment.html