[Python-Dev] rest2latex - was: Re: Raising objections

[Thomas Heller]

engelbert.gruber at ssg.co.at wrote:
> On Fri, 28 Apr 2006, Thomas Heller wrote:
> 
>> Gerhard Häring wrote:
>>> Thomas Heller wrote:
>>>> [...] I'm now happy with the tool that converts the ctypes tutorial
>>>> from reST to LaTeX,
>>>> I will later (today or tomorrow) commit that into Python SVN.
>>>
>>> Did you commit that already? Alternatively, can you send it to me, 
>>> please?
>>>
>>> -- Gerhard
>>
>> I meant the ctypes tutorial in latex format, not the tool itself.
>>
>> Anyway, the tool is mkydoc.py, in combination with missing.py:
>>
>> http://svn.python.org/view/external/ctypes-0.9.9.6/docs/manual/
>>
>> I'm not sure it is ready for public consumption ;-).
> 
> from what i saw it is not, because paths are hardcoded,

Sure, but it should only require some small changes to adapt it to
other rest sources.

> but aside from 
> this it should be usable and i am willing to take it up and into 
> docutils, but this requires feedback

I must work on the docs themselves, so I currently have only two things:

- the table in the ctypes tutorial has a totally different look than the other
  tables in the docs.  Compare
http://docs.python.org/dev/lib/ctypes-simple-data-types.html
  with
http://docs.python.org/dev/lib/module-struct.html

- feature request: it would be very nice if it were possible to generate links
into the index for functions and types from the rest sources.


Thomas