Issues from [email protected]

[encukou]

Users who don't have a github login are instructed to report issues to [email protected].
I meant to do some triaging before converting the mails to GH issues, but always had something more important to do. So I'm posting a rough list to get more eyes on these. Each has a link to the list post.

(These weren't triaged; they're not necessarily good ideas.)

### Tasks
- [x] typo in socket docs -- [Hank Knox](https://mail.python.org/archives/list/[email protected]/thread/T7BAG3ROH3YT3YTAWCUE7CMZ2FI6VO72/)
- [x] asyncio shield typo -- [Dyussenov Nuraly](https://mail.python.org/archives/list/[email protected]/thread/6EM4DHHS3RMWSJWV2ZGKWTJRD4Z2GNIC/) - (https://github.com/python/cpython/pull/108427)
- [x] array -- data type range printed wrong -- [Shivansh Verma](https://mail.python.org/archives/list/[email protected]/thread/B463UYLY2RBIG66LXM3TIPZDZIYWCN6X/) (#113708)
- [ ] EPUB error -- e.g. [Glenn Street](https://mail.python.org/archives/list/[email protected]/thread/HSIILYH7LVK4JU5U5GWHHIP4PU34UTNN/), [Ranjith B](https://mail.python.org/archives/list/[email protected]/thread/Y3K22WC7QQVIECZBLFZPYYFWOCAOPZ2K/), [sobi](https://mail.python.org/archives/list/[email protected]/message/JELSGFZ6HC2SKHPHTX3LSGH627QVGE5N/)
- [x] Howto/regex omits the simplest {n} case -- [Derek Mead](https://mail.python.org/archives/list/[email protected]/thread/7D56UZ3VSWCQVQPIL44LWTO42EJUBRKI/) -- (https://github.com/python/cpython/pull/111110)
- [x] Problem in help for str().rsplit() -- [Alan Brogan](https://mail.python.org/archives/list/[email protected]/thread/MCSKKTHBKX6AIK25YI2INEDVONJZYRLH/) - (https://github.com/python/cpython/pull/113355)
- [x] replacement for deprecation -- [SUN Guonian](https://mail.python.org/archives/list/[email protected]/thread/4AYZNSW3RB3DNT5C7JEE6RCESBWIKZTD/) (https://github.com/python/cpython/pull/112783)
- [x] Potential typo in Profiler docs? -- [2dfkit](https://mail.python.org/archives/list/[email protected]/thread/DJNXVVP2UW4R6OAPRA6TE5WMHDC4NKZ6/)
- [x] timeit -- [Arthur Goldberg](https://mail.python.org/archives/list/[email protected]/thread/CQON3MGDEN6CY5KFXXBY4FTCG2FIIDTM/) -- (GH-110407)
- [x] list of errata: 1 -- [Stephan Stiller](https://mail.python.org/archives/list/[email protected]/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/)
- [x] list of errata: 2 -- [Stephan Stiller](https://mail.python.org/archives/list/[email protected]/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/) -- (https://github.com/python/cpython/pull/119330)
- [x] list of errata: 3 -- [Stephan Stiller](https://mail.python.org/archives/list/[email protected]/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/) -- (https://github.com/python/cpython/pull/112777)
- [x] list of errata: 4 -- [Stephan Stiller](https://mail.python.org/archives/list/[email protected]/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/) - WONTFIX
- [x] list of errata: 5 -- [Stephan Stiller](https://mail.python.org/archives/list/[email protected]/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/) - WONTFIX
- [x] list of errata: 6 -- [Stephan Stiller](https://mail.python.org/archives/list/[email protected]/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/) -- (#120219)
- [x] list of errata: 7 -- [Stephan Stiller](https://mail.python.org/archives/list/[email protected]/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/)
- [x] list of errata: 8 -- [Stephan Stiller](https://mail.python.org/archives/list/[email protected]/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/) -- (https://github.com/python/cpython/pull/111574)
- [x] list of errata: 9 -- [Stephan Stiller](https://mail.python.org/archives/list/[email protected]/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/)
- [x] profiler docs inaccuracy -- [2dfkit](https://mail.python.org/archives/list/[email protected]/thread/DJNXVVP2UW4R6OAPRA6TE5WMHDC4NKZ6/#DJNXVVP2UW4R6OAPRA6TE5WMHDC4NKZ6) -- (https://github.com/python/cpython/pull/112221)
- [ ] https://github.com/python/cpython/issues/112146
- [x] Getting tkinter -- [Steve Philcox](https://mail.python.org/archives/list/[email protected]/message/JOQ3RQVG3A7ZYOWEVU7TAYLY2WSZ6TST/): This complaint is about how to install dependencies when building CPython; this is already covered by the devguide.
- [ ] https://github.com/python/cpython/issues/120302
- [x] Problems in Python tutorial -- [Todd Hoatson](https://mail.python.org/archives/list/[email protected]/message/REO4QRDIHU5ML4BMNXPDONCKONIH6RN3/)
- [x] link from UserList docs to the collections classes list of methods -- [Seebs](https://mail.python.org/archives/list/[email protected]/message/37ZRBCHCB37Y2KW73EBHXFGRIZHFCNUU/) - WONTFIX
- [x] confusing formatting of “`field`s” -- [Роман Филимонов](https://mail.python.org/archives/list/[email protected]/message/G5AYM2N4LLB65BTPQZBX5BIMBXRGUPVP/): this is a common way of marking up the plural variant of something that's marked up using a monospaced font; not a bug
- [x] socket.makefile -- [Michael Gold](https://mail.python.org/archives/list/[email protected]/thread/3VGLA6Q6QDYB7XIAHFIRAVW4TQSEAZGA/)
- [x] `pow` - “integral” is confusing to non-natives -- [marc rovira](https://mail.python.org/archives/list/[email protected]/thread/HD47WPHMLKUTQEWEQOHBAGULUHN4ICPQ/) -- (https://github.com/python/cpython/pull/119688)

Feel free to tick off ones that aren't appropriate, and convert larger ones to their own issues.

Linked PRs

• gh-110383 TimeIt Docs Spelling Fix #110407
• [3.12] gh-110383 TimeIt Docs Spelling Fix (GH-110407) #110409
• [3.11] gh-110383 TimeIt Docs Spelling Fix (GH-110407) #110410
• gh-110383: Swap 'the all' -> 'all the' in socket docs #110434
• [3.12] gh-110383: Swap 'the all' -> 'all the' in socket docs (GH-110434) #110435
• [3.11] gh-110383: Swap 'the all' -> 'all the' in socket docs (GH-110434) #110436
• gh-110383: Array module docs fix #111018
• gh-110383: Added explanation about simplest regex use case for quantifiers. #111110
• [3.12] gh-110383: Added explanation about simplest regex use case for quantifiers. (GH-111110) #111204
• [3.11] gh-110383: Added explanation about simplest regex use case for quantifiers. (GH-111110) #111205
• gh-110383: Italicize variable name #111206
• [3.12] gh-110383: Italicize variable name (GH-111206) #111207
• [3.11] gh-110383: Italicize variable name (GH-111206) #111208
• gh-110383: Changed the doc for str.rsplit from 'starting from the left' to 'starting from the right'  #111247
• gh-110383: Fix documentation profile cumtime fix #112221
• [3.12] gh-110383: Fix documentation profile cumtime fix (GH-112221) #112262
• [3.11] gh-110383: Fix documentation profile cumtime fix (GH-112221) #112263
• gh-110383: Explained which error message is generated when there is an unhandled exception #111574
• [3.12] gh-110383: Explained which error message is generated when there is an unhandled exception (GH-111574) #112264
• [3.11] gh-110383: Explained which error message is generated when there is an unhandled exception (GH-111574) #112265
• gh-110383: Add documentation entry for sorted(d) #112777
• gh-110383: Remove references to removed popen[234] #112783
• gh-110383: Fix docstring for str.rsplit maxsplit param to 'starting from the right' #113353
• gh-110383: Improve accuracy of str.split() and str.rsplit() docstrings #113355
• [3.12] gh-110383: Improve accuracy of str.split() and str.rsplit() docstrings (GH-113355) #113379
• [3.11] gh-110383: Improve accuracy of str.split() and str.rsplit() docstrings (GH-113355) #113380
• gh-110383: Added explanation in Doc about array data types range. Based on GNU docs #113708
• gh-110383: Fix problems in Python Input and Output tutorial #118970
• gh-110383: Document socket.makefile() accepts combined modes #119150
• GH-110383: Improve Tutorial for Input Ouput #119230
• [3.13] gh-110383: Document socket.makefile() accepts combined modes (GH-119150) #119324
• [3.12] gh-110383: Document socket.makefile() accepts combined modes (GH-119150) #119325
• [3.13] GH-110383: Improve Tutorial for Input Ouput (GH-119230) #119326
• [3.12] GH-110383: Improve Tutorial for Input Ouput (GH-119230) #119327
• gh-110383: Update dict get, fromkeys, and setdefault signatures in docs #119330
• [3.13] gh-110383: Align dict.get(), .fromkeys(), and .setdefault() docs with docstrings (GH-119330) #119370
• [3.12] gh-110383: Align dict.get(), .fromkeys(), and .setdefault() docs with docstrings (GH-119330) #119371
• gh-110383: Clarify "non-integral" wording in pow() docs #119688
• [3.13] gh-110383: Clarify "non-integral" wording in pow() docs (GH-119688) #120206
• [3.12] gh-110383: Clarify "non-integral" wording in pow() docs (GH-119688) #120207
• gh-110383: Improve 'old string formatting' text in tutorial #120219
• [3.13] gh-110383: Improve 'old string formatting' text in tutorial (GH-120219) #120229
• [3.12] gh-110383: Improve 'old string formatting' text in tutorial (GH-120219) #120230

[erlend-aasland]

I'm not sure where these colours are defined.

Me neither, but ISTM the PDFs are generated from make -C Doc dist. I'm suspecting it might be the Sphinx LaTeX package sphinx.sty.

[erlend-aasland]

@encukou: I suggest creating separate, and more actionable, issues of the EPUB and PDF readability reports. I think the two remaining issues reports by Stiller are non-issues; the first is talking about IDLE in a tutorial that is using the REPL, and I'm not sure the remaining issue is worth trying to solve. Regarding the "UserList" issue, I have no opinion.

In the future, I think it would be better to not collect multiple unrelated reports into one issue, like it's done here; such an umbrella issue has an enormous risk of quickly turning stale. IMO, it is better for the reporters, for the triagers, and for contributors, if we break these up into single more actionable and easily triaged issues :)

[encukou]

I suggest creating separate, and more actionable, issues of the EPUB and PDF readability reports.

Please do make an issue! GitHub has a button to do that in the ⋯ menu.

IMO, it is better for the reporters, for the triagers, and for contributors, if we break these up into single more actionable and easily triaged issues

When I did that, I was too tempted to triage each of the reports, which resulted in a big backlog. Converting from email to GitHub needs to take me less than a minute; otherwise, on a busy day I'll leave it to “some day when I have time”.

[hugovk]

I think the two remaining issues reports by Stiller are non-issues; the first is talking about IDLE in a tutorial that is using the REPL, and I'm not sure the remaining issue is worth trying to solve.

I've checked these off as WONTFIX.

Regarding the "UserList" issue, I have no opinion.

Same, and no-one else has had a go, so I've checked this off as WONTFIX too.

We've got new issues for some of these things, I think we can close this issue now, thanks everyone for helping out!