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

[stani]

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)
https://bugs.launchpad.net/bugs/452430
You received this bug notification because you are a member of Ubuntu
Sponsors for universe, which is a direct subscriber.