[Python-modules-team] Bug#739300: Bug#739300: dh_sphinxdoc: Please replace MathJax.js with links to the packaged libjs-mathjax

[Dmitry Shachnev]

On Thu, 06 Mar 2014 19:00:09 +0100, Julian Taylor wrote:
> replacing a directory with a symlink is problematic as dpkg has special
> rules for handling symlinks which can cause all kinds of upgrade issues.
> The most common ones are files disappearing (see the plentora of missing
> copyright bugs due to symlinking -doc packages) or unpack errors due to
> ordering issues in the tarballs.
>
> For this reason dh_linktree exists, please use that instead.
> Another approach is to modify the path the webserver serves from, thats
> what I do in IPython.

I see two disadvantages in this approach:

- First, as Sebastian mentioned, “30k-ish symlinks is just too much for a
  documentation displaying one or two formulas”.

- Then, set of MathJax files changes with each release, so we will have
  to rebuild all such packages with every new MathJax release (otherwise
  some symlinks will be broken or missing).

The problem with replacing a directory with symlink can be easily solved
by adding a preinst script to the package.

--
Dmitry Shachnev
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: OpenPGP digital signature
URL: <http://lists.alioth.debian.org/pipermail/python-modules-team/attachments/20140307/19e3cdbc/attachment-0001.sig>