[Bug 452430] Re: Please sync phatch 0.2.4-1 (universe) from Debian Unstable (main)

stani spe.stani.be at gmail.com
Thu Oct 15 21:59:57 BST 2009

The */docs/* are shipped in the upstream tarball as source restructured
text *.rst, which are converted by sphinx to *.html. Debian and Ubuntu
ignore the shipped *.html files and use sphinx at build time to
regenerate them from the source *.rst files. I don't know if this is a
Debian policy, but besides as the upstream author I would also recommend
it to ensure the html files are always up to date. (As a human being I
might forget to update the html files before doing a release.)

The diff we are seeing here affects only the */docs/build/html/* files,
which are ignored by Debian/Ubuntu, but not the */docs/source/*.rst
files which are used by Debian and Ubuntu. So this diff does not matter
for Debian and Ubuntu at all.

If you would be curious why the html changes and not the rst source
files, this is because the html uses now a left navigation sidebar
instead of a right navigation sidebar which affects the html code (but
not the rst source). But again, this is of no value for Ubuntu.

Please sync phatch 0.2.4-1 (universe) from Debian Unstable (main)
You received this bug notification because you are a member of Ubuntu
Sponsors for universe, which is a direct subscriber.

More information about the Ubuntu-universe-sponsors mailing list