[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Sphinx 1.3 in Debian experimental

On Mon, Jun 29, 2015 at 2:41 PM, Dmitry Shachnev <mitya57@debian.org> wrote:
> Hi Sandro,
> On Mon, 29 Jun 2015 14:08:40 -0400, Sandro Tosi wrote:
>> that's great news! I just recently (like end of last week) received a
>> patch for basemap to address dates in the doc, and it seemed like your
>> effort and their were not in sync.
> Looking at the patch in #790235, that is a different issue.
> It happens because basemap uses |today| in a couple of files, namely:
> http://sources.debian.net/src/basemap/1.0.7+dfsg-1/doc/users/index.rst/#L8
> http://sources.debian.net/src/basemap/1.0.7+dfsg-1/doc/api/index.rst/#L8
> I am not sure if I can change everything in Sphinx for that.
> Juan's patches set |today| to a value based on dpkg-parsechangelog output,
> but that is obviously unacceptable for upstream Sphinx, and carrying that
> as a Debian-specific patch will be an ugly hack.
> In your particular case (and probably other ones), I think it'll be much
> easier to patch out uses of |today| than to apply Juan's hack.

well that requires to carry the patch in all the packages using
|today| instead of adapt sphinx to what Debian wants to achieve
(reproducible build) in the place that makes more sense: the tool
generating the doc. YMMV tho

>> Might just be enough to give them a heads up so they dont waste more time
>> in fixing docs when a the new release of sphinx will do it once and for all
> The patch in Sphinx 1.3 was written by Chris Lamb, who is one of the most
> active participants of Debian reproducible builds effort. So I don't think
> there can be some issue with synchronization here.
> Also, as your example demonstrates, Sphinx 1.3 won't "do it once and for all".
> --
> Dmitry Shachnev

Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

Reply to: