dma-buf: Reorganize device dma access docs
authorDaniel Vetter <daniel.vetter@ffwll.ch>
Fri, 9 Dec 2016 18:53:07 +0000 (19:53 +0100)
committerSumit Semwal <sumit.semwal@linaro.org>
Tue, 13 Dec 2016 11:39:51 +0000 (17:09 +0530)
commit2904a8c1311f02896635fd35744262413a0b2726
treece61b0e4799617f22b315ffa83cd04beb6d97afb
parent24a367348a017555f982a9ee137070a7a821fa97
dma-buf: Reorganize device dma access docs

- Put the initial overview for dma-buf into dma-buf.rst.
- Put all the comments about detailed semantics into the right
  kernel-doc comment for functions or ops structure member.
- To allow that detail, switch the reworked kerneldoc to inline style
  for dma_buf_ops.
- Tie everything together into a much more streamlined overview
  comment, relying on the hyperlinks for all the details.
- Also sprinkle some links into the kerneldoc for dma_buf and
  dma_buf_attachment to tie it all together.

Cc: linux-doc@vger.kernel.org
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Sumit Semwal <sumit.semwal@linaro.org>
Signed-off-by: Daniel Vetter <daniel.vetter@intel.com>
Signed-off-by: Sumit Semwal <sumit.semwal@linaro.org>
Link: http://patchwork.freedesktop.org/patch/msgid/20161209185309.1682-4-daniel.vetter@ffwll.ch
Documentation/dma-buf-sharing.txt
Documentation/driver-api/dma-buf.rst
drivers/dma-buf/dma-buf.c
drivers/dma-buf/sync_file.c
include/linux/dma-buf.h