|SUCCESS| doc: fix API comments for Doxygen 1.18.0

[dpdklab at iol.unh.edu]

Test-Label: ai-code-review
Test-Status: SUCCESS
https://dpdk.org/patch/169012

_AI Code Review_

=== Patch Review: series.patch (via Claude) ===
Review date: 2026-09-03

# DPDK Patch Review

## Summary

This patch updates Doxygen comments to fix compatibility issues with Doxygen 1.18.0. The changes are purely documentation-related, removing parentheses from function references and adjusting references to struct members.

---

## Findings

### Errors

None.

### Warnings

None.

### Info

**Documentation quality degradation** (acknowledged in commit message):

The patch notes that anonymous struct/union member references are being degraded from specific field links (e.g., `@ref rte_event.flow_id`) to general struct page links (e.g., `@ref rte_event "flow_id"`). While this is a necessary workaround for Doxygen 1.18.0 limitations, it reduces documentation precision.

The changes appear to be correct workarounds for the upstream Doxygen issues cited in the commit message.

**Function reference style consistency**:

The patch changes function references from `@ref function()` to `@ref function` (removing parentheses). This is applied consistently across all affected references:
- `rte_event_port_preschedule_modify()` - `rte_event_port_preschedule_modify`
- `rte_graph_feature_data_app_cookie_get()` - `rte_graph_feature_data_app_cookie_get`
- `rte_graph_feature_data_first_feature_get()` - `rte_graph_feature_data_first_feature_get`
- `rte_graph_feature_data_next_feature_get()` - `rte_graph_feature_data_next_feature_get`
- `rte_graph_feature_arc_mbuf_dynfields_get()` - `rte_graph_feature_arc_mbuf_dynfields_get`

This is a valid Doxygen reference style, though less explicit about the item being a function.

---

## Conclusion

The patch is **acceptable**. It addresses a real compatibility issue with Doxygen 1.18.0 through minimal, focused changes to documentation comments. No code logic is modified, and no correctness, style, or process violations were identified.

The documentation quality trade-off (struct member links becoming less precise) is clearly documented in the commit message and appears to be unavoidable given the upstream Doxygen behavior changes.