Mailman 3 December 2017 - docs

[issue32208] Improve semaphore documentation
by Antoine Pitrou Dec. 4, 2017

Dec. 4, 2017

Antoine Pitrou <pitrou(a)free.fr> added the comment: The changes you are proposing sound reasonable to me. Would you like to submit a pull request for them? ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python, pitrou stage: -> needs patch versions: -Python 3.4, Python 3.5, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32208> _______________________________________

1 0

Incorrect Syntax
by epiphany＠tutanota.com Dec. 4, 2017

Dec. 4, 2017

https://docs.python.org/3/tutorial/stdlib2.html#output-formatting >>> import pprint>>> t = [[[['black', 'cyan'], 'white', ['green', 'red']], [['magenta',... 'yellow'], 'blue']]]...>>> pprint.pprint(t, width=30) It doesn't work. There's one "]" too much in blue... It should look like this: >>> import pprint>>> t = [[[['black', 'cyan'], 'white', ['green', 'red']], [['magenta',... 'yellow'], 'blue']]...>>> pprint.pprint(t, width=30) Then it works.

2 1

[issue32192] Provide importlib.util.lazy_import helper function
by Nick Coghlan Dec. 3, 2017

Dec. 3, 2017

Nick Coghlan <ncoghlan(a)gmail.com> added the comment: Maintaining the actual implementation as a third party module seems like a good idea to me, so I'm marking this as a documentation issue instead. The idea would be to add this as an example of a very basic lazy importer under https://docs.python.org/3/library/importlib.html#examples ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32192> _______________________________________

1 0

[issue13305] datetime.strftime("%Y") not consistent for years < 1000
by Ned Deily Dec. 1, 2017

Dec. 1, 2017

Ned Deily <nad(a)python.org> added the comment: (See also msg307413 in duplicate Issue32195 for more discussion.) ---------- nosy: +ned.deily _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue13305> _______________________________________

1 0

[issue32190] Separate out legacy introspection APIs in the inspect docs
by Nick Coghlan Dec. 1, 2017

Dec. 1, 2017

New submission from Nick Coghlan <ncoghlan(a)gmail.com>: (Follow up to https://bugs.python.org/issue27172) The deprecation notice on inspect.getfullargspec has been removed, since we want folks porting from Python 2 to rely on it as part of the porting process, rather than feeling they need to upgrade to using inspect.signature() immediately. At the same time, we really don't want folks relying on it for *new* code, since it has some inherent limitations (like failing to distinguish positional-only args from positional-and-keyword ones), and some odd historical quirks (like reporting the bound arg as part of the signature for already bound methods). The subprocess modules clearly separates out the "Older high-level API" https://docs.python.org/3/library/subprocess.html#older-high-level-api to help make it clear that new code should use "subprocess.run" instead. We could potentially add a similar final section to the inspect documentation for "Legacy introspection APIs". That would also be useful if https://bugs.python.org/issue31230 is eventually implemented - the current generator and coroutine specific APIs could be moved down to the legacy section for backwards compatibility maintenance, with the type independent API being preferred for new code. ---------- assignee: docs@python components: Documentation messages: 307362 nosy: brett.cannon, docs@python, ncoghlan priority: normal severity: normal stage: needs patch status: open title: Separate out legacy introspection APIs in the inspect docs type: enhancement versions: Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32190> _______________________________________

1 0