[Doc-SIG] ST and DOM

[Edward Welbourne]

> 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

Return a list containing an arithmetic progression of integers.
range(i, j) returns [i, i+1, i+2, ..., j-1]; start (!) defaults to 0.
When step is given, it specifies the increment (or decrement).
For example, range(4) returns [0, 1, 2, 3].  The end point is omitted!
These are exactly the valid indices for a list of 4 elements.

how, after all, would source code manage to express that ?
One can't have an optional first argument, yet require the second: one
can only do it by faking it in the way one interprets one's arguments.

	Eddy.