pm: state: use code/endcode for code examples
Enclode code examples using code/endcode Doxygen commands.
Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
diff --git a/include/pm/state.h b/include/pm/state.h
index 1410961..4881492 100644
--- a/include/pm/state.h
+++ b/include/pm/state.h
@@ -117,6 +117,7 @@
* one Zephyr power state. This property allows the platform
* distinguish them. e.g:
*
+ * @code{.dts}
* power-states {
* state0: state0 {
* compatible = "zephyr,power-state";
@@ -132,7 +133,8 @@
* min-residency-us = <20000>;
* exit-latency-us = <200>;
* };
- * }
+ * };
+ * @endcode
*/
uint8_t substate_id;
@@ -196,6 +198,8 @@
* UTIL_LISTIFY func
*
* Example devicetree fragment:
+ *
+ * @code{.dts}
* cpus {
* ...
* cpu0: cpu@0 {
@@ -221,10 +225,14 @@
* exit-latency-us = <500>;
* };
* };
+ * @endcode
*
- * Example usage: *
+ * Example usage:
+ *
+ * @code{.c}
* const struct pm_state_info states[] =
* PM_STATE_INFO_DT_ITEMS_LIST(DT_NODELABEL(cpu0));
+ * @endcode
*
* @param node_id A node identifier with compatible zephyr,power-state
* @return an array of struct pm_state_info.
@@ -264,6 +272,8 @@
* UTIL_LISTIFY func
*
* Example devicetree fragment:
+ *
+ * @code{.dts}
* cpus {
* ...
* cpu0: cpu@0 {
@@ -287,9 +297,13 @@
* min-residency-us = <50000>;
* exit-latency-us = <500>;
* };
+ * @endcode
*
- * Example usage: *
+ * Example usage:
+ *
+ * @code{.c}
* const enum pm_state states[] = PM_STATE_DT_ITEMS_LIST(DT_NODELABEL(cpu0));
+ * @endcode
*
* @param node_id A node identifier with compatible zephyr,power-state
* @return an array of enum pm_state items.