build-depend on doc packages?
I'm working with a Debian developer (Jonas Smedegaard) on packaging
the latest version of pandoc. One question that has come up is this:
In building pandoc's documentation, Haddock warns:
> Warning: The documentation for the following packages are not installed. No
> links will be generated to these packages: array-0.2.0.0, base-4.1.0.0,
> bytestring-0.9.1.4, containers-0.2.0.1, directory-1.0.0.3, filepath-1.1.0.2,
> ghc-prim-0.1.0.0, integer-0.1.0.1, old-locale-1.0.0.1, old-time-1.0.0.2,
> packedstring-0.1.0.1, pcre-light-0.3.1, pretty-1.0.1.0, process-1.0.1.1,
> rts-1.0, syb-0.1.0.1, template-haskell-2.3.0.1, unix-2.3.2.0
It produces the documentation just fine, but without the hyperlinks to
these other packages' documentation. If make the relevant -doc packages
build-depends, Haddock will add the hyperlinks, but users may find that
they don't lead anywhere if they haven't installed the -doc packages
that are linked to. We could ensure that there are no broken links by
making all these -doc packages not just build-depends but
install-depends of libghc6-pandoc-doc. But I can imagine someone
wanting the pandoc documentation without all the other stuff. So, is
there a policy about this? Should we go for
1) no hyperlinks,
2) hyperlinks that will be broken unless other -doc packages are
installed, or
3) hyperlinks that are guaranteed not to be broken, because the
other -doc packages are install-depends?
There's another warning we're getting in the build process that I
don't understand:
> Linking debian/dh_haskell_shlibdeps/a.out ...
> dpkg-shlibdeps: warning: binaries to analyze should already be installed in
> their package's directory.
> dpkg-shlibdeps: warning: dependency on libdl.so.2 could be avoided if
> "debian/dh_haskell_shlibdeps/a.out" were not uselessly linked against it (they
> use none of its symbols).
> dpkg-shlibdeps: warning: dependency on libz.so.1 could be avoided if
> "debian/dh_haskell_shlibdeps/a.out" were not uselessly linked against it (they
> use none of its symbols).
> dpkg-shlibdeps: warning: dependency on libutil.so.1 could be avoided if
> "debian/dh_haskell_shlibdeps/a.out" were not uselessly linked against it (they
> use none of its symbols).
> dpkg-shlibdeps: warning: dependency on libpcre.so.3 could be avoided if
> "debian/dh_haskell_shlibdeps/a.out" were not uselessly linked against it (they
> use none of its symbols).
Is this something we should fix? IF so, how?
Btw, the repository is at git.debian.org/git/collab-maint/pandoc
Best,
John
Reply to: