[issue34611] some examples in 'itertools' modules docs are inaccuracy.

2018-09-09 Thread Raymond Hettinger


Raymond Hettinger  added the comment:

I concur with  Karthikeyan.   The doc examples read fine as-is.  They have 
worked well for many users for a long time.  It only takes seconds of 
experimentation to see exactly what is returned.  There is also a plain text 
description and a rough pure python equivalent.

Marking this as not a bug.  Thank you for looking at the docs, but I'm going to 
pass on this particular suggestion.

--
resolution:  -> not a bug
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue34611] some examples in 'itertools' modules docs are inaccuracy.

2018-09-08 Thread Karthikeyan Singaravelan


Karthikeyan Singaravelan  added the comment:

I don't know if it's worth it to edit the results to return Python data 
structures in the linked PR. The current version is more concise and indicates 
the general result of the function instead of the actual return values of the 
function calls which is intentional. Maybe is there some example in itertools 
that you are referring to that has incorrect results?

Thanks

--
nosy: +xtreak

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue34611] some examples in 'itertools' modules docs are inaccuracy.

2018-09-08 Thread taketakeyyy


Change by taketakeyyy :


--
keywords: +patch
pull_requests: +8573
stage:  -> patch review

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue34611] some examples in 'itertools' modules docs are inaccuracy.

2018-09-08 Thread Mark Dickinson


New submission from Mark Dickinson :

@taketakeyyy: Did you mean to include information about *which* examples are 
inaccurate? This issue isn't really useful without that information.

--
nosy: +mark.dickinson

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue34611] some examples in 'itertools' modules docs are inaccuracy.

2018-09-08 Thread Serhiy Storchaka


Change by Serhiy Storchaka :


--
assignee: docs@python -> rhettinger
nosy: +rhettinger

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue34611] some examples in 'itertools' modules docs are inaccuracy.

2018-09-08 Thread taketakeyyy


Change by taketakeyyy :


--
assignee: docs@python
components: Documentation
nosy: docs@python, taketake...@gmail.com
priority: normal
severity: normal
status: open
title: some examples in 'itertools' modules docs are inaccuracy.
versions: Python 3.8

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com