Re: [PATCH v1 9/9] gitlab: move docs and tools build across from Travis

[Peter Maydell]

On Wed, 13 Jan 2021 at 15:40, Daniel P. Berrangé <berrange@redhat.com> wrote:
>
> On Wed, Jan 13, 2021 at 03:14:08PM +0000, Alex Bennée wrote:
> > While we are at it we might as well check the tag generation. For
> > bonus points we run GNU globals htags into the public pages directory
> > for publishing with the auto generated pages.

> > +build-tools-and-docs-debian:
> > +  <<: *native_build_job_definition
> > +  variables:
> > +    IMAGE: debian-amd64
> > +    MAKE_CHECK_ARGS: ctags gtags TAGS cscope
> > +    CONFIGURE_ARGS: --enable-docs --enable-tools
> > +  artifacts:
> > +    expire_in: 2 days
> > +    paths:
> > +      - build
>
> Do we actually need this job at all ?
>
> Assuming the depenedancies are in the dockerfile, then all the
> build jobs will be testing docs and tools already, as meson will
> auto enable it.

What I would like to see is a set of "just build the docs"
CI jobs which test all our supported Sphinx versions
(eg 1.6, 2.0, 2.4, 3.0, 3.2), since we've found that Sphinx
is not great about consistency of accepted syntax from
version to version. (Somebody sent a patch for this ages
ago, but it was for a Travis CI job IIRC, which we're trying
to move away from.)

thanks
-- PMM