Received: by 2002:a05:6358:3188:b0:123:57c1:9b43 with SMTP id q8csp4130483rwd; Sun, 11 Jun 2023 00:53:57 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ7YWBHg/OLgRBQ8Unxt0xTUK4sqDyrgkPF3ZkMcKjbYCXmthwCU2cwJNcWVJ73O1s437cci X-Received: by 2002:a17:90b:17c8:b0:259:548b:d394 with SMTP id me8-20020a17090b17c800b00259548bd394mr5396084pjb.28.1686470037337; Sun, 11 Jun 2023 00:53:57 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1686470037; cv=none; d=google.com; s=arc-20160816; b=P3bxZ44Cnh0ECEChoM46UikrORIiObBAT4o9L68bBSeKSipzn+p9dg2BrMa+z64/gE IuoJTVkFjjI/5+D/Nvdkl7a0/t4WBs6ASTen8Um7OeA57f4tdI+P/7f9GUarku7WUPZV VG90R3glH5Pcm8mB1LCD7w//BI181c0IhMYZNmtKkRNAlJ7ZocRE/8lQi5ggKgiNw7mb B7QY887CbWNivRgyq0IugkkhJgTNOaTkbEq3PkEXX5jYWDQG5zCvJoBzWGHH2SF731ay L4h7m06kw8lCrwKm6npkEg6h2Ffa9Cz+lWNaQtikCgsLAOEPGSv+6Qi5rSrlBahmQ8sW GrVQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:in-reply-to :organization:from:content-language:references:cc:to:subject :user-agent:mime-version:date:message-id; bh=IEuXkgw+TgPfzPnxstwRHxsPaOiw6t2vM8CzGpYx1X8=; b=ULt3i1HXbSYOIXlhcqydyV2/vXRravH8jIxPhg+gR3JlfiVgirMUvb+T28cNEEA9TA edrZ6+XQjHFGZJCwtlAxXAbXEPHCsm2JgqN6j42U0/yHfto5bpZEKkxEb9FBZl/OVPJd jR7sOryojutMCCL7hiTqgGl6lezHc4ifRY8LDvg9Pv9OCiuVxhipI5GAydLlja58saUR 1t5FeNHcJ6I9pdlelGZ55RjrKb0vvXSP2V4NX2RkgTdS/aJZNFnpZZf1ACGxFzEk9w4y GCP5eQhUbZpvmSIkLOlm8/ebr/mJY7YZF84P6uQG1SpsnkUPOTsLu0zbo5CQEI1+qwfd E0gg== ARC-Authentication-Results: i=1; mx.google.com; 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 Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id s18-20020a17090a881200b0024e47fae466si2737278pjn.180.2023.06.11.00.53.46; Sun, 11 Jun 2023 00:53:57 -0700 (PDT) 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; 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 S231248AbjFKG7c (ORCPT + 99 others); Sun, 11 Jun 2023 02:59:32 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:54966 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229450AbjFKG7a (ORCPT ); Sun, 11 Jun 2023 02:59:30 -0400 Received: from mail.loongson.cn (mail.loongson.cn [114.242.206.163]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id 788CC30CB for ; Sat, 10 Jun 2023 23:59:27 -0700 (PDT) Received: from loongson.cn (unknown [10.20.42.43]) by gateway (Coremail) with SMTP id _____8DxyOnNcIVkMo8CAA--.5821S3; Sun, 11 Jun 2023 14:59:25 +0800 (CST) Received: from [10.20.42.43] (unknown [10.20.42.43]) by localhost.localdomain (Coremail) with SMTP id AQAAf8AxPMrNcIVk8bIRAA--.42850S3; Sun, 11 Jun 2023 14:59:25 +0800 (CST) Message-ID: Date: Sun, 11 Jun 2023 14:59:25 +0800 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.11.0 Subject: Re: [RESEND,12/15] drm/nouveau/dispnv04/crtc: Demote kerneldoc abuses To: Lee Jones Cc: Karol Herbst , nouveau@lists.freedesktop.org, linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Ben Skeggs References: <20230609081732.3842341-13-lee@kernel.org> Content-Language: en-US From: Sui Jingfeng Organization: Loongson In-Reply-To: <20230609081732.3842341-13-lee@kernel.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-CM-TRANSID: AQAAf8AxPMrNcIVk8bIRAA--.42850S3 X-CM-SenderInfo: xvxlyxpqjiv03j6o00pqjv00gofq/ X-Coremail-Antispam: 1Uk129KBj93XoW7Cw1Utw4fuF15tr15CF4Utrc_yoW8CrWDpa 17GF1F9rWkta1rK3WIyF929FWrGa93KFW3K3ZxJ34ruwnIyr1jvr4YkF1aqryDXF17Cw4f trn7Kryaga1fZFbCm3ZEXasCq-sJn29KB7ZKAUJUUUU8529EdanIXcx71UUUUU7KY7ZEXa sCq-sGcSsGvfJ3Ic02F40EFcxC0VAKzVAqx4xG6I80ebIjqfuFe4nvWSU5nxnvy29KBjDU 0xBIdaVrnRJUUUvYb4IE77IF4wAFF20E14v26r1j6r4UM7CY07I20VC2zVCF04k26cxKx2 IYs7xG6rWj6s0DM7CIcVAFz4kK6r106r15M28lY4IEw2IIxxk0rwA2F7IY1VAKz4vEj48v e4kI8wA2z4x0Y4vE2Ix0cI8IcVAFwI0_JFI_Gr1l84ACjcxK6xIIjxv20xvEc7CjxVAFwI 0_Gr0_Cr1l84ACjcxK6I8E87Iv67AKxVW8JVWxJwA2z4x0Y4vEx4A2jsIEc7CjxVAFwI0_ Gr0_Gr1UM2AIxVAIcxkEcVAq07x20xvEncxIr21l57IF6xkI12xvs2x26I8E6xACxx1l5I 8CrVACY4xI64kE6c02F40Ex7xfMcIj6xIIjxv20xvE14v26r1q6rW5McIj6I8E87Iv67AK xVW8JVWxJwAm72CE4IkC6x0Yz7v_Jr0_Gr1lF7xvr2IY64vIr41lc7I2V7IY0VAS07AlzV AYIcxG8wCF04k20xvY0x0EwIxGrwCFx2IqxVCFs4IE7xkEbVWUJVW8JwC20s026c02F40E 14v26r1j6r18MI8I3I0E7480Y4vE14v26r106r1rMI8E67AF67kF1VAFwI0_JF0_Jw1lIx kGc2Ij64vIr41lIxAIcVC0I7IYx2IY67AKxVWUCVW8JwCI42IY6xIIjxv20xvEc7CjxVAF wI0_Gr0_Cr1lIxAIcVCF04k26cxKx2IYs7xG6r1j6r1xMIIF0xvEx4A2jsIE14v26r4j6F 4UMIIF0xvEx4A2jsIEc7CjxVAFwI0_Gr0_Gr1UYxBIdaVFxhVjvjDU0xZFpf9x07jOdb8U UUUU= X-Spam-Status: No, score=-2.0 required=5.0 tests=BAYES_00,NICE_REPLY_A, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE 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 Reviewed-by: Sui Jingfeng On 2023/6/9 16:17, Lee Jones wrote: > Fixes the following W=1 kernel build warning(s): > > drivers/gpu/drm/nouveau/dispnv04/crtc.c:453: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst > drivers/gpu/drm/nouveau/dispnv04/crtc.c:629: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst > > Cc: Ben Skeggs > Cc: Karol Herbst > Cc: Lyude Paul > Cc: David Airlie > Cc: Daniel Vetter > Cc: dri-devel@lists.freedesktop.org > Cc: nouveau@lists.freedesktop.org > Signed-off-by: Lee Jones > Reviewed-by: Karol Herbst > --- > drivers/gpu/drm/nouveau/dispnv04/crtc.c | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) > > diff --git a/drivers/gpu/drm/nouveau/dispnv04/crtc.c b/drivers/gpu/drm/nouveau/dispnv04/crtc.c > index a6f2e681bde98..7794902df17d5 100644 > --- a/drivers/gpu/drm/nouveau/dispnv04/crtc.c > +++ b/drivers/gpu/drm/nouveau/dispnv04/crtc.c > @@ -449,7 +449,7 @@ nv_crtc_mode_set_vga(struct drm_crtc *crtc, struct drm_display_mode *mode) > regp->Attribute[NV_CIO_AR_CSEL_INDEX] = 0x00; > } > > -/** > +/* > * Sets up registers for the given mode/adjusted_mode pair. > * > * The clocks, CRTCs and outputs attached to this CRTC must be off. > @@ -625,7 +625,7 @@ nv_crtc_swap_fbs(struct drm_crtc *crtc, struct drm_framebuffer *old_fb) > return ret; > } > > -/** > +/* > * Sets up registers for the given mode/adjusted_mode pair. > * > * The clocks, CRTCs and outputs attached to this CRTC must be off. -- Jingfeng