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

@@ -19,7 +19,7 @@
  * directly from application code but may be freely used within the OS.
  */
 
-#ifdef CONFIG_SOC_EARLY_RESET_HOOK
+#if defined(CONFIG_SOC_EARLY_RESET_HOOK) || defined(__DOXYGEN__)
 /**
  * @brief SoC hook executed before data RAM initialization, at the beginning
  * of the reset vector.
@@ -33,9 +33,9 @@ void soc_early_reset_hook(void);
 #define soc_early_reset_hook() do { } while (0)
 #endif
 
-#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.
@@ -45,7 +45,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.
  *
@@ -57,7 +57,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.
  *
@@ -69,7 +69,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.
  *
@@ -81,7 +81,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
  *
@@ -93,7 +93,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.
  *
@@ -106,7 +106,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.
  *