Received: by 2002:a05:6358:d09b:b0:dc:cd0c:909e with SMTP id jc27csp2697732rwb; Thu, 17 Nov 2022 14:51:53 -0800 (PST) X-Google-Smtp-Source: AA0mqf6RjSnO3vuEG7qoRJ7FZOIQIEw0Px5liYRcmdHE8h4BAabBwJxdXOj+Gn5pF+zPmKcCAJlB X-Received: by 2002:a17:906:706:b0:7ac:2e16:eb05 with SMTP id y6-20020a170906070600b007ac2e16eb05mr4049056ejb.26.1668725513294; Thu, 17 Nov 2022 14:51:53 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1668725513; cv=none; d=google.com; s=arc-20160816; b=LgMMS756gmznvKFk9E0sXOBz6FBw5alpjB8zFbs/rhYMJROWGwf5nnWQ4ceWfD6mdp 2rYBjJoBfAuTxbLUdNPWLmId1CGSb8dg1522JUkCC4cd5M6FuKo7T5KO8oapC8d12TQh uMONmxIJQEps0E61fY5JMGjkzRKTMa4bMc+1IfB3/JX6rO0/bb4NCYxHiIf5DbFCbX5A KUelI6S0WQcGFCgm+MUaD9McLUl6/tif0HikbIIMTE/SJxu6xdQneMaHb68Jt0fWdKmN Y4qG7mLc73NLN12lA+t8sKqshs0Hwu+nBXmIla3qD5BHLXoZYGv2IZMYXSnxb2n4QBdr iZGw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:subject:message-id:date:from:in-reply-to :references:mime-version:dkim-signature; bh=csDjA7Lmaoy5t254PbIdwoXPbMVcPqUkx2VOtdueRJA=; b=y/0ZwCDiZD8KXIjVlxdnVuxGJhf+jvQNZbKujgpUhTECROkxb2PpUMhO6GY3ml7vHY oerccq7RN9KK7c3JWxHjqp1+al7bQptkMqX29pJtfkT9P0/6U+i5U/G2NoMvS2NiYnrS TY/QdBsfnKmpZeK5BwpowgKHHCzEhQTYaijFrVMgkTEi7OduAoRwukd7r+FaKyEdt/l+ 1+rTDZczhkLD4K5CQHWUvhPrTEZ1ieyhIF0aw39bXazy+cLWZt2/qispyQYs7MFIsRqj F/jkFUMg/IfuJaG8O7BlflaybwtsJWyl3sF6C+knvVURc7Sy1MeF/tDJzKgl/qZKEcvs zjzQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=WcCYDu+P; 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=gmail.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id qw11-20020a1709066a0b00b00787bacce740si1733134ejc.537.2022.11.17.14.51.30; Thu, 17 Nov 2022 14:51:53 -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=@gmail.com header.s=20210112 header.b=WcCYDu+P; 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=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S240036AbiKQWlU (ORCPT + 92 others); Thu, 17 Nov 2022 17:41:20 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:44366 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232026AbiKQWlS (ORCPT ); Thu, 17 Nov 2022 17:41:18 -0500 Received: from mail-oi1-x22d.google.com (mail-oi1-x22d.google.com [IPv6:2607:f8b0:4864:20::22d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 66D838DA51 for ; Thu, 17 Nov 2022 14:41:17 -0800 (PST) Received: by mail-oi1-x22d.google.com with SMTP id n186so3512670oih.7 for ; Thu, 17 Nov 2022 14:41:17 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=csDjA7Lmaoy5t254PbIdwoXPbMVcPqUkx2VOtdueRJA=; b=WcCYDu+PsGUNad1cIgVVLDXXKK+7SMRon35QDWLYdzHMC2Nfe+AJjlPyeQ+mTu9p2M lnKp7TE209DHIBwCFIwt13H+B1gwnE1I0xbUsPntNC8IsWiqDD38owDU1nhRRAZpyBwm SGDeAQTKLvoCYiUoaCCUxckQCxRFp0KH1FV3cKhOpYZum13wN3Iu0WOuavrbQJtQF/oi 7j9uJvvZnZZRt6uur28wzC7JOs9XzeHpBLrm2bhuoorZiEOW4yVDFK1d476Yi1NFe+rG VJVvrFemSmwvxuLJtWUO7wb2U58Y8ysRNo2iTDRkkZHHb417wB7LhB+tsf5/d+r+KnsI zwAQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=csDjA7Lmaoy5t254PbIdwoXPbMVcPqUkx2VOtdueRJA=; b=Nkure9tcL59balXSe2z8msk9xjhWpcq+JY1QOUG5OEO/E4FMCKfk7PBrndbeX7y3ya jEUEXScAIllQj1k7cgSVcXP09Ae/yWngjQ4bKZAdZZbZEI8ygKENThdOcKfys4h+NSy6 hO5tgLTkXQ7lNTqBsQJ/iQWkWQYlzE4RMgyL6lPnhE/zTM/COFiZyub7ZUu4lMB72x0f QZ4ANpZ5NhttQPPd9CYCTnYR6PKaJMkUSkpI3TUrx+HBM+leePE/gNWRQntWrBVxKCEm MYZlpZG3a0NJyjlgg4Pu0f+CJFlgN+fwOMuYznLzAeMdXGMK9+TAtINTilmvi8XFB/DZ Jhkw== X-Gm-Message-State: ANoB5pkV/SAGLhSoUWfEk7fVZhiSDFPmpwGPFmefmAR15OXxuAlaZugP paZyOAP5EsifRg6pXa5OTEV0KKhatIDzwWLJZFM= X-Received: by 2002:a05:6808:9b8:b0:34f:97ea:14d with SMTP id e24-20020a05680809b800b0034f97ea014dmr2306901oig.96.1668724876652; Thu, 17 Nov 2022 14:41:16 -0800 (PST) MIME-Version: 1.0 References: <20221117172009.28207-1-rdunlap@infradead.org> <28960f0b-97b9-7a41-9da3-188be25dd886@amd.com> In-Reply-To: <28960f0b-97b9-7a41-9da3-188be25dd886@amd.com> From: Alex Deucher Date: Thu, 17 Nov 2022 17:41:04 -0500 Message-ID: Subject: Re: [PATCH -next] drm/amd/display: fix kernel-doc issues in dc.h To: Harry Wentland Cc: Randy Dunlap , linux-kernel@vger.kernel.org, Leo Li , Rodrigo Siqueira , amd-gfx@lists.freedesktop.org, dri-devel@lists.freedesktop.org, Daniel Vetter , Alex Deucher , David Airlie Content-Type: text/plain; charset="UTF-8" X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS 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 Applied. Thanks! Alex On Thu, Nov 17, 2022 at 2:39 PM Harry Wentland wrote: > > > > On 11/17/22 12:20, Randy Dunlap wrote: > > Fix these kernel-doc complaints: > > > > drivers/gpu/drm/amd/display/dc/dc.h:505: warning: cannot understand function prototype: 'struct dc_clocks ' > > dc.h:472: warning: Enum value 'MPC_SPLIT_AVOID' not described in enum 'pipe_split_policy' > > dc.h:472: warning: Enum value 'MPC_SPLIT_AVOID_MULT_DISP' not described in enum 'pipe_split_policy' > > dc.h:532: warning: Incorrect use of kernel-doc format: * @fw_based_mclk_switching > > > > Fixes: ea76895ffab1 ("drm/amd/display: Document pipe split policy") > > Fixes: 1682bd1a6b5f ("drm/amd/display: Expand kernel doc for DC") > > Signed-off-by: Randy Dunlap > > Cc: Rodrigo Siqueira > > Cc: Alex Deucher > > Cc: Harry Wentland > > Cc: Leo Li > > Cc: amd-gfx@lists.freedesktop.org > > Cc: David Airlie > > Cc: Daniel Vetter > > Cc: dri-devel@lists.freedesktop.org > > Reviewed-by: Harry Wentland > > Harry > > > --- > > drivers/gpu/drm/amd/display/dc/dc.h | 12 ++++++------ > > 1 file changed, 6 insertions(+), 6 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 > > @@ -458,15 +458,15 @@ enum pipe_split_policy { > > MPC_SPLIT_DYNAMIC = 0, > > > > /** > > - * @MPC_SPLIT_DYNAMIC: Avoid pipe split, which means that DC will not > > + * @MPC_SPLIT_AVOID: Avoid pipe split, which means that DC will not > > * try any sort of split optimization. > > */ > > MPC_SPLIT_AVOID = 1, > > > > /** > > - * @MPC_SPLIT_DYNAMIC: With this option, DC will only try to optimize > > - * the pipe utilization when using a single display; if the user > > - * connects to a second display, DC will avoid pipe split. > > + * @MPC_SPLIT_AVOID_MULT_DISP: With this option, DC will only try to > > + * optimize the pipe utilization when using a single display; if the > > + * user connects to a second display, DC will avoid pipe split. > > */ > > MPC_SPLIT_AVOID_MULT_DISP = 2, > > }; > > @@ -497,7 +497,7 @@ enum dcn_zstate_support_state { > > }; > > > > /** > > - * dc_clocks - DC pipe clocks > > + * struct dc_clocks - DC pipe clocks > > * > > * For any clocks that may differ per pipe only the max is stored in this > > * structure > > @@ -528,7 +528,7 @@ struct dc_clocks { > > bool fclk_prev_p_state_change_support; > > int num_ways; > > > > - /** > > + /* > > * @fw_based_mclk_switching > > * > > * DC has a mechanism that leverage the variable refresh rate to switch >