Skip to content

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

Open
pranavchoudhary-tech wants to merge 2 commits into
python:mainfrom
pranavchoudhary-tech:fix-windows-pomerge
Open

docs: add Windows instructions for pomerge in translating guide#1862
pranavchoudhary-tech wants to merge 2 commits into
python:mainfrom
pranavchoudhary-tech:fix-windows-pomerge

Conversation

@pranavchoudhary-tech

@pranavchoudhary-tech pranavchoudhary-tech commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

Fixes #1783

This PR adds the missing Windows commands tab for the pomerge translation recovery tool, resolving the TODO in translating.rst. The commands for Windows use xcopy and rmdir to achieve the same result as the Unix cp and rm.

@read-the-docs-community

read-the-docs-community Bot commented Jul 18, 2026

Copy link
Copy Markdown

Documentation build overview

📚 CPython devguide | 🛠️ Build #33647673 | 📁 Comparing 01ee673 against latest (4d14223)

  🔍 Preview build  

2 files changed
± versions/index.html
± documentation/translations/translating/index.html

Comment thread getting-started/pull-request-lifecycle.rst
@pranavchoudhary-tech

Copy link
Copy Markdown
Contributor Author

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!

@zware zware left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The commands look reasonable to me, assuming that pomerge is available and working the same way on Windows.

I haven't tried this out, I'm hoping you have run this successfully? :)

@pranavchoudhary-tech

Copy link
Copy Markdown
Contributor Author

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! 😄

@StanFromIreland

Copy link
Copy Markdown
Member

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

@StanFromIreland StanFromIreland left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you please add the .. include:: /include/activate-tab.rst to the top of the file like we have elsewhere.

@pranavchoudhary-tech

Copy link
Copy Markdown
Contributor Author

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Task: Add windows instructions for translations when CPython files move

4 participants