Re: pybuild sphinxdoc and extensions
On Sun, Apr 06, 2014 at 11:47:43PM +0800, Thomas Goirand wrote:
>
> override_dh_sphinxdoc:
> ifeq (,$(findstring nodocs, $(DEB_BUILD_OPTIONS)))
> sphinx-build -b html doc/source \
> $(CURDIR)/debian/$$PKG/usr/share/doc/$$PKG/html
> dh_sphinxdoc -O--buildsystem=python_distutils
> endif
>
> So sphinx builds directly in the destination. You then only need to add
> a .doc-base file and you're good to go. The advantage is that you can
> *not* build the docs if you wish (if you're testing your packaging, and
> don't care when doing the tests), and also you wont need to clean
> build/html.
nice trick,
> As for http_proxy='localhost', it's much better to write
> http_proxy='127.0.0.1:9', as there really could be a web proxy running
> on localhost, and you don't really want to use it, do you?
I just used the snipset of the wiki page explaining the library
packaging. Maybe the wiki should be changed.
> Also, are you
> doing like this to avoid intersphinx? In this case, why don't you just
> remove the intersphinx extension from conf.py? That's IMO much cleaner
> than just blocking the connection.
It is easier for me to deal with this from the debian/rules files instead of
maintaining a patch.
> I'm not sure about your "binary extensions" thing though...
In fact my package use the autodoc so it load the module at build time
(of the documetnation). So it needs to find also the Extensions.
This is why I try to set the proper PYTHONPATH during the doc
generation.
A+
Fred
--
GPG public key 4096R/4696E015 2011-02-14
fingerprint = E92E 7E6E 9E9D A6B1 AA31 39DC 5632 906F 4696 E015
uid Picca Frédéric-Emmanuel <picca@synchrotron-soleil.fr>
GPG public key 1024D/A59B1171 2009-08-11
fingerprint = 1688 A3D6 F0BD E4DF 2E6B 06AA B6A9 BA6A A59B 1171
uid Picca Frédéric-Emmanuel <picca@debian.org>
Reply to: