Re: Make documentation builds reproducible - Mailing list pgsql-hackers

From Peter Smith
Subject Re: Make documentation builds reproducible
Date
Msg-id CAHut+Psb6d4pqDNi7e=EWgn8EyyrMoJNuNvpvyBGr-Pot6WOOw@mail.gmail.com
Whole thread Raw
In response to Re: Make documentation builds reproducible  (Peter Smith <smithpb2250@gmail.com>)
Responses Re: Make documentation builds reproducible
List pgsql-hackers
On Thu, Jan 25, 2024 at 9:12 AM Peter Smith <smithpb2250@gmail.com> wrote:
>
> On Tue, Jan 23, 2024 at 12:32 PM Peter Smith <smithpb2250@gmail.com> wrote:
> >
> > On Tue, Jan 23, 2024 at 12:13 PM Tom Lane <tgl@sss.pgh.pa.us> wrote:
> > >
> > > Peter Smith <smithpb2250@gmail.com> writes:
> > > > I usually the HTML documentation locally using command:
> > > > make STYLE=website html
> > > > This has been working forever, but seems to have broken due to commit
> > > > [1] having an undeclared variable.
> > >
> > > Interestingly, that still works fine for me, on RHEL8 with
> > >
> > > docbook-dtds-1.0-69.el8.noarch
> > > docbook-style-xsl-1.79.2-9.el8.noarch
> > > docbook-style-dsssl-1.79-25.el8.noarch
> > >
> > > What docbook version are you using?
> > >
> >
> > [postgres@CentOS7-x64 sgml]$ sudo yum list installed | grep docbook
> > docbook-dtds.noarch                   1.0-60.el7                 @anaconda
> > docbook-style-dsssl.noarch            1.79-18.el7                @base
> > docbook-style-xsl.noarch              1.78.1-3.el7               @anaconda
> >
>
> IIUC these releases notes [1] say autolink.index.see existed since
> v1.79.1, but unfortunately, that is more recent than my ancient
> installed v1.78.1
>
> From the release notes:
> ------
> Robert Stayton: autolink.index.see.xml
>
> New param to control automatic links in index from see and
> seealso to indexterm primary.
> ------
>
> ======
> [1] https://docbook.sourceforge.net/release/xsl/1.79.1/RELEASE-NOTES.html
>

Is anything going to be changed for this? Since the recent commit [1]
when building the docs now each time I need to first hack (e.g. either
the Makefile or stylesheet-html-common.xml) to declare the missing
‘autolink.index.see’ variable. I know that my old OS is approaching
EOL but I thought my docbook installation was still valid.

======
[1] https://github.com/postgres/postgres/commit/b0f0a9432d0b6f53634a96715f2666f6d4ea25a1

Kind Regards,
Peter Smith.
Fujitsu Australia



pgsql-hackers by date:

Previous
From: Nathan Bossart
Date:
Subject: Re: Optmize bitmapword macros calc (src/backend/nodes/bitmapset.c)
Next
From: Tatsuo Ishii
Date:
Subject: When extended query protocol ends?