Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.debian.maint.python > #9465 > unrolled thread

Heads up about file name changes

Back to article view | Back to linux.debian.maint.python

Contents

  Heads up about file name changes Barry Warsaw <barry@debian.org> - 2017-04-05 23:00 +0200
    Re: Heads up about file name changes Dmitry Shachnev <mitya57@debian.org> - 2017-04-06 18:50 +0200

#9465 — Heads up about file name changes

[Multipart message — attachments visible in raw view] — view raw

As Ubuntu 17.04 development winds down, I've been spending a fair bit of time
looking at FTBFS.  For packages that have been copied from Debian, especially
Python ones, we try really hard not to introduce too many deltas.  Doko
usually does archive-wide test rebuilds at various times during the cycle to
find build failures.  Here are the results of one he did a couple of weeks
ago:

http://qa.ubuntuwire.org/ftbfs/rebuilds/test-rebuild-20170322.1-zesty.html

I've started by looking at the Python package build failures and I've noticed
a bit of a trend, so I thought I'd at least mention it here, because
eventually the same changes I'm uploading as Ubuntu deltas will have to be
ported to Debian.  Yes, I could do that in git or experimental, but right now
I don't have time for that, sorry.  I also haven't investigated exactly what's
changed in the file names, but I'm suspecting something's changed in Sphinx.

So far, I've seen this problem in python-babel and python-pika.  In both
packages, d/rules tries to remove redundant files.  In babel's case it's
license.txt[1] and in pika's case it's version_history.txt (same path
pattern).  In both cases, these d/rules commands fail because the files now
end in .rst.txt, not .txt.

The fixes are easy of course, but this will probably affect many packages in
DPMT so I wanted to give a heads up.

Cheers,
-Barry

[1] rm debian/python-babel-doc/usr/share/doc/python-babel-doc/html/_sources/license.txt

[toc] | [next] | [standalone]

#9470

[Multipart message — attachments visible in raw view] — view raw

Hi Barry!

On Wed, Apr 05, 2017 at 04:53:54PM -0400, Barry Warsaw wrote:
> So far, I've seen this problem in python-babel and python-pika.  In both
> packages, d/rules tries to remove redundant files.  In babel's case it's
> license.txt[1] and in pika's case it's version_history.txt (same path
> pattern).  In both cases, these d/rules commands fail because the files now
> end in .rst.txt, not .txt.
>
> The fixes are easy of course, but this will probably affect many packages in
> DPMT so I wanted to give a heads up.

Thanks for this heads up! This is a change in Sphinx 1.5, added in
https://github.com/sphinx-doc/sphinx/pull/2454.

Sphinx now uses the original file name + sourcelink_suffix (.txt by default)
for files in _sources directory.

Another effect of the same change is that the projects with custom Sphinx
themes and templates now need to add SOURCELINK_SUFFIX option to
DOCUMENTATION_OPTIONS JS object, otherwise the search will not work (like it
is done in https://github.com/rtfd/sphinx_rtd_theme/commit/a5e0e304).

Sphinx 1.5 will be in experimental until the freeze ends, so we still have
time to file and/or fix the bugs.

--
Dmitry Shachnev

[toc] | [prev] | [standalone]

Back to top | Article view | linux.debian.maint.python

csiph-web