drm/i915: kerneldoc for tiling IOCTL and swizzle functions
authorDaniel Vetter <daniel.vetter@ffwll.ch>
Fri, 24 Jul 2015 15:40:15 +0000 (17:40 +0200)
committerDaniel Vetter <daniel.vetter@ffwll.ch>
Mon, 27 Jul 2015 08:26:30 +0000 (10:26 +0200)
commit3271dca483a48759cdbdb5f16a13125ab91f6c05
treee3313a3b9ab06276de9b9b61d07d1a8e3b1749ea
parent7f96ecaf1ea26fd7041acc56379a5c4393ee51ad
drm/i915: kerneldoc for tiling IOCTL and swizzle functions

Chris rightfully suggested that documenting fences without documenting
the BO tiling tracking doesn't make much sense, so fix that.

The important bit to stress here (since it lead to some confusion) is
the GEM doesn't really care about tiling. Except for a few select cases
where the kernel needs to manage something that userspace can't take
care of: Namely the limited number of fences and fixing up swizzling,
although we still fail at the later.

v2: Move the low-level tiling/swizzling functions and kerneldoc to
i915_gem_fence.c and leave only the userspace interface here.
Suggested by Chris.

Cc: Chris Wilson <chris@chris-wilson.co.uk>
Reviewed-by: Chris Wilson <chris@chris-wilson.co.uk>
Signed-off-by: Daniel Vetter <daniel.vetter@intel.com>
Documentation/DocBook/drm.tmpl
drivers/gpu/drm/i915/i915_gem_fence.c
drivers/gpu/drm/i915/i915_gem_tiling.c