cpython icon indicating copy to clipboard operation
cpython copied to clipboard

gh-67341: fix comment about windows link stat mapping

Open moreal opened this issue 6 months ago • 2 comments

// Windows doesn't define S_IFLNK, but posixmodule.c maps

The above comment is written in https://github.com/python/cpython/commit/99d6135a157f6626fddd5d61007d363b3a14990d#diff-b5b7e4f5599916b2018e911ef423f9d3fd46cb71268e1a73c74a1c9ae2cb6791 commit, and posixmodule.c included such logic at that time.

The commit https://github.com/python/cpython/commit/f2f373f5931be48efc3f6fa2c2faa1cca79dce75 which resolves https://github.com/python/cpython/issues/67341, moved the logic from posixmodule.c to fileutils.c.


This pull request includes only trivial changes but I've attached the GitHub issue number as a prefix, which I believe corresponds to Issue 23152 mentioned in the commit message. At the time, the contributors were using a separate tool outside of GitHub, so I thought it would be appropriate to match it with the bpo number listed in the issue description. Please let me know if there are any mistakes! Thank you.

  • Issue: gh-67341

moreal avatar Jun 27 '25 16:06 moreal

Hello, thanks for your interest in contributing! I see that your prior PR, #136027, was accepted, but please don't use that as a green light to make several PRs fixing comment typos. These generally fall under the umbrella of "cosmetic changes", which we try to avoid.

That said, this PR is already here, so we might as well use it. Are there any other comment fixes you would like to make? Let's do it all in one change, rather than many tiny changes; it's easier for us to handle from a review stance. After this one, please try to avoid sole comment changes. Thanks!

ZeroIntensity avatar Jun 27 '25 23:06 ZeroIntensity

Hello, thank you for letting me know about that policy! I apologize for taking up the maintainers' attention.

I was referencing the CPython source code while working on other tasks, and these were comment errors I discovered in that process, so there are no additional fixes to add. The reason it became 2 PRs is because I submitted them as I found them while reading through the source code.

Next time, even if I discover such issues (cosmetic changes), I'll just understand and move on without submitting fixes. Thanks!

moreal avatar Jun 28 '25 08:06 moreal

FYI, no need to force push. We squash at the end.

ZeroIntensity avatar Jun 30 '25 14:06 ZeroIntensity

Yeah I've accepted the other PR because it's annoying when a comment is wrong especially when it's about defining stuff.

picnixz avatar Jul 14 '25 07:07 picnixz