Re: [PATCH v3 1/1] A compact idiom to add code examples in kerneldoc comments.

From: Greg Kroah-Hartman
Date: Fri Mar 27 2020 - 02:32:42 EST


On Thu, Mar 26, 2020 at 07:51:56PM +0000, peter@xxxxxxxxxxxxxxxxxxxxxxxx wrote:
> From: Peter Lister <peter@xxxxxxxxxxxxxxxxxxxxxxxx>
>
> scripts/kernel-doc - When a double colon follows a section heading
> (e.g. Example::), write a double colon line to the ReST output to make
> the following text (e.g. a code snippet) into a literal block.
>
> drivers/base/platform.c - Changed Example: headings to Example:: to
> literalise code snippets as above.
>
> This patch also removes two kerneldoc build warnings:
> ./drivers/base/platform.c:134: WARNING: Unexpected indentation.
> ./drivers/base/platform.c:213: WARNING: Unexpected indentation.
>
> Signed-off-by: Peter Lister <peter@xxxxxxxxxxxxxxxxxxxxxxxx>
> ---
> drivers/base/platform.c | 4 ++--
> scripts/kernel-doc | 19 +++++++++++++++----
> 2 files changed, 17 insertions(+), 6 deletions(-)

For the driver/base/platform.c change:

Reviewed-by: Greg Kroah-Hartman <gregkh@xxxxxxxxxxxxxxxxxxx>