From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-13.1 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,INCLUDES_PATCH,MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 9730DC47423 for ; Fri, 2 Oct 2020 05:50:24 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 5E14620796 for ; Fri, 2 Oct 2020 05:50:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601617824; bh=sTwGnquoE6P2N3xCIRO9CZ2Os6A80mTdNqw5RZU1SyA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:List-ID:From; b=zWN9fKMkGx6LSFP0CabRcyv2on1H+Jt84zQYnxdSy5juqpcoYi9lSbRQag2p/Jv87 OsPmaIaWDtSSPwx8pGKxXWgTdXgNfm5mW9ru9unTWhVR2iKzVHfkSVbVmQt7HtEG0C T81HZ3uBVbAkGe9weru4KUOlHMJtBz7w+3tEoRqA= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726232AbgJBFuX (ORCPT ); Fri, 2 Oct 2020 01:50:23 -0400 Received: from mail.kernel.org ([198.145.29.99]:59758 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725951AbgJBFt7 (ORCPT ); Fri, 2 Oct 2020 01:49:59 -0400 Received: from mail.kernel.org (ip5f5ad59f.dynamic.kabel-deutschland.de [95.90.213.159]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 75CED20796; Fri, 2 Oct 2020 05:49:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601617798; bh=sTwGnquoE6P2N3xCIRO9CZ2Os6A80mTdNqw5RZU1SyA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=LO/yhVjpcKKYyooCaLTv+Auj+IRmFi1qXp6f+Nlpzm4Dl0nWPYW5Qw0Rk/AFH0e0u JAdr2UncxBX6V0kfPK5Br6yHvCdLGxK7bHA+/Dw/GONDcggVRXpK8G+vZf+Bf11lOr fum2cdAd3wNLjAcbamr47ooKDjH2QZVemXVPmApA= Received: from mchehab by mail.kernel.org with local (Exim 4.94) (envelope-from ) id 1kODx6-006hit-By; Fri, 02 Oct 2020 07:49:56 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "David S. Miller" , "Jonathan Corbet" , Andrew Lunn , linux-kernel@vger.kernel.org Subject: [PATCH 5/6] scripts: kernel-doc: add support for typedef enum Date: Fri, 2 Oct 2020 07:49:49 +0200 Message-Id: X-Mailer: git-send-email 2.26.2 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The PHY kernel-doc markup has gained support for documenting a typedef enum. However, right now the parser was not prepared for it. So, add support for parsing it. Fixes: 4069a572d423 ("net: phy: Document core PHY structures") Signed-off-by: Mauro Carvalho Chehab --- scripts/kernel-doc | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/scripts/kernel-doc b/scripts/kernel-doc index d94e28fcead0..5ac3749905e5 100755 --- a/scripts/kernel-doc +++ b/scripts/kernel-doc @@ -1339,14 +1339,22 @@ sub show_warnings($$) { sub dump_enum($$) { my $x = shift; my $file = shift; + my $members; + $x =~ s@/\*.*?\*/@@gos; # strip comments. # strip #define macros inside enums $x =~ s@#\s*((define|ifdef)\s+|endif)[^;]*;@@gos; - if ($x =~ /enum\s+(\w*)\s*\{(.*)\}/) { + if ($x =~ /typedef\s+enum\s*\{(.*)\}\s*(\w*)\s*;/) { + $declaration_name = $2; + $members = $1; + } elsif ($x =~ /enum\s+(\w*)\s*\{(.*)\}/) { $declaration_name = $1; - my $members = $2; + $members = $2; + } + + if ($declaration_name) { my %_members; $members =~ s/\s+$//; @@ -1381,8 +1389,7 @@ sub dump_enum($$) { 'sections' => \%sections, 'purpose' => $declaration_purpose }); - } - else { + } else { print STDERR "${file}:$.: error: Cannot parse enum!\n"; ++$errors; } -- 2.26.2