Claude review: drm/exec: drm_exec.h: eliminate kernel-doc warnings

[Claude Code Review Bot <claude-review@example.com>]

Overall Series Review

Subject: drm/exec: drm_exec.h: eliminate kernel-doc warnings
Author: Randy Dunlap <rdunlap@infradead.org>
Patches: 1
Reviewed: 2026-05-28T12:04:23.470549

---

This is a single-patch series from Randy Dunlap fixing kernel-doc warnings in `include/drm/drm_exec.h`. The patch is trivial and correct — it addresses two distinct kernel-doc issues:

1. **Missing `Returns:` tag** — kernel-doc requires `Returns:` (with colon) rather than just `Returns` for return value documentation.
2. **Parameter name mismatch** — the `drm_exec_retry()` macro uses `_exec` as its parameter name but the kernel-doc documented it as `@exec`.

Both fixes are mechanical and match the actual code. The Fixes tag references `bba175a2d4be ("drm/exec, drm/xe: Avoid abusing the drm_exec retry pointer")` which introduced `drm_exec_retry()` with the underscore-prefixed parameter and the `drm_exec_is_contended()` return value issue. Note: The patches did not apply to the drm-next tree because the referenced commit (which adds `drm_exec_retry()`) has not yet landed on drm-next — the tree only has `drm_exec_retry_on_contention`, not `drm_exec_retry`.

**Verdict: Patch looks good.** No functional concerns.

---
Generated by Claude Code Patch Reviewer