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