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

["Bohdan D. Marcus" <bohdandmarcus@gmail.com>]

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@gmail.com>
---
 .../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