[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 5/5] kernel-doc: Remove $decl_type='type name' hack
From: |
Eduardo Habkost |
Subject: |
[PATCH 5/5] kernel-doc: Remove $decl_type='type name' hack |
Date: |
Fri, 2 Oct 2020 22:41:23 -0400 |
The $decl_type='type name' hack makes it impossible to document
macros with uppercase names (e.g. most of the macros in
object.h).
Now that we have explicitly tagged the struct and typedef doc
comments in memory.h and object.h, we don't need that hack
anymore. This will make the documentation for the macros in
object.h finally be rendered as expected.
Signed-off-by: Eduardo Habkost <ehabkost@redhat.com>
---
scripts/kernel-doc | 12 +-----------
1 file changed, 1 insertion(+), 11 deletions(-)
diff --git a/scripts/kernel-doc b/scripts/kernel-doc
index 57b911ff174..0ff62bb6a2d 100755
--- a/scripts/kernel-doc
+++ b/scripts/kernel-doc
@@ -1064,14 +1064,6 @@ sub output_blockhead {
sub dump_declaration($$) {
no strict 'refs';
my ($prototype, $file) = @_;
- if ($decl_type eq 'type name') {
- if ($prototype =~ /^(enum|struct|union)\s+/) {
- $decl_type = $1;
- } else {
- return;
- }
- }
-
my $func = "dump_" . $decl_type;
&$func(@_);
}
@@ -1928,9 +1920,7 @@ sub process_name($$) {
++$warnings;
}
- if ($identifier =~ m/^[A-Z]/) {
- $decl_type = 'type name';
- } elsif ($identifier =~ m/^struct\b/) {
+ if ($identifier =~ m/^struct\b/) {
$decl_type = 'struct';
} elsif ($identifier =~ m/^union\b/) {
$decl_type = 'union';
--
2.26.2
- [PATCH 0/5] kernel-doc ixes, Eduardo Habkost, 2020/10/02
- [PATCH 2/5] kernel-doc: Handle function typedefs without asterisks, Eduardo Habkost, 2020/10/02
- [PATCH 1/5] kernel-doc: Handle function typedefs that return pointers, Eduardo Habkost, 2020/10/02
- [PATCH 4/5] memory: Explicitly tag doc comments for structs, Eduardo Habkost, 2020/10/02
- [PATCH 5/5] kernel-doc: Remove $decl_type='type name' hack,
Eduardo Habkost <=
- [PATCH 3/5] qom: Explicitly tag doc comments for typedefs and structs, Eduardo Habkost, 2020/10/02
- Re: [PATCH 0/5] kernel-doc ixes, Paolo Bonzini, 2020/10/03