Обсуждение: pgsql: Doc: un-break PDF build.

Поиск
Список
Период
Сортировка

pgsql: Doc: un-break PDF build.

От
Tom Lane
Дата:
Doc: un-break PDF build.

Oversight in 5c4c7efad: gotta adjust the cell height for removal of
an entry.  Per buildfarm.

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/798394c6ccdada517c3508047a865d9994bfe25f

Modified Files
--------------
doc/src/sgml/gin.sgml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)


Re: pgsql: Doc: un-break PDF build.

От
Bruce Momjian
Дата:
Thanks, I missed that issue.

---------------------------------------------------------------------------

On Sat, Nov 25, 2023 at 01:03:11AM +0000, Tom Lane wrote:
> Doc: un-break PDF build.
> 
> Oversight in 5c4c7efad: gotta adjust the cell height for removal of
> an entry.  Per buildfarm.
> 
> Branch
> ------
> master
> 
> Details
> -------
> https://git.postgresql.org/pg/commitdiff/798394c6ccdada517c3508047a865d9994bfe25f
> 
> Modified Files
> --------------
> doc/src/sgml/gin.sgml | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
> 


-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.



Re: pgsql: Doc: un-break PDF build.

От
Bruce Momjian
Дата:
On Fri, Nov 24, 2023 at 08:16:12PM -0500, Bruce Momjian wrote:
> 
> Thanks, I missed that issue.

Can someone tell me how you saw that warning in the build farm?  I don't
see it in with a make check or a build of the docs.

Attached is the patch that fixed it.

---------------------------------------------------------------------------

> 
> On Sat, Nov 25, 2023 at 01:03:11AM +0000, Tom Lane wrote:
> > Doc: un-break PDF build.
> > 
> > Oversight in 5c4c7efad: gotta adjust the cell height for removal of
> > an entry.  Per buildfarm.
> > 
> > Branch
> > ------
> > master
> > 
> > Details
> > -------
> > https://git.postgresql.org/pg/commitdiff/798394c6ccdada517c3508047a865d9994bfe25f
> > 
> > Modified Files
> > --------------
> > doc/src/sgml/gin.sgml | 2 +-
> > 1 file changed, 1 insertion(+), 1 deletion(-)
> > 
> 
> 
> -- 
>   Bruce Momjian  <bruce@momjian.us>        https://momjian.us
>   EDB                                      https://enterprisedb.com
> 
>   Only you can decide what is important to you.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.

Вложения

Re: pgsql: Doc: un-break PDF build.

От
Tom Lane
Дата:
Bruce Momjian <bruce@momjian.us> writes:
> Can someone tell me how you saw that warning in the build farm?  I don't
> see it in with a make check or a build of the docs.

Yeah, for some reason it only shows up when building PDFs.

https://buildfarm.postgresql.org/cgi-bin/show_log.pl?nm=alabio&dt=2023-11-25%2000%3A02%3A10

            regards, tom lane



Re: pgsql: Doc: un-break PDF build.

От
Bruce Momjian
Дата:
On Sat, Nov 25, 2023 at 10:50:10AM -0500, Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > Can someone tell me how you saw that warning in the build farm?  I don't
> > see it in with a make check or a build of the docs.
> 
> Yeah, for some reason it only shows up when building PDFs.
> 
> https://buildfarm.postgresql.org/cgi-bin/show_log.pl?nm=alabio&dt=2023-11-25%2000%3A02%3A10

Odd, I don't see that here.  Maybe I need an upgraded toolchain:

    $ make postgres-A4.pdf 2>&1 | grep -v INFO
    /usr/bin/xsltproc --nonet --path . --path . --stringparam pg.version '17devel' --stringparam img.src.path './'
--stringparampaper.type A4 -o postgres-A4.fo stylesheet-fo.xsl postgres-full.xml
 
    Making portrait pages on A4 paper (210mmx297mm)
    /usr/bin/fop -fo postgres-A4.fo -pdf postgres-A4.pdf
    [warning] /usr/bin/fop: JVM flavor 'sun' not understood
    [WARN] FOUserAgent - Font "Symbol,normal,700" not found. Substituting with "Symbol,normal,400".
    [WARN] FOUserAgent - Font "ZapfDingbats,normal,700" not found. Substituting with "ZapfDingbats,normal,400".
    [WARN] PropertyMaker - span="inherit" on fo:block, but no explicit value found on the parent FO.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.



Re: pgsql: Doc: un-break PDF build.

От
Tom Lane
Дата:
Bruce Momjian <bruce@momjian.us> writes:
> On Sat, Nov 25, 2023 at 10:50:10AM -0500, Tom Lane wrote:
>> Yeah, for some reason it only shows up when building PDFs.
>> https://buildfarm.postgresql.org/cgi-bin/show_log.pl?nm=alabio&dt=2023-11-25%2000%3A02%3A10

> Odd, I don't see that here.  Maybe I need an upgraded toolchain:

Hmm, I did see it here, using fop 2.5 and docbook 1.79.

            regards, tom lane



Re: pgsql: Doc: un-break PDF build.

От
Bruce Momjian
Дата:
On Sat, Nov 25, 2023 at 11:26:16AM -0500, Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > On Sat, Nov 25, 2023 at 10:50:10AM -0500, Tom Lane wrote:
> >> Yeah, for some reason it only shows up when building PDFs.
> >> https://buildfarm.postgresql.org/cgi-bin/show_log.pl?nm=alabio&dt=2023-11-25%2000%3A02%3A10
> 
> > Odd, I don't see that here.  Maybe I need an upgraded toolchain:
> 
> Hmm, I did see it here, using fop 2.5 and docbook 1.79.

Uh, I have on Debian 12 (bookworm):

    fop is 2.8
    ii  fop                                      1:2.8-2                                 all          XML formatter
drivenby XSL Formatting Objects (XSL-FO.) - app
 
    ii  libfop-java                              1:2.8-2                                 all          XML formatter
drivenby XSL Formatting Objects (XSL-FO.) - libs
 
    
    docbook is 1.79
    ii  docbook                                  4.5-10                                  all          standard SGML
representationsystem for technical documents
 
    ii  docbook-dsssl                            1.79-10                                 all          modular DocBook
DSSSLstylesheets, for print and HTML
 
    ii  docbook-xml                              4.5-12                                  all          standard XML
documentationsystem for software and systems
 
    ii  docbook-xsl                              1.79.2+dfsg-2                           all          stylesheets for
processingDocBook XML to various output formats
 
    ii  docbook-xsl-doc-html                     1.79.1-1                                all          stylesheets for
processingDocBook XML files (HTML documentation)
 

Kind of odd I don't see it the error.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.



Re: pgsql: Doc: un-break PDF build.

От
Andrew Dunstan
Дата:
On 2023-11-25 Sa 11:34, Bruce Momjian wrote:
> On Sat, Nov 25, 2023 at 11:26:16AM -0500, Tom Lane wrote:
>> Bruce Momjian <bruce@momjian.us> writes:
>>> On Sat, Nov 25, 2023 at 10:50:10AM -0500, Tom Lane wrote:
>>>> Yeah, for some reason it only shows up when building PDFs.
>>>> https://buildfarm.postgresql.org/cgi-bin/show_log.pl?nm=alabio&dt=2023-11-25%2000%3A02%3A10
>>> Odd, I don't see that here.  Maybe I need an upgraded toolchain:
>> Hmm, I did see it here, using fop 2.5 and docbook 1.79.
> Uh, I have on Debian 12 (bookworm):
>
>     fop is 2.8
>     ii  fop                                      1:2.8-2                                 all          XML formatter
drivenby XSL Formatting Objects (XSL-FO.) - app
 
>     ii  libfop-java                              1:2.8-2                                 all          XML formatter
drivenby XSL Formatting Objects (XSL-FO.) - libs
 
>     
>     docbook is 1.79
>     ii  docbook                                  4.5-10                                  all          standard SGML
representationsystem for technical documents
 
>     ii  docbook-dsssl                            1.79-10                                 all          modular DocBook
DSSSLstylesheets, for print and HTML
 
>     ii  docbook-xml                              4.5-12                                  all          standard XML
documentationsystem for software and systems
 
>     ii  docbook-xsl                              1.79.2+dfsg-2                           all          stylesheets for
processingDocBook XML to various output formats
 
>     ii  docbook-xsl-doc-html                     1.79.1-1                                all          stylesheets for
processingDocBook XML files (HTML documentation)
 
>
> Kind of odd I don't see it the error.
>

What command are you invoking to build the docs? The default docs make 
target doesn't build the PDFs - you have to build those explicitly.


cheers


andrew

--
Andrew Dunstan
EDB: https://www.enterprisedb.com




Re: pgsql: Doc: un-break PDF build.

От
Bruce Momjian
Дата:
On Sat, Nov 25, 2023 at 02:14:11PM -0500, Andrew Dunstan wrote:
> 
> On 2023-11-25 Sa 11:34, Bruce Momjian wrote:
> > On Sat, Nov 25, 2023 at 11:26:16AM -0500, Tom Lane wrote:
> > > Bruce Momjian <bruce@momjian.us> writes:
> > > > On Sat, Nov 25, 2023 at 10:50:10AM -0500, Tom Lane wrote:
> > > > > Yeah, for some reason it only shows up when building PDFs.
> > > > > https://buildfarm.postgresql.org/cgi-bin/show_log.pl?nm=alabio&dt=2023-11-25%2000%3A02%3A10
> > > > Odd, I don't see that here.  Maybe I need an upgraded toolchain:
> > > Hmm, I did see it here, using fop 2.5 and docbook 1.79.
> > Uh, I have on Debian 12 (bookworm):
> > 
> >     fop is 2.8
> >     ii  fop                                      1:2.8-2                                 all          XML formatter
drivenby XSL Formatting Objects (XSL-FO.) - app
 
> >     ii  libfop-java                              1:2.8-2                                 all          XML formatter
drivenby XSL Formatting Objects (XSL-FO.) - libs
 
> >     
> >     docbook is 1.79
> >     ii  docbook                                  4.5-10                                  all          standard SGML
representationsystem for technical documents
 
> >     ii  docbook-dsssl                            1.79-10                                 all          modular
DocBookDSSSL stylesheets, for print and HTML
 
> >     ii  docbook-xml                              4.5-12                                  all          standard XML
documentationsystem for software and systems
 
> >     ii  docbook-xsl                              1.79.2+dfsg-2                           all          stylesheets
forprocessing DocBook XML to various output formats
 
> >     ii  docbook-xsl-doc-html                     1.79.1-1                                all          stylesheets
forprocessing DocBook XML files (HTML documentation)
 
> > 
> > Kind of odd I don't see it the error.
> > 
> 
> What command are you invoking to build the docs? The default docs make
> target doesn't build the PDFs - you have to build those explicitly.

I showed it previously in this thread:

        $ make postgres-A4.pdf 2>&1 | grep -v INFO
        /usr/bin/xsltproc --nonet --path . --path . --stringparam pg.version '17devel' --stringparam img.src.path './'
--stringparampaper.type A4 -o postgres-A4.fo
 
        +stylesheet-fo.xsl postgres-full.xml
        Making portrait pages on A4 paper (210mmx297mm)
        /usr/bin/fop -fo postgres-A4.fo -pdf postgres-A4.pdf
        [warning] /usr/bin/fop: JVM flavor 'sun' not understood
        [WARN] FOUserAgent - Font "Symbol,normal,700" not found. Substituting with "Symbol,normal,400".
        [WARN] FOUserAgent - Font "ZapfDingbats,normal,700" not found. Substituting with "ZapfDingbats,normal,400".
        [WARN] PropertyMaker - span="inherit" on fo:block, but no explicit value found on the parent FO.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.



Re: pgsql: Doc: un-break PDF build.

От
Bruce Momjian
Дата:
On Sat, Nov 25, 2023 at 02:18:43PM -0500, Bruce Momjian wrote:
> I showed it previously in this thread:
> 
>         $ make postgres-A4.pdf 2>&1 | grep -v INFO
>         /usr/bin/xsltproc --nonet --path . --path . --stringparam pg.version '17devel' --stringparam img.src.path
'./'--stringparam paper.type A4 -o postgres-A4.fo
 
>         +stylesheet-fo.xsl postgres-full.xml
>         Making portrait pages on A4 paper (210mmx297mm)
>         /usr/bin/fop -fo postgres-A4.fo -pdf postgres-A4.pdf
>         [warning] /usr/bin/fop: JVM flavor 'sun' not understood
>         [WARN] FOUserAgent - Font "Symbol,normal,700" not found. Substituting with "Symbol,normal,400".
>         [WARN] FOUserAgent - Font "ZapfDingbats,normal,700" not found. Substituting with "ZapfDingbats,normal,400".
>         [WARN] PropertyMaker - span="inherit" on fo:block, but no explicit value found on the parent FO.

Oops, please disregard my report. I was able to reproduce the failure
just now.  I must have incorrectly applied the patch in testing.
Mystery solved.

I am not sure if I am going to build the PDF for every doc patch, but at
least I can do it when I am concerned, and know how to reproduce it if
the buildfarm fails.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.