From: Tom Lane <tgl@sss.pgh.pa.us>
To: Aleksander Alekseev <aleksander@timescale.com>
cc: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Subject: Re: MacOS: xsltproc fails with "warning: failed to load external
 entity"
In-reply-to: 
 <CAJ7c6TNq3phiefEopG8X7ZJ7oj7kZyQdPefHM+kt=XvVPkd08Q@mail.gmail.com>
References: 
 <CAJ7c6TO8Aro2nxg=EQsVGiSDe-TstP4EsSvDHd7DSRsP40PgGA@mail.gmail.com>
 <CAJ7c6TO0mA_wPDuUT8b+DdwzUe+SBfGqHE+XXb52GrRnLWu1iQ@mail.gmail.com>
 <CAJ7c6TNq3phiefEopG8X7ZJ7oj7kZyQdPefHM+kt=XvVPkd08Q@mail.gmail.com>
Comments: In-reply-to Aleksander Alekseev <aleksander@timescale.com>
	message dated "Mon, 30 Jan 2023 14:53:25 +0300"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <489603.1675095648.1@sss.pgh.pa.us>
Content-Transfer-Encoding: quoted-printable
Date: Mon, 30 Jan 2023 11:20:48 -0500
Message-ID: <489604.1675095648@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/489604.1675095648%40sss.pgh.pa.us>
Precedence: bulk

Aleksander Alekseev <aleksander@timescale.com> writes:
>> I've found a solution:
>> =

>> ```
>> export SGML_CATALOG_FILES=3D/usr/local/etc/xml/catalog
>> export XMLLINT=3D"xmllint --catalogs"
>> export XSLTPROC=3D"xsltproc --catalogs"
>> ```

Hmm, there is no such directory on my Mac, and indeed this recipe
does not work here.  I tried to transpose it to MacPorts by
substituting /opt/local/etc/xml/catalog, which does exist --- but
the recipe still doesn't work.

I believe what is actually failing is that http://docbook.sourceforge.net
now redirects to https:, and the ancient xsltproc version provided by
Apple doesn't do https.  What you need to do if you want to use their
xsltproc is install a local copy of the SGML catalog files and
stylesheets, preferably in the place that xsltproc would look by default
(/etc/xml/catalog seems to be the standard one).  It would be good to
document how to do that, but this patch doesn't do so.

What we do actually have already is a recommendation to install
appropriate MacPorts or Homebrew packages:

https://www.postgresql.org/docs/devel/docguide-toolsets.html#DOCGUIDE-TOOL=
SETS-INST-MACOS

and it works okay for me as long as I use MacPorts' version of xsltproc.

			regards, tom lane