[PATCH 3/3] media: atomisp: fix block comment formatting in ia_css_timer.h

From: Bohdan D. Marcus

Date: Thu Jul 02 2026 - 09:57:19 EST


Fix block comment formatting issues reported by checkpatch.pl
in ia_css_timer.h by ensuring block comments use '*' on subsequent
lines and aligning them properly to conform to the Linux kernel
coding style guidelines. Also, remove misplaced Kernel-doc tags
from macro definitions and correct function signature formatting.

Signed-off-by: Bohdan D. Marcus <bohdandmarcus@xxxxxxxxx>
---
.../staging/media/atomisp/pci/ia_css_timer.h | 49 +++++++++++--------
1 file changed, 28 insertions(+), 21 deletions(-)

diff --git a/drivers/staging/media/atomisp/pci/ia_css_timer.h b/drivers/staging/media/atomisp/pci/ia_css_timer.h
index da752834adf4..2e555b39bc25 100644
--- a/drivers/staging/media/atomisp/pci/ia_css_timer.h
+++ b/drivers/staging/media/atomisp/pci/ia_css_timer.h
@@ -1,23 +1,28 @@
/* SPDX-License-Identifier: GPL-2.0 */
/**
-Support for Intel Camera Imaging ISP subsystem.
-Copyright (c) 2010 - 2015, Intel Corporation.
-
-*/
+ * Support for Intel Camera Imaging ISP subsystem.
+ * Copyright (c) 2010 - 2015, Intel Corporation.
+ */

#ifndef __IA_CSS_TIMER_H
#define __IA_CSS_TIMER_H

-/* @file
+/*
+ * @file
* Timer interface definitions
*/
-#include <type_support.h> /* for uint32_t */
+#include <type_support.h> /* for uint32_t */
#include "ia_css_err.h"

-/* @brief timer reading definition */
+/*
+ * @brief timer reading definition
+ */
typedef u32 clock_value_t;

-/* @brief 32 bit clock tick,(timestamp based on timer-value of CSS-internal timer)*/
+/*
+ * @brief 32 bit clock tick, (timestamp based on timer-value of
+ * CSS-internal timer)
+ */
struct ia_css_clock_tick {
clock_value_t ticks; /** measured time in ticks.*/
};
@@ -38,24 +43,26 @@ enum ia_css_tm_event {

/* @brief code measurement common struct */
struct ia_css_time_meas {
- clock_value_t start_timer_value; /** measured time in ticks */
- clock_value_t end_timer_value; /** measured time in ticks */
+ clock_value_t start_timer_value; /** measured time in ticks */
+ clock_value_t end_timer_value; /** measured time in ticks */
};

-/**@brief SIZE_OF_IA_CSS_CLOCK_TICK_STRUCT checks to ensure correct alignment for struct ia_css_clock_tick. */
+/*
+ * SIZE_OF_IA_CSS_CLOCK_TICK_STRUCT checks to ensure correct
+ * alignment for struct ia_css_clock_tick.
+ */
#define SIZE_OF_IA_CSS_CLOCK_TICK_STRUCT sizeof(clock_value_t)
-/* @brief checks to ensure correct alignment for ia_css_time_meas. */
+
+/* checks to ensure correct alignment for ia_css_time_meas. */
#define SIZE_OF_IA_CSS_TIME_MEAS_STRUCT (sizeof(clock_value_t) \
+ sizeof(clock_value_t))

-/* @brief API to fetch timer count directly
-*
-* @param curr_ts [out] measured count value
-* @return 0 if success
-*
-*/
-int
-ia_css_timer_get_current_tick(
- struct ia_css_clock_tick *curr_ts);
+/*
+ * @brief API to fetch timer count directly
+ *
+ * @param curr_ts [out] measured count value
+ * @return 0 if success
+ */
+int ia_css_timer_get_current_tick(struct ia_css_clock_tick *curr_ts);

#endif /* __IA_CSS_TIMER_H */
--
2.55.0