[igt-dev] [PATCH i-g-t v3 4/4] meson_options.txt: disable Sphinx by default

Kamil Konieczny kamil.konieczny at linux.intel.com
Thu Apr 13 10:10:08 UTC 2023


Hi Mauro,

On 2023-04-13 at 11:21:59 +0200, Mauro Carvalho Chehab wrote:
> From: Mauro Carvalho Chehab <mchehab at kernel.org>
> 
> Building IGT with Sphinx enabled and rst2pdf installed takes:
> 
> 	$ touch tests/xe/xe_compute.c
> 	$ time ninja -C build
> 
> 	...
> 
>         real    0m10.545s
>         user    0m13.778s
>         sys     0m0.724s
> 
> With Sphinx disabled, the same build is a lot faster:
> 
> 	$ touch tests/xe/xe_compute.c
> 	$ time ninja -C build
> 
> 	...
> 
> 	real	0m1.746s
> 	user	0m1.574s
> 	sys	0m0.171s
> 
> As Sphinx and PDF outputs aren't something that every single
> IGT developer would need, let's speedup the build by disabling
> it by default.

imho this may require a change in our building pipeline so
+cc Petri.

Regards,
Kamil

> 
> Test plan and test documentation validation will still run,
> as this is a necessary step to validate if the tests documentation
> were not broken on a patch, but this will save some time during
> normal builds.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab at kernel.org>
> ---
>  meson_options.txt | 1 +
>  1 file changed, 1 insertion(+)
> 
> diff --git a/meson_options.txt b/meson_options.txt
> index d4e373d6cfc4..2cb44f20169b 100644
> --- a/meson_options.txt
> +++ b/meson_options.txt
> @@ -26,6 +26,7 @@ option('testplan',
>  
>  option('sphinx',
>         type : 'feature',
> +       value : 'disabled',
>         description : 'Build testplan documentation using Sphinx')
>  
>  option('docs',
> -- 
> 2.39.2
> 


More information about the igt-dev mailing list