Mailman 3 January 2020 - docs

[issue38558] Data Structures documentation out of sync with new Walrus operator
by Matt Ward 03 Feb '20

03 Feb '20

New submission from Matt Ward <matt(a)matthewward.net>: The 3.8 documentation still includes the text. ```Note that in Python, unlike C, assignment cannot occur inside expressions. C programmers may grumble about this, but it avoids a common class of problems encountered in C programs: typing = in an expression when == was intended.``` https://docs.python.org/3.8/tutorial/datastructures.html#more-on-conditions This would seem to no longer be the case with with the inclusion of https://www.python.org/dev/peps/pep-0572/ in 3.8 unless I am misunderstanding the above statement. ---------- assignee: docs@python components: Documentation messages: 355151 nosy: Matt Ward, docs@python priority: normal severity: normal status: open title: Data Structures documentation out of sync with new Walrus operator type: enhancement versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38558> _______________________________________

7 11

Possible bug in documentation of Return value in Try/Except/Finally block
by Tapan Parmar 03 Feb '20

03 Feb '20

Hello guys, I have come across this question https://stackoverflow.com/questions/59639733/python-docs-have-misleading-ex… Please check this out, I think the Doc is misleading on this specific topic. Best Regards, Tapan H. Parmar Data scientist | Technical Team lead - Python INEXTURE Solutions LLP LinkedIn <https://www.linkedin.com/in/tapanhp/> | +91 95744 31893

2 2

[issue39391] Nondeterministic Pydoc output on functions that have functions as default parameters
by Peter Occil 01 Feb '20

01 Feb '20

New submission from Peter Occil <poccil14(a)gmail.com>: It appears that if a method has default parameters set to functions, as in this example: def f1(): pass def f2(a, b=f1): pass The resulting Pydoc output produces a different, nondeterministic rendering for the f2 method each time it generates the documentation, such as `m1(a, b=<function f1 at 0x7f4ff67f8950>)` or `m1(a, b=<function f1 at 0x7f4ff67f8950>)`. And this is problematic for version control systems, among other things, especially since this is not a meaningful change to the documentation. One solution may be to write, say, `m1(a, b=f1)` instead. ---------- assignee: docs@python components: Documentation messages: 360278 nosy: Peter Occil, docs@python priority: normal severity: normal status: open title: Nondeterministic Pydoc output on functions that have functions as default parameters type: behavior _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39391> _______________________________________

6 8

[issue29249] Pathlib glob ** bug
by Gregory P. Smith 31 Jan '20

31 Jan '20

Change by Gregory P. Smith <greg(a)krypto.org>: ---------- versions: +Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29249> _______________________________________

1 0

[issue39455] Update the documentation for linecache module
by Aurora 31 Jan '20

31 Jan '20

New submission from Aurora <auroralanes(a)pm.me>: Added the definitions for two undocumented functions. ---------- assignee: docs@python components: Documentation messages: 360709 nosy: docs@python, opensource-assist priority: normal pull_requests: 17572 severity: normal status: open title: Update the documentation for linecache module type: enhancement versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39455> _______________________________________

1 2

[issue12731] python lib re uses obsolete sense of \w in full violation of UTS#18 RL1.2a
by Terry J. Reedy 31 Jan '20

31 Jan '20

Change by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- assignee: docs@python -> components: +Unicode -Documentation nosy: +benjamin.peterson, lemburg, serhiy.storchaka _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue12731> _______________________________________

1 0

[issue12731] python lib re uses obsolete sense of \w in full violation of UTS#18 RL1.2a
by Henry S. Thompson 31 Jan '20

31 Jan '20

Henry S. Thompson <ht(a)inf.ed.ac.uk> added the comment: [One year and 2 days later... :-[ Is this fixed in 3.9? If not, the Versions list above should be updated. The failure of lower() to preserve 'alpha-ness' is a serious bug, it causes significant failures in e.g. Turkish NLP, and it's _not_ just a failure of the documentation! Please can we move this to category Unicode and get at least this aspect of the problem fixed? Should I raise a separate issue on isalpha() etc.? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue12731> _______________________________________

1 0

doc error at https://docs.python.org/3/library/random.html#module-random
by keith.briggs＠bt.com 31 Jan '20

31 Jan '20

"pseudo random number generator" (once) should be "pseudo-random number generator" (as elsewhere on the same page) It is a number generator which is pseudo-random, not a random number generator which is pseudo! Keith

2 1

Python document update request for sort keys in json module
by niks9731＠gmail.com 31 Jan '20

31 Jan '20

Hello, I run an application on python 2.7.5 version. I have a json that is represented by a python dictionary. That dictionary is a nested one with values that can be dictionaries or list themselves. I want to go through the dict recursively with any inside dict also processed in sorted-keys order so that I can take a checksum of the dict which would be same in any subsequent iterations of me taking the checksum. I see that the json module has a "sort_keys" parameter that I can pass. Below is what it says on the doc page for the "sort_keys" parameter. It says, dictionaries but it doesn't explicitly say that it can handle dictionaries or lists as values of the dictionary for which I want the checksum. I tried to look at the source and it did seem like the nested dicts are also sorted. I also tried few examples and found the same behavior. So my request is can we add in the documentation that the sort_keys parameter also works in case of nested dictionaries (assuming of course that what I understood is correct). From the documentation: https://docs.python.org/2/library/json.html If sort_keys is true (default: False), then the output of dictionaries will be sorted by key. Let me know if something is not clear. Thanks in advance for your help.

2 1

Section on Tk themed widgets missing discussion of PanedWindow
by Donald Rozenberg 31 Jan '20

31 Jan '20

The documentation page https://docs.python.org/3/library/tkinter.ttk.html#module-tkinter.ttk is missing a discussion of the PanedWindow widget. -- Don Rozenberg 707-882-3601 don.rozenberg(a)gmail.com

2 1