Snapshots no longer build

On 29 January 2011 11:12, Magnus Hagander <magnus@hagander.net> wrote:

The snapshot builds are failing with:

openjade:installation.sgml:1010:58:X: reference to non-existent ID "UUID-OSSP"
openjade:installation.sgml:1044:54:X: reference to non-existent ID "XML2"
openjade:/usr/local/share/sgml/docbook/dsssl/modular/html/dblink.dsl:203:1:E:
XRef LinkEnd to missing ID 'UUID-OSSP'
openjade:/usr/local/share/sgml/docbook/dsssl/modular/html/dblink.dsl:203:1:E:
XRef LinkEnd to missing ID 'XML2'
gmake[1]: *** [INSTALL.html] Error 1
gmake[1]: *** Deleting file `INSTALL.html'
gmake: *** [distdir] Error 2

Looks like it's because of 159e3d86292cfec2a2828f9f69ac7a6cb1be242d.

Any idea why this is happening?

I don't know what's causing that since I can see both of those IDs are
present, but I should also mention that the identities those linkends
point to should have xreflabel attributes. At the moment, it's
reading: "Use the OSSP UUID library when building the Section F.44
module"

--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935

Magnus Hagander <magnus@hagander.net> writes:

The snapshot builds are failing with:
openjade:installation.sgml:1010:58:X: reference to non-existent ID "UUID-OSSP"
openjade:installation.sgml:1044:54:X: reference to non-existent ID "XML2"
openjade:/usr/local/share/sgml/docbook/dsssl/modular/html/dblink.dsl:203:1:E:
XRef LinkEnd to missing ID 'UUID-OSSP'

Any idea why this is happening?

Bruce forgot that installation.sgml has to be buildable standalone
("make INSTALL" target).

regards, tom lane

Thom Brown <thom@linux.com> writes:

On 29 January 2011 11:12, Magnus Hagander <magnus@hagander.net> wrote:

Any idea why this is happening?

I don't know what's causing that since I can see both of those IDs are
present, but I should also mention that the identities those linkends
point to should have xreflabel attributes. At the moment, it's
reading: "Use the OSSP UUID library when building the Section F.44
module"

Yeah, that is pretty icky, and Bruce introduced similar unpleasantness
in a bunch of places. I'm unsure that xreflabel is a good fix, though,
because there are other places where the wording is such that a
chapter/section number reference *is* appropriate, eg a parenthetical
cross-reference "(see <xref>)".

I think what we might need is to use <link linkend="xml2">xml2</link>
in the places where we want the xref to read as an incidental hyperlink
rather than a cross-reference. Comments?

regards, tom lane

On 29 January 2011 17:58, Tom Lane <tgl@sss.pgh.pa.us> wrote:

Thom Brown <thom@linux.com> writes:

On 29 January 2011 11:12, Magnus Hagander <magnus@hagander.net> wrote:

Any idea why this is happening?

I don't know what's causing that since I can see both of those IDs are
present, but I should also mention that the identities those linkends
point to should have xreflabel attributes.  At the moment, it's
reading: "Use the OSSP UUID library when building the Section F.44
module"

Yeah, that is pretty icky, and Bruce introduced similar unpleasantness
in a bunch of places.  I'm unsure that xreflabel is a good fix, though,
because there are other places where the wording is such that a
chapter/section number reference *is* appropriate, eg a parenthetical
cross-reference "(see <xref>)".

Okay, I see why that's a problem.

I think what we might need is to use <link linkend="xml2">xml2</link>
in the places where we want the xref to read as an incidental hyperlink
rather than a cross-reference.  Comments?

Sure, that would work.

--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935

On Sat, Jan 29, 2011 at 18:33, Tom Lane <tgl@sss.pgh.pa.us> wrote:

Magnus Hagander <magnus@hagander.net> writes:

The snapshot builds are failing with:
openjade:installation.sgml:1010:58:X: reference to non-existent ID "UUID-OSSP"
openjade:installation.sgml:1044:54:X: reference to non-existent ID "XML2"
openjade:/usr/local/share/sgml/docbook/dsssl/modular/html/dblink.dsl:203:1:E:
XRef LinkEnd to missing ID 'UUID-OSSP'

Any idea why this is happening?

Bruce forgot that installation.sgml has to be buildable standalone
("make INSTALL" target).

Yup, that fixed it. Thanks - nagios is green and happy again.

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

Tom Lane wrote:

Thom Brown <thom@linux.com> writes:

On 29 January 2011 11:12, Magnus Hagander <magnus@hagander.net> wrote:

Any idea why this is happening?

I don't know what's causing that since I can see both of those IDs are
present, but I should also mention that the identities those linkends
point to should have xreflabel attributes. At the moment, it's
reading: "Use the OSSP UUID library when building the Section F.44
module"

Yeah, that is pretty icky, and Bruce introduced similar unpleasantness
in a bunch of places. I'm unsure that xreflabel is a good fix, though,
because there are other places where the wording is such that a
chapter/section number reference *is* appropriate, eg a parenthetical
cross-reference "(see <xref>)".

I think what we might need is to use <link linkend="xml2">xml2</link>
in the places where we want the xref to read as an incidental hyperlink
rather than a cross-reference. Comments?

Agreed, thanks. I did forget about that INSTALL build requiremnt. We do
mention the requirement in release.sgml.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ It's impossible for everything to be true. +