This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Title: Automate creation of idlelib/help.html from Doc/.../idle.html
Type: behavior Stage: needs patch
Components: Build, IDLE Versions: Python 3.7, Python 3.6
Status: open Resolution:
Dependencies: Superseder:
Assigned To: terry.reedy Nosy List: terry.reedy, zach.ware
Priority: normal Keywords:

Created on 2015-09-23 03:42 by terry.reedy, last changed 2022-04-11 14:58 by admin.

Messages (2)
msg251402 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2015-09-23 03:42
This continues #16893, which replaced help.txt with help.html for the Idle doc display.  It also replaced the display classes with new classes in  I currently create help.html in a .bat file.  With Doc as current directory, it uses
  ..\pcbuild\python_d.exe -c "from import copy_strip; copy_strip()"
With a change to the if __name__ block so that
  ..\pcbuild\python_d.exe -m copy_strip
would work.

This issue is first about revising Zack Ware's makefile patch,, which adds an 'idledoc' target.  It is attached to #16893.  It needs 'copy' replaced by 'copy, strip, and rename'. The command above requires finding a compatible python.exe, and I do not know if that is a problem.

In normal use, 'idledoc' should only be invoked for the earliest 3.x getting maintenance patches, and the result merged forward.

If this is resolved, it would be nice if the new 'idledoc' target were built as apart of the release process, and any changes checked in.  But the latter should currently still be done for all 3.x branches
msg301902 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2017-09-11 20:55
Zach, I currently build idlelib/help.html by first building a complete doc set and then copying from Doc/.../idle.html, stripping trailing whitespace on the say.  One problem is that the result has a lot of extraneous stuff aside from the doc text itself: the code for the header, sidebar, and footer. These are a nuisance when committing changes and for extracting just the text we want.

I would prefer to create a clean .html from Doc/library/idle.rst that just has the code for the doc, without the extraneous matter.  Do you know how?  I looked in Doc/make.bat and it says it will not work on single files.
Date User Action Args
2022-04-11 14:58:21adminsetgithub: 69405
2017-09-11 20:55:28terry.reedysetmessages: + msg301902
versions: + Python 3.7, - Python 2.7, Python 3.4, Python 3.5
2017-06-19 19:11:14terry.reedysetcomponents: + Build, IDLE
2015-09-23 03:42:34terry.reedycreate