Mailman 3 January 2022 - Docs-bugs

[issue29688] Add support for Path.absolute()
by Eryk Sun 31 Jan '22

31 Jan '22

Eryk Sun <eryksun(a)gmail.com> added the comment: > I'm not seeing what's wrong with your example. "C:" or "C:spam\\eggs" are not absolute paths. They depend on the effective working directory on the drive. An absolute path should never depend on a working directory, which can change at random. WinAPI SetEnvironmentVariableW() allows applications to set environment variables with names that begin with "=". These names are effectively reserved for special use by the OS, at least as documented. In particular, names of the form "=X:", where "X" is a drive letter, are used to store the working directory on a drive. The C runtime _[w]chdir() function sets these per-drive environment variables, as does Python's os.chdir(). As environment variables, they can be inherited by child processes. When then Windows API resolves a file path to access a file, or in GetFullPathNameW(), a drive-relative path such as "X:" or "X:spam\\eggs" is resolved against either the current working directory (if it's on the drive) or the value of the "=X:" environment variable for the drive. If the latter isn't defined, it defaults to the root directory, e.g. "X:\\". If the current working directory is on the drive, the system updates the value of the "=X:" environment variable, if it exists. > on Windows you have to resolve the drive separately from the > working directory and then concatenate them? No, if self.drive is defined, then abspath(self.drive) should be called instead of getcwd(). In Windows, ntpath.abspath() calls WinAPI GetFullPathNameW(), which resolves the working directory on the drive. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29688> _______________________________________

1 0

[issue29688] Add support for Path.absolute()
by Eryk Sun 31 Jan '22

31 Jan '22

Change by Eryk Sun <eryksun(a)gmail.com>: ---------- Removed message: https://bugs.python.org/msg412220 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29688> _______________________________________

1 0

[issue29688] Add support for Path.absolute()
by Eryk Sun 31 Jan '22

31 Jan '22

Eryk Sun <eryksun(a)gmail.com> added the comment: > I'm not seeing what's wrong with your example. "C:" or "C:spam\\eggs" are not absolute paths. They depend on the effective working directory on the drive. An absolute path should never depend on a working directory, which can change at random. WinAPI SetEnvironmentVariableW() allows applications to set environment variables with names that begin with "=". These names are effectively reserved for special use by the OS, at least as documented. In particular, names of the form "=X:", where "X" is a drive letter, are used to store the working directory on a drive. The C runtime _[w]chdir() function sets these per-drive environment variables, as does Python's os.chdir(). As environment variables, they can be inherited by child processes. When then Windows API resolves a file path to access a file, or in GetFullPathNameW(), a drive-relative path such as "X:" or "X:spam\\eggs" is resolved against either the current working directory (if it's on the drive) or the value of the "=X:" environment variable for the drive. If the latter isn't defined, it defaults to the root directory, e.g. "X:\\". If the current working directory is on the drive, the system updates the value of the "=X:" environment variable, if it exists. > on Windows you have to resolve the drive separately from the > working directory and then concatenate them? Yes, if self.drive is defined. This would be handled by os.path.abspath(self.drive), which calls WinAPI GetFullPathNameW(). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29688> _______________________________________

1 0

[issue29688] Add support for Path.absolute()
by Brett Cannon 31 Jan '22

31 Jan '22

Brett Cannon <brett(a)python.org> added the comment: @eryksun I'm not seeing what's wrong with your example. Would you mind pointing out what you expect the result to be? And are you saying on Windows you have to resolve the drive separately from the working directory and then concatenate them? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29688> _______________________________________

1 0

[issue20923] [doc] Explain ConfigParser 'valid section name' and .SECTCRE
by Irit Katriel 31 Jan '22

31 Jan '22

Irit Katriel <iritkatriel(a)gmail.com> added the comment: The comment Terry suggests to add (see https://bugs.python.org/issue20923#msg255304) could be placed in this paragraph: https://docs.python.org/3/library/configparser.html#supported-ini-file-stru… ---------- keywords: +easy nosy: +iritkatriel title: Explain ConfigParser 'valid section name' and .SECTCRE -> [doc] Explain ConfigParser 'valid section name' and .SECTCRE 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/issue20923> _______________________________________

1 0

[issue46589] Improve documentation for typing._GenericAlias
by Alex Waygood 30 Jan '22

30 Jan '22

Change by Alex Waygood <Alex.Waygood(a)Gmail.com>: ---------- assignee: -> docs@python components: +Documentation keywords: +patch nosy: +Jelle Zijlstra, docs@python, gvanrossum, kj stage: -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46589> _______________________________________

1 0

[issue45990] Exception notes need more documentation
by Ram Rachum 30 Jan '22

30 Jan '22

New submission from Ram Rachum <ram(a)rachum.com>: The new __note__ feature for exception could be useful, but the documentation (and the section in "What's new") aren't good enough: "__note__: A mutable field which is :const:`None` by default and can be set to a string. If it is not :const:`None`, it is included in the traceback. This field can be used to enrich exceptions after they have been caught." This is more of a definition than an explanation. If this is solving a problem, there should be an explanation that starts from the problem being solved, hopefully with 2-3 examples where this is useful. If people start using this feature without some guidance, they might put things in the note that should have been in the message. ---------- assignee: docs@python components: Documentation messages: 407722 nosy: cool-RR, docs@python, iritkatriel priority: normal severity: normal status: open title: Exception notes need more documentation versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45990> _______________________________________

2 1

[issue30210] No Documentation on tkinter dnd module
by Irit Katriel 29 Jan '22

29 Jan '22

Irit Katriel <iritkatriel(a)gmail.com> added the comment: Doc was added under issue25237: https://docs.python.org/3/library/tkinter.dnd.html ---------- nosy: +iritkatriel resolution: -> duplicate stage: needs patch -> resolved status: open -> closed superseder: -> Add doc for tkinter commondialog.Dialog and subclasses _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue30210> _______________________________________

1 0

[issue29688] Add support for Path.absolute()
by Eryk Sun 29 Jan '22

29 Jan '22

Eryk Sun <eryksun(a)gmail.com> added the comment: In Windows, paths that are relative to the current directory on a drive aren't resolved. The following should be resolved by the current code: >>> os.chdir('C:/Temp') >>> pathlib.Path('C:').absolute() WindowsPath('C:') But _from_parts() has bugs with drive-relative paths. Assuming the bugs are fixed, when a path has a drive, Path.absolute() should resolve against abspath(self.drive) instead of getcwd(). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29688> _______________________________________

1 0

[issue29688] Add support for Path.absolute()
by Barney Gale 29 Jan '22

29 Jan '22

Barney Gale <barney.gale(a)gmail.com> added the comment: Now that GH 26153 is merged, I think this bug can be resolved. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29688> _______________________________________

1 0