Re: BUG #19404: manpages are missing in 18.x source.tar.gz - Mailing list pgsql-bugs

From Tom Lane
Subject Re: BUG #19404: manpages are missing in 18.x source.tar.gz
Date
Msg-id 533713.1770999660@sss.pgh.pa.us
Whole thread Raw
In response to Re: BUG #19404: manpages are missing in 18.x source.tar.gz  (Marcel Hofstetter <hofstetter@jomasoft.ch>)
Responses Re: BUG #19404: manpages are missing in 18.x source.tar.gz
List pgsql-bugs
Marcel Hofstetter <hofstetter@jomasoft.ch> writes:
> A clean build fails as follows

I realized that the bit that's failing for you only runs when
sqlmansect is not 7 (so I guess you're on Solaris?).  However,
it's still fine here when I do

$ make man sqlmansect=5sql
...
/usr/bin/xmllint --nonet --path . --path . --output postgres-full.xml --noent --valid postgres.sgml
/usr/bin/xsltproc --nonet --path . --path . --stringparam pg.version '19devel'  stylesheet-man.xsl postgres-full.xml
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 
make[3]: Leaving directory '/home/postgres/pgsql/doc/src/sgml'

I find this part of your output suspicious though:

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

I don't see any of that here, which suggests that you're using old
docbook files.  Maybe they are old enough to just fail to emit the
man files entirely?  What I've got is not exactly new either,
since this is RHEL8:

$ rpm -qa | grep docbook
docbook-dtds-1.0-69.el8.noarch
docbook-style-xsl-1.79.2-9.el8.noarch
docbook-style-dsssl-1.79-25.el8.noarch

> It works well with the old default Solaris docbook

Interesting.  Debugging docbook problems is beyond my realm I fear.

            regards, tom lane



pgsql-bugs by date:

Previous
From: Marcel Hofstetter
Date:
Subject: Re: BUG #19404: manpages are missing in 18.x source.tar.gz
Next
From: Marcel Hofstetter
Date:
Subject: Re: BUG #19404: manpages are missing in 18.x source.tar.gz