libcamera: Fix spellings and grammar

Fix a number of spelling errors and word duplications throughout the comments
within libcamera.

These were picked up with spellintian.

Also one capitalisation of the first word of a \return statement picked
up by checkstyle.py while creating this patch.

Reviewed-by: Paul Elder <paul.elder@ideasonboard.com>
Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>

src/libcamera/buffer.cpp

@@ -321,7 +321,7 @@ Buffer::Buffer(unsigned int index, const Buffer *metadata)
  * \fn Buffer::timestamp()
  * \brief Retrieve the time when the buffer was processed
  *
- * The timestamp is expressed as a number number of nanoseconds since the epoch.
+ * The timestamp is expressed as a number of nanoseconds since the epoch.
  *
  * \return Timestamp when the buffer was processed
  */

src/libcamera/camera.cpp

@@ -757,7 +757,7 @@ int Camera::freeBuffers()
  * \param[in] cookie Opaque cookie for application use
  *
  * This method creates an empty request for the application to fill with
- * buffers and paramaters, and queue for capture.
+ * buffers and parameters, and queue for capture.
  *
  * The \a cookie is stored in the request and is accessible through the
  * Request::cookie() method at any time. It is typically used by applications

src/libcamera/controls.cpp

@@ -204,7 +204,7 @@ std::string ControlValue::toString() const
  * \var Contrast
  * ControlType: Integer
  *
- * Specify a fixed constrast parameter.
+ * Specify a fixed contrast parameter.
  */
 
 /**

src/libcamera/ipa_module.cpp

@@ -348,7 +348,7 @@ close:
  * the IPA module information it contains was successfully retrieved and
  * validated.
  *
- * \return true if the the IPAModule is valid, false otherwise
+ * \return True if the IPAModule is valid, false otherwise
  */
 bool IPAModule::isValid() const
 {

src/libcamera/pipeline_handler.cpp

@@ -149,7 +149,7 @@ PipelineHandler::~PipelineHandler()
  * return false.
  *
  * If multiple instances of a pipeline are available in the system, the
- * PipelineHandler class will be instanciated once per instance, and its match()
+ * PipelineHandler class will be instantiated once per instance, and its match()
  * function called for every instance. Each call shall acquire media devices for
  * one pipeline instance, until all compatible media devices are exhausted.
  *

src/libcamera/stream.cpp

@@ -649,7 +649,7 @@ void Stream::destroyBuffers()
  * \var Stream::bufferPool_
  * \brief The pool of buffers associated with the stream
  *
- * The stream buffer pool is populated by the Camera class after a succesfull
+ * The stream buffer pool is populated by the Camera class after a successful
  * stream configuration.
  */
 

src/libcamera/v4l2_device.cpp

@@ -30,7 +30,7 @@ LOG_DEFINE_CATEGORY(V4L2)
  *
  * The V4L2Device class groups together the methods and fields common to
  * both the V4L2VideoDevice and V4L2Subdevice classes, and provides a base
- * class whith methods to open and close the device node associated with the
+ * class with methods to open and close the device node associated with the
  * device and to perform IOCTL system calls on it.
  *
  * The V4L2Device class cannot be instantiated directly, as its constructor