Skip to content

Conversation

@gpshead
Copy link
Member

@gpshead gpshead commented Nov 16, 2025

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


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

gpshead and others added 2 commits November 16, 2025 15:01
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 <noreply@anthropic.com>
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 <noreply@anthropic.com>
@AA-Turner
Copy link
Member

#140418

Remove PDF and CHM references from IDLE help file browser and config.

Co-Authored-By: Claude <noreply@anthropic.com>
@zooba
Copy link
Member

zooba commented Nov 17, 2025

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?

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

Labels

docs Documentation in the Doc dir OS-windows topic-installation

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

3 participants