GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — gh-91242: [cleanup] Remove the unsupported windows CHM help doc build system by gpshead · Pull Request #141643 · python/cpython

Conversation

@gpshead

@gpshead gpshead commented Nov 16, 2025 •
edited by github-actions Bot
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Member

This originally started by having claude look for easy TODOs to tackle and seeing idlelib.editor._sphinx_version() as unneeded. which led to the rabbithole of "what windows chm build stuff is left to cleanup" and finding all of this.

I explicitly asked claude to keep the htmlhelp build target and focus only on removing the CHM support. As I have no idea who and what may still use the claimed useful on all platforms htmlhelp itself.

But the long dead/deprecated by Microsoft CHM format stuff can still go away? I need both Windows and Docs folks take on this. The linked issue kickstarted its deprecation and removal from our installers in 2022, but I also don't touch windows so I'm the wrong one to ask.

🤖 Commits generated with Claude Code

  • Issue: Include HTML docs with Windows installer instead of CHM #91242

📚 Documentation preview 📚: https://cpython-previews--141643.org.readthedocs.build/

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

All reactions
gpshead and others added 2 commits November 16, 2025 15:01
@gpshead @claude
[cleanup] Remove unused idlelib.editor._sphinx_version()
74036e5
The `_sphinx_version()` function is no longer needed since CHM
(Compiled HTML Help) documentation files are no longer installed.
This removes the dead code as indicated by the TODO comment.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@gpshead @claude
pythongh-91242: Remove CHM (Compiled HTML Help) build infrastructure
2e6f6df
Remove all CHM compilation infrastructure to complete the deprecation
that began in August 2022. CHM format documentation is now obsolete
and has been replaced by HTML documentation.

Changes:
- Doc/: Remove CHM compilation from make.bat, remove htmlhelp config
  from conf.py, update Makefile and README.rst to remove CHM references
- PC/layout/: Remove CHM file copying, constants, options, and manifest
  entries from the Windows package layout system
- Tools/msi/: Remove CHM support from MSI installer build and upload
  scripts

The htmlhelp build target is retained as it remains useful for
generating HTML Help format files without CHM compilation.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@gpshead gpshead added docs Documentation in the Doc dir OS-windows labels Nov 16, 2025
@github-project-automation github-project-automation Bot added this to Docs PRs Nov 16, 2025
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Nov 16, 2025
@bedevere-app bedevere-app Bot mentioned this pull request Nov 16, 2025
Include HTML docs with Windows installer instead of CHM #91242
Closed
@gpshead
gpshead requested a review from zooba November 16, 2025 23:35
@gpshead gpshead added the topic-installation label Nov 16, 2025
@AA-Turner

AA-Turner commented Nov 17, 2025

Copy link
Copy Markdown
Member

#140418

gpshead reacted with thumbs up emoji
All reactions
  • 👍 1 reaction

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@gpshead @claude
Adopt additional IDLE help file changes from python#140418
13d562e
Remove PDF and CHM references from IDLE help file browser and config.

Co-Authored-By: Claude <[email protected]>
@zooba

zooba commented Nov 17, 2025

Copy link
Copy Markdown
Member

I'd prefer to leave the PC/layout scripts unchanged, as those are version-independent (you can use main to lay out/package older builds), and the Tools/msi scripts are also deprecated to be removed after 3.15, so probably safer to leave those alone as well.

It looks like the Doc changes still allow us to generate htmlhelp, it just results in HTML files (like html)? Is there any value to this? I know we had to do some tricks with encoding and (IIRC) cross-references for HTMLHelp, so maybe those are still relevant?

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@github-actions

github-actions Bot commented May 2, 2026

Copy link
Copy Markdown

This PR is stale because it has been open for 30 days with no activity.

All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

@github-actions github-actions Bot added the stale Stale PR or inactive for long period of time. label May 2, 2026
@gpshead gpshead closed this Jun 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@zooba zooba Awaiting requested review from zooba
@terryjreedy terryjreedy Awaiting requested review from terryjreedy terryjreedy will be requested when the pull request is marked ready for review terryjreedy is a code owner
@AA-Turner AA-Turner Awaiting requested review from AA-Turner AA-Turner will be requested when the pull request is marked ready for review AA-Turner is a code owner
@hugovk hugovk Awaiting requested review from hugovk hugovk will be requested when the pull request is marked ready for review hugovk is a code owner
@StanFromIreland StanFromIreland Awaiting requested review from StanFromIreland StanFromIreland will be requested when the pull request is marked ready for review StanFromIreland is a code owner

Uh oh!

There was an error while loading. Please reload this page.

Assignees

No one assigned

Labels

docs Documentation in the Doc dir OS-windows stale Stale PR or inactive for long period of time. topic-installation

Projects

Docs PRs
Status: Todo

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Uh oh!

There was an error while loading. Please reload this page.

3 participants

@gpshead @AA-Turner @zooba
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.