This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author terry.reedy
Recipients akuchling, docs@python, py.user, r.david.murray, rhettinger, terry.reedy
Date 2013-06-21.19:55:51
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1371844552.22.0.797785297748.issue18220@psf.upfronthosting.co.za>
In-reply-to
Content
The problem with all of range, slice, and islice is that 
[start,] stop [, step] is an impossible signature and needed to be changed.

The actual signature is
start_or_stop, [stop, [step]]
with customized processing to interpret start_or_stop according to the presence of stop (which is not really optional). We suggestion to doc it this was rejected as equally confusing.

In 3.3, we decided to stop trying to force all signatures presented to the user into one line and instead use multiple lines to present what are multiple signatures from a user view. So this alternative was used for range and slice (and other functions).

For islice, the islice entry has
itertools.islice(iterable, stop)
itertools.islice(iterable, start, stop[, step])

Py.user is corrrect in suggesting the same change for islice docstring. I have changed the title to be clearer.

The itertools function table has
islice() 	seq, [start,] stop [, step] 	elements from ...

I thing this should be changed also. A new line for arguments 'seq, stop' would say
'elements from seq[0:stop]'   example 'islice('ABCDEFG', 2) --> A B
Then remove brackets from [start] in the current line.

Py.user: To accept non-trival patches (typos, grammar corrections are trivial) we need a signed contributor agreement
http://www.python.org/psf/contrib/  and
http://www.python.org/psf/contrib/contrib-form/  new electronic form
An '*' will appear after your name here when it is processed.
I presume this will need a real (legal) name on the form, even though not in the tracker user list.
History
Date User Action Args
2013-06-21 19:55:52terry.reedysetrecipients: + terry.reedy, akuchling, rhettinger, r.david.murray, docs@python, py.user
2013-06-21 19:55:52terry.reedysetmessageid: <1371844552.22.0.797785297748.issue18220@psf.upfronthosting.co.za>
2013-06-21 19:55:52terry.reedylinkissue18220 messages
2013-06-21 19:55:51terry.reedycreate