]> git.proxmox.com Git - mirror_qemu.git/commitdiff
kernel-doc: Remove $decl_type='type name' hack
authorEduardo Habkost <ehabkost@redhat.com>
Sat, 3 Oct 2020 02:41:23 +0000 (22:41 -0400)
committerEduardo Habkost <ehabkost@redhat.com>
Tue, 6 Oct 2020 15:09:35 +0000 (11:09 -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>
Reviewed-by: Paolo Bonzini <pbonzini@redhat.com>
Message-Id: <20201003024123.193840-6-ehabkost@redhat.com>
Signed-off-by: Eduardo Habkost <ehabkost@redhat.com>
scripts/kernel-doc

index 57b911ff174859412ac6b53a1d5581fb1f39ddc5..0ff62bb6a2ddb9c7a15a68d002be1537bb1917b2 100755 (executable)
@@ -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';