[libcamera-devel] [PATCH] libcamera: media_device: Fix \sa tags for MediaDevice::link

[Laurent Pinchart]

Hi Marvin,

Thank you for the patch.

On Mon, Aug 29, 2022 at 03:59:50PM +0200, Marvin Schmidt via libcamera-devel wrote:
> doxygen didn't create proper links to the overloads of
> MediaDevice::link because the signatures didn't match due to an
> additional 'const'
> 
> While at it remove the unnecessary `MediaDevice::` and wrap the lines
> 
> Fixes: b65feafe ("libcamera: media_device: Add functions to get a MediaLink")

The standard format for fixes tags is a 12 digits commit ID. I'll fix
this when applying.

> Signed-off-by: Marvin Schmidt <marvin.schmidt1987 at gmail.com>

Reviewed-by: Laurent Pinchart <laurent.pinchart at ideasonboard.com>

> ---
>  src/libcamera/media_device.cpp | 16 ++++++++++------
>  1 file changed, 10 insertions(+), 6 deletions(-)
> 
> diff --git a/src/libcamera/media_device.cpp b/src/libcamera/media_device.cpp
> index 7c94da9e..52c8e66e 100644
> --- a/src/libcamera/media_device.cpp
> +++ b/src/libcamera/media_device.cpp
> @@ -352,8 +352,9 @@ MediaEntity *MediaDevice::getEntityByName(const std::string &name) const
>   * entity with name \a sourceName, to the pad at index \a sinkIdx of the
>   * sink entity with name \a sinkName, if any.
>   *
> - * \sa MediaDevice::link(const MediaEntity *source, unsigned int sourceIdx, const MediaEntity *sink, unsigned int sinkIdx) const
> - * \sa MediaDevice::link(const MediaPad *source, const MediaPad *sink) const
> + * \sa link(const MediaEntity *source, unsigned int sourceIdx,
> + *          const MediaEntity *sink, unsigned int sinkIdx)
> + * \sa link(const MediaPad *source, const MediaPad *sink)
>   *
>   * \return The link that connects the two pads, or nullptr if no such a link
>   * exists
> @@ -381,8 +382,9 @@ MediaLink *MediaDevice::link(const std::string &sourceName, unsigned int sourceI
>   * entity \a source, to the pad at index \a sinkIdx of the sink entity \a
>   * sink, if any.
>   *
> - * \sa MediaDevice::link(const std::string &sourceName, unsigned int sourceIdx, const std::string &sinkName, unsigned int sinkIdx) const
> - * \sa MediaDevice::link(const MediaPad *source, const MediaPad *sink) const
> + * \sa link(const std::string &sourceName, unsigned int sourceIdx,
> + *          const std::string &sinkName, unsigned int sinkIdx)
> + * \sa link(const MediaPad *source, const MediaPad *sink)
>   *
>   * \return The link that connects the two pads, or nullptr if no such a link
>   * exists
> @@ -404,8 +406,10 @@ MediaLink *MediaDevice::link(const MediaEntity *source, unsigned int sourceIdx,
>   * \param[in] source The source pad
>   * \param[in] sink The sink pad
>   *
> - * \sa MediaDevice::link(const std::string &sourceName, unsigned int sourceIdx, const std::string &sinkName, unsigned int sinkIdx) const
> - * \sa MediaDevice::link(const MediaEntity *source, unsigned int sourceIdx, const MediaEntity *sink, unsigned int sinkIdx) const
> + * \sa link(const std::string &sourceName, unsigned int sourceIdx,
> + *          const std::string &sinkName, unsigned int sinkIdx)
> + * \sa link(const MediaEntity *source, unsigned int sourceIdx,
> + *          const MediaEntity *sink, unsigned int sinkIdx)
>   *
>   * \return The link that connects the two pads, or nullptr if no such a link
>   * exists

-- 
Regards,

Laurent Pinchart