Mailman 3 January 2021 - docs

[issue42528] Improve the docs of most Py*_Check{,Exact} API calls
by Antonio Cuni 06 Jan '21

06 Jan '21

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 06 Jan '21

06 Jan '21

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 06 Jan '21

06 Jan '21

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 06 Jan '21

06 Jan '21

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 05 Jan '21

05 Jan '21

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 05 Jan '21

05 Jan '21

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 05 Jan '21

05 Jan '21

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č 05 Jan '21

05 Jan '21

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 02 Jan '21

02 Jan '21

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

Coding
by Deante Seals 01 Jan '21

01 Jan '21

Hi there I would like to learn coding!

1 0