Message179362
Lib/idlelib/help.txt and Doc/library/idle.rst contain almost exactly the same information, only formatted a bit differently. This issue is to suggest the merger of the two files, by way of creating help.txt from idle.rst as a part of the build or install process.
This could be as simple as merely copying the one to the other, but that of course leaves in place all reST directives that mean nothing to a simple text document. Thus, idle.rst should be processed to create help.txt. This could be done with sphinx/docutils, but to avoid having the CPython build process (not just the doc build process) depend on those tools, I think a very simple dedicated script could be created to do the processing without much trouble.
As far as I can tell, this new script would only have to do a few simple steps:
- Remove comments (including index markers, etc.)
- Remove reST roles (replace ":role:`" with "`", possibly remove "`" as well)
- Remove backslash escapes
- Remove (or undouble) double colons
- Replace "#." with "1.", etc.
Thoughts? |
|
Date |
User |
Action |
Args |
2013-01-08 16:45:12 | zach.ware | set | recipients:
+ zach.ware, eric.araujo, docs@python, Todd.Rovito |
2013-01-08 16:45:12 | zach.ware | set | messageid: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za> |
2013-01-08 16:45:12 | zach.ware | link | issue16893 messages |
2013-01-08 16:45:11 | zach.ware | create | |
|