From: Tom Lane <tgl@sss.pgh.pa.us>
To: Marcel Hofstetter <hofstetter@jomasoft.ch>
cc: pgsql-bugs@lists.postgresql.org
Subject: Re: BUG #19404: manpages are missing in 18.x source.tar.gz
In-reply-to: <7e8fb3c4-0c60-40f3-ad25-50795de3b06d@jomasoft.ch>
References: <19404-b4e0349be603f15d@postgresql.org> <297967.1770917125@sss.pgh.pa.us> <7e8fb3c4-0c60-40f3-ad25-50795de3b06d@jomasoft.ch>
Comments: In-reply-to Marcel Hofstetter <hofstetter@jomasoft.ch>
	message dated "Thu, 12 Feb 2026 18:33:16 +0100"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <302684.1770919394.1@sss.pgh.pa.us>
Content-Transfer-Encoding: quoted-printable
Date: Thu, 12 Feb 2026 13:03:14 -0500
Message-ID: <302685.1770919394@sss.pgh.pa.us>
Archived-At: <https://www.postgresql.org/message-id/302685.1770919394%40sss.pgh.pa.us>
Precedence: bulk

Marcel Hofstetter <hofstetter@jomasoft.ch> writes:
> gmake man fails with v18

> -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'
> 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

Are you working with somebody's modified version of the PG
distribution?  The commands generated by "make man" look nothing
like that here:

$ make man
make -C doc man
make[1]: Entering directory '/home/postgres/REL_18/pgsql/doc'
make -C src man
make[2]: Entering directory '/home/postgres/REL_18/pgsql/doc/src'
make -C sgml man
make[3]: Entering directory '/home/postgres/REL_18/pgsql/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/sq=
l_feature_packages.txt ../../../src/backend/catalog/sql_features.txt > fea=
tures-supported.sgml
'/usr/bin/perl' ./mk_feature_tables.pl NO ../../../src/backend/catalog/sql=
_feature_packages.txt ../../../src/backend/catalog/sql_features.txt > feat=
ures-unsupported.sgml
'/usr/bin/perl' ./generate-errcodes-table.pl ../../../src/backend/utils/er=
rcodes.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-tar=
gets-meson.pl > targets-meson.sgml
'/usr/bin/perl' ../../../src/backend/utils/activity/generate-wait_event_ty=
pes.pl --docs ../../../src/backend/utils/activity/wait_event_names.txt
/usr/bin/xmllint --nonet --path . --path . --output postgres-full.xml --no=
ent --valid postgres.sgml
/usr/bin/xsltproc --nonet --path . --path . --stringparam pg.version '18.2=
'  stylesheet-man.xsl postgres-full.xml
touch man-stamp
make[3]: Leaving directory '/home/postgres/REL_18/pgsql/doc/src/sgml'
make[2]: Leaving directory '/home/postgres/REL_18/pgsql/doc/src'
make[1]: Leaving directory '/home/postgres/REL_18/pgsql/doc'

It's that way for quite a few versions before v18, too.

			regards, tom lane