[Doc-SIG] ST and DOM

Edward D. Loper edloper@gradient.cis.upenn.edu
Sun, 25 Mar 2001 10:55:59 EST


> > Technically, it is *not* necessarily the same information you get from
> > the Python code.
> 
> e.g.
> 
> >>> print range.__doc__
> range([start,] stop[, step]) -> list of integers

Yeah.. that doc string always bothered me.  Makes me think I'm
using some language other than Python. :)  When I first looked at
that signature, I really couldn't tell whether calling it with 2
parameters would give it a stop & a step, or a start & a step... And
it seems like you should be able to at *least* tell that type of
info from the signature.

But, that said, I see your point.

-Edward