kernel: hooks: make definitions appear in Doxygen

The hooks' signature was not visible to Doxygen due to preprocessor
conditionals - instead, the dummy no-op implementation was seen instead.

Update #ifdef guard to make the hooks' signature and the associated
documentation visible to Doxygen such that it appears in docs.

Also fix a tiny typo on soc_reset_hook()'s documentation comment.

Signed-off-by: Mathieu Choplain <[email protected]>

Author: mathieuchopstm

include/zephyr/platform/hooks.h

@@ -20,9 +20,9 @@
  */
 
 
-#ifdef CONFIG_SOC_RESET_HOOK
+#if defined(CONFIG_SOC_RESET_HOOK) || defined(__DOXYGEN__)
 /**
- * @brief SoC  hook executed at the beginning of the reset vector.
+ * @brief SoC hook executed at the beginning of the reset vector.
  *
  * This hook is implemented by the SoC and can be used to perform any
  * SoC-specific initialization.
@@ -32,7 +32,7 @@ void soc_reset_hook(void);
 #define soc_reset_hook() do { } while (0)
 #endif
 
-#ifdef CONFIG_SOC_PREP_HOOK
+#if defined(CONFIG_SOC_PREP_HOOK) || defined(__DOXYGEN__)
 /**
  * @brief SoC hook executed after the reset vector.
  *
@@ -44,7 +44,7 @@ void soc_prep_hook(void);
 #define soc_prep_hook() do { } while (0)
 #endif
 
-#ifdef CONFIG_SOC_EARLY_INIT_HOOK
+#if defined(CONFIG_SOC_EARLY_INIT_HOOK) || defined(__DOXYGEN__)
 /**
  * @brief SoC hook executed before the kernel and devices are initialized.
  *
@@ -56,7 +56,7 @@ void soc_early_init_hook(void);
 #define soc_early_init_hook() do { } while (0)
 #endif
 
-#ifdef CONFIG_SOC_LATE_INIT_HOOK
+#if defined(CONFIG_SOC_LATE_INIT_HOOK) || defined(__DOXYGEN__)
 /**
  * @brief SoC hook executed after the kernel and devices are initialized.
  *
@@ -68,7 +68,7 @@ void soc_late_init_hook(void);
 #define soc_late_init_hook() do { } while (0)
 #endif
 
-#ifdef CONFIG_SOC_PER_CORE_INIT_HOOK
+#if defined(CONFIG_SOC_PER_CORE_INIT_HOOK) || defined(__DOXYGEN__)
 /**
  * @brief SoC per-core initialization
  *
@@ -80,7 +80,7 @@ void soc_per_core_init_hook(void);
 #define soc_per_core_init_hook() do { } while (0)
 #endif
 
-#ifdef CONFIG_BOARD_EARLY_INIT_HOOK
+#if defined(CONFIG_BOARD_EARLY_INIT_HOOK) || defined(__DOXYGEN__)
 /**
  * @brief Board hook executed before the kernel starts.
  *
@@ -93,7 +93,7 @@ void board_early_init_hook(void);
 #define board_early_init_hook() do { } while (0)
 #endif
 
-#ifdef CONFIG_BOARD_LATE_INIT_HOOK
+#if defined(CONFIG_BOARD_LATE_INIT_HOOK) || defined(__DOXYGEN__)
 /**
  * @brief Board hook executed after the kernel starts.
  *