[Python-Dev] Re: Docutils/reStructuredText is ready to process PEPs
Thu, 1 Aug 2002 00:42:48 -0400
On Thu, Aug 01, 2002, Eric S. Raymond wrote:
> Ka-Ping Yee <firstname.lastname@example.org>:
>> I am not against structured text processing systems in general.
>> I think that something of this flavour would be a great solution
>> for PEPs and docstrings, and that David has done an impressive
>> job on RST. It's just that RST is much too big (for me).
> And if we're going to pay the transition costs to move to a
> heavyweight markup, it ought to be DocBook, same direction GNOME and
> KDE and the Linux kernel and FreeBSD and PHP are going.
Well, reST can generate DocBook easily enough. The problem I see with
DocBook is the creation/editing side: XML is painful. Having written
one presentation in pure XML/PythonPoint and another presentation in my
home-grown structured text system that then got converted to XML for
processing by PythonPoint, I'm a big believer in the *concept* of reST.
What remains to be seen is whether reST works well enough in the Real
Aahz (email@example.com) <*> http://www.pythoncraft.com/
Project Vote Smart: http://www.vote-smart.org/