Skip to content

fix: remove stale REMOVE/ADD markers from Win32 modules - #290

Draft
toddr-bot wants to merge 1 commit into
cpan-authors:mainfrom
toddr-bot:koan.toddr.bot/cleanup-win32-stale-markers
Draft

fix: remove stale REMOVE/ADD markers from Win32 modules#290
toddr-bot wants to merge 1 commit into
cpan-authors:mainfrom
toddr-bot:koan.toddr.bot/cleanup-win32-stale-markers

Conversation

@toddr-bot

@toddr-bot toddr-bot commented Apr 12, 2026

Copy link
Copy Markdown
Contributor

What

Remove stale development annotations (#### REMOVE, #### ADD, ## REMOVE) from Win32Helper.pm, Win32IO.pm, and Win32Pump.pm.

Why

These markers were left from an unfinished refactoring where the author wanted to switch from passing OS file handles to using fd-based save/restore around CreateProcess. The alternative approach was never completed due to premature closure issues (documented in the original comment). The markers have been there for years and are misleading — _inherit() in Win32Helper.pm had #### REMOVE on every line despite being actively exported and used by Win32IO.pm.

How

  • Win32Helper.pm: Removed #### REMOVE markers from _inherit() and deleted the commented-out old version of the function (lines 93-100)
  • Win32IO.pm: Removed 12 lines of commented-out #### ADD code and 3 ## REMOVE markers. Replaced the 4-line explanatory comment with a concise 2-line note
  • Win32Pump.pm: Removed #### REMOVE markers from 13 lines of active code

No functional changes — only annotations and dead comments removed.

Testing

  • make test: 863/863 pass (pty.t skips due to IO::Pty version, pre-existing)
  • Win32 modules are not loaded on Unix, so changes are textual only on this platform. CI will validate on Windows.

🤖 Generated with Claude Code


Quality Report

Changes: 3 files changed, 17 insertions(+), 58 deletions(-)

Code scan: clean

Tests: failed (0 Failed, 37 tests)

Branch hygiene: clean

Generated by Kōan post-mission quality pipeline

Clean up annotations from an unfinished refactoring in Win32Helper.pm,
Win32IO.pm, and Win32Pump.pm. The _inherit() function in Win32Helper
had '#### REMOVE' on every line despite being actively used by Win32IO.
The '#### ADD' blocks in Win32IO were commented-out alternative code
that was never completed. Replace the misleading multi-line REMOVE
comment in Win32IO with a concise explanation of why OS handles are
used instead of fds.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant