Python documentation in DocBook
DaveP
DaveP at NEARLYdpawson.freeserve.co.uk
Tue Nov 12 15:44:34 EST 2002
martin at v.loewis.de (Martin v. Loewis) wrote in
news:m3adkevs4y.fsf at mira.informatik.hu-berlin.de:
> DaveP <DaveP at NEARLYdpawson.freeserve.co.uk> writes:
>
>> Is there a source form example of the py docs,
>> and perhaps a statement of what is required of the processing?
>
> Please have a look at
>
> http://www.python.org/doc/current/doc/doc.html
>
> for a specification of the Python documentation format. There are
> certainly many examples for that, see the Doc directory of the Python
> distibution or CVS.
I hadn't realised it was Latex? Sorry.
>
>> Just to take a look at producing docbook from that,
>> and to see if XML/XSLT/XSL-FO processing chain could do the job
>> please?
>
> What is your question?
I too see the benefits of the toolsets available for XML, and wondered
if the problems were manageable.
Looking at the volume of documentation, it would require a (mainly)
automated transfer old to new, just wondering how big the task was.
As is hinted at, http://www.python.org/doc/current/doc/structured.html
I do believe XML could do the job.
Building your own schema/stylesheets is an option, a lot could be
saved by borrowing what has gone before. NIH is a weak excuse IMHO :-)
regards DaveP
More information about the Python-list
mailing list