Re: Documentation generation scripts

[Matthias Klose <doko@cs.tu-berlin.de>]

Alexandre Fayolle writes:
> Hello,
> 
> I'm working on the packaging of a python module (psyco). This module has
> some doc provided in Python's latex idiom, and therefore requires that
> the mkhowto script (provided in the Doc/tools/ directory of the python
> source distribution) be available. 
> 
> I've been unable to find a debian package providing these tools. 
> 
> Should I :
> 
>  * file a bug report against the python packages, requesting a
> python-doc-tools package to be added to the debian archive
>  * ship my own version of mkhowto in the package to build the
> documentation

the mkhowto bits are not big, so maybe it's the best thing to include
them in your package. I doubt that python-doc-tools is really
needed. Only the python core uses this doc system (or am I wrong?) and
at some point, maybe with python3, psyco will be included in the core
(?).

And if you file a bug report, make sure you include a patch :-)

	Matthias