Re: testing out Docker CI scripts?

[Han-Wen Nienhuys]

On Sat, Feb 22, 2020 at 11:43 PM David Kastrup <address@hidden> wrote:
> >> Assuming that all translations are kept at exactly the same level and
> >> the example code is not at all adapted to the language in question in
> >> lyrics and code comments.
> >>
> >> And assuming that our regtests make up 40% of the LilyPond material in
> >> the documentation and are not getting recompiled as part of including
> >> them into the various forms of the documentation.
> >>
> >> Since the documentation graphics are produced in PNG format for HTML
> >> inclusion and in PDF format for PDF inclusion, that seems audacious.
> >
> > I don't understand you; what seems audacious?
> >
> > I think the runtime of make doc is off by a factor of about 5, which
> > could be explained if somehow each language recompiles the snippets
> > afresh.
> >
> > You seem dismissive of my analysis, so I guess you don't want to look
> > into this further?
>
> Clicking on the images in the HTML documentation leads you to the source
> code of the respective snippet as generated by lilypond-book.  Doing
> this on corresponding images in different translations leads you to the
> same source file.
>
> That does appear like the basic database mechanism is working.
>
> Most of the non-English documentation is outdated to some smaller or
> larger degree, meaning that there is considerable variance in the
> contained snippets compared to the upstream English version.
>
> The generation of snippets as PNG (not needed for running the regtests)
> creates them as larger size bitmaps in Ghostscript, scaling them down
> for quality.  There is also extensive Ghostscript carnage happening for
(etc)

You are telling me that "make doc" is slow for good reasons.  I am
telling you that we don't need to spend so much processing time to get
test results for pending patches, because the doc itself is not what
we're interested in when pushing a change.

For example, I agree that the antialiased images are nice for the docs
that serve as downloads, but the AA is irrelevant for qualifying a
staging => master push.  So there is certainly some gains to be had
here.

-- 
Han-Wen Nienhuys - address@hidden - http://www.xs4all.nl/~hanwen