[03/15] libipa: awb: Follow function names with '()' in doxygen documentation
diff mbox series

Message ID 20250223230403.1226-4-laurent.pinchart@ideasonboard.com
State Accepted
Headers show
Series
  • libipa: awb: Drive-by fixes
Related show

Commit Message

Laurent Pinchart Feb. 23, 2025, 11:03 p.m. UTC
Function names are followed by parentheses in doxygen documentation
blocks as convention in libcamera. Add missing parentheses in the
AwbAlgorithm documentation.

Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
---
 src/ipa/libipa/awb.cpp | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

Comments

Stefan Klug Feb. 24, 2025, 9 a.m. UTC | #1
Hi Laurent,

Thank you for the patch. 

On Mon, Feb 24, 2025 at 01:03:51AM +0200, Laurent Pinchart wrote:
> Function names are followed by parentheses in doxygen documentation
> blocks as convention in libcamera. Add missing parentheses in the
> AwbAlgorithm documentation.

I wasn't aware of that.

Reviewed-by: Stefan Klug <stefan.klug@ideasonboard.com> 

> 
> Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
> ---
>  src/ipa/libipa/awb.cpp | 14 +++++++-------
>  1 file changed, 7 insertions(+), 7 deletions(-)
> 
> diff --git a/src/ipa/libipa/awb.cpp b/src/ipa/libipa/awb.cpp
> index dc672f129c4a..1adefa5bb929 100644
> --- a/src/ipa/libipa/awb.cpp
> +++ b/src/ipa/libipa/awb.cpp
> @@ -49,7 +49,7 @@ namespace ipa {
>   */
>  
>  /**
> - * \fn AwbStats::computeColourError
> + * \fn AwbStats::computeColourError()
>   * \brief Compute an error value for when the given gains would be applied
>   * \param[in] gains The gains to apply
>   *
> @@ -65,7 +65,7 @@ namespace ipa {
>   */
>  
>  /**
> - * \fn AwbStats::getRGBMeans
> + * \fn AwbStats::getRGBMeans()
>   * \brief Get RGB means of the statistics
>   *
>   * Fetch the RGB means from the statistics. The values of each channel are
> @@ -85,7 +85,7 @@ namespace ipa {
>   */
>  
>  /**
> - * \fn AwbAlgorithm::init
> + * \fn AwbAlgorithm::init()
>   * \brief Initialize the algorithm with the given tuning data
>   * \param[in] tuningData The tuning data to use for the algorithm
>   *
> @@ -93,7 +93,7 @@ namespace ipa {
>   */
>  
>  /**
> - * \fn AwbAlgorithm::calculateAwb
> + * \fn AwbAlgorithm::calculateAwb()
>   * \brief Calculate AWB data from the given statistics
>   * \param[in] stats The statistics to use for the calculation
>   * \param[in] lux The lux value of the scene
> @@ -106,7 +106,7 @@ namespace ipa {
>   */
>  
>  /**
> - * \fn AwbAlgorithm::gainsFromColourTemperature
> + * \fn AwbAlgorithm::gainsFromColourTemperature()
>   * \brief Compute white balance gains from a colour temperature
>   * \param[in] colourTemperature The colour temperature in Kelvin
>   *
> @@ -118,14 +118,14 @@ namespace ipa {
>   */
>  
>  /**
> - * \fn AwbAlgorithm::controls
> + * \fn AwbAlgorithm::controls()
>   * \brief Get the controls info map for this algorithm
>   *
>   * \return The controls info map
>   */
>  
>  /**
> - * \fn AwbAlgorithm::handleControls
> + * \fn AwbAlgorithm::handleControls()
>   * \param[in] controls The controls to handle
>   * \brief Handle the controls supplied in a request
>   */
> -- 
> Regards,
> 
> Laurent Pinchart
>

Patch
diff mbox series

diff --git a/src/ipa/libipa/awb.cpp b/src/ipa/libipa/awb.cpp
index dc672f129c4a..1adefa5bb929 100644
--- a/src/ipa/libipa/awb.cpp
+++ b/src/ipa/libipa/awb.cpp
@@ -49,7 +49,7 @@  namespace ipa {
  */
 
 /**
- * \fn AwbStats::computeColourError
+ * \fn AwbStats::computeColourError()
  * \brief Compute an error value for when the given gains would be applied
  * \param[in] gains The gains to apply
  *
@@ -65,7 +65,7 @@  namespace ipa {
  */
 
 /**
- * \fn AwbStats::getRGBMeans
+ * \fn AwbStats::getRGBMeans()
  * \brief Get RGB means of the statistics
  *
  * Fetch the RGB means from the statistics. The values of each channel are
@@ -85,7 +85,7 @@  namespace ipa {
  */
 
 /**
- * \fn AwbAlgorithm::init
+ * \fn AwbAlgorithm::init()
  * \brief Initialize the algorithm with the given tuning data
  * \param[in] tuningData The tuning data to use for the algorithm
  *
@@ -93,7 +93,7 @@  namespace ipa {
  */
 
 /**
- * \fn AwbAlgorithm::calculateAwb
+ * \fn AwbAlgorithm::calculateAwb()
  * \brief Calculate AWB data from the given statistics
  * \param[in] stats The statistics to use for the calculation
  * \param[in] lux The lux value of the scene
@@ -106,7 +106,7 @@  namespace ipa {
  */
 
 /**
- * \fn AwbAlgorithm::gainsFromColourTemperature
+ * \fn AwbAlgorithm::gainsFromColourTemperature()
  * \brief Compute white balance gains from a colour temperature
  * \param[in] colourTemperature The colour temperature in Kelvin
  *
@@ -118,14 +118,14 @@  namespace ipa {
  */
 
 /**
- * \fn AwbAlgorithm::controls
+ * \fn AwbAlgorithm::controls()
  * \brief Get the controls info map for this algorithm
  *
  * \return The controls info map
  */
 
 /**
- * \fn AwbAlgorithm::handleControls
+ * \fn AwbAlgorithm::handleControls()
  * \param[in] controls The controls to handle
  * \brief Handle the controls supplied in a request
  */