[issue47086] Include HTML docs with Windows installer instead of CHM

Steve Dower added the comment: New changeset fe010605f87f988ef1053e372d1c3898d2633d96 by Steve Dower in branch 'main': bpo-47086: Remove dead link to old CHM documentation (GH-32075) https://github.com/python/cpython/commit/fe010605f87f988ef1053e372d1c3898d2633d96 --

[issue47086] Include HTML docs with Windows installer instead of CHM

Change by Steve Dower : -- pull_requests: +30163 stage: commit review -> patch review pull_request: https://github.com/python/cpython/pull/32075 ___ Python tracker ___

[issue47086] Include HTML docs with Windows installer instead of CHM

Steve Dower added the comment: This should work for you (luckily, this is about the simplest possible case): import sys import winreg def get_help(): KEY = rf"Software\Python\PythonCore\{sys.winver}\Help\Main Python Documentation" try: return

[issue47086] Include HTML docs with Windows installer instead of CHM

Terry J. Reedy added the comment: In the IDLE Help menu, 'Python Docs', default hotkey 'F1', invokes '<>', which is handled by EditorWindow.help_docs. For Windows, line 599, is 'os.startfile(self.help_url)'. (Otherwise, webbrowser is used.) On Windows, help_url is

[issue47086] Include HTML docs with Windows installer instead of CHM

Change by Eryk Sun : -- nosy: -eryksun ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue47086] Include HTML docs with Windows installer instead of CHM

Ned Deily added the comment: > Do you have any thoughts about distributing the docs in ePub format? Note that it's *much* easier to manufacture the docs in html format than it is in ePub format. -- ___ Python tracker

[issue47086] Include HTML docs with Windows installer instead of CHM

Steve Dower added the comment: > Do you have any thoughts about distributing the docs in ePub format? If Windows includes a reader for all supported versions, and it's easy to build, sure. But I don't think the first bit is true. Most people are going to be fairly comfortable with their

[issue47086] Include HTML docs with Windows installer instead of CHM

Ned Deily added the comment: At a minimum, though, Doc/tools/templates/download.html should be changed to remove the chm reference. -- ___ Python tracker ___

[issue47086] Include HTML docs with Windows installer instead of CHM

Eryk Sun added the comment: Do you have any thoughts about distributing the docs in ePub format? -- nosy: +eryksun ___ Python tracker ___

[issue47086] Include HTML docs with Windows installer instead of CHM

Steve Dower added the comment: The key is defined at https://github.com/python/cpython/blob/main/Tools/msi/doc/doc.wxs#L17 and is not set for a Store install at all. But we don't include the docs in that either - go straight to the web. -- ___

[issue47086] Include HTML docs with Windows installer instead of CHM

Steve Dower added the comment: For the registry key, reading the default value from key "HKCU\Software\Python\PythonCore\{sys.winver}\Help\Main Python Documentation" (or HKLM - no need to worry about the Wow6432Node bit here) and passing it to os.startfile() will work for all active

[issue47086] Include HTML docs with Windows installer instead of CHM

Steve Dower added the comment: Good call on IDLE, I didn't even think to check there (there is a registry key that points at the documentation if it was installed, which would be the best approach for IDLE to use). The makefiles don't urgently need to remove those references. If people

[issue47086] Include HTML docs with Windows installer instead of CHM

Ned Deily added the comment: If you remove the .chm file from the Windows installer, I believe IDLE needs to be updated to look for the installed html files instead (see Lib/idlelib/editor.py). And does this mean we should no longer produce .chm files at all for 3.11+? If so, there is work

[issue47086] Include HTML docs with Windows installer instead of CHM

Steve Dower added the comment: Leaving this open and assigned to myself for a couple of days to deal with any other fallout. In particular, I wasn't able to test the (minor) changes to the publishing steps (e.g. GPG signing), so will have to wait for the next release to see what

[issue47086] Include HTML docs with Windows installer instead of CHM

Steve Dower added the comment: New changeset 3751b6b030b4a3b88959b4f3c4ef2e58d325e497 by Steve Dower in branch 'main': bpo-47086: Remove .chm from Windows installer and add HTML docs (GH-32038) https://github.com/python/cpython/commit/3751b6b030b4a3b88959b4f3c4ef2e58d325e497 --

[issue47086] Include HTML docs with Windows installer instead of CHM

Change by Steve Dower : -- keywords: +patch pull_requests: +30128 stage: needs patch -> patch review pull_request: https://github.com/python/cpython/pull/32038 ___ Python tracker

[issue47086] Include HTML docs with Windows installer instead of CHM

New submission from Steve Dower : CHM is getting too hard to handle (see e.g. issue47051 for the latest issue), so let's just bite the bullet and ship the HTML docs instead. -- components: Windows messages: 415701 nosy: paul.moore, steve.dower, tim.golden, zach.ware priority: normal