From patchwork Wed Jul 12 02:23:38 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 118773 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:a6b2:0:b0:3e4:2afc:c1 with SMTP id c18csp870054vqm; Tue, 11 Jul 2023 19:38:24 -0700 (PDT) X-Google-Smtp-Source: APBJJlH91vQifcHNN7ZqPsyMVkOF97yenzjNZUaXBTvCBflCFgjQ5tnPtXLN+qqAU2wKVuW70u0B X-Received: by 2002:a05:622a:591:b0:403:a9aa:56d6 with SMTP id c17-20020a05622a059100b00403a9aa56d6mr14447686qtb.58.1689129504397; Tue, 11 Jul 2023 19:38:24 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1689129504; cv=none; d=google.com; s=arc-20160816; b=WQ5VPVPaJOeWzTW9VRSepnuHRjkuoUsxOaVTySw/gZJIeeg+5DdITcV0b4tzmbCFWc IHERV2HJsiz9SsDYxJxcdsw2PLIE9KjUEGoWhehowaHYFG+0Mu+9ziw+/x9ozFr4kgmL IGqz1ha5b8MW/kCitU9lnVA7idBeZ/5TLMEpUqGGIFura2di8TxMPbQp68sYNNOylj9Y i7vQz9lqpxxQidZiTnctaI7ADTHdXjVMhpNyEBOgA0+9MdWPljNuFiUwCRFGqyPrY1dp EGEpiRq+qoeGw2vWxwNDS4EzayCzTDU8uK0P+tw3dxj7SKUPn8NpY+X5MZ5QhJVdPAJl 1Dkg== 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=cePnlLEiqgQ2Pylbx1FGY2RvBTUt1YcYyuWHcsYfmpE=; fh=GZqxvULGe/nUImXj+i249vDPO0PK7CCuQPiYIPjMhn8=; b=tz/YjW9BcN4k2dQjPijfF3ZtXXCUl97sBZ9qMcAC+LwxHatG58yFNzw+ZfZsGuOe28 LnhZcKDGf+TaSNNpEJBmRCFs21F1SsPHy3vtYPd+32sTJaRmYrXfs98O46jm3Pw+YfvE UncqIos7xnvB94I81XZstlN2UeUW8ZGYhK67OaNVB6RwfDWn7SYW07okOZFfkeUVD5w8 kj0GnXgz0qd004Tp2xbZ8tO+OrEAXl6ZLkB38/fPsdpz4+SU3KyCL3V8w9ILdfCjkfAj 7J4ghDMT3HmSDpKt37ts3KnEuwkrvhpOQhGQm7Rcv6xrr7ijdBNmgtgGu2nlUO7yFUYQ kovA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=nvRUmlLP; 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 pi12-20020a17090b1e4c00b00263d559dbf1si10708772pjb.55.2023.07.11.19.38.11; Tue, 11 Jul 2023 19:38:24 -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; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=nvRUmlLP; 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 S231431AbjGLCYJ (ORCPT + 99 others); Tue, 11 Jul 2023 22:24:09 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40034 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229772AbjGLCYH (ORCPT ); Tue, 11 Jul 2023 22:24:07 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5EC821998 for ; Tue, 11 Jul 2023 19:23:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: Content-Type:MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To: Content-ID:Content-Description:In-Reply-To:References; bh=cePnlLEiqgQ2Pylbx1FGY2RvBTUt1YcYyuWHcsYfmpE=; b=nvRUmlLPkADlM46tMRobzAMSVD k5PIOvwf+/myoNanBVdhsfFi/Y4FQOM6XNfmw8+5sS9U3D4XYAmQTP9Vr5eaUs53ppYYAO1WfYxY2 s/VpgFIRGUTQBOfan6CxNsz08Z40UHPqgOuPGTJlQbWuWcNzOcYR+1ZadgyS/7UHygk7hPNIFZOH/ jSKjRpA5sK6Ool1tfoSmuPJ886W4J4h4tRR9yZAlDC0tyz1smPEjDifSrdWA+FHjKLYY61Ypjnsm7 EwJknqk7zaiK0zATbBXIcGfEimEpgDHF/NTx7UhqoVsBON5hoZLrHP5xgtUaPlpoeb5loWznPyBVp Rzdr1ruQ==; Received: from [2601:1c2:980:9ec0::2764] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1qJPW2-00GFs8-0B; Wed, 12 Jul 2023 02:23:42 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Harry Wentland , Leo Li , Rodrigo Siqueira , Aurabindo Pillai , Alex Deucher , amd-gfx@lists.freedesktop.org, =?utf-8?q?Christian_K=C3=B6nig?= , "Pan, Xinhui" , dri-devel@lists.freedesktop.org Subject: [PATCH] drm/amd/display: dc.h: eliminate kernel-doc warnings Date: Tue, 11 Jul 2023 19:23:38 -0700 Message-ID: <20230712022339.17902-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED, SPF_HELO_NONE,SPF_NONE,T_SCC_BODY_TEXT_LINE,URIBL_BLOCKED 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: INBOX X-GMAIL-THRID: 1771180659428995119 X-GMAIL-MSGID: 1771180659428995119 Quash 175 kernel-doc warnings in dc.h by unmarking 2 struct comments as containing kernel-doc notation and by spelling one struct field correctly in a kernel-doc comment. Fixes: 1682bd1a6b5f ("drm/amd/display: Expand kernel doc for DC") Fixes: ea76895ffab1 ("drm/amd/display: Document pipe split policy") Fixes: f6ae69f49fcf ("drm/amd/display: Include surface of unaffected streams") Signed-off-by: Randy Dunlap Cc: Harry Wentland Cc: Leo Li Cc: Rodrigo Siqueira Cc: Aurabindo Pillai Cc: Alex Deucher Cc: amd-gfx@lists.freedesktop.org Cc: Alex Deucher Cc: Christian König Cc: "Pan, Xinhui" Cc: dri-devel@lists.freedesktop.org Reviewed-by: Harry Wentland --- drivers/gpu/drm/amd/display/dc/dc.h | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff -- a/drivers/gpu/drm/amd/display/dc/dc.h b/drivers/gpu/drm/amd/display/dc/dc.h --- a/drivers/gpu/drm/amd/display/dc/dc.h +++ b/drivers/gpu/drm/amd/display/dc/dc.h @@ -506,7 +506,7 @@ enum dcn_zstate_support_state { DCN_ZSTATE_SUPPORT_DISALLOW, }; -/** +/* * struct dc_clocks - DC pipe clocks * * For any clocks that may differ per pipe only the max is stored in this @@ -728,7 +728,7 @@ struct resource_pool; struct dce_hwseq; struct link_service; -/** +/* * struct dc_debug_options - DC debug struct * * This struct provides a simple mechanism for developers to change some @@ -756,7 +756,7 @@ struct dc_debug_options { bool use_max_lb; enum dcc_option disable_dcc; - /** + /* * @pipe_split_policy: Define which pipe split policy is used by the * display core. */ @@ -1334,7 +1334,7 @@ struct dc_validation_set { struct dc_stream_state *stream; /** - * @plane_state: Surface state + * @plane_states: Surface state */ struct dc_plane_state *plane_states[MAX_SURFACES];