[libcamera-devel] [PATCH v2 01/12] libcamera: FrameBuffer: Correct Buffer references

[Laurent Pinchart]

Hi Kieran,

Thank you for the patch.

On Mon, Aug 03, 2020 at 05:18:05PM +0100, Kieran Bingham wrote:
> Update the remaining (capitalised) Buffer references to the new FrameBuffer
> object that they refer to.
> 
> Lower-case 'buffer' terms are kept, as a generic reference to a buffer
> rather than the specific type 'FrameBuffer'.
> 
> Signed-off-by: Kieran Bingham <kieran.bingham at ideasonboard.com>
> Reviewed-by: Niklas Söderlund <niklas.soderlund at ragnatech.se>
> ---
>  src/libcamera/buffer.cpp | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
> 
> diff --git a/src/libcamera/buffer.cpp b/src/libcamera/buffer.cpp
> index 1a1d4bac7aed..8278f8a92af4 100644
> --- a/src/libcamera/buffer.cpp
> +++ b/src/libcamera/buffer.cpp
> @@ -174,11 +174,11 @@ FrameBuffer::FrameBuffer(const std::vector<Plane> &planes, unsigned int cookie)
>   * The intended callers of this method are buffer completion handlers that
>   * need to associate a buffer to the request it belongs to.
>   *
> - * A Buffer is associated to a request by Request::addBuffer() and the
> + * A FrameBuffer is associated to a request by Request::addBuffer() and the
>   * association is valid until the buffer completes. The returned request
>   * pointer is valid only during that interval.
>   *
> - * \return The Request the Buffer belongs to, or nullptr if the buffer is
> + * \return The Request the FrameBuffer belongs to, or nullptr if the buffer is
>   * not associated with a request
>   */
>  
> @@ -224,7 +224,7 @@ FrameBuffer::FrameBuffer(const std::vector<Plane> &planes, unsigned int cookie)
>  
>  /**
>   * \brief Copy the contents from another buffer
> - * \param[in] src Buffer to copy
> + * \param[in] src FrameBuffer to copy

This could stay the same as Buffer is capitalized due to being the first
word. Doesn't matter much though.

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

>   *
>   * Copy the buffer contents and metadata from \a src to this buffer. The
>   * destination FrameBuffer shall have the same number of planes as the source

-- 
Regards,

Laurent Pinchart