[Debian-med-packaging] Bug#721780: htseq: FTBFS: dh_sphinxdoc: Sphinx documentation not found

[Diane Trout]

Hello,

I did some investigation and I think I fixed the bug.

The actual problem is that dh_sphinxdoc "doesn't fail silently when there are 
no docs". So when building a binary package, there are no html pages to 
install which causes dh_sphinxdoc to fail. When I was making the package I 
never tried running debuild -B so hadn't seen the problem.

I've moved the doc building commands around a bit, so the man pages are built 
for the binary package and the html pages are built for the -doc package.

The oddness of having a the .PHONY: clean is  because there's a file named 
clean in the package, and without the .PHONY: declaration make thinks clean is 
up to date and thus never runs the commands.

Also the strange http_proxy line came from 
https://wiki.debian.org/Python/LibraryStyleGuide

Whoever wrote that wiki page recommended it to prevent silently downloading 
dependencies from PyPI. It should currently be safe, but its hard to know if 
in the future if upstream will add a dependency that gets automatically 
downloaded instead of added to the build-depends.

Diane

On Wednesday, September 04, 2013 11:42:06 Andreas Tille wrote:
> Hi Diane,
> 
> I can confirm that `dpkg-buildpackage -B` really fails.  The buildlog
> says a bit earlier than the quote below:
> 
>   copying static files... WARNING: html_static_path entry
> '/tmp/python-htseq/doc/_static' does not exist
> 
> Please keep us (or debian-python) informed if you might need help to fix
> this.  (If I would be pretty comfortable with sphinx documentation I
> would have injected a fix in Git but I also need to think about this
> issue.)
> 
> BTW, please `git pull` - I did some cosmetic changes.  I also stumbled
> upon your clean target in debian/rules.  May be I'm missing something
> but I'm temped to change this to
> 
> 
> diff --git a/debian/rules b/debian/rules
> index 9131c5f..fd4514d 100755
> --- a/debian/rules
> +++ b/debian/rules
> @@ -25,10 +25,7 @@ override_dh_installdocs:
>         python setup.py build_sphinx -b man
>         dh_installdocs
> 
> -clean:
> +override_dh_clean:
>         make -C src clean
>         rm -rf dist build MANIFEST
>         dh_clean
> -
> -.PHONY: clean
> -