drm/print: Unconfuse kerneldoc
authorDaniel Vetter <daniel.vetter@ffwll.ch>
Thu, 14 Dec 2017 20:30:51 +0000 (21:30 +0100)
committerDaniel Vetter <daniel.vetter@ffwll.ch>
Fri, 15 Dec 2017 10:13:39 +0000 (11:13 +0100)
commit42f1b310332916d130455f300504b72f80c2a66c
treeae17e74c81641b9dc7192975c5b5beec5f3aab9d
parent7cdeb37c66e9b48fce8be9373bf5c96f2dd76c75
drm/print: Unconfuse kerneldoc

It thinks we want to document the __printf(2,0) annotion. Not sure we
want to teach it about all possible gcc-only flags, hence why I opted
for the cheap trick of just moving it ahead of the kerneldoc.

This is only a problem for static inline functions, since for
non-inline function the kerneldoc is in the .c file, but the special
annotations are all in the header.

Cc'ing kernel-doc maintainers as fyi.

Cc: linux-doc@vger.kernel.org
Cc: Jonathan Corbet <corbet@lwn.net>
Acked-by: Alex Deucher <alexander.deucher@amd.com>
Signed-off-by: Daniel Vetter <daniel.vetter@intel.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20171214203054.20141-3-daniel.vetter@ffwll.ch
include/drm/drm_print.h