[libcamera-devel,v3,04/14] libcamera: camera: Fix minor issues in Camera::Private documentation
diff mbox series

Message ID 20210811232625.17280-5-laurent.pinchart@ideasonboard.com
State Accepted
Headers show
Series
  • libcamera: Replace CameraData with Camera::Private
Related show

Commit Message

Laurent Pinchart Aug. 11, 2021, 11:26 p.m. UTC
Improve the Camera::Private documentation by fixing minor spelling or
style issues.

Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
---
 src/libcamera/camera.cpp | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

Comments

Jacopo Mondi Aug. 12, 2021, 7:49 a.m. UTC | #1
Hi Laurent,

On Thu, Aug 12, 2021 at 02:26:15AM +0300, Laurent Pinchart wrote:
> Improve the Camera::Private documentation by fixing minor spelling or
> style issues.
>
> Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
> ---
>  src/libcamera/camera.cpp | 8 ++++----
>  1 file changed, 4 insertions(+), 4 deletions(-)
>
> diff --git a/src/libcamera/camera.cpp b/src/libcamera/camera.cpp
> index 4080da151af1..a22cc7b8e49d 100644
> --- a/src/libcamera/camera.cpp
> +++ b/src/libcamera/camera.cpp
> @@ -368,10 +368,10 @@ Camera::Private::~Private()
>
>  /**
>   * \var Camera::Private::queuedRequests_
> - * \brief The list of queued and not yet completed request
> + * \brief The list of queued and not yet completed requests
>   *
> - * The list of queued request is used to track requests queued in order to
> - * ensure completion of all requests when the pipeline handler is stopped.
> + * This list tracks requests queued in order to ensure completion of all
> + * requests when the pipeline handler is stopped.
>   *
>   * \sa PipelineHandler::queueRequest(), PipelineHandler::stop(),
>   * PipelineHandler::completeRequest()
> @@ -400,7 +400,7 @@ Camera::Private::~Private()
>
>  /**
>   * \var Camera::Private::requestSequence_
> - * \brief The queuing sequence of the request
> + * \brief The queuing sequence number of the request
>   *
>   * When requests are queued, they are given a per-camera sequence number to
>   * facilitate debugging of internal request usage.

Thanks, I'm sorry this required you additional work, I noticed the
documentation was verbatim copied only after I reviewed it.

Reviewed-by: Jacopo Mondi <jacopo@jmondi.org>

Thanks
   j

> --
> Regards,
>
> Laurent Pinchart
>
Kieran Bingham Aug. 16, 2021, 10:16 a.m. UTC | #2
On 12/08/2021 00:26, Laurent Pinchart wrote:
> Improve the Camera::Private documentation by fixing minor spelling or
> style issues.
> 
> Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>

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

> ---
>  src/libcamera/camera.cpp | 8 ++++----
>  1 file changed, 4 insertions(+), 4 deletions(-)
> 
> diff --git a/src/libcamera/camera.cpp b/src/libcamera/camera.cpp
> index 4080da151af1..a22cc7b8e49d 100644
> --- a/src/libcamera/camera.cpp
> +++ b/src/libcamera/camera.cpp
> @@ -368,10 +368,10 @@ Camera::Private::~Private()
>  
>  /**
>   * \var Camera::Private::queuedRequests_
> - * \brief The list of queued and not yet completed request
> + * \brief The list of queued and not yet completed requests
>   *
> - * The list of queued request is used to track requests queued in order to
> - * ensure completion of all requests when the pipeline handler is stopped.
> + * This list tracks requests queued in order to ensure completion of all
> + * requests when the pipeline handler is stopped.
>   *
>   * \sa PipelineHandler::queueRequest(), PipelineHandler::stop(),
>   * PipelineHandler::completeRequest()
> @@ -400,7 +400,7 @@ Camera::Private::~Private()
>  
>  /**
>   * \var Camera::Private::requestSequence_
> - * \brief The queuing sequence of the request
> + * \brief The queuing sequence number of the request
>   *
>   * When requests are queued, they are given a per-camera sequence number to
>   * facilitate debugging of internal request usage.
>

Patch
diff mbox series

diff --git a/src/libcamera/camera.cpp b/src/libcamera/camera.cpp
index 4080da151af1..a22cc7b8e49d 100644
--- a/src/libcamera/camera.cpp
+++ b/src/libcamera/camera.cpp
@@ -368,10 +368,10 @@  Camera::Private::~Private()
 
 /**
  * \var Camera::Private::queuedRequests_
- * \brief The list of queued and not yet completed request
+ * \brief The list of queued and not yet completed requests
  *
- * The list of queued request is used to track requests queued in order to
- * ensure completion of all requests when the pipeline handler is stopped.
+ * This list tracks requests queued in order to ensure completion of all
+ * requests when the pipeline handler is stopped.
  *
  * \sa PipelineHandler::queueRequest(), PipelineHandler::stop(),
  * PipelineHandler::completeRequest()
@@ -400,7 +400,7 @@  Camera::Private::~Private()
 
 /**
  * \var Camera::Private::requestSequence_
- * \brief The queuing sequence of the request
+ * \brief The queuing sequence number of the request
  *
  * When requests are queued, they are given a per-camera sequence number to
  * facilitate debugging of internal request usage.