drm/fourcc: Add DOC: overview comment
authorBrian Starkey <brian.starkey@arm.com>
Tue, 21 Aug 2018 16:16:11 +0000 (17:16 +0100)
committerAlexandru Gheorghe <alexandru-cosmin.gheorghe@arm.com>
Tue, 21 Aug 2018 17:02:30 +0000 (18:02 +0100)
commit7e7b68ef0076691f05b85a3ecd604a6160015fe9
treeccca1410d3595a3ed076b8fe9e4e2612721cf04f
parentc76abab59b3cb34a0bc819595614844ed28be721
drm/fourcc: Add DOC: overview comment

There's a number of things which haven't previously been documented
around the usage of format modifiers. Capture the current
understanding in an overview comment and add it to the rst
documentation.

Ideally, the generated documentation would also include documentation
of all of the #defines, but the kernel-doc system doesn't currently
support kernel-doc comments on #define constants.

Suggested-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Signed-off-by: Brian Starkey <brian.starkey@arm.com>
Reviewed-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Signed-off-by: Alexandru Gheorghe <alexandru-cosmin.gheorghe@arm.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20180821161611.10424-1-brian.starkey@arm.com
Documentation/gpu/drm-kms.rst
include/uapi/drm/drm_fourcc.h