Mailman 3 April 2022 - Docs-bugs

[issue32658] Metacharacter (\) documentation suggestion
by miss-islington 05 Apr '22

05 Apr '22

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- nosy: +miss-islington nosy_count: 5.0 -> 6.0 pull_requests: +30383 pull_request: https://github.com/python/cpython/pull/32322 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32658> _______________________________________

1 0

[issue41233] Missing links to errnos on Built-in Exceptions page
by Jelle Zijlstra 05 Apr '22

05 Apr '22

Jelle Zijlstra <jelle.zijlstra(a)gmail.com> added the comment: Thanks for the patch! ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41233> _______________________________________

1 0

[issue41233] Missing links to errnos on Built-in Exceptions page
by miss-islington 05 Apr '22

05 Apr '22

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset e47e6ffed36eb1dd82da3bcadf8b45b894ef4ce2 by Miss Islington (bot) in branch '3.9': bpo-41233: Add links to errnos referenced in exceptions docs (GH-21380) https://github.com/python/cpython/commit/e47e6ffed36eb1dd82da3bcadf8b45b894… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41233> _______________________________________

1 0

[issue41233] Missing links to errnos on Built-in Exceptions page
by miss-islington 05 Apr '22

05 Apr '22

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset 3fa800d7a7a405f51e0e8c9b7dac2f2a75c17bb4 by Miss Islington (bot) in branch '3.10': bpo-41233: Add links to errnos referenced in exceptions docs (GH-21380) https://github.com/python/cpython/commit/3fa800d7a7a405f51e0e8c9b7dac2f2a75… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41233> _______________________________________

1 0

[issue41233] Missing links to errnos on Built-in Exceptions page
by miss-islington 05 Apr '22

05 Apr '22

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- pull_requests: +30378 pull_request: https://github.com/python/cpython/pull/32317 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41233> _______________________________________

1 0

[issue41233] Missing links to errnos on Built-in Exceptions page
by miss-islington 05 Apr '22

05 Apr '22

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- nosy: +miss-islington nosy_count: 8.0 -> 9.0 pull_requests: +30377 pull_request: https://github.com/python/cpython/pull/32316 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41233> _______________________________________

1 0

[issue41233] Missing links to errnos on Built-in Exceptions page
by Jelle Zijlstra 05 Apr '22

05 Apr '22

Jelle Zijlstra <jelle.zijlstra(a)gmail.com> added the comment: New changeset a74892cb2168d249d9a8c53fad605a5def9b41d4 by yyyyyyyan in branch 'main': bpo-41233: Add links to errnos referenced in exceptions docs (GH-21380) https://github.com/python/cpython/commit/a74892cb2168d249d9a8c53fad605a5def… ---------- nosy: +JelleZijlstra _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41233> _______________________________________

1 0

[issue47097] Document PEP 646
by Jelle Zijlstra 05 Apr '22

05 Apr '22

New submission from Jelle Zijlstra <jelle.zijlstra(a)gmail.com>: https://docs.python.org/3.11/library/typing.html doesn't say anything about TypeVarTuple yet. ---------- assignee: docs@python components: Documentation messages: 415850 nosy: AlexWaygood, JelleZijlstra, docs@python, gvanrossum, kj, mrahtz priority: deferred blocker severity: normal stage: needs patch status: open title: Document PEP 646 versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47097> _______________________________________

3 5

[issue21314] Document '/' in signatures
by Petr Viktorin 04 Apr '22

04 Apr '22

Petr Viktorin <encukou(a)gmail.com> added the comment: - PEP 570 (Python Positional-Only Parameters) is final - The language spec was updated to mention it - the FAQ entry was revised to not link to the PEP and be a self-contained explanation IMO the only thing left is to make searching for `/` yield the right results, but that is bpo-15871. Closing this issue. ---------- nosy: +petr.viktorin resolution: -> fixed stage: commit review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue21314> _______________________________________

1 0

[issue47206] pickle docs are wrong about nested classes
by Jelle Zijlstra 04 Apr '22

04 Apr '22

New submission from Jelle Zijlstra <jelle.zijlstra(a)gmail.com>: https://docs.python.org/3.10/library/pickle.html#what-can-be-pickled-and-un… says that only "classes that are defined at the top level of a module" can be pickled. But in fact these work fine in current Python, probably since 3.3 when __qualname__ was added (https://docs.python.org/3/library/stdtypes.html#definition.__qualname__). Similarly, the docs claim only top-level functions can be pickled, but in fact methods nested in classes work fine. Example script demonstrating that these work: import pickle class X: class Y: pass def method(self): pass print(pickle.dumps(X.Y)) print(pickle.loads(pickle.dumps(X.Y))) print(pickle.dumps(X.Y())) print(pickle.loads(pickle.dumps(X.Y()))) print(pickle.dumps(X.method)) print(pickle.loads(pickle.dumps(X.method))) ---------- assignee: docs@python components: Documentation messages: 416625 nosy: JelleZijlstra, alexandre.vassalotti, docs@python priority: normal severity: normal status: open title: pickle docs are wrong about nested classes type: behavior versions: Python 3.10, Python 3.11, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47206> _______________________________________

2 1

[issue45317] Document the removal the usage of the C stack in Python to Python calls
by Mark Shannon 04 Apr '22

04 Apr '22

New submission from Mark Shannon <mark(a)hotpy.org>: Assuming that issue 45256 is implemented, we will need to document it. I'm opening a separate issue, so this doesn't get lost in the midst of 45256. We need to: Document the changes to gdb. Possibly at https://wiki.python.org/moin/DebuggingWithGdb, or in the main docs. Add a "what's new" entry explaining what the impact of this change is. ---------- assignee: docs@python components: Documentation messages: 402850 nosy: Mark.Shannon, docs@python priority: release blocker severity: normal status: open title: Document the removal the usage of the C stack in Python to Python calls type: enhancement versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45317> _______________________________________

2 5

[issue39090] Document various options for getting the absolute path from pathlib.Path objects
by Barney Gale 04 Apr '22

04 Apr '22

Barney Gale <barney.gale(a)gmail.com> added the comment: The docs for PurePath.is_absolute() say: > A path is considered absolute if it has both a root and (if the flavour allows) a drive This does not preclude it from having ".." segments. PurePath.absolute() is documented as of bpo-29688 / 3.11, see: https://docs.python.org/3.11/library/pathlib.html#pathlib.Path.absolute The documentation for the absolute() method is deliberately placed alongside resolve() for ease of comparison. Both methods make a path absolute, but resolve() also follows symlinks, and consequently is able to safely elide ".." segments. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39090> _______________________________________

1 0

[issue47209] Documentation for asserting values of `unittest.mock.Mock.call_args_list`
by himkt 04 Apr '22

04 Apr '22

New submission from himkt <himkt(a)klis.tsukuba.ac.jp>: Currently documentation says we can check call_args_list by providing a list of tuples of arguments. ``` >>> expected = [(), ((3, 4),), ({'key': 'fish', 'next': 'w00t!'},)] >>> mock.call_args_list == expected True ``` (from https://docs.python.org/3.11/library/unittest.mock.html#unittest.mock.Mock.…) However, I think we have to wrap all arguments with `call`. I'd happy to send a patch if it should be fixed. ### Reproduce: ``` import time from unittest.mock import call from unittest.mock import patch with patch("time.sleep") as mock_obj: time.sleep(1) time.sleep(2) print("mock_obj.call_args_list") print(mock_obj.call_args_list) print("mock_obj.call_args_list == [(1,), (2,)]") print(mock_obj.call_args_list == [(1,), (2,)]) print("mock_obj.call_args_list == [call(1,), call(2,)]") print(mock_obj.call_args_list == [call(1,), call(2,)]) ``` ``` > python demo.py 2022-04-04 12:03:18 mock_obj.call_args_list [call(1), call(2)] mock_obj.call_args_list == [(1,), (2,)] False mock_obj.call_args_list == [call(1,), call(2,)] True ``` ### Links - Documentation in repo: https://github.com/python/cpython/blob/4216dce04b7d3f329beaaafc82a77c4ac6cf… - Documentation in page: https://docs.python.org/3.11/library/unittest.mock.html#unittest.mock.Mock.… ---------- assignee: docs@python components: Documentation messages: 416650 nosy: docs@python, himkt priority: normal severity: normal status: open title: Documentation for asserting values of `unittest.mock.Mock.call_args_list` type: behavior versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47209> _______________________________________

1 2

[issue46337] urllib.parse: Allow more flexibility in schemes and URL resolution behavior
by Ned Deily 04 Apr '22

04 Apr '22

Change by Ned Deily <nad(a)python.org>: ---------- hgrepos: -414 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46337> _______________________________________

1 0

[issue46337] urllib.parse: Allow more flexibility in schemes and URL resolution behavior
by Ned Deily 04 Apr '22

04 Apr '22

Change by Ned Deily <nad(a)python.org>: Removed file: https://bugs.python.org/file50716/mitre_f188eec1268fd49bdc7375fc5b77ded657c… _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46337> _______________________________________

1 0

[issue46337] urllib.parse: Allow more flexibility in schemes and URL resolution behavior
by qweqwe4844m 04 Apr '22

04 Apr '22

Change by qweqwe4844m <hn7n1(a)hotmail.com>: ---------- assignee: -> docs@python components: +2to3 (2.x to 3.x conversion tool), Argument Clinic, Build, C API, Cross-Build, Demos and Tools, Documentation, Extension Modules, FreeBSD, Interpreter Core, Parser, Regular Expressions, SSL, Tests, Unicode, Windows, XML, ctypes, email, macOS hgrepos: +414 nosy: +barry, docs@python, ezio.melotti, koobs, larry, lys.nikolaou, mrabarnett, ned.deily, pablogsal, paul.moore, r.david.murray, ronaldoussoren, steve.dower, tim.golden, vstinner, zach.ware versions: +Python 3.7 Added file: https://bugs.python.org/file50716/mitre_f188eec1268fd49bdc7375fc5b77ded657c… _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46337> _______________________________________

1 0

[issue30964] Mention ensurepip in package installation docs
by Sam Ezeh 03 Apr '22

03 Apr '22

Change by Sam Ezeh <sam.z.ezeh(a)gmail.com>: ---------- pull_requests: -30352 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue30964> _______________________________________

1 0

[issue30964] Mention ensurepip in package installation docs
by Sam Ezeh 03 Apr '22

03 Apr '22

Change by Sam Ezeh <sam.z.ezeh(a)gmail.com>: ---------- nosy: +sam_ezeh nosy_count: 3.0 -> 4.0 pull_requests: +30352 pull_request: https://github.com/python/cpython/pull/32291 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue30964> _______________________________________

1 0

[issue26792] docstrings of runpy.run_{module,path} are rather sparse
by Antony Lee 03 Apr '22

03 Apr '22

Change by Antony Lee <anntzer.lee(a)gmail.com>: ---------- nosy: -Antony.Lee _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue26792> _______________________________________

1 0

[issue47142] Document importlib.resources.abc.Traversable
by Petr Viktorin 03 Apr '22

03 Apr '22

New submission from Petr Viktorin <encukou(a)gmail.com>: importlib.resources.files is documented [0] as returning importlib.resources.abc.Traversable, which is an undocumented class (dead link) now. It should be documented. The [source] has helpful docstrings, but is missing some details. I'd like to know these before writing some docs: - Can the argument to `joinpath` contain path separators? - Are the methods expected to raise specific exception types (e.g. if a resource is missing, or you call iterdir on a “file”)? This seems quite important for people who implement the protocol. [0]: https://docs.python.org/dev/library/importlib.resources.html#importlib.reso… [source]: https://github.com/python/cpython/blob/main/Lib/importlib/resources/abc.py#… ---------- assignee: docs@python components: Documentation messages: 416164 nosy: docs@python, jaraco, petr.viktorin priority: normal severity: normal status: open title: Document importlib.resources.abc.Traversable _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47142> _______________________________________

2 4

[issue47031] math.nan should note that NANs do not compare equal to anything
by Steven D'Aprano 03 Apr '22

03 Apr '22

New submission from Steven D'Aprano <steve+python(a)pearwood.info>: The IEEE-754 requirement that NANs are never equal to anything, even to themselves, is a common stumbling block for those new to the consequences of IEEE-754. See for example #47020. The documentation for math.nan would be a good place to add a note like "Due to the requirements of the `IEEE-754 standard <https://en.wikipedia.org/wiki/IEEE_754>`_, math.nan and float('nan') are never equal to any other value, including themselves. Use math.isnan to test for NANs." https://docs.python.org/3.8/library/math.html#math.nan ---------- assignee: docs@python components: Documentation keywords: easy messages: 415302 nosy: docs@python, steven.daprano priority: normal severity: normal status: open title: math.nan should note that NANs do not compare equal to anything type: enhancement versions: Python 3.10, Python 3.11, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47031> _______________________________________

7 15

[issue46033] Duplicated sentence in for statement documentation
by Michał D 03 Apr '22

03 Apr '22

New submission from Michał D <michcio1234(a)gmail.com>: In for statement description, there seem to be two sentences meant to mean the same: > The suite is then executed once for each item provided by the iterator, in the order returned by the iterator. Each item in turn is assigned to the target list using the standard rules for assignments (see Assignment statements), and then the suite is executed. (from https://docs.python.org/3/reference/compound_stmts.html#the-for-statement) I believe only one of these sentences should be kept (probably the second one). If I am wrong, and the current version is actually correct, then it is unclear - to me it sounds like the iterator is iterated through twice, and suite is executed twice for each item. ---------- assignee: docs@python components: Documentation messages: 408189 nosy: docs@python, michcio1234 priority: normal severity: normal status: open title: Duplicated sentence in for statement documentation versions: Python 3.10 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46033> _______________________________________

4 6

[issue24563] [doc] Encoding declaration: doc supported encodings
by Terry J. Reedy 03 Apr '22

03 Apr '22

Change by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue24563> _______________________________________

1 0

[issue24563] [doc] Encoding declaration: doc supported encodings
by miss-islington 03 Apr '22

03 Apr '22

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset ce6af314ca8529d5ed0f307deb9c33029a69f4cb by Miss Islington (bot) in branch '3.10': bpo-24563: Link encoding names to encoding declarations (GH-32274) https://github.com/python/cpython/commit/ce6af314ca8529d5ed0f307deb9c33029a… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue24563> _______________________________________

1 0

[issue24563] [doc] Encoding declaration: doc supported encodings
by miss-islington 03 Apr '22

03 Apr '22

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset f4e280d8c5461fa5e928fa07f6cd1779a4ac43ba by Miss Islington (bot) in branch '3.9': bpo-24563: Link encoding names to encoding declarations (GH-32274) https://github.com/python/cpython/commit/f4e280d8c5461fa5e928fa07f6cd1779a4… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue24563> _______________________________________

1 0

[issue24563] [doc] Encoding declaration: doc supported encodings
by miss-islington 03 Apr '22

03 Apr '22

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- pull_requests: +30339 pull_request: https://github.com/python/cpython/pull/32276 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue24563> _______________________________________

1 0

[issue24563] [doc] Encoding declaration: doc supported encodings
by miss-islington 03 Apr '22

03 Apr '22

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- nosy: +miss-islington nosy_count: 4.0 -> 5.0 pull_requests: +30338 pull_request: https://github.com/python/cpython/pull/32275 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue24563> _______________________________________

1 0

[issue24563] [doc] Encoding declaration: doc supported encodings
by Terry J. Reedy 03 Apr '22

03 Apr '22

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: New changeset 01be5d6446abbdd95d0c18bd19a58a62b05568d8 by Terry Jan Reedy in branch 'main': bpo-24563: Link encoding names to encoding declarations (GH-32274) https://github.com/python/cpython/commit/01be5d6446abbdd95d0c18bd19a58a62b0… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue24563> _______________________________________

1 0

[issue24563] [doc] Encoding declaration: doc supported encodings
by Terry J. Reedy 02 Apr '22

02 Apr '22

Change by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- pull_requests: +30337 pull_request: https://github.com/python/cpython/pull/32274 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue24563> _______________________________________

1 0

[issue24563] [doc] Encoding declaration: doc supported encodings
by Terry J. Reedy 02 Apr '22

02 Apr '22

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: I am writing a PR with an internal link. I decided that linking to Standard Encodings is sufficient. The Python Text Encodings section follows that. Anyone wanting to use any of those can experiment to see which work. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue24563> _______________________________________

1 0

[issue45099] asyncio.Task's documentation says that loop arg is removed when it's not
by jack1142 02 Apr '22

02 Apr '22

New submission from jack1142 <kuba.kuczys(a)gmail.com>: The documentation here: https://docs.python.org/3.10/library/asyncio-task.html#asyncio.Task Says that `loop` parameter was removed but it's still part of the signature. It gets even more confusing when the deprecation right below it is saying that *not* passing it when there is no running event loop is deprecated :) I could make a PR removing this information but I'm not sure whether there should be also some information put about it being deprecated in 3.8 but not actually getting removed in 3.10? ---------- assignee: docs@python components: Documentation messages: 401047 nosy: docs@python, jack1142 priority: normal severity: normal status: open title: asyncio.Task's documentation says that loop arg is removed when it's not type: behavior versions: Python 3.10 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45099> _______________________________________

4 10

[issue45584] Clarifying truncating in documentation
by Arthur Milchior 02 Apr '22

02 Apr '22

New submission from Arthur Milchior <arthur(a)milchior.fr>: While floor/ceil 's documentation are very precise, `truncate` was not explained. I actually had to search online to understand the difference between `truncate` and `floor` (admittedly, once I remembered that numbers are signed, and that floating numbers actually uses a bit for negation symbol instead of two complement, it became obvious) I assume that I won't be the only user having this trouble, especially for people whose mother tongue is not English. So I suggest adding a clarification to help make what should be obvious to most actually explicit ---------- assignee: docs@python components: Documentation messages: 404850 nosy: ArthurMilchior, docs@python priority: normal severity: normal status: open title: Clarifying truncating in documentation type: enhancement versions: Python 3.10, Python 3.11, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45584> _______________________________________

5 11

[issue45114] bad example for os.stat
by Harri 02 Apr '22

02 Apr '22

New submission from Harri <harri(a)afaics.de>: The example on https://docs.python.org/3/library/stat.html should be improved to avoid endless recursion, if there is a symlink loop. I would suggest to use os.lstat instead of os.stat. ---------- assignee: docs@python components: Documentation messages: 401133 nosy: docs@python, harridu priority: normal severity: normal status: open title: bad example for os.stat versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45114> _______________________________________

4 7

[issue26792] docstrings of runpy.run_{module,path} are rather sparse
by Jelle Zijlstra 02 Apr '22

02 Apr '22

Change by Jelle Zijlstra <jelle.zijlstra(a)gmail.com>: ---------- nosy: +JelleZijlstra nosy_count: 4.0 -> 5.0 pull_requests: +30330 pull_request: https://github.com/python/cpython/pull/32265 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue26792> _______________________________________

1 0

[issue29920] Document cgitb.text and cgitb.html
by Irit Katriel 02 Apr '22

02 Apr '22

Irit Katriel <iritkatriel(a)gmail.com> added the comment: Closing as the backport to 3.5/3.6 is no longer relevant and also cgitb is deprecated under 594. ---------- nosy: +iritkatriel resolution: -> fixed stage: -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29920> _______________________________________

1 0

[issue24563] [doc] Encoding declaration: doc supported encodings
by Irit Katriel 02 Apr '22

02 Apr '22

Change by Irit Katriel <iritkatriel(a)gmail.com>: ---------- keywords: +easy title: Encoding declaration: doc supported encodings -> [doc] Encoding declaration: doc supported encodings versions: +Python 3.10, Python 3.11, Python 3.9 -Python 2.7, Python 3.4, Python 3.5, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue24563> _______________________________________

1 0

[issue22738] improve 'python -h' documentation for '-c'
by Irit Katriel 02 Apr '22

02 Apr '22

Irit Katriel <iritkatriel(a)gmail.com> added the comment: Closing as the discussion stalled about 7 years ago and was then leaning towards rejecting the suggestion. ---------- nosy: +iritkatriel resolution: -> rejected stage: needs patch -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22738> _______________________________________

1 0

[issue39090] Document various options for getting the absolute path from pathlib.Path objects
by Brett Cannon 01 Apr '22

01 Apr '22

Change by Brett Cannon <brett(a)python.org>: ---------- nosy: +barneygale _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39090> _______________________________________

1 0

[issue47189] What's new in Python 3.11: Faster CPython
by Ken Jin 01 Apr '22

01 Apr '22

Change by Ken Jin <kenjin4096(a)gmail.com>: ---------- keywords: +patch pull_requests: +30307 stage: -> patch review pull_request: https://github.com/python/cpython/pull/32235 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47189> _______________________________________

1 0

[issue47189] What's new in Python 3.11: Faster CPython
by Ken Jin 01 Apr '22

01 Apr '22

Change by Ken Jin <kenjin4096(a)gmail.com>: ---------- assignee: docs@python components: Documentation nosy: docs@python, kj priority: normal severity: normal status: open title: What's new in Python 3.11: Faster CPython versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47189> _______________________________________

1 0

[issue39090] Document various options for getting the absolute path from pathlib.Path objects
by Eryk Sun 01 Apr '22

01 Apr '22

Eryk Sun <eryksun(a)gmail.com> added the comment: > Now a file that doesn't exist: > >>> mike = Path("palin.jpg") > >>> mike.resolve() > WindowsPath('palin.jpg') This is a bug in resolve(). It was fixed in 3.10+ by switching to ntpath.realpath(). I don't remember why a fix for 3.9 was never applied. Work on the PR may have stalled due to a minor disagreement. > 'C:\Windows\..\Program Files' and '/usr/../bin' == relative path No, a relative path depends on either the current working directory or, for a symlink target, the path of the directory that contains the symlink. In Windows, a rooted path such as r"\spam" is a relative path because it depends on the drive of the current working directory. For example, if the current working directory is r"Z:\eggs", then r"\spam" resolves to r"Z:\spam". Also, a drive-relative paths such as "Z:spam" depends on the working directory of the given drive. Windows supports a separate working directory for each drive. For example, if the working directory of drive "Z:" is r"Z:\eggs", then "Z:spam" resolves to r"Z:\eggs\spam". ---------- nosy: +eryksun _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39090> _______________________________________

1 0

[issue47187] locale module example is wrong for some platforms
by Sylvain Marie 01 Apr '22

01 Apr '22

New submission from Sylvain Marie <sylvain.marie(a)schneider-electric.com>: The example in the doc shows ```python >>> import locale >>> loc = locale.getlocale() # get current locale # use German locale; name might vary with platform >>> locale.setlocale(locale.LC_ALL, 'de_DE') >>> locale.strcoll('f\xe4n', 'foo') # compare a string containing an umlaut >>> locale.setlocale(locale.LC_ALL, '') # use user's preferred locale >>> locale.setlocale(locale.LC_ALL, 'C') # use default (C) locale >>> locale.setlocale(locale.LC_ALL, loc) # restore saved locale ``` However locale.getlocale() does not return the locale for all categories (locale.LC_ALL is even not allowed) but the locale for the LC_CTYPE category. Therefore restoring it using `locale.setlocale(locale.LC_ALL, loc)` does not actually restore the initial settings, and may even fail on some platforms (on mine it does). The correct example should have the first line of code replaced with ``` >>> loc = locale.setlocale(locale.LC_ALL) # get current locale ``` Note: this issue was first reported in the `pandas` library at https://github.com/pandas-dev/pandas/issues/46595 ---------- assignee: docs@python components: Documentation messages: 416487 nosy: docs@python, smarie priority: normal severity: normal status: open title: locale module example is wrong for some platforms versions: Python 3.10 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47187> _______________________________________

1 0

[issue38668] Update os.path documentation regarding recommended types
by Jack DeVries 01 Apr '22

01 Apr '22

Change by Jack DeVries <jdevries3133(a)gmail.com>: ---------- keywords: +patch nosy: +jack__d nosy_count: 2.0 -> 3.0 pull_requests: +30304 stage: -> patch review pull_request: https://github.com/python/cpython/pull/32232 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38668> _______________________________________

1 0

[issue32658] Metacharacter (\) documentation suggestion
by Jack DeVries 01 Apr '22

01 Apr '22

Jack DeVries <jdevries3133(a)gmail.com> added the comment: Did you run ``make venv`` to setup your virtual environment? Sphynx themes are usually pip dependencies, so if you're getting a "missing theme" error, it sounds like your virtual environment is not setup right. ---------- nosy: +jack__d _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32658> _______________________________________

1 0

[issue32658] Metacharacter (\) documentation suggestion
by mike mcleod 01 Apr '22

01 Apr '22

Change by mike mcleod <mikecmcleod(a)gmail.com>: ---------- keywords: +patch pull_requests: +30302 stage: -> patch review pull_request: https://github.com/python/cpython/pull/32230 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32658> _______________________________________

1 0

[issue47183] Cant compile html docs
by mike mcleod 01 Apr '22

01 Apr '22

New submission from mike mcleod <mikecmcleod(a)gmail.com>: After sync'ing to upstream/main and then python/Doc on  main via 🐍 v3.11.0a6+ ❯ make html mkdir -p build Building NEWS from Misc/NEWS.d with blurb PATH=./venv/bin:$PATH sphinx-build -b html -d build/doctrees -W . build/html Running Sphinx v3.5.4 building [mo]: targets for 0 po files that are out of date building [html]: targets for 495 source files that are out of date updating environment: [new config] 495 added, 0 changed, 0 removed reading sources... [100%] whatsnew/index looking for now-outdated files... none found pickling environment... done checking consistency... done preparing documents... failed Warning, treated as error: unsupported theme option 'license_url' given make: *** [Makefile:53: build] Error 2 No changes to source. ---------- assignee: docs@python components: Documentation messages: 416448 nosy: docs@python, mikecmcleod priority: normal severity: normal status: open title: Cant compile html docs type: compile error versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47183> _______________________________________

2 3

[issue39090] Document various options for getting the absolute path from pathlib.Path objects
by Vedran Čačić 01 Apr '22

01 Apr '22

Vedran Čačić <vedgar(a)gmail.com> added the comment: > First, I hope we all agree: > 'C:\Windows\..\Program Files' and '/usr/../bin' == relative path I don't agree. To me, absolute means regardless of a reference point. So, absolute path would be a path that refers to the same entity from whichever directory you reference it. And that is surely the case for these two. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39090> _______________________________________

1 0