classification
Title: Automate creation of idlelib/help.html from Doc/.../idle.html
Type: behavior Stage: needs patch
Components: Build, IDLE Versions: Python 3.6, Python 3.5, Python 3.4, Python 2.7
process
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 2017-06-19 19:11 by terry.reedy.

Messages (1)
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 help.py.  I currently create help.html in a .bat file.  With Doc as current directory, it uses
  ..\pcbuild\python_d.exe -c "from idlelib.help import copy_strip; copy_strip()"
With a change to the help.py if __name__ block so that
  ..\pcbuild\python_d.exe -m idlelib.help copy_strip
would work.

This issue is first about revising Zack Ware's makefile patch, https://bugs.python.org/file36975/issue16893-v4.diff, 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
History
Date User Action Args
2017-06-19 19:11:14terry.reedysetcomponents: + Build, IDLE
2015-09-23 03:42:34terry.reedycreate