Обсуждение: 17beta1 source download does not include docs & manpages
Hi 16.3 source download includes manpages and html docs. -bash-5.1$ tar tvf postgresql-16.3.tar | grep html | wc -l 1166 -bash-5.1$ tar tvf postgresql-16.3.tar | grep man1 | wc -l 35 17beta1 does not. -bash-5.1$ tar tvf postgresql-17beta1.tar | grep html | wc -l 3 -bash-5.1$ tar tvf postgresql-17beta1.tar | grep man1 | wc -l 0 is this intended? Thanks, Marcel Hofstetter
On 2024-05-28 14:15 +0200, Marcel Hofstetter wrote: > 16.3 source download includes manpages and html docs. > > -bash-5.1$ tar tvf postgresql-16.3.tar | grep html | wc -l > 1166 > -bash-5.1$ tar tvf postgresql-16.3.tar | grep man1 | wc -l > 35 > > > 17beta1 does not. > > -bash-5.1$ tar tvf postgresql-17beta1.tar | grep html | wc -l > 3 > -bash-5.1$ tar tvf postgresql-17beta1.tar | grep man1 | wc -l > 0 > > is this intended? Yes, that build step was removed[1] in order to only create a tarball of files in the git tree from now on. Maybe the release notes should make that more clear instead of just saying "Remove make's distprep option". [1] https://www.postgresql.org/message-id/e07408d9-e5f2-d9fd-5672-f53354e9305e%40eisentraut.org -- Erik
Am 28.05.2024 um 20:42 schrieb Erik Wienhold: > On 2024-05-28 14:15 +0200, Marcel Hofstetter wrote: >> 16.3 source download includes manpages and html docs. >> >> -bash-5.1$ tar tvf postgresql-16.3.tar | grep html | wc -l >> 1166 >> -bash-5.1$ tar tvf postgresql-16.3.tar | grep man1 | wc -l >> 35 >> >> >> 17beta1 does not. >> >> -bash-5.1$ tar tvf postgresql-17beta1.tar | grep html | wc -l >> 3 >> -bash-5.1$ tar tvf postgresql-17beta1.tar | grep man1 | wc -l >> 0 >> >> is this intended? > > Yes, that build step was removed[1] in order to only create a tarball of > files in the git tree from now on. Maybe the release notes should make > that more clear instead of just saying "Remove make's distprep option". > > [1] https://www.postgresql.org/message-id/e07408d9-e5f2-d9fd-5672-f53354e9305e%40eisentraut.org > Thanks for the feedback. Unfortunately I'm unable to produce the html files on my Solaris 11.4 CBE system (margay buildfarm member) -bash-5.1$ gmake html gmake -C doc html gmake[1]: Entering directory '/export/home/marcel/source/postgresql-17beta1/doc' gmake -C src html gmake[2]: Entering directory '/export/home/marcel/source/postgresql-17beta1/doc/src' gmake -C sgml html gmake[3]: Entering directory '/export/home/marcel/source/postgresql-17beta1/doc/src/sgml' /usr/bin/xsltproc --nonet --path . --path . --stringparam pg.version '17beta1' stylesheet.xsl postgres-full.xml runtime error: file stylesheet-common.xsl line 124 element value-of Variable 'chunk.base.dir' has not been declared. XPath error : Undefined variable runtime error: file stylesheet-common.xsl line 124 element value-of XPath evaluation returned no result. no result for postgres-full.xml gmake[3]: *** [Makefile:130: html-stamp] Error 10 gmake[3]: Leaving directory '/export/home/marcel/source/postgresql-17beta1/doc/src/sgml' gmake[2]: *** [Makefile:8: html] Error 2 gmake[2]: Leaving directory '/export/home/marcel/source/postgresql-17beta1/doc/src' gmake[1]: *** [Makefile:16: html] Error 2 gmake[1]: Leaving directory '/export/home/marcel/source/postgresql-17beta1/doc' gmake: *** [GNUmakefile:27: html] Error 2 -bash-5.1$ uname -a SunOS g0071 5.11 11.4.42.111.0 sun4v sparc sun4v logical-domain Best regards, Marcel
On 2024-05-28 21:02 +0200, Marcel Hofstetter wrote: > Unfortunately I'm unable to produce the html files on my > Solaris 11.4 CBE system (margay buildfarm member) > > -bash-5.1$ gmake html > gmake -C doc html > gmake[1]: Entering directory > '/export/home/marcel/source/postgresql-17beta1/doc' > gmake -C src html > gmake[2]: Entering directory > '/export/home/marcel/source/postgresql-17beta1/doc/src' > gmake -C sgml html > gmake[3]: Entering directory > '/export/home/marcel/source/postgresql-17beta1/doc/src/sgml' > /usr/bin/xsltproc --nonet --path . --path . --stringparam pg.version > '17beta1' stylesheet.xsl postgres-full.xml > runtime error: file stylesheet-common.xsl line 124 element value-of > Variable 'chunk.base.dir' has not been declared. > XPath error : Undefined variable What DocBook XSL stylesheet version do you have installed? The docs say that 1.77.0 is required: https://www.postgresql.org/docs/17/docguide-toolsets.html#DOCGUIDE-TOOLSETS-DOCBOOK-XSL > runtime error: file stylesheet-common.xsl line 124 element value-of > XPath evaluation returned no result. > no result for postgres-full.xml > gmake[3]: *** [Makefile:130: html-stamp] Error 10 > gmake[3]: Leaving directory > '/export/home/marcel/source/postgresql-17beta1/doc/src/sgml' > gmake[2]: *** [Makefile:8: html] Error 2 > gmake[2]: Leaving directory > '/export/home/marcel/source/postgresql-17beta1/doc/src' > gmake[1]: *** [Makefile:16: html] Error 2 > gmake[1]: Leaving directory > '/export/home/marcel/source/postgresql-17beta1/doc' > gmake: *** [GNUmakefile:27: html] Error 2 > > -bash-5.1$ uname -a > SunOS g0071 5.11 11.4.42.111.0 sun4v sparc sun4v logical-domain -- Erik
>> '/export/home/marcel/source/postgresql-17beta1/doc/src/sgml' >> /usr/bin/xsltproc --nonet --path . --path . --stringparam pg.version >> '17beta1' stylesheet.xsl postgres-full.xml >> runtime error: file stylesheet-common.xsl line 124 element value-of >> Variable 'chunk.base.dir' has not been declared. >> XPath error : Undefined variable > > What DocBook XSL stylesheet version do you have installed? The docs say > that 1.77.0 is required: > > https://www.postgresql.org/docs/17/docguide-toolsets.html#DOCGUIDE-TOOLSETS-DOCBOOK-XSL Looks like we are a bit to low on Solaris -bash-5.1$ pkg list docbook-style-xsl NAME (PUBLISHER) VERSION IFO data/docbook/docbook-style-xsl 1.75.2-11.4.42.0.0.111.0 i-- But this is currently the only available version for the public Solaris 11.4.42. Thanks, Marcel
Marcel Hofstetter <hofstetter@jomasoft.ch> writes: >> What DocBook XSL stylesheet version do you have installed? The docs say >> that 1.77.0 is required: > Looks like we are a bit to low on Solaris > -bash-5.1$ pkg list docbook-style-xsl > NAME (PUBLISHER) VERSION IFO > data/docbook/docbook-style-xsl 1.75.2-11.4.42.0.0.111.0 i-- > But this is currently the only available version for the > public Solaris 11.4.42. 1.77 was released in 2012, so it doesn't seem unreasonable for us to rely on that in 2024. I suggest downloading the stylesheets from https://github.com/docbook/wiki/wiki/DocBookXslStylesheets to someplace convenient and setting the environment variable XML_CATALOG_FILES to point there. regards, tom lane
Am 29.05.2024 um 18:32 schrieb Tom Lane: > Marcel Hofstetter <hofstetter@jomasoft.ch> writes: >>> What DocBook XSL stylesheet version do you have installed? The docs say >>> that 1.77.0 is required: > >> Looks like we are a bit to low on Solaris >> -bash-5.1$ pkg list docbook-style-xsl >> NAME (PUBLISHER) VERSION IFO >> data/docbook/docbook-style-xsl 1.75.2-11.4.42.0.0.111.0 i-- > >> But this is currently the only available version for the >> public Solaris 11.4.42. > > 1.77 was released in 2012, so it doesn't seem unreasonable for us > to rely on that in 2024. I suggest downloading the stylesheets > from https://github.com/docbook/wiki/wiki/DocBookXslStylesheets > to someplace convenient and setting the environment variable > XML_CATALOG_FILES to point there. I downloaded docbook-xsl 1.79.1 and now I'm able to produce the html docs on Solaris. Thanks! Marcel