Eric Engestrom
2e33098162
docs/ci: always build the docs
...
It only takes 2 min of runner time, and it's been broken several times
by now, so let's just always run this job.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/36893 >
2025-08-26 09:49:56 +00:00
Eric Engestrom
a569a5f9c6
docs/ci: drop unnecessary comment
...
None of the other `rules:` say this, because everyone know this by now.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/36893 >
2025-08-26 09:49:56 +00:00
Eric Engestrom
1b7dd64977
docs/ci: drop redundant/dead fork rule
...
`.common-rules` already covers that.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/36893 >
2025-08-26 09:49:55 +00:00
Yonggang Luo
1f44a470b4
util: Always generate u_format_gen.h as docs need it
...
Signed-off-by: Yonggang Luo <luoyonggang@gmail.com >
Reviewed-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/36891 >
2025-08-21 03:19:02 +08:00
Sergi Blanch-Torne
6ba1b61395
ci: separate hidden jobs to -inc yml files
...
Almost all the gitlab-ci.yml files in Mesa have their hidden jobs defined in
an include file. This may have started with !25238 with the idea to simplify
the re-use of hidden jobs by other projects. But we missed the .gitlab-ci
directory.
Signed-off-by: Sergi Blanch-Torne <sergi.blanch.torne@collabora.com >
Acked-by: Martin Roukala (né Peres) <martin.roukala@mupuf.org >
Reviewed-by: Eric Engestrom <eric@igalia.com >
Reviewed-by: Valentine Burley <valentine.burley@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/35427 >
2025-06-30 12:32:29 +00:00
Eric Engestrom
f88dc25d23
docs/ci: allow running linkcheck in pre-merge pipelines
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/34923 >
2025-05-12 10:19:28 +00:00
Eric Engestrom
fe82dcfc3d
docs/linkcheck: print summary of problems found
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/34923 >
2025-05-12 10:19:27 +00:00
Eric Engestrom
904052a9d8
docs/ci: follow convention of only running jobs by default for Marge
...
Because `alpine/x86_64_build` references these rules, this commit fixes
that job as well.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/34469 >
2025-04-15 15:14:50 +00:00
Eric Engestrom
ddeaa10bfc
docs/ci: split pre-merge & merge pipeline rules
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/34469 >
2025-04-15 15:14:50 +00:00
Eric Engestrom
6922ef5294
docs/ci: add comment explaining what that long rule actually does
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/34469 >
2025-04-15 15:14:50 +00:00
Eric Engestrom
bda8692b95
docs/ci: add link to the website preview for convenience
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/34469 >
2025-04-15 15:14:50 +00:00
Eric Engestrom
33f82078e0
docs/ci: replace deprecated pages job with pages: true
...
See https://docs.gitlab.com/ci/yaml/#pages
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/34469 >
2025-04-15 15:14:50 +00:00
Daniel Stone
370efffe10
ci/docs: Add timeout to doc build
...
Give these about double the time they usually take to complete.
Signed-off-by: Daniel Stone <daniels@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/34280 >
2025-04-01 12:21:01 +00:00
Erik Faye-Lund
cf07e89d06
docs/ci: treat warnings as errors
...
When we moved building the docs to Meson, we accidentally dropped the -W
flag that we used to have. This lead to us no longer detecting certain
problems in the docs, which is unfortunate.
Let's bring this back gated by the werror meson-option, and wire that up
on the CI end.
Fixes: fdd204538b ("ci: build docs using meson")
Reviewed-by: Dylan Baker <None>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/32831 >
2025-01-02 21:33:51 +00:00
Erico Nunes
4f99e84367
docs/ci: pass -D platforms=[] to avoid dependencies
...
Since commit 8f6fca89aa ("meson: delete dri3 build option"),
the docs build attempts to find dependencies like xshmfence which
are not found in the current docs image.
Avoid checking for those dependencies by not enabling any platforms,
which will skip the check overall.
Signed-off-by: Erico Nunes <nunes.erico@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/31025 >
2024-09-04 22:57:25 +00:00
Eric Engestrom
07202111a6
ci/rules: make every job exist as manual in fork pipelines
...
In forks, every job exists, but no job is automatically run.
Should help with the problem of users clicking on that tempting "play"
button GitLab offers and that has been causing a lot of issues with
wasted resources.
Downside is, users now have to use the `bin/ci/ci_run_n_monitor.sh`
script to be able to run a bunch of jobs at once.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25252 >
2024-08-26 11:49:34 +00:00
Eric Engestrom
2156ea8ec7
docs/ci: drop .no_scheduled_pipelines-rules from test-docs
...
None of the existing rules can match in a scheduled pipeline, so we already `never` run.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/29908 >
2024-06-26 20:25:39 +00:00
Eric Engestrom
aba6bf7765
docs/ci: auto-run test-docs in fork pipelines
...
Since it's gated on a manual container job already.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/29908 >
2024-06-26 20:25:39 +00:00
Eric Engestrom
d48c91c582
docs/ci: merge test-docs and test-docs-mr
...
No reason to have two different jobs, they both do exactly the same
thing with just different rules for existing.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/29908 >
2024-06-26 20:25:39 +00:00
Eric Engestrom
5e44b4b123
docs/ci: fix indentation of list nested in a dict item
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/29908 >
2024-06-26 20:25:39 +00:00
Erik Faye-Lund
fdd204538b
ci: build docs using meson
...
To avoid having to inflate the image here even further, let's just add
what we need to the the normal x86 Alpine build image, and use that.
Reviewed-by: Daniel Stone <daniels@collabora.com >
Reviewed-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/11494 >
2024-06-25 10:59:54 +00:00
David Heidelberg
180cb30986
ci/docs: add coreutils
...
Needed for correct GitLab CI `date` variable parsing.
Closes: https://gitlab.freedesktop.org/mesa/mesa/-/issues/10041
Signed-off-by: David Heidelberg <david.heidelberg@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25917 >
2023-10-30 19:16:19 +00:00
Eric Engestrom
49395b4aa4
docs/ci: allow sanity job to be missing
...
The rules of both jobs never matched, so there was always the potential
for the job to be missing, but it's about to get worse with the next
commit, so fix that now.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25920 >
2023-10-30 17:50:56 +00:00
Erik Faye-Lund
bbd6ef4d34
docs: remove breathe/doxygen stuff
...
Reviewed-by: Jani Nikula <jani@nikula.org >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/24507 >
2023-10-26 16:13:26 +00:00
Erik Faye-Lund
67485efd65
docs: prepare for hawkmoth
...
Hawkmoth is a Sphinx-extension that uses Clang to directly parse C code
for automatic documentation of C/C++ code, similar to what Doxygen does.
However, Doxygen is rather clunky to integrate into the build process,
so let's start switching over to Hawkmoth instead.
As Sphinx does not have syntax for describing parameter direction, add
an rst_prolog with rst replacements for them.
Reviewed-by: Jani Nikula <jani@nikula.org >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/24507 >
2023-10-26 16:13:25 +00:00
Eric Engestrom
632792eca0
ci/docs: drop extra overwritten rules
...
Every job re-defines its own rules, so there is no point in including these here.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25307 >
2023-09-27 10:05:37 +01:00
Eric Engestrom
9618fefd18
ci: unify container and build jobs rules
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25294 >
2023-09-26 18:06:23 +00:00
Erik Faye-Lund
9aefd97cfd
docs: use custom html theme
...
This uses the new custom HTML theme for Sphinx, so our documentation
looks similar to our website.
Reviewed-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8399 >
2023-04-26 22:45:41 +00:00
Emma Anholt
c346413d9c
ci: Add missing dependency on doxygen sources for docs-generation jobs.
...
!22191 broke docs generation and marge didn't notice because of missing
deps.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22271 >
2023-04-04 20:00:17 +00:00
Erik Faye-Lund
859bcd605d
ci: move docs-stuff out of root .gitlab-ci.yml
...
Unlike most other cases, we don't put the YAML-file in a ci-folder,
because we already have one for the CI-specific docs. So let's just
leave the YAML file directly in the docs-folder.
This should fix the problem that any docs-changes that touches the
CI-rules needs a full CI run just because of touching the root
.gitlab-ci.yml file. This causes needless friction and wastes CI
resources.
Reviewed-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/21953 >
2023-03-20 15:27:37 +00:00