Re: some notes on man page build - Mailing list pgsql-docs

From Magnus Hagander
Subject Re: some notes on man page build
Date
Msg-id CABUevEzUa-Yh5ieOt5wqUt65kRAr+Vgn6Us2MJ7NEYzbEarR9Q@mail.gmail.com
Whole thread Raw
In response to some notes on man page build  (Peter Eisentraut <peter_e@gmx.net>)
List pgsql-docs
On Sun, Aug 17, 2014 at 4:03 PM, Peter Eisentraut <peter_e@gmx.net> wrote:
> I want to put some notes out of my head and on the record regarding the
> docbook-xsl stylesheets and the man page build.
>
> The release builds currently use version 1.76.1, because that's what's
> in Debian stable on borka.  That works fine.  I didn't look into older
> versions recently, so let's make sure we use at least that one.
>
> In
> <http://www.postgresql.org/message-id/1373416746.16613.2.camel@vanquo.pezone.net>
> is asked for an upgrade to 1.78.1, which is the current upstream
> release, because I wanted this bug fixed:
>
> http://sourceforge.net/p/docbook/bugs/1233/
>
> It turned out, however, that it introduced these two bugs
>
> http://sourceforge.net/p/docbook/bugs/1321/
> http://sourceforge.net/p/docbook/bugs/1322/
>
> These are fixed upstream, but there hasn't been a new release in a while.
>
> So the strategy going forward is to keep using 1.76.1 until borka gets
> upgraded (or are we going to use wheezy-lts?).  If it does get upgraded
> and Debian jessie ships with 1.78.1, we'll need to decide about either
> downgrading back to 1.76.1 or taking whatever new release might be out
> there at the time.  We should not ship a release built with 1.78.1.

We haven't actually decided if we're going to go wheezy-lts or jessie.
I would guess we'll be sticking to wheezy-lts at least for some time,
mainly to cut down the work ofh aving to upgrade boxes. However, if
there is a specific reason a box would be better off on jessie, we
will upgrade it (not necessarily right after jessie is released of
course, it will take some time to prepare the infrastructure to deal
with that version, and right now we don't have a pressing need so it
won't be on day 1).

We can of course also use this specific package from backports
assuming the fixed version is in jessie (in which case it should be
available as a wheezy backport I think). But all that is of course
irrelevant until there has actually been a release into either jessie
*or* wheezy with the fixin it :)

--
 Magnus Hagander
 Me: http://www.hagander.net/
 Work: http://www.redpill-linpro.com/


pgsql-docs by date:

Previous
From: Peter Eisentraut
Date:
Subject: some notes on man page build
Next
From: Kevin Grittner
Date:
Subject: Re: Sample archive_command is still problematic