docs: add Windows instructions for pomerge in translating guide - #1862

Documentation build overview

CPython devguide | Build #34932631 | Comparing d5dd47b against latest (4d14223)

Preview build

Modified

• index.html
• _static/psrt-coordinator-triage.html
• documentation/index.html
• genindex/index.html
• security/index.html
• triage/index.html
• versions/index.html
• core-team/experts/index.html
• core-team/join-team/index.html
• core-team/team-log/index.html
• and 24 more...

Ah, my apologies! I created this branch from my fork's main branch without syncing with upstream/main first, which accidentally dragged in some unrelated commits from another PR I was working on.

I have just rebased and force-pushed to clean it up. It should only contain the Windows instructions for pomerge now. Let me know if everything looks good!

Thanks for the review and approval! Yes, I can confirm the standard shell commands (xcopy, rmdir, git checkout) work perfectly in the Windows Command Prompt. Since pomerge is a Python tool, it uses Python's built-in glob which natively handles the **\*.po globbing patterns on Windows just as well as it does on Unix!

@tomasr8 topic-sprints is for docs on how to organise/run sprints. Ive just created a sprint label for PRs being worked on at a sprint, like in CPython.

Done! Added the activate-tab.rst include to the top of the file.

@tomasr8 topic-sprints is for docs on how to organise/run sprints. Ive just created a sprint label for PRs being worked on at a sprint, like in CPython.

Haha yeah I figured, sorry about that! I just wanted a temporary label so I could keep track of the issues :) Thanks for adding the label!

I'll be at a Windows computer next week, if it helps.

@StanFromIreland good catch from Claude! You're totally right, cmd.exe doesn't expand wildcards so the previous command would just crash.

I've updated the dosbatch instructions to use a standard for /R loop instead. This passes the files to pomerge one by one, which works perfectly since it saves its translation memory iteratively.

I also added shopt -s globstar to the Unix tab, since Bash actually needs that flag enabled for **/*.po to work recursively too. Thanks for pointing this out!

@StanFromIreland Excellent catch on the translation memory overwrite! You are absolutely right; pomerge overwrites ~/.pomerge.json on every invocation, so looping through files one-by-one is completely broken.

I've pushed a fix that replaces the Windows dosbatch tab entirely with a powershell script. By using PowerShell's Get-ChildItem, we can natively expand the wildcards into an array and pass all files to pomerge in a single invocation, bypassing the overwrite issue completely while avoiding the lack of native globbing in cmd.exe.

I've also applied your suggested comment to the Unix tab!

Hi @zware, thanks for the approval! All 5 checks are passing and the branch merges cleanly. Could you go ahead and merge when you get a chance? Thanks!

Hi @zware, I've just rebased the branch onto the latest main everything is up to date now. Would appreciate another look when you get a chance!