]> git.baikalelectronics.ru Git - kernel.git/commit
kernel-doc: add support for one line inline struct member doc comments
authorJani Nikula <jani.nikula@intel.com>
Wed, 16 Nov 2016 15:26:16 +0000 (17:26 +0200)
committerJonathan Corbet <corbet@lwn.net>
Wed, 16 Nov 2016 23:30:27 +0000 (16:30 -0700)
commitb8822610c8847e0cfb0efa781845ec5207ea994b
treeb6814f726e98072f37c9d1a40a8128f4d21171ab
parent553b9c370d9e9e36c2e791f4297c2cc2270414f0
kernel-doc: add support for one line inline struct member doc comments

kernel-doc supports documenting struct members "inline" since
fd7ffa968a25 ("scripts/kernel-doc Allow struct arguments documentation
in struct body"). This requires the inline kernel-doc comments to have
the opening and closing comment markers (/** and */ respectively) on
lines of their own, even for short comments. For example:

/**
 * struct foo - struct documentation
 */
struct foo {
/**
 * @bar: member documentation
 */
int bar;
};

Add support for one line inline comments:

/**
 * struct foo - struct documentation
 */
struct foo {
/** @bar: member documentation */
int bar;
};

Note that mixing of the two in one doc comment is not allowed; either
both comment markers must be on lines of their own, or both must be on
the one line. This limitation keeps both the comments more uniform, and
kernel-doc less complicated.

Cc: Daniel Vetter <daniel@ffwll.ch>
Signed-off-by: Jani Nikula <jani.nikula@intel.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
scripts/kernel-doc