From patchwork Mon Nov 28 05:43:03 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 26515 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:f944:0:0:0:0:0 with SMTP id q4csp5452110wrr; Sun, 27 Nov 2022 21:47:31 -0800 (PST) X-Google-Smtp-Source: AA0mqf5rTcfPZLTweG0jLoII63rQgtAc0smgU5sv/xvTzF45epR2OSOHJwbZ69SEylSHf4fWkkSO X-Received: by 2002:a63:f406:0:b0:477:cc1f:204 with SMTP id g6-20020a63f406000000b00477cc1f0204mr17803222pgi.592.1669614451076; Sun, 27 Nov 2022 21:47:31 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1669614451; cv=none; d=google.com; s=arc-20160816; b=NRvAAOw68rThtU4l0I2pXmgQuINXDzhVoVAyYupBQRojtZmfRQgQ4vYrnk8gtzKOui +9O9/JMN/w742/jWq2s7GpwdaHRkI46Ch7JgDEeLVTiaNQvEJkkwHNU3a2H8QaAoMuuA krEqdKazQCRiEiKmFWuL4cmV2n+rjrKeC1r7dLBA6TyG8qDnOeonkUq19ZC0Ee3y8L3q qalLb6V03C6YgO1DjXenI/lOrgNXR6lcUq6oqlt5pID2e9tsOoXcJOMa7TTjzCzNneIc S+28i2RVVW3qhuqrqzWBH+kuQSdlrJN0Xu7pGBAYyG4y98zMBl+fs9Aer0e7K4IRAwKh uTOw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=rAZjs5UVPuF5bfxao1OY7vzICa60Q2zFN/Hm2qt2VHU=; b=rluHPkI6mOqTzog7G70Pk6s3r9UyRrWgz7LUIGXoCDrwgg5vK1TmXC6dOjp4duH9B3 Q7hftBgZyYHefK5mkxWZ7LXJPH8XC9BbynZP7djLxcimsBEeisog0ak8F/oS9XMKu3nJ z5ZPMcrMNZhoyubL+HT3b/xxD1fU9zKclFkgEKF3De+Rq7LMBsbEMK+dU1476jK432zh UpSMxp78h/aBC/Bh/DGdfL3fROas8iGTrVNX1lgXVinVr6C0tVrCMj9DTzkIMdQg6spc QqfojC2vKM4jmgBhYvHHuN1fOx+IRFgJJ2LDZdy7BxQWoelLHFtT2VR0KzFMGNcIoMze 9HVw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=casper.20170209 header.b="CPlXT/MS"; 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id w14-20020a170902e88e00b00176953fee67si11824397plg.86.2022.11.27.21.47.17; Sun, 27 Nov 2022 21:47:31 -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=@infradead.org header.s=casper.20170209 header.b="CPlXT/MS"; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229610AbiK1FnN (ORCPT + 99 others); Mon, 28 Nov 2022 00:43:13 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47268 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229503AbiK1FnM (ORCPT ); Mon, 28 Nov 2022 00:43:12 -0500 Received: from casper.infradead.org (casper.infradead.org [IPv6:2001:8b0:10b:1236::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4C7286151; Sun, 27 Nov 2022 21:43:11 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:MIME-Version: Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type:Content-ID: Content-Description:In-Reply-To:References; bh=rAZjs5UVPuF5bfxao1OY7vzICa60Q2zFN/Hm2qt2VHU=; b=CPlXT/MSLy7JhJ6JO5Jfwo++/p L8SaNZpnC+leKaKJV9IbxZimN4AISrYseGendIuLB91Ky60ID+0zESWRBQ8emK7crgXLXjtKUPz7C 79lZxrt26G38UtVoULi3xyzrm6m7UBMETyz8YzleQ9D0SeAYwnmN5L8AQYdsvk2r0+gojaYKxEjAF 1KgGjCcgz5+hXKM9f2VNnzdprOLlkDpPg6lmh0ihkbBbM60joL6ATuOC8FRQYEQecRMML9/KiUP3k F1uiN6vUDS7gRZzRq8L4Tjg3czSKeW4eu6QvE8rLtEIq5WKDyDs7m1zM3F+w60un/9vIgxL4bohZ+ mf48/4Ag==; Received: from [2601:1c2:d80:3110::a2e7] (helo=casper.infradead.org) by casper.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1ozWvD-00COhF-1z; Mon, 28 Nov 2022 05:43:15 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , linux-media@vger.kernel.org, Robert Schlabbach , Mauro Carvalho Chehab Subject: [PATCH -next] media: dvb/frontend.h: fix kernel-doc warnings Date: Sun, 27 Nov 2022 21:43:03 -0800 Message-Id: <20221128054303.3124-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.38.1 MIME-Version: 1.0 X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_NONE autolearn=ham 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?1750717642254173065?= X-GMAIL-MSGID: =?utf-8?q?1750717642254173065?= scripts/kernel-doc spouts multiple warnings, so fix them: include/uapi/linux/dvb/frontend.h:399: warning: Enum value 'QAM_1024' not described in enum 'fe_modulation' include/uapi/linux/dvb/frontend.h:399: warning: Enum value 'QAM_4096' not described in enum 'fe_modulation' frontend.h:286: warning: contents before sections frontend.h:780: warning: missing initial short description on line: * enum atscmh_rs_code_mode Fixes: 8220ead805b6 ("media: dvb/frontend.h: document the uAPI file") Fixes: 6508a50fe84f ("media: dvb: add DVB-C2 and DVB-S2X parameter values") Signed-off-by: Randy Dunlap Cc: linux-media@vger.kernel.org Cc: Robert Schlabbach Cc: Mauro Carvalho Chehab Reviewed-by: Robert Schlabbach Reviewed-by: Bagas Sanjaya --- include/uapi/linux/dvb/frontend.h | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff -- a/include/uapi/linux/dvb/frontend.h b/include/uapi/linux/dvb/frontend.h --- a/include/uapi/linux/dvb/frontend.h +++ b/include/uapi/linux/dvb/frontend.h @@ -282,7 +282,6 @@ enum fe_spectral_inversion { /** * enum fe_code_rate - Type of Forward Error Correction (FEC) * - * * @FEC_NONE: No Forward Error Correction Code * @FEC_1_2: Forward Error Correction Code 1/2 * @FEC_2_3: Forward Error Correction Code 2/3 @@ -363,8 +362,8 @@ enum fe_code_rate { * @APSK_32: 32-APSK modulation * @DQPSK: DQPSK modulation * @QAM_4_NR: 4-QAM-NR modulation - * @QAM-1024: 1024-QAM modulation - * @QAM-4096: 4096-QAM modulation + * @QAM_1024: 1024-QAM modulation + * @QAM_4096: 4096-QAM modulation * @APSK_8_L: 8APSK-L modulation * @APSK_16_L: 16APSK-L modulation * @APSK_32_L: 32APSK-L modulation @@ -777,7 +776,7 @@ enum atscmh_rs_frame_mode { }; /** - * enum atscmh_rs_code_mode + * enum atscmh_rs_code_mode - ATSC-M/H Reed Solomon modes * @ATSCMH_RSCODE_211_187: Reed Solomon code (211,187). * @ATSCMH_RSCODE_223_187: Reed Solomon code (223,187). * @ATSCMH_RSCODE_235_187: Reed Solomon code (235,187).