[PATCH 0/5] kernel-doc ixes

Eduardo Habkost posted 5 patches 3 years, 7 months ago
Test docker-quick@centos7 failed
Test docker-mingw@fedora failed
Test checkpatch passed
Test FreeBSD passed
Patches applied successfully (tree, apply log)
git fetch https://github.com/patchew-project/qemu tags/patchew/20201003024123.193840-1-ehabkost@redhat.com
Maintainers: Paolo Bonzini <pbonzini@redhat.com>, Eduardo Habkost <ehabkost@redhat.com>, "Daniel P. Berrangé" <berrange@redhat.com>
include/exec/memory.h |  6 +++---
include/qom/object.h  | 22 +++++++++++-----------
scripts/kernel-doc    | 16 +++-------------
3 files changed, 17 insertions(+), 27 deletions(-)
[PATCH 0/5] kernel-doc ixes
Posted by Eduardo Habkost 3 years, 7 months ago
Among other fixes in kernel-doc, this series get rid of
QEMU-specific $decl_type='type name' hack in kernel-doc, because
it made it impossible to document macros with names starting with
uppercase letters (like most of the macros at qom/object.h).

Eduardo Habkost (5):
  kernel-doc: Handle function typedefs that return pointers
  kernel-doc: Handle function typedefs without asterisks
  qom: Explicitly tag doc comments for typedefs and structs
  memory: Explicitly tag doc comments for structs
  kernel-doc: Remove $decl_type='type name' hack

 include/exec/memory.h |  6 +++---
 include/qom/object.h  | 22 +++++++++++-----------
 scripts/kernel-doc    | 16 +++-------------
 3 files changed, 17 insertions(+), 27 deletions(-)

-- 
2.26.2



Re: [PATCH 0/5] kernel-doc ixes
Posted by Paolo Bonzini 3 years, 7 months ago
On 03/10/20 04:41, Eduardo Habkost wrote:
> Among other fixes in kernel-doc, this series get rid of
> QEMU-specific $decl_type='type name' hack in kernel-doc, because
> it made it impossible to document macros with names starting with
> uppercase letters (like most of the macros at qom/object.h).

Thanks, it seemed like a good idea but... it wasn't. :)

Reviewed-by: Paolo Bonzini <pbonzini@redhat.com>

Paolo

> Eduardo Habkost (5):
>   kernel-doc: Handle function typedefs that return pointers
>   kernel-doc: Handle function typedefs without asterisks
>   qom: Explicitly tag doc comments for typedefs and structs
>   memory: Explicitly tag doc comments for structs
>   kernel-doc: Remove $decl_type='type name' hack
> 
>  include/exec/memory.h |  6 +++---
>  include/qom/object.h  | 22 +++++++++++-----------
>  scripts/kernel-doc    | 16 +++-------------
>  3 files changed, 17 insertions(+), 27 deletions(-)
>