Claude review: drm/tegra: tegra_drm.h: fix all uapi kernel-doc warnings

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

Patch Review

**Struct member descriptions (lines 307, 325 in patched file):**

The two added descriptions fix the documented warnings for `cmdbuf` and `target` members of `struct drm_tegra_reloc`:

```c
/** @cmdbuf: cmd information */
struct {
```

```c
/** @target: relocate target information */
struct {
```

These are correct and silence the warnings. Minor nit: `"cmd information"` is quite vague — something like `"command buffer location"` would better match the sub-fields (`handle` and `offset` into the command buffer), but this is a stylistic preference and the existing text is adequate.

**Define constant comments (lines 782–861 in patched file):**

The four `#define` comments are converted from bare `/**` blocks (which the kernel-doc parser flags as malformed) to proper `define MACRO - description` form. For example:

```c
/**
 * define DRM_TEGRA_SUBMIT_CMD_GATHER_UPTR - \
 *    Execute Host1x opcodes from user pointer.
 *
 * Execute `words` words of Host1x opcodes specified in the `gather_data_ptr`
 * buffer. Each GATHER_UPTR command uses successive words from the buffer.
 */
#define DRM_TEGRA_SUBMIT_CMD_GATHER_UPTR		0
```

The `\` line-continuation on the first `define` line is used to keep line length manageable, particularly for `DRM_TEGRA_SUBMIT_RELOC_SECTOR_LAYOUT`. This works with the kernel-doc script's line-joining logic, so it should parse correctly. The added short descriptions (`"Select sector layout swizzling..."`, `"Execute Host1x opcodes..."`, `"Wait for syncpoint (absolute)."`, `"Wait for syncpoint (relative)."`) are clear and appropriate.

**No functional code changes.** Only documentation comments are modified. No risk of runtime behavior change since this is a UAPI header and only comment lines are touched.

**Verdict:** Patch is correct and ready to merge. The warnings are real, the fixes are appropriate, and the Tegra maintainer has already acked it.

---
Generated by Claude Code Patch Reviewer