scipy/scipy — pull request #312 by sciunto (2012-09-16 14:29:29+00:00)
Title: Docstrings: improvement rv_discrete

Hi,

From my point of view, the docstring of class rv_discrete() was poorly understandable.

The problem was:
Most of examples were not directly executable and mostly illustrated the ' Alternatively' section in notes.

In the new version,
* It starts with a distribution from a list.
* I use the notation xk, pk, easily understandable and already used previously in the doc.
* The 'alternatively' section is now at the end of the Notes (it's an alternative ;) )
* A typo fixed :)

I have not fully understood yet examples using . But I think we must avoid examples that could not be executed "out of the box". For the moment, still there...

François.