Re: Unable to build doc on latest head

Lists: pgsql-hackers
From: Ashutosh Bapat <ashutosh(dot)bapat(at)enterprisedb(dot)com>
To: pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Unable to build doc on latest head
Date: 2017-04-03 06:44:09
Message-ID: CAFjFpRdH0u1UyOD+23qxRH+qmcSb=oCGcGMeNVBG6jr5=Vqpzw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-hackers

Hi,
Recently my doc build has started failing with errors

runtime error: file stylesheet.xsl line 57 element call-template
The called template 'id.attribute' was not found.
runtime error: file stylesheet.xsl line 57 element call-template
The called template 'id.attribute' was not found.
runtime error: file stylesheet.xsl line 57 element call-template
The called template 'id.attribute' was not found.
runtime error: file stylesheet.xsl line 57 element call-template
The called template 'id.attribute' was not found.
runtime error: file stylesheet.xsl line 57 element call-template
The called template 'id.attribute' was not found.
runtime error: file stylesheet.xsl line 46 element call-template
The called template 'id.attribute' was not found.
runtime error: file stylesheet.xsl line 46 element call-template
The called template 'id.attribute' was not found.
runtime error: file stylesheet.xsl line 46 element call-template
The called template 'id.attribute' was not found.
runtime error: file stylesheet.xsl line 46 element call-template
The called template 'id.attribute' was not found.
runtime error: file stylesheet.xsl line 46 element call-template
The called template 'id.attribute' was not found.
runtime error: file stylesheet.xsl line 46 element call-template
The called template 'id.attribute' was not found.
no result for postgres.xml

id.attribute was added by d6376245.

[1] says that id.attribute is supported in stylesheets version 1.77.1. Do I
need to update stylesheets version? How do I do it? Any help will be
appreciated.

[1] https://lists.oasis-open.org/archives/docbook-apps/201301/msg00040.html
--
Best Wishes,
Ashutosh Bapat
EnterpriseDB Corporation
The Postgres Database Company


From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Ashutosh Bapat <ashutosh(dot)bapat(at)enterprisedb(dot)com>
Cc: pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Unable to build doc on latest head
Date: 2017-04-03 15:06:36
Message-ID: 21063.1491231996@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-hackers

Ashutosh Bapat <ashutosh(dot)bapat(at)enterprisedb(dot)com> writes:
> Recently my doc build has started failing with errors
> runtime error: file stylesheet.xsl line 57 element call-template
> The called template 'id.attribute' was not found.

> [1] says that id.attribute is supported in stylesheets version 1.77.1. Do I
> need to update stylesheets version?

FWIW, it's working for me with docbook-style-xsl-1.79.1.

Appendix J claims our minimum supported version is 1.74.0, but since
none of that page seems to have been updated for the new docs tooling,
I'm not surprised if it's wrong.

> How do I do it? Any help will be appreciated.

That would depend on your platform. For me, the stylesheets shipped with
RHEL6 were too old, but I grabbed a more recent SRPM out of the Fedora
repos and was able to build/install that with little trouble.

regards, tom lane


From: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
To: Ashutosh Bapat <ashutosh(dot)bapat(at)enterprisedb(dot)com>, pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Unable to build doc on latest head
Date: 2017-04-03 15:53:46
Message-ID: 09f40210-da89-0102-37c3-fb5b5e056851@2ndquadrant.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-hackers

On 4/3/17 02:44, Ashutosh Bapat wrote:
> [1] says that id.attribute is supported in stylesheets version 1.77.1.
> Do I need to update stylesheets version? How do I do it? Any help will
> be appreciated.

The oldest version among the ones listed at
http://docbook.sourceforge.net/release/xsl/ that works for me is 1.77.0.
Which one do you have?

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services


From: Andrew Gierth <andrew(at)tao11(dot)riddles(dot)org(dot)uk>
To: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
Cc: Ashutosh Bapat <ashutosh(dot)bapat(at)enterprisedb(dot)com>, pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Unable to build doc on latest head
Date: 2017-04-03 20:31:59
Message-ID: 87d1ctteuj.fsf@news-spur.riddles.org.uk
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-hackers

>>>>> "Peter" == Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> writes:

> On 4/3/17 02:44, Ashutosh Bapat wrote:
>> [1] says that id.attribute is supported in stylesheets version
>> 1.77.1. Do I need to update stylesheets version? How do I do it?
>> Any help will be appreciated.

Peter> The oldest version among the ones listed at
Peter> http://docbook.sourceforge.net/release/xsl/ that works for me is
Peter> 1.77.0. Which one do you have?

BTW, the version in freebsd ports is 1.76.1, and the download stats on
docbook.sourceforge.net suggests that this one is still pretty widely
used despite its age. I filed a PR on the port, but who knows when
anything will happen.

--
Andrew (irc:RhodiumToad)


From: Ashutosh Bapat <ashutosh(dot)bapat(at)enterprisedb(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Unable to build doc on latest head
Date: 2017-04-04 03:41:23
Message-ID: CAFjFpRd-KiUUFA75nYdWj6CTkV7U+ZfROOPnbVHszKgwdp9y5Q@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-hackers

On Mon, Apr 3, 2017 at 8:36 PM, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:

> Ashutosh Bapat <ashutosh(dot)bapat(at)enterprisedb(dot)com> writes:
> > Recently my doc build has started failing with errors
> > runtime error: file stylesheet.xsl line 57 element call-template
> > The called template 'id.attribute' was not found.
>
> > [1] says that id.attribute is supported in stylesheets version 1.77.1.
> Do I
> > need to update stylesheets version?
>
> FWIW, it's working for me with docbook-style-xsl-1.79.1.
>
> Appendix J claims our minimum supported version is 1.74.0, but since
> none of that page seems to have been updated for the new docs tooling,
> I'm not surprised if it's wrong.
>
> > How do I do it? Any help will be appreciated.
>
> That would depend on your platform. For me, the stylesheets shipped with
> RHEL6 were too old, but I grabbed a more recent SRPM out of the Fedora
> repos and was able to build/install that with little trouble.
>
>
I forgot to specify the platform in my mail. It's Ubuntu 12.04 64bit. I
have docbook-xsl 1.76.1+dfsg-1ubuntu1. Looks like I need to update it to
1.77.1, but 12.04 doesn't support it readily, will need to force an upgrade.

Amit Langote, on other thread, said that the html docs compile even after
those errors. I didn't notice that. I thought, the docs didn't get built
because of those errors. So, probably I am good right now.

--
Best Wishes,
Ashutosh Bapat
EnterpriseDB Corporation
The Postgres Database Company


From: Ashutosh Bapat <ashutosh(dot)bapat(at)enterprisedb(dot)com>
To: Andrew Gierth <andrew(at)tao11(dot)riddles(dot)org(dot)uk>
Cc: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>, pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Unable to build doc on latest head
Date: 2017-04-04 03:43:31
Message-ID: CAFjFpRe_dVxUF72N-Expjgr3GY-3R6K-gRMSpDT3WU7axh2g4w@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-hackers

On Tue, Apr 4, 2017 at 2:01 AM, Andrew Gierth <andrew(at)tao11(dot)riddles(dot)org(dot)uk>
wrote:

> >>>>> "Peter" == Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
> writes:
>
> > On 4/3/17 02:44, Ashutosh Bapat wrote:
> >> [1] says that id.attribute is supported in stylesheets version
> >> 1.77.1. Do I need to update stylesheets version? How do I do it?
> >> Any help will be appreciated.
>
> Peter> The oldest version among the ones listed at
> Peter> http://docbook.sourceforge.net/release/xsl/ that works for me is
> Peter> 1.77.0. Which one do you have?
>

1.76.1, docbook-xsl 1.76.1+dfsg-1ubuntu1

>
> BTW, the version in freebsd ports is 1.76.1, and the download stats on
> docbook.sourceforge.net suggests that this one is still pretty widely
> used despite its age. I filed a PR on the port, but who knows when
> anything will happen.
>

:(

--
Best Wishes,
Ashutosh Bapat
EnterpriseDB Corporation
The Postgres Database Company


From: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
To: Ashutosh Bapat <ashutosh(dot)bapat(at)enterprisedb(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Unable to build doc on latest head
Date: 2017-04-04 12:54:13
Message-ID: 53f8f1b8-be8c-f2d3-7fd3-84ec2462b27a@2ndquadrant.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-hackers

On 4/3/17 23:41, Ashutosh Bapat wrote:
> I forgot to specify the platform in my mail. It's Ubuntu 12.04 64bit. I
> have docbook-xsl 1.76.1+dfsg-1ubuntu1. Looks like I need to update it to
> 1.77.1, but 12.04 doesn't support it readily, will need to force an upgrade.

You can just uninstall the docbook-xsl package, which will cause the
latest version to be downloaded on the fly and cached.

--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services