Subject: Re: [bug#73028] [PATCH] doc: Document usage of #:out-of-source? for meson-build-system.

From: Maxim Cournoyer <[email-masked]>
Date: Wed, 11 Sep 2024 15:09:10 +0900

Hi Dariqq,

Dariqq <[email-masked]> writes:

> Followup to 220546810830422f8ec3e6a4145fec85429914a1.
>
> * doc/guix.texi (meson-build-system): Document #:out-of-source? parameter.
>
> Change-Id: I730e1aef15010006a68710f8e46ce75dc50e6c67
> ---
>  doc/guix.texi | 4 ++++
>  1 file changed, 4 insertions(+)
>
> diff --git a/doc/guix.texi b/doc/guix.texi
> index 16c697586a..2302e0f15c 100644
> --- a/doc/guix.texi
> +++ b/doc/guix.texi
> @@ -10146,6 +10146,10 @@ Build Systems
>  of inputs, and they can be changed with the parameters @code{#:meson}
>  and @code{#:ninja} if needed.
>  
> +As Meson only supports out-of-source builds the @code{#:out-of-source?}
> +parameter specifies whether to search for license files in the source
> +or build directory.
> +

That strikes me as odd; is it useful in practice?  Otherwise I'd rather
we keep it undocumented, so that it can be removed without notice in a
future cleanup (in a 'private API' way).

-- 
Thanks,
Maxim