[PATCH v5 15/18] Documentation: Split doxygen_input in public and internal inputs

[Kieran Bingham]

Quoting Laurent Pinchart (2024-08-05 15:36:51)
> To prepare for splitting the API documentation in public and internal
> documents, split the doxygen_input list in the public and internal
> counterparts.
> 
> Signed-off-by: Laurent Pinchart <laurent.pinchart at ideasonboard.com>
> ---
>  Documentation/meson.build | 25 ++++++++++++++++---------
>  1 file changed, 16 insertions(+), 9 deletions(-)
> 
> diff --git a/Documentation/meson.build b/Documentation/meson.build
> index 070420715bd1..1d84ed815b50 100644
> --- a/Documentation/meson.build
> +++ b/Documentation/meson.build
> @@ -28,27 +28,34 @@ if doxygen.found() and dot.found()
>                                output : 'Doxyfile',
>                                configuration : cdata)
>  
> -    doxygen_input = [
> -        doxyfile,
> -        libcamera_base_headers,

$ git grep libcamera_base_headers
Documentation/meson.build:        libcamera_base_headers,
include/libcamera/base/meson.build:libcamera_base_headers = [
src/libcamera/base/meson.build:                                    [libcamera_base_sources, libcamera_base_headers],
src/libcamera/base/meson.build:                                        libcamera_base_headers,

I wonder if we should get rid of libcamera_base_headers and
libcamera_base_sources too?


Reviewed-by: Kieran Bingham <kieran.bingham at ideasonboard.com>


> +    doxygen_public_input = [
> +        libcamera_base_public_headers,
>          libcamera_base_public_sources,
> -        libcamera_base_internal_sources,
> -        libcamera_internal_headers,
> -        libcamera_ipa_headers,
> -        libcamera_ipa_interfaces,
>          libcamera_public_headers,
>          libcamera_public_sources,
> +    ]
> +
> +    doxygen_internal_input = [
> +        libcamera_base_private_headers,
> +        libcamera_base_internal_sources,
> +        libcamera_internal_headers,
>          libcamera_internal_sources,
> +        libcamera_ipa_headers,
> +        libcamera_ipa_interfaces,
>          libipa_headers,
>          libipa_sources,
>      ]
>  
>      if is_variable('ipu3_ipa_sources')
> -        doxygen_input += [ipu3_ipa_sources]
> +        doxygen_internal_input += [ipu3_ipa_sources]
>      endif
>  
>      custom_target('doxygen',
> -                  input : doxygen_input,
> +                  input : [
> +                      doxyfile,
> +                      doxygen_public_input,
> +                      doxygen_internal_input,
> +                  ],
>                    output : 'api-html',
>                    command : [doxygen, doxyfile],
>                    install : true,
> -- 
> Regards,
> 
> Laurent Pinchart
>