commit d5e79eeba3 ("dma-buf: heaps: Deduplicate docs and adopt common
format") fixed the struct dma_heap member list upstream by adding the
colon kernel-doc needs to @heap_devt, @list and @heap_cdev.
That hunk is missing from android-mainline. The drm-next merge cited
below resolved this block by taking the new @priv: line from mainline
while keeping the android side's colonless @heap_devt / @list /
@heap_cdev, next to the ANDROID-only @heap_dev.
Restore the upstream wording, give the ANDROID-only @heap_dev the same
treatment, and document @refcount, which was added later with the heap
device lifetime handling and was never described.
drm-misc-next is clean here, so there is nothing to send upstream for
this.
scripts/kernel-doc -none drivers/dma-buf/dma-heap.c reports five
warnings before this change and none after it.
No functional change.
Fixes: da0c10aefa ("Merge de848da12f ("Merge tag 'drm-next-2024-09-19' of https://gitlab.freedesktop.org/drm/kernel") into android-mainline")
Change-Id: Ic073f95624280d52f6ae39f58768acefd1809f77
Signed-off-by: Hung-Chun Tseng <alan.tseng.cs@gmail.com>
Hung-Chun Tseng
d6549754be