[issue30612] Unusual Windows registry path syntax
New submission from Christian Ullrich: In 3.6.1, the manual, section 3.1.3, has this to say: "Your administrator will need to activate the “Enable Win32 long paths” group policy, or set the registry value HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem@LongPathsEnabled to 1." Separating a value name from the key path with an @-sign, which is what the above is doing, is something I have never before seen anywhere. I suggest changing it by either: - replacing the instructions for the manual change with a link to <https://msdn.microsoft.com/en-us/library/windows/desktop/aa365247(v=vs.85).aspx#maxpath> or a more suitable reference (I could not find a KB article when I looked) - rewording it as, e.g., ... in the registry key HKEY_...FileSystem, set the REG_DWORD value LongPathsEnabled to 1 The value type could be left out; the value is predefined on all platforms where it will be effective. ---------- assignee: docs@python components: Documentation messages: 295505 nosy: Christian.Ullrich, docs@python priority: normal severity: normal status: open title: Unusual Windows registry path syntax type: enhancement versions: Python 3.6 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue30612> _______________________________________
Changes by R. David Murray <rdmurray@bitdance.com>: ---------- components: +Windows nosy: +paul.moore, steve.dower, tim.golden, zach.ware versions: +Python 3.7 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue30612> _______________________________________
Steve Dower added the comment: Pull requests welcome, but as someone who lives in the Windows API day in and day out, I can vouch for it being the normal abbreviated way of specifying a fully qualified registry value. ---------- priority: normal -> low _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue30612> _______________________________________
Christian Ullrich added the comment: Out of curiosity, can you point me to an example or two? I have been living with, though not in, Win32 for quite a few years myself, and I can say with certainty that I have never seen this notation before in my life. Other than that, PR on the way soonish. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue30612> _______________________________________
Steve Dower added the comment: There's a handful of references in https://docs.microsoft.com/en-us/visualstudio/ide/walkthrough-creating-a-mul..., though TBH most of the docs written by actual doc writers use more complicated sentences to avoid it. It's also the syntax used by MSBuild, which is probably mostly why I think it's normal. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue30612> _______________________________________
Cheryl Sabella <cheryl.sabella@gmail.com> added the comment: @chrullrich, were you still interested in creating a PR for this? Thanks! ---------- nosy: +cheryl.sabella versions: +Python 3.8 -Python 3.6 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue30612> _______________________________________
Change by Zackery Spytz <zspytz@gmail.com>: ---------- keywords: +patch nosy: +ZackerySpytz nosy_count: 7.0 -> 8.0 pull_requests: +19558 stage: -> patch review pull_request: https://github.com/python/cpython/pull/20281 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue30612> _______________________________________
Steve Dower <steve.dower@python.org> added the comment: New changeset ff1ae3dd334faa2006394c2318db385cdc42030a by Zackery Spytz in branch 'master': bpo-30612: Tweak Windows registry path syntax in the docs (GH-20281) https://github.com/python/cpython/commit/ff1ae3dd334faa2006394c2318db385cdc4... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue30612> _______________________________________
Change by Steve Dower <steve.dower@python.org>: ---------- nosy: -miss-islington resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue30612> _______________________________________
Change by miss-islington <mariatta.wijaya+miss-islington@gmail.com>: ---------- nosy: +miss-islington nosy_count: 8.0 -> 9.0 pull_requests: +21771 pull_request: https://github.com/python/cpython/pull/22815 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue30612> _______________________________________
Change by miss-islington <mariatta.wijaya+miss-islington@gmail.com>: ---------- nosy: +miss-islington pull_requests: +21772 pull_request: https://github.com/python/cpython/pull/22816 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue30612> _______________________________________
miss-islington <mariatta.wijaya+miss-islington@gmail.com> added the comment: New changeset f53ea8adaecacfe8c1e4a093136fb5318b15d779 by Miss Skeleton (bot) in branch '3.8': bpo-30612: Tweak Windows registry path syntax in the docs (GH-20281) https://github.com/python/cpython/commit/f53ea8adaecacfe8c1e4a093136fb5318b1... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue30612> _______________________________________
miss-islington <mariatta.wijaya+miss-islington@gmail.com> added the comment: New changeset bd9d76bbbb9eb226d99e186dae39e06ba8977485 by Miss Skeleton (bot) in branch '3.9': bpo-30612: Tweak Windows registry path syntax in the docs (GH-20281) https://github.com/python/cpython/commit/bd9d76bbbb9eb226d99e186dae39e06ba89... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue30612> _______________________________________
participants (6)
-
Cheryl Sabella -
Christian Ullrich
-
miss-islington
-
R. David Murray
-
Steve Dower
-
Zackery Spytz