Mailman 3 January 2021 - docs

[issue38413] Remove or change "Multithreading" section
by Vladimir Ryabtsev Jan. 6, 2021

Jan. 6, 2021

New submission from Vladimir Ryabtsev <greatvovan(a)gmail.com>: This is regarding the page https://docs.python.org/3.7/library/sqlite3.html. I believe this section on the very bottom of the page has been kept here for pretty long time, during that both SQLite and the sqlite3 module evolved and improved. Now the content contradicts to the description of function "connect()" in the part describing "check_same_thread" parameter. The function description says that using connections from multiple threads is allowed with serialization handled by the user (and it is true), while the bottom "Mutithreading" section says sharing connections is not allowed. I think we can remove "Mutithreading" section entirely unless there is something important to add to what already mentioned. ---------- assignee: docs@python components: Documentation messages: 354227 nosy: Vladimir Ryabtsev, docs@python priority: normal severity: normal status: open title: Remove or change "Multithreading" section versions: Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38413> _______________________________________

6 15

[issue42528] Improve the docs of most Py*_Check{,Exact} API calls
by Antonio Cuni Jan. 6, 2021

Jan. 6, 2021

New submission from Antonio Cuni <anto.cuni(a)gmail.com>: I think that none of these API calls can fail, but only few of them are documented as such. E.g. PyNumber_Check contains the sentece "This function always succeeds" but PyBytes_Check does not. ---------- assignee: docs@python components: Documentation messages: 382269 nosy: antocuni, docs@python priority: normal severity: normal status: open title: Improve the docs of most Py*_Check{,Exact} API calls type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42528> _______________________________________

3 5

[issue42681] mistake in curses documentation
by Robert T McQuaid Jan. 6, 2021

Jan. 6, 2021

New submission from Robert T McQuaid <rtmq(a)fixcas.com>: The description of color_pair starts with curses.color_pair(color_number) It should be curses.color_pair(pair_number) ---------- assignee: docs@python components: Documentation messages: 383344 nosy: arbor, docs@python priority: normal severity: normal status: open title: mistake in curses documentation versions: Python 3.10 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42681> _______________________________________

6 21

[issue34451] docs: tutorial/introduction doesn't mention toggle of prompts
by Jonathan Fine Jan. 6, 2021

Jan. 6, 2021

New submission from Jonathan Fine <jfine2358(a)gmail.com>: Interactive code examples need the prompt to be stripped, before copy-and-paste. This is explained in https://docs.python.org/3/tutorial/introduction.html But this page does not tell us about the [>>>] prompt-toggle at top of each interactive code example. This caused a user error, reported in https://mail.python.org/pipermail/python-ideas/2018-August/052869.html. The [>>>] toggle isn't in the Python 2.7 docs, so nothing to fix there! ---------- assignee: docs@python components: Documentation messages: 323839 nosy: docs@python, jfine2358 priority: normal severity: normal status: open title: docs: tutorial/introduction doesn't mention toggle of prompts versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34451> _______________________________________

5 6

[issue14014] codecs.StreamWriter.reset contract not fulfilled
by Berker Peksag Jan. 6, 2021

Jan. 6, 2021

Change by Berker Peksag <berker.peksag(a)gmail.com>: ---------- assignee: -> docs@python components: -Unicode nosy: +docs@python -vstinner _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue14014> _______________________________________

1 0

[issue42828] Python readline module
by Marco Franzo Jan. 5, 2021

Jan. 5, 2021

New submission from Marco Franzo <frenzisys(a)gmail.com>: It would be better to write at the end of the program this: os.system('stty sane') because when you import readline, at the end of program, the console remains unusable ---------- assignee: docs@python components: Documentation messages: 384379 nosy: docs@python, frenzisys priority: normal severity: normal status: open title: Python readline module type: enhancement versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42828> _______________________________________

3 3

[issue42832] classmethod change in 3.9 needs better documentation
by Irit Katriel Jan. 5, 2021

Jan. 5, 2021

New submission from Irit Katriel <iritkatriel(a)yahoo.com>: The change in issue 19072 broke our code where a decorator assumes that __get__ is only called for instance methods. It might be worth adding this to What's new in 3.9. Also in the documentation: https://docs.python.org/3/library/functions.html#classmethod It implies that before 3.9 it was not possible to wrap, but it was possible, it just behaved differently. ---------- assignee: docs@python components: Documentation messages: 384404 nosy: docs@python, iritkatriel priority: normal severity: normal status: open title: classmethod change in 3.9 needs better documentation type: behavior versions: Python 3.10, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42832> _______________________________________

1 0

documentation typo
by Brandon Rohrer Jan. 5, 2021

Jan. 5, 2021

Hi Python docs! I'd like to call out what appears to be a small typo in this page <https://docs.python.org/3/library/functions.html#print>. This line: print(**objects*, *sep=' '*, *end='n'*, *file=sys.stdout*, *flush=False*) <https://docs.python.org/3/library/functions.html#print> appears to be missing a backslash in the keyword arg *end='n'* I believe it should read *end='\n'* Thanks! Brandon

2 1

[issue42826] typing.Iterable does not need__getitem__() method
by Peter Pavlinič Jan. 5, 2021

Jan. 5, 2021

New submission from Peter Pavlinič <peter.pavlinic(a)trilogic.si>: https://docs.python.org/3.10/glossary.html#term-iterable ---------- assignee: docs@python components: Documentation messages: 384334 nosy: docs@python, peter.pavlinic priority: normal severity: normal status: open title: typing.Iterable does not need__getitem__() method type: enhancement versions: Python 3.10 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42826> _______________________________________

3 4

A small bug in your documentation
by ddormer＠provizorcare.com Jan. 2, 2021

Jan. 2, 2021

Hi, I am new to Python and love your documentation. One small error in the Python 3.9.1 documentation, section 3.2 First steps towards programming. The example for the Fibonacci Series is incorrect. Lines two and three begin with secondary prompts when they should begin with primary prompts. As a new user, its curious how you could even do this except through an external editor. Line one does not lead to a secondary prompt, nor does line 2 if it were written against the primary prompt because the first two lines are comment lines beginning with "#". So, both lines 2 and 3 should begin with primary prompts, >>>, not ... Respectfully submitted, Doug Dormer

1 0