[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: RE : Bits from the Sphinx maintainer



* PICCA Frédéric-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr>, 2011-08-08, 07:45:
If your package builds documentation using Sphinx, I highly recommend you to stop creating jquery.js symlink with dh_link (or such) and use dh_sphinxdoc instead. This is the only future-proof way to have fully-functional, policy compliant package with Sphinx-built documentation.

I tryed it for one of my package.
I faced this "issue".
the setup.py file of the upstream was generating the doc during the build process and install it under the build/lib.xxx

so at the end all the documentation was under /usr/share/pyshare/<module>/doc/...

This is pretty weird place for documentation. dh_sphinxdoc by default looks only into subdirectories of /usr/share/doc/, but you can tell it to look somewhere else.

--
Jakub Wilk


Reply to: