[issue42450] Docstrings in itertools recipes should have triple-quotes

[Raymond Hettinger]

Raymond Hettinger  added the comment:


New changeset a83119d7be95dd3f5ff22abe289da6091584f853 by Miss Islington (bot) 
in branch '3.9':
bpo-42450: Minor updates to the itertools recipes (GH-23555) (GH-23562)
https://github.com/python/cpython/commit/a83119d7be95dd3f5ff22abe289da6091584f853


--

___
Python tracker 

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

[issue42450] Docstrings in itertools recipes should have triple-quotes

[Raymond Hettinger]

Raymond Hettinger  added the comment:


New changeset fc40b3020cf3c869833fd5d3720cf9768fe3bb46 by Raymond Hettinger in 
branch 'master':
bpo-42450: Minor updates to the itertools recipes (GH-23555)
https://github.com/python/cpython/commit/fc40b3020cf3c869833fd5d3720cf9768fe3bb46


--

___
Python tracker 

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

[issue42450] Docstrings in itertools recipes should have triple-quotes

[miss-islington]

Change by miss-islington :


--
nosy: +miss-islington
nosy_count: 3.0 -> 4.0
pull_requests: +22443
pull_request: https://github.com/python/cpython/pull/23562

___
Python tracker 

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

[issue42450] Docstrings in itertools recipes should have triple-quotes

[Raymond Hettinger]

Change by Raymond Hettinger :


--
pull_requests: +22436
pull_request: https://github.com/python/cpython/pull/23555

___
Python tracker 

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

[issue42450] Docstrings in itertools recipes should have triple-quotes

[Raymond Hettinger]

Raymond Hettinger  added the comment:

Thanks Eric, I will update those quotation marks in the next edit to the 
recipes.

Peter, sorry I closed this so abruptly.  All suggestions are welcome.  In this 
case, readability trumps other rules.  Also, PEP 257 wasn't intended to be 
strict.  Lots of code in the standard library follows local conventions which 
vary module to module.

--

___
Python tracker 

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

[issue42450] Docstrings in itertools recipes should have triple-quotes

[Eric V. Smith]

Eric V. Smith  added the comment:

Although I do have to say it wouldn't offend me if the partition and 
nth_combination examples were changed to double quotes to be consistent! But 
it's not important.

--

___
Python tracker 

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

[issue42450] Docstrings in itertools recipes should have triple-quotes

[Raymond Hettinger]

Change by Raymond Hettinger :


--
resolution:  -> not a bug
stage:  -> 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

[issue42450] Docstrings in itertools recipes should have triple-quotes

[Raymond Hettinger]

Raymond Hettinger  added the comment:

I concur with Eric.

--

___
Python tracker 

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

[issue42450] Docstrings in itertools recipes should have triple-quotes

[Karthikeyan Singaravelan]

Change by Karthikeyan Singaravelan :


--
nosy: +rhettinger

___
Python tracker 

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

[issue42450] Docstrings in itertools recipes should have triple-quotes

[Eric V. Smith]

Eric V. Smith  added the comment:

I don't think the readability of the examples would be improved by triple 
quotes. In fact, I think it would be reduced.

--
nosy: +eric.smith

___
Python tracker 

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

[issue42450] Docstrings in itertools recipes should have triple-quotes

[Peter Norvig]

New submission from Peter Norvig :

In the itertools recipes (  
https://docs.python.org/3/library/itertools.html#itertools-recipes ) there are 
21 functions that have single-quote docstrings. These should be changed to 
triple-quotes, as mandated in PEP 257.

--
messages: 381704
nosy: peter.norvig2
priority: normal
severity: normal
status: open
title: Docstrings in itertools recipes should have triple-quotes
versions: Python 3.10, Python 3.6, Python 3.7, Python 3.8, Python 3.9

___
Python tracker 

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