doc build error on Fedora 38

Started by Devrim GÜNDÜZabout 3 years ago6 messagesdocs
Jump to latest
#1Devrim GÜNDÜZ
devrim@gunduz.org

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&quot;
]>
^
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&ndash;2023</year>
^
legal.sgml:14: parser error : Entity 'copy' not defined
<productname>PostgreSQL</productname> is Copyright &copy;
1996&ndash;2023
^
legal.sgml:14: parser error : Entity 'ndash' not defined
<productname>PostgreSQL</productname> is Copyright &copy;
1996&ndash;2023
^
legal.sgml:19: parser error : Entity 'copy' not defined
<productname>Postgres95</productname> is Copyright &copy; 1994&ndash;5
^
legal.sgml:19: parser error : Entity 'ndash' not defined
<productname>Postgres95</productname> is Copyright &copy; 1994&ndash;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

#2Laurenz Albe
laurenz.albe@cybertec.at
In reply to: Devrim GÜNDÜZ (#1)
Re: doc build error on Fedora 38

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

#3Devrim GÜNDÜZ
devrim@gunduz.org
In reply to: Laurenz Albe (#2)
Re: doc build error on Fedora 38

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

#4Julien Rouhaud
rjuju123@gmail.com
In reply to: Devrim GÜNDÜZ (#3)
Re: doc build error on Fedora 38

On Thu, 6 Apr 2023, 19:11 Devrim Gündüz, <devrim@gunduz.org> wrote:

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.

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

Show quoted text
#5Devrim GÜNDÜZ
devrim@gunduz.org
In reply to: Julien Rouhaud (#4)
Re: doc build error on Fedora 38

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

#6Tom Lane
tgl@sss.pgh.pa.us
In reply to: Devrim GÜNDÜZ (#5)
Re: doc build error on Fedora 38

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&amp;a=commitdiff&amp;h=969509c3f

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

regards, tom lane