docs: fix anonymous flags in various structs

I noticed a few structs where the flags didn't show up correctly in the
docs.
Naming the flag struct makes the individual flags appear properly in the
nested struct.

Merges #17803
Closes #17804

Author: VaiaPatta1985

components/esp_driver_mcpwm/include/driver/mcpwm_cap.h

@@ -22,7 +22,8 @@ typedef struct {
     int group_id;                         /*!< Specify from which group to allocate the capture timer */
     mcpwm_capture_clock_source_t clk_src; /*!< MCPWM capture timer clock source */
     uint32_t resolution_hz;               /*!< Resolution of capture timer */
-    struct {
+    /// Extra configuration flags for capture timer
+    struct extra_mcpwm_capture_timer_flags {
         uint32_t allow_pd: 1;       /*!< Set to allow power down. When this flag set, the driver will backup/restore the MCPWM registers before/after entering/exist sleep mode.
                                       By this approach, the system can power off MCPWM's power domain.
                                       This can save power, but at the expense of more RAM being consumed.*/

components/esp_driver_mcpwm/include/driver/mcpwm_cmpr.h

@@ -21,7 +21,8 @@ extern "C" {
 typedef struct {
     int intr_priority;                  /*!< MCPWM comparator interrupt priority,
                                              if set to 0, the driver will try to allocate an interrupt with a relative low priority (1,2,3) */
-    struct {
+    /// Extra configuration flags for comparator
+    struct extra_mcpwm_comparator_flags {
         uint32_t update_cmp_on_tez: 1;  /*!< Whether to update compare value when timer count equals to zero (tez) */
         uint32_t update_cmp_on_tep: 1;  /*!< Whether to update compare value when timer count equals to peak (tep) */
         uint32_t update_cmp_on_sync: 1; /*!< Whether to update compare value on sync event */

components/esp_driver_mcpwm/include/driver/mcpwm_fault.h

@@ -23,7 +23,8 @@ typedef struct {
     int intr_priority;            /*!< MCPWM GPIO fault interrupt priority,
                                        if set to 0, the driver will try to allocate an interrupt with a relative low priority (1,2,3) */
     int gpio_num;                 /*!< GPIO used by the fault signal */
-    struct {
+    /// Extra configuration flags for GPIO fault
+    struct extra_mcpwm_gpio_fault_flags {
         uint32_t active_level: 1; /*!< On which level the fault signal is treated as active */
     } flags;                      /*!< Extra configuration flags for GPIO fault */
 } mcpwm_gpio_fault_config_t;

components/esp_driver_mcpwm/include/driver/mcpwm_gen.h

@@ -20,7 +20,8 @@ extern "C" {
  */
 typedef struct {
     int gen_gpio_num;           /*!< The GPIO number used to output the PWM signal */
-    struct {
+    /// Extra configuration flags for generator
+    struct extra_mcpwm_generator_flags {
         uint32_t invert_pwm: 1;   /*!< Whether to invert the PWM signal (done by GPIO matrix) */
     } flags;                      /*!< Extra configuration flags for generator */
 } mcpwm_generator_config_t;

components/esp_driver_mcpwm/include/driver/mcpwm_oper.h

@@ -22,7 +22,8 @@ typedef struct {
     int group_id;                              /*!< Specify from which group to allocate the MCPWM operator */
     int intr_priority;                         /*!< MCPWM operator interrupt priority,
                                                     if set to 0, the driver will try to allocate an interrupt with a relative low priority (1,2,3) */
-    struct {
+    /// Extra configuration flags for operator
+    struct extra_mcpwm_operator_flags {
         uint32_t update_gen_action_on_tez: 1;  /*!< Whether to update generator action when timer counts to zero */
         uint32_t update_gen_action_on_tep: 1;  /*!< Whether to update generator action when timer counts to peak */
         uint32_t update_gen_action_on_sync: 1; /*!< Whether to update generator action on sync event */

components/esp_driver_mcpwm/include/driver/mcpwm_sync.h

@@ -20,9 +20,10 @@ extern "C" {
  */
 typedef struct {
     mcpwm_timer_event_t timer_event; /*!< Timer event, upon which MCPWM timer will generate the sync signal */
-    struct {
+    /// Extra configuration flags for timer sync source
+    struct extra_mcpwm_timer_sync_src_flags {
         uint32_t propagate_input_sync: 1; /*!< The input sync signal would be routed to its sync output */
-    } flags;                          /*!< Extra configuration flags for timer sync source */
+    } flags;                              /*!< Extra configuration flags for timer sync source */
 } mcpwm_timer_sync_src_config_t;
 
 /**
@@ -46,7 +47,8 @@ esp_err_t mcpwm_new_timer_sync_src(mcpwm_timer_handle_t timer, const mcpwm_timer
 typedef struct {
     int group_id; /*!< MCPWM group ID */
     int gpio_num; /*!< GPIO used by sync source */
-    struct {
+    /// Extra configuration flags for GPIO sync source
+    struct extra_mcpwm_gpio_sync_src_flags {
         uint32_t active_neg: 1;   /*!< Whether the sync signal is active on negedge, by default, the sync signal's posedge is treated as active */
     } flags;                      /*!< Extra configuration flags for GPIO sync source */
 } mcpwm_gpio_sync_src_config_t;

components/esp_driver_mcpwm/include/driver/mcpwm_timer.h

@@ -37,7 +37,8 @@ typedef struct {
     uint32_t period_ticks;               /*!< Number of count ticks within a period */
     int intr_priority;                   /*!< MCPWM timer interrupt priority,
                                               if set to 0, the driver will try to allocate an interrupt with a relative low priority (1,2,3) */
-    struct {
+    /// Extra configuration flags for MCPWM timer
+    struct extra_mcpwm_timer_flags {
         uint32_t update_period_on_empty: 1; /*!< Whether to update period when timer counts to zero */
         uint32_t update_period_on_sync: 1;  /*!< Whether to update period on sync event */
         uint32_t allow_pd: 1;               /*!< Set to allow power down. When this flag set, the driver will backup/restore the MCPWM registers before/after entering/exist sleep mode.

components/esp_driver_parlio/include/driver/parlio_rx.h

@@ -33,14 +33,15 @@ typedef struct {
                                                          Only takes effect when using level or pulse delimiter, set to `-1` if only use the soft delimiter */
     gpio_num_t              data_gpio_nums[PARLIO_RX_UNIT_MAX_DATA_WIDTH]; /*!< Parallel IO data GPIO numbers, set to `-1` if it's not used,
                                                                                 The driver will take [0 .. (data_width - 1)] as the data pins */
-    struct {
+    /// Extra configuration flags for PARLIO RX unit
+    struct extra_parlio_rx_unit_flags {
         uint32_t            free_clk : 1;           /*!< Whether the input external clock is a free-running clock. A free-running clock will always keep running (e.g. I2S bclk),
                                                          a non-free-running clock will start when there are data transporting and stop when the bus idle (e.g. SPI).
                                                          This flag only takes effect when select PARLIO_CLK_SRC_EXTERNAL as clock source */
         uint32_t            clk_gate_en : 1;        /*!< Enable RX clock gating, only available when the clock direction is output(not supported on ESP32-C6)
                                                          the output clock will be controlled by the valid gpio,
                                                          i.e. high level of valid gpio to enable the clock output, low to disable */
-        uint32_t            allow_pd: 1;             /*!< Set to allow power down. When this flag set, the driver will backup/restore the PARLIO registers before/after entering/exist sleep mode.
+        uint32_t            allow_pd: 1;            /*!< Set to allow power down. When this flag set, the driver will backup/restore the PARLIO registers before/after entering/exist sleep mode.
                                                          By this approach, the system can power off PARLIO's power domain.
                                                          This can save power, but at the expense of more RAM being consumed. */
     } flags;                                        /*!< RX driver flags */

components/esp_driver_parlio/include/driver/parlio_tx.h

@@ -37,7 +37,8 @@ typedef struct {
     size_t dma_burst_size;    /*!< DMA burst size, in bytes */
     parlio_sample_edge_t sample_edge;       /*!< Parallel IO sample edge */
     parlio_bit_pack_order_t bit_pack_order; /*!< Set the order of packing the bits into bytes (only works when `data_width` < 8) */
-    struct {
+    /// Extra configuration flags for PARLIO TX unit
+    struct extra_parlio_tx_unit_flags {
         uint32_t clk_gate_en: 1;  /*!< Enable TX clock gating,
                                        the output clock will be controlled by the MSB bit of the data bus,
                                        i.e. by data_gpio_nums[PARLIO_TX_UNIT_MAX_DATA_WIDTH-1]. High level to enable the clock output, low to disable */

components/esp_driver_pcnt/include/driver/pulse_cnt.h

@@ -64,7 +64,8 @@ typedef struct {
     int high_limit;     /*!< High limitation of the count unit, should be higher than 0 */
     int intr_priority;  /*!< PCNT interrupt priority,
                             if set to 0, the driver will try to allocate an interrupt with a relative low priority (1,2,3) */
-    struct {
+    /// Extra configuration flags for PCNT unit
+    struct extra_pcnt_unit_flags {
         uint32_t accum_count: 1; /*!< Whether to accumulate the count value when overflows at the high/low limit */
 #if SOC_PCNT_SUPPORT_STEP_NOTIFY
         uint32_t en_step_notify_up: 1;   /*!< Enable step notify in the positive direction */
@@ -79,7 +80,8 @@ typedef struct {
 typedef struct {
     int edge_gpio_num;  /*!< GPIO number used by the edge signal. Set to -1 if unused */
     int level_gpio_num; /*!< GPIO number used by the level signal. Set to -1 if unused */
-    struct {
+    /// Extra configuration flags for PCNT channel
+    struct extra_pcnt_chan_flags {
         uint32_t invert_edge_input: 1;   /*!< Invert the input edge signal */
         uint32_t invert_level_input: 1;  /*!< Invert the input level signal */
         uint32_t virt_edge_io_level: 1;  /*!< Virtual edge IO level, 0: low, 1: high. Only valid when edge_gpio_num is set to -1 */
@@ -146,7 +148,8 @@ esp_err_t pcnt_unit_set_glitch_filter(pcnt_unit_handle_t unit, const pcnt_glitch
  */
 typedef struct {
     int clear_signal_gpio_num;  /*!< GPIO number used by the clear signal, the default active level is high */
-    struct {
+    /// Extra configuration flags for PCNT clear signal
+    struct extra_pcnt_clear_signal_flags {
         uint32_t invert_clear_signal: 1;  /*!< Invert the clear input signal */
     } flags;                              /*!< clear signal config flags */
 } pcnt_clear_signal_config_t;