pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feed17beta1 source download does not include docs & manpages
7+ messages / 3 participants
[nested] [flat]
* 17beta1 source download does not include docs & manpages
@ 2024-05-28 12:15 Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-28 18:42 ` Re: 17beta1 source download does not include docs & manpages Erik Wienhold <ewie@ewie.name>
0 siblings, 1 reply; 7+ messages in thread
From: Marcel Hofstetter @ 2024-05-28 12:15 UTC (permalink / raw)
To: pgsql-docs@lists.postgresql.org
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: 17beta1 source download does not include docs & manpages
2024-05-28 12:15 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
@ 2024-05-28 18:42 ` Erik Wienhold <ewie@ewie.name>
2024-05-28 19:02 ` Re: 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
0 siblings, 1 reply; 7+ messages in thread
From: Erik Wienhold @ 2024-05-28 18:42 UTC (permalink / raw)
To: Marcel Hofstetter <hofstetter@jomasoft.ch>; +Cc: pgsql-docs@lists.postgresql.org
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: 17beta1 source download does not include docs & manpages
2024-05-28 12:15 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-28 18:42 ` Re: 17beta1 source download does not include docs & manpages Erik Wienhold <ewie@ewie.name>
@ 2024-05-28 19:02 ` Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-28 19:53 ` Re: 17beta1 source download does not include docs & manpages Erik Wienhold <ewie@ewie.name>
0 siblings, 1 reply; 7+ messages in thread
From: Marcel Hofstetter @ 2024-05-28 19:02 UTC (permalink / raw)
To: Erik Wienhold <ewie@ewie.name>; +Cc: pgsql-docs@lists.postgresql.org
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: 17beta1 source download does not include docs & manpages
2024-05-28 12:15 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-28 18:42 ` Re: 17beta1 source download does not include docs & manpages Erik Wienhold <ewie@ewie.name>
2024-05-28 19:02 ` Re: 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
@ 2024-05-28 19:53 ` Erik Wienhold <ewie@ewie.name>
2024-05-29 06:53 ` Re: 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
0 siblings, 1 reply; 7+ messages in thread
From: Erik Wienhold @ 2024-05-28 19:53 UTC (permalink / raw)
To: Marcel Hofstetter <hofstetter@jomasoft.ch>; +Cc: pgsql-docs@lists.postgresql.org
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: 17beta1 source download does not include docs & manpages
2024-05-28 12:15 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-28 18:42 ` Re: 17beta1 source download does not include docs & manpages Erik Wienhold <ewie@ewie.name>
2024-05-28 19:02 ` Re: 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-28 19:53 ` Re: 17beta1 source download does not include docs & manpages Erik Wienhold <ewie@ewie.name>
@ 2024-05-29 06:53 ` Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-29 16:32 ` Re: 17beta1 source download does not include docs & manpages Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 1 reply; 7+ messages in thread
From: Marcel Hofstetter @ 2024-05-29 06:53 UTC (permalink / raw)
To: Erik Wienhold <ewie@ewie.name>; +Cc: pgsql-docs@lists.postgresql.org
>> '/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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: 17beta1 source download does not include docs & manpages
2024-05-28 12:15 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-28 18:42 ` Re: 17beta1 source download does not include docs & manpages Erik Wienhold <ewie@ewie.name>
2024-05-28 19:02 ` Re: 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-28 19:53 ` Re: 17beta1 source download does not include docs & manpages Erik Wienhold <ewie@ewie.name>
2024-05-29 06:53 ` Re: 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
@ 2024-05-29 16:32 ` Tom Lane <tgl@sss.pgh.pa.us>
2024-05-30 11:14 ` Re: 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
0 siblings, 1 reply; 7+ messages in thread
From: Tom Lane @ 2024-05-29 16:32 UTC (permalink / raw)
To: Marcel Hofstetter <hofstetter@jomasoft.ch>; +Cc: Erik Wienhold <ewie@ewie.name>; pgsql-docs@lists.postgresql.org
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: 17beta1 source download does not include docs & manpages
2024-05-28 12:15 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-28 18:42 ` Re: 17beta1 source download does not include docs & manpages Erik Wienhold <ewie@ewie.name>
2024-05-28 19:02 ` Re: 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-28 19:53 ` Re: 17beta1 source download does not include docs & manpages Erik Wienhold <ewie@ewie.name>
2024-05-29 06:53 ` Re: 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-29 16:32 ` Re: 17beta1 source download does not include docs & manpages Tom Lane <tgl@sss.pgh.pa.us>
@ 2024-05-30 11:14 ` Marcel Hofstetter <hofstetter@jomasoft.ch>
0 siblings, 0 replies; 7+ messages in thread
From: Marcel Hofstetter @ 2024-05-30 11:14 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: Erik Wienhold <ewie@ewie.name>; pgsql-docs@lists.postgresql.org
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
^ permalink raw reply [nested|flat] 7+ messages in thread
end of thread, other threads:[~2024-05-30 11:14 UTC | newest]
Thread overview: 7+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2024-05-28 12:15 17beta1 source download does not include docs & manpages Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-28 18:42 ` Erik Wienhold <ewie@ewie.name>
2024-05-28 19:02 ` Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-28 19:53 ` Erik Wienhold <ewie@ewie.name>
2024-05-29 06:53 ` Marcel Hofstetter <hofstetter@jomasoft.ch>
2024-05-29 16:32 ` Tom Lane <tgl@sss.pgh.pa.us>
2024-05-30 11:14 ` Marcel Hofstetter <hofstetter@jomasoft.ch>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox