Re: BUG #19404: manpages are missing in 18.x source.tar.gz

From: Marcel Hofstetter <hofstetter(at)jomasoft(dot)ch>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: pgsql-bugs(at)lists(dot)postgresql(dot)org
Subject: Re: BUG #19404: manpages are missing in 18.x source.tar.gz
Date: 2026-02-13 10:44:56
Message-ID: 921d18fd-ca9e-48a3-a67e-2d1274141af2@jomasoft.ch
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-bugs

>
> Are you working with somebody's modified version of the PG
> distribution?

No. source download from yesterday.

I use the follow docbook.

-bash-5.1$ export
XML_CATALOG_FILES="/export/home/marcel/docbook-xsl-ns-1.79.1/catalog.xml
/etc/xml/catalog"

A clean build fails as follows

-bash-5.1$ gmake man
gmake -C doc man
gmake[1]: Entering directory
'/export/home/marcel/source/postgresql-18.2/doc'
gmake -C src man
gmake[2]: Entering directory
'/export/home/marcel/source/postgresql-18.2/doc/src'
gmake -C sgml man
gmake[3]: Entering directory
'/export/home/marcel/source/postgresql-18.2/doc/src/sgml'
{ \
echo "<!ENTITY version \"18.2\">"; \
echo "<!ENTITY majorversion \"18\">"; \
} > 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/perl' ./generate-targets-meson.pl targets-meson.txt
generate-targets-meson.pl > targets-meson.sgml
'/usr/bin/perl'
../../../src/backend/utils/activity/generate-wait_event_types.pl --docs
../../../src/backend/utils/activity/wait_event_names.txt
/usr/bin/xmllint --nonet --path . --path . --output postgres-full.xml
--noent --valid postgres.sgml
/usr/bin/xsltproc --nonet --path . --path . --stringparam pg.version
'18.2' stylesheet-man.xsl postgres-full.xml
Note: namesp. add : added namespace before processing
PostgreSQL 18.2 Documentation
Element div in namespace '' encountered in td, but no template matches.
Element div in namespace '' encountered in td, but no template matches.
Element div in namespace '' encountered in td, but no template matches.
Element acronym in namespace '' encountered in td, but no template matches.
touch man-stamp
for file in man1/*.1; do sed -e '/^\.TH/s/"7"/"5sql"/' -e
's/\\fR(7)/\\fR(5)/g' -e '1s/^\.so man7/.so
man5/g;1s/^\(\.so.*\)\.7$/\1.5sql/g' $file >fixedman/man1/`basename
$file` || exit; done
Can't open man1/*.1
gmake[3]: *** [Makefile:250: fixed-man-stamp] Error 1
gmake[3]: Leaving directory
'/export/home/marcel/source/postgresql-18.2/doc/src/sgml'
gmake[2]: *** [Makefile:8: man] Error 2
gmake[2]: Leaving directory
'/export/home/marcel/source/postgresql-18.2/doc/src'
gmake[1]: *** [Makefile:16: man] Error 2
gmake[1]: Leaving directory '/export/home/marcel/source/postgresql-18.2/doc'
gmake: *** [GNUmakefile:27: man] Error 2

It works well with the old default Solaris docbook

-bash-5.1$ ls -l /usr/share/sgml/docbook/ | grep xsl-style
lrwxrwxrwx 1 root root 22 May 27 2024 xsl-stylesheets ->
xsl-stylesheets-1.75.2
drwxr-xr-x 23 root sys 27 May 27 2024 xsl-stylesheets-1.75.2

-bash-5.1$ unset XML_CATALOG_FILES

-bash-5.1$ gmake man
gmake -C doc man
gmake[1]: Entering directory
'/export/home/marcel/source/postgresql-18.2/doc'
gmake -C src man
gmake[2]: Entering directory
'/export/home/marcel/source/postgresql-18.2/doc/src'
gmake -C sgml man
gmake[3]: Entering directory
'/export/home/marcel/source/postgresql-18.2/doc/src/sgml'
{ \
echo "<!ENTITY version \"18.2\">"; \
echo "<!ENTITY majorversion \"18\">"; \
} > 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/perl' ./generate-targets-meson.pl targets-meson.txt
generate-targets-meson.pl > targets-meson.sgml
'/usr/bin/perl'
../../../src/backend/utils/activity/generate-wait_event_types.pl --docs
../../../src/backend/utils/activity/wait_event_names.txt
/usr/bin/xmllint --nonet --path . --path . --output postgres-full.xml
--noent --valid postgres.sgml
/usr/bin/xsltproc --nonet --path . --path . --stringparam pg.version
'18.2' stylesheet-man.xsl postgres-full.xml
Element sup in namespace '' encountered in td, but no template matches.
Element sup in namespace '' encountered in td, but no template matches.
Element sup in namespace '' encountered in td, but no template matches.
Element sup in namespace '' encountered in td, but no template matches.
Element sup in namespace '' encountered in td, but no template matches.
Element sup in namespace '' encountered in td, but no template matches.
Element sup in namespace '' encountered in td, but no template matches.
Element sup in namespace '' encountered in td, but no template matches.
Element sup in namespace '' encountered in td, but no template matches.
touch man-stamp
for file in man1/*.1; do sed -e '/^\.TH/s/"7"/"5sql"/' -e
's/\\fR(7)/\\fR(5)/g' -e '1s/^\.so man7/.so
man5/g;1s/^\(\.so.*\)\.7$/\1.5sql/g' $file >fixedman/man1/`basename
$file` || exit; done
for file in man3/*.3; do sed -e '/^\.TH/s/"7"/"5sql"/' -e
's/\\fR(7)/\\fR(5)/g' -e '1s/^\.so man7/.so
man5/g;1s/^\(\.so.*\)\.7$/\1.5sql/g' $file >fixedman/man3/`basename
$file` || exit; done
for file in man7/*.7; do sed -e '/^\.TH/s/"7"/"5sql"/' -e
's/\\fR(7)/\\fR(5)/g' -e '1s/^\.so man7/.so
man5/g;1s/^\(\.so.*\)\.7$/\1.5sql/g' $file >fixedman/man5/`basename
$file | sed s/\.7$/.5sql/` || exit; done
gmake[3]: Leaving directory
'/export/home/marcel/source/postgresql-18.2/doc/src/sgml'
gmake[2]: Leaving directory
'/export/home/marcel/source/postgresql-18.2/doc/src'
gmake[1]: Leaving directory '/export/home/marcel/source/postgresql-18.2/doc'

In response to

Responses

Browse pgsql-bugs by date

  From Date Subject
Next Message Tom Lane 2026-02-13 16:21:00 Re: BUG #19404: manpages are missing in 18.x source.tar.gz
Previous Message PG Bug reporting form 2026-02-13 09:02:37 BUG #19407: pg_dump : DROP RULE creates forward references