Author zach.ware
Recipients Todd.Rovito, docs@python, eric.araujo, zach.ware
Date 2013-01-08.16:45:11
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
In-reply-to
Content
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?
History
Date User Action Args
2013-01-08 16:45:12zach.waresetrecipients: + zach.ware, eric.araujo, docs@python, Todd.Rovito
2013-01-08 16:45:12zach.waresetmessageid: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
2013-01-08 16:45:12zach.warelinkissue16893 messages
2013-01-08 16:45:11zach.warecreate