From patchwork Sun Jan 29 15:04:35 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Jonathan_Neusch=C3=A4fer?= X-Patchwork-Id: 50001 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp1784010wrn; Sun, 29 Jan 2023 07:25:38 -0800 (PST) X-Google-Smtp-Source: AK7set8YyTHV7v/QNyvzVK7OiQdPa9wFtq/6VD9+VrsV2cxU8xC7DYlPQvpUvTBkijWAslD0ufGK X-Received: by 2002:a05:6a21:e382:b0:bc:fed4:5a88 with SMTP id cc2-20020a056a21e38200b000bcfed45a88mr996242pzc.0.1675005938407; Sun, 29 Jan 2023 07:25:38 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1675005938; cv=none; d=google.com; s=arc-20160816; b=xdgx9TL1JIXaOIKn8CQozna0MM+VY00dta89zwm2w4c8VaPRiIHzb359km7r+qK0sj cfw0Ab+9IZbzC51LQVkP7ScrCpNlQTTFlztjsia4Pa9D6esbaOzwSX4yywJqaapeh1zm ecPkf5Ip8A7XTbmQEyi1luF4tJ5QouG24xioOK5YsV/+ls0g/6AvTaWRZEQrpAsU8x/S G4cRFIjPJLvLoQsQdIUq6hh0opuRMOkvWy2NQ6gWP9rDKtURVOz0fq4ble14yFPRxju3 2HXlrV6xvlw1+U0Si4Wk1vG0tpq7Y9n+FnaovRUZko6pKYuDlsZbXfQEucYyqbGR+xxa XOAg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:ui-outboundreport:content-transfer-encoding :mime-version:message-id:date:subject:cc:to:from:dkim-signature; bh=LKM9+AkAZ2k8wD2UTDat70Yx32Z0654CB/qqvWDqscg=; b=BYyZYe1zMKO+9Xhoyknu/JulH7lIJkWNB54MBh0uKj6CEP4sjRQjBXQBHvIvJT03O+ xmn5dHZzNMuRp8E6eVwSJ5ZmnMyWLD35kx1rfdvMqMQpCD1BeRuV7+PjYPimNZCra/zZ UL7sXfFvNPhKcH1VTAHOBN3JCde93+eMdkSTU1vjnzV8ylA7a9yiugAcEkbTsRvzrZcQ 46OVooJrierqeW4Toi+x/Prb2s6jgmMH9GxjA3n+ERbgiChIBKJA5zm4sw/aSUOfhrVE iGceSCwGrVaFKWFubLbhygCDUFjyzad2wfgdDmw693I/3ydlDtYG0qb6lt9uZouXCuQY S8bQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmx.net header.s=s31663417 header.b=ret9eSyr; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmx.net Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id e188-20020a6369c5000000b004b64146f245si9613920pgc.148.2023.01.29.07.25.25; Sun, 29 Jan 2023 07:25:38 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@gmx.net header.s=s31663417 header.b=ret9eSyr; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmx.net Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234460AbjA2PEq (ORCPT + 99 others); Sun, 29 Jan 2023 10:04:46 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48164 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234449AbjA2PEn (ORCPT ); Sun, 29 Jan 2023 10:04:43 -0500 Received: from mout.gmx.net (mout.gmx.net [212.227.17.21]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 283B61E9E9; Sun, 29 Jan 2023 07:04:41 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=s31663417; t=1675004677; bh=4jrPQunuxuiB0eXyNSnLg5DAL4du4RKWiXJDWj48ScQ=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date; b=ret9eSyrY4ldDebnL0lUtrtE/S7uFAmoF2LlozbctRQ6GyXLwbiM5tusM/9w0iG6G pkahQ+a+wFat97al5vekNz9ixdOBarMF+PGuR57+/ypfddrhjONZXiiPY8SV6NEpzz yRWRTMRDmirz5iW6PUxoJcOEIEQZjlROzFQETL+cfU93R7kcb+2zOUjkEaEYsfAc9F Sawo/SYJtR30ZUiJ0laDjDbqg6IBshFeTNliLsJ0ReuJ9jpQPhVreP7QNuFF4+fOww xxRnIBjxffqYi9yz6Q/EhxXunaj3F9gpMHyG8vHmYa5/D9bJoaj9YyDHdxrI+RVLZn 4E6wKimSEPmKg== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Received: from probook ([95.223.44.193]) by mail.gmx.net (mrgmx104 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MA7GM-1pWcZD1dVK-00BcTh; Sun, 29 Jan 2023 16:04:37 +0100 From: =?utf-8?q?Jonathan_Neusch=C3=A4fer?= To: linux-doc@vger.kernel.org Cc: =?utf-8?q?Jonathan_Neusch=C3=A4fer?= , Jonathan Corbet , linux-kernel@vger.kernel.org Subject: [PATCH] scripts: kernel-doc: Remove workaround for @param... syntax Date: Sun, 29 Jan 2023 16:04:35 +0100 Message-Id: <20230129150435.1510400-1-j.neuschaefer@gmx.net> X-Mailer: git-send-email 2.39.0 MIME-Version: 1.0 X-Provags-ID: V03:K1:9vZVQ0xybHF13EjRMUHbJl3XT9TEgx/ZUcDRfFJSFOnRWZuSYu3 ggnTIE/TmhdsLD3ovH6TRkIHnYBl9K6UKaEyZ2yscnpgJI7XLd0ZqrNLBD0ZSuIPay1xxOf lwa4WuQIq3A67ShTWcQNydwbD6MZkfkNC4q8sQOGBu61BtTrYZvfckz9b1BiJju/1fKAvqK bt48BOsciEbWE2jgsdTJA== UI-OutboundReport: notjunk:1;M01:P0:X07j5CW3+E4=;gwAtE4sDFy2xg/jUx29Rdar6Txy /kNXmCr9NwkdAHuuBMPhQR3mhPl27T3oRHkhRBcY6WoN+Hcm/eJ55pId3tqS7+nOTWIrYkLup +ZuM60sVKKdMjgC4yjfmDdbyvrkqq5tH/PoMdNhzWA7/+xOxYRb4S6v+3V/km5YBI5OjaNArh CorSuHIHjTFgZ8wby5Fl8V1VgBeVGqwY3SrJTbyXx4dYsefFiUCDGLBvifG9fBTk35eA+WeZG q2bqx1TjV3RcKUv6Ue5AC6UUOGBjSKlHr1LTes55CMuXFudNtpTGqkpuqPYLxQksPc92zkeLT 5X3MDEzVXZjCbAeJ0FMGgNX9jbpToNGD6YC8PPKeYTRmDgAI69TWzx5FHW3FshFOollVm9QrO mG/UyfwzQOU6gTlR4e3uJ8kx5pgX+NH12TBuOzlw/g4QTT0NLG2R+ZdQQCkUElY5dt35v/TC3 KPR70g8Ht6yuCDxmaNU2lKjrhKQMxg77UDT0KTReS2Tt444AYGUoh/1/o93hiGZgSV6jLXiDl Jkobhvd7YPT7pHXOm1VBX3fUYc+4R1HvbD0Pn0TmNxFTS0XVYufzTnFs0L1W1VHy6bt9ldJMa 4FQ+MKcOT7hkE/bUkuX69zFSMcEN+5swrHWhEt9aZHyPSvDO4yXdDkcrSY58J5kIlzS1vawRp FSieVzmbhc+4Ips2KIhhiy4dE0K02kPlG5Q1fcJUNscf1iR/frzsEImCxLglIahVkGZzJ+ObG 5iReV3imLjC8T/YKzISdw0Fd3Rdj/sNgmFn/fXstxbwBQtPL5jwH5BehakuOEXEbeM31ZDiQ5 +1P9mRnh1gBa/CGPJp0KxFJ1CUBp3wRws1rjPkfAFmF/+F3tzdWi4X2eEybfbT+B1/KQdjwuT vhz103rJgR4X6lPaMOmsHD0YP5TC5iof19X53zR1rji5DzIOgSTyj4dXMqy9lZcnfOoMMj++D kvi54/9bSv9bNSRmdJLoureyES0= X-Spam-Status: No, score=0.5 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H2,RCVD_IN_SBL_CSS,SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1756371027151533640?= X-GMAIL-MSGID: =?utf-8?q?1756371027151533640?= Commit 43756e347f21 ("scripts/kernel-doc: Add support for named variable macro arguments") improved how named variable macro arguments are handled, and changed how they are documented in kerneldoc comments from "@param...", to "@param", deprecating the old syntax. All users of the old syntax have since been converted, so this commit finally removes support for it. The output of "make htmldocs" is the same with and without this commit. Signed-off-by: Jonathan Neuschäfer --- scripts/kernel-doc | 11 ----------- 1 file changed, 11 deletions(-) -- 2.39.0 diff --git a/scripts/kernel-doc b/scripts/kernel-doc index 54b0893cae666..5cf38abdaf9da 100755 --- a/scripts/kernel-doc +++ b/scripts/kernel-doc @@ -2079,17 +2079,6 @@ sub process_name($$) { sub process_body($$) { my $file = shift; - # Until all named variable macro parameters are - # documented using the bare name (`x`) rather than with - # dots (`x...`), strip the dots: - if ($section =~ /\w\.\.\.$/) { - $section =~ s/\.\.\.$//; - - if ($verbose) { - emit_warning("${file}:$.", "Variable macro arguments should be documented without dots\n"); - } - } - if ($state == STATE_BODY_WITH_BLANK_LINE && /^\s*\*\s?\S/) { dump_section($file, $section, $contents); $section = $section_default;