Обсуждение: doc build error on Fedora 38

Hi,

I'm getting the following errors while building PDF docs on Fedora 38
(and works fine on Fedora 37). This is how I build them:

./configure
cd doc/src/sgml/
make postgres-A4.pdf

and getting the following errors. Google did not help me that much. This
is libxml2-2.10.3 and libxslt 1.1.37 (same on Fedora 37).


========================================================================
{ \
  echo "<!ENTITY version \"16devel\">"; \
  echo "<!ENTITY majorversion \"16\">"; \
} > version.sgml
'/usr/bin/perl' ./mk_feature_tables.pl YES
../../../src/backend/catalog/sql_feature_packages.txt
../../../src/backend/catalog/sql_features.txt > features-supported.sgml
'/usr/bin/perl' ./mk_feature_tables.pl NO
../../../src/backend/catalog/sql_feature_packages.txt
../../../src/backend/catalog/sql_features.txt > features-
unsupported.sgml
'/usr/bin/perl' ./generate-errcodes-table.pl
../../../src/backend/utils/errcodes.txt > errcodes-table.sgml
'/usr/bin/perl' ./generate-keywords-table.pl . > keywords-table.sgml
/usr/bin/xmllint --nonet --path . --path . --output postgres-full.xml --
noent --valid postgres.sgml
I/O error : Attempt to load network entity
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
postgres.sgml:21: warning: failed to load external entity
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
]>
  ^
postgres.sgml:23: element book: validity error : No declaration for
attribute id of element book
<book id="postgres">
                   ^
postgres.sgml:24: element title: validity error : No declaration for
element title
 <title>PostgreSQL &version; Documentation</title>
                                                  ^
postgres.sgml:27: element corpauthor: validity error : No declaration
for element corpauthor
  <corpauthor>The PostgreSQL Global Development Group</corpauthor>
                                                                  ^
postgres.sgml:28: element productname: validity error : No declaration
for element productname
  <productname>PostgreSQL</productname>
                                       ^
postgres.sgml:29: element productnumber: validity error : No declaration
for element productnumber
  <productnumber>&version;</productnumber>
                                          ^
postgres.sgml:3: element date: validity error : No declaration for
element date
legal.sgml:6: parser error : Entity 'ndash' not defined
 <year>1996–2023</year>
                  ^
legal.sgml:14: parser error : Entity 'copy' not defined
  <productname>PostgreSQL</productname> is Copyright ©
1996–2023
                                                           ^
legal.sgml:14: parser error : Entity 'ndash' not defined
  <productname>PostgreSQL</productname> is Copyright ©
1996–2023
                                                                       ^
legal.sgml:19: parser error : Entity 'copy' not defined
  <productname>Postgres95</productname> is Copyright © 1994–5
                                                           ^
legal.sgml:19: parser error : Entity 'ndash' not defined
  <productname>Postgres95</productname> is Copyright © 1994–5
                                                                       ^
legal.sgml:49: parser error : chunk is not well balanced

^
postgres.sgml:30: parser error : Entity 'legal' failed to parse
  &legal;
         ^
make: *** [Makefile:73: postgres-full.xml] Error 1

========================================================================

Any ideas?

Regards,
--
Devrim Gündüz
Open Source Solution Architect, PostgreSQL Major Contributor
Twitter: @DevrimGunduz , @DevrimGunduzTR

On Thu, 2023-04-06 at 11:41 +0100, Devrim Gündüz wrote:
> I'm getting the following errors while building PDF docs on Fedora 38
> (and works fine on Fedora 37). This is how I build them:
>
> ./configure
> cd doc/src/sgml/
> make postgres-A4.pdf
>
> and getting the following errors. Google did not help me that much. This
> is libxml2-2.10.3 and libxslt 1.1.37 (same on Fedora 37).
>
> [...]
> I/O error : Attempt to load network entity
> http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
> [...]

Not sure if that helps, but could it simply be a problem accessing
the network?

Yours,
Laurenz Albe

Hi,

On Thu, 2023-04-06 at 13:10 +0200, Laurenz Albe wrote:
> Not sure if that helps, but could it simply be a problem accessing
> the network?

Not sure. I can download and install all other tarballs, packages, etc.

Regards,
--
Devrim Gündüz
Open Source Solution Architect, PostgreSQL Major Contributor
Twitter: @DevrimGunduz , @DevrimGunduzTR

Hi Julien,

On Thu, 2023-04-06 at 20:18 +0800, Julien Rouhaud wrote:
> maybe you have a local copy of the docbook dtd on the older version?
> have
> you installed the required packages for that now that those files are
> available only via https, which isn't supported by any tool?
> https://www.postgresql.org/docs/15/docguide-toolsets.html#id-1.11.11.5.5

:-( Indeed, that is the problem. Apparently my script failed to install
docbook-dtds adn docbook-style-xsl  while building Fedora 38 box. 

Thanks!

Regards,
--
Devrim Gündüz
Open Source Solution Architect, PostgreSQL Major Contributor
Twitter: @DevrimGunduz , @DevrimGunduzTR

Devrim =?ISO-8859-1?Q?G=FCnd=FCz?= <devrim@gunduz.org> writes:
> On Thu, 2023-04-06 at 20:18 +0800, Julien Rouhaud wrote:
>> have
>> you installed the required packages for that now that those files are
>> available only via https, which isn't supported by any tool?

> :-( Indeed, that is the problem. Apparently my script failed to install
> docbook-dtds adn docbook-style-xsl  while building Fedora 38 box. 

See also this recent change:

https://git.postgresql.org/gitweb/?p=postgresql.git&a=commitdiff&h=969509c3f

Those doc changes haven't shipped yet, but the it-doesn't-work
situation has been true for awhile.

            regards, tom lane