On Sat, 2004-02-28 at 12:58, Matthias Klose wrote:
> yes, at least for python2.3
>
> > Would it be sensible to include something about this in python
> > policy?
>
> is it needed?
Policy is perhaps the wrong place for it, but at the moment this
"feature" is not well advertised.
Splitting the -dev package into -dev and -doc-dev -- the latter having
only the doc tools -- would make it more obvious that you don't need to
ship them in your diff (a few packages do, currently). But if the -dev
package had a mention in its description and in README.maintainers then
it would be easier to know that the tools are shipped.
Of course, then it would be sensible to agree that they will ship at
least as long as upstream ships them.
Here's a snippet for the control file:
Includes templates, tools and scripts used to produce
Python-like documentation.
And something for README.maintainers:
Doc tools
---------
If your package ships documentation produced in the Python
documentation format, you can generate it at build-time by
build-depending on pythonX.X-dev, and you will find the
templates, tools and scripts in /usr/lib/python2.3/doc/tools --
adjust your build scripts accordingly.
Cheers,
--
Fabian Fagerholm <fabbe@paniq.net>
Attachment:
signature.asc
Description: This is a digitally signed message part