Re: [Intel-gfx] [PATCH 0/6] Add support for in-line nested struct comments

From: Daniel Vetter
Date: Mon Feb 19 2018 - 10:39:25 EST


On Fri, Feb 16, 2018 at 11:48:14AM -0200, Mauro Carvalho Chehab wrote:
> This series fix two bugs at kernel-doc.rst examples and add support
> for in-line nested struct comments.
>
> It also converts one documentation at intel_dpio_phy to use it,
> in order to give a practical example about how to use it.
>
> Mauro Carvalho Chehab (6):
> doc-guide: kernel-doc: fix example for nested_foobar struct
> doc-guide: kernel-doc: fix example for inlined comments
> doc-guide: kernel-doc: move in-line section to be after nested struct
> scripts: kernel-doc: support in-line comments on nested structs/unions
> doc-guide: kernel-doc: add examples about nested union/structs
> drm: intel_dpio_phy: fix kernel-doc comments at nested struct

Oh, this is cool. Thanks a lot for doing this.
-Daniel

>
> Documentation/doc-guide/kernel-doc.rst | 69 ++++++++++++++++++++--------------
> drivers/gpu/drm/i915/intel_dpio_phy.c | 2 +-
> scripts/kernel-doc | 2 +-
> 3 files changed, 43 insertions(+), 30 deletions(-)
>
> --
> 2.14.3
>
>
> _______________________________________________
> Intel-gfx mailing list
> Intel-gfx@xxxxxxxxxxxxxxxxxxxxx
> https://lists.freedesktop.org/mailman/listinfo/intel-gfx

--
Daniel Vetter
Software Engineer, Intel Corporation
http://blog.ffwll.ch