public inbox for [email protected]  
help / color / mirror / Atom feed
From: Bruce Momjian <[email protected]>
To: PostgreSQL-documentation <[email protected]>
Cc: Andres Freund <[email protected]>
Subject: INSTALL.html build error
Date: Thu, 29 Mar 2018 07:55:37 -0400
Message-ID: <[email protected]> (raw)

I see the following build error in git head:

	$ make INSTALL.html
	/usr/bin/xmllint --noout --valid INSTALL.xml
	INSTALL.xml:721: element xref: validity error : IDREF attribute linkend references an unknown ID "jit"
	Makefile:115: recipe for target 'INSTALL.html' failed
	make: *** [INSTALL.html] Error 4

There are restrictions on what the INSTALL file can reference.  It is
explained in installation.sgml:

	The standalone version has some portions that are different from the
	version that is integrated into the full documentation set, in
	particular as regards links, so that INSTALL.html can be created without
	links to the main documentation.  See standalone-profile.xsl for
	details.

and standalone-profile.xsl has:

	To omit something in the stand-alone INSTALL file, give the element a
	condition="standalone-ignore" attribute.

I have fixed it by using "standalone-ignore" in the attached, applied
patch.

-- 
  Bruce Momjian  <[email protected]>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +


Attachments:

  [text/x-diff] xml.diff (1.1K, 2-xml.diff)
  download | inline diff:
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
new file mode 100644
index 30921cf..7a7823b
*** a/doc/src/sgml/installation.sgml
--- b/doc/src/sgml/installation.sgml
*************** su - postgres
*** 763,769 ****
         <listitem>
          <para>
           Build with support for <productname>LLVM</productname> based
!          <acronym>JIT</acronym> compilation (see <xref linkend="jit"/>).  This
           requires the <productname>LLVM</productname> library to be installed.
           The minimum required version of <productname>LLVM</productname> is
           currently 3.9.
--- 763,771 ----
         <listitem>
          <para>
           Build with support for <productname>LLVM</productname> based
!          <acronym>JIT</acronym> compilation<phrase
!          condition="standalone-ignore"> (see <xref
!          linkend="jit"/>)</phrase>.  This
           requires the <productname>LLVM</productname> library to be installed.
           The minimum required version of <productname>LLVM</productname> is
           currently 3.9.


reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: INSTALL.html build error
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox