From patchwork Wed May 26 08:47:14 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 448146 Delivered-To: patch@linaro.org Received: by 2002:a02:7a1b:0:0:0:0:0 with SMTP id a27csp5017139jac; Wed, 26 May 2021 01:48:00 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwv1bAm8UzzcdHZSZhwNNhOScY7hFfA3uUqX+f2skxGcV1Gik3w5jJ3tqsYqUoZaUAK9Ohq X-Received: by 2002:a17:90a:d14f:: with SMTP id t15mr2905541pjw.160.1622018880560; Wed, 26 May 2021 01:48:00 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1622018880; cv=none; d=google.com; s=arc-20160816; b=Ly6ksQ3HTnzcMEm5qECZrMqjUS9AE6tnwTJenih77ETahnQx6cO9qxkNK8ySFT+dFc JRztUkkJQDAK0LufvEYmsvIpLBEZ+ylNs5L48p0ssnXlRP6k0Z8BfYpoQgXCBNrCDFQg mduLlQNYnGRHpmJif3KQAR8YctznNBoLrVBZ1u70ZQDI+uxWFy4qYzaoGBSgA3i/LDNo KBa1KyKeAhmRN1TA7EyaSVLZBRLEYfsXx/LLxaNj9Kp+RSy4ROJpkE+gaYijegQd5iOh eNF89ekLYgWw22Q0P27a1m2dwExnlNOQQtwndNq67fexVAR1I3tHaYLrw4NHHsrqJAb0 6F8g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:cc:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:to:from :dkim-signature:delivered-to; bh=7zQBHzs8bUaTq312vSS5VlkiBcTZpiBpI37cda1Zuvw=; b=dA18sL5xkRqW5Z8fOaYTe/6LJxBQ9ZHVAyGPWqNYxB8Sq9cvdWoMUR0FuFaFtsKxwk 7OfjWnn9TrllcZfXZLG3lant+mDkqfrMeMVrKQTledkteHOmPQ77PpK70xBgg1v+mJ6D U4b+GP9Mfx7hSruBfQAkLhtXdWkMYRGk74pfugGvliq5KtRd7C/PGao9I7z6FJQXJZ7s N+oa0hWAC1fLRix3yirhRyx+nOOxQJlWxijyrq/RO92nzAx+TqRmtaKq7KzBalUwzOL0 UYTlUc/u0B6SUffwCOOcZIr+WGgKtlmlGpMZDZCabI4JJ7h4W6fB7bJwt74SkmYk3AXy sRbg== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=UYtZk9Vp; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from gabe.freedesktop.org (gabe.freedesktop.org. [131.252.210.177]) by mx.google.com with ESMTPS id k7si2336185plk.303.2021.05.26.01.48.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 26 May 2021 01:48:00 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) client-ip=131.252.210.177; Authentication-Results: mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=UYtZk9Vp; spf=pass (google.com: best guess record for domain of dri-devel-bounces@lists.freedesktop.org designates 131.252.210.177 as permitted sender) smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 2657F6EC2F; Wed, 26 May 2021 08:47:59 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-wr1-x429.google.com (mail-wr1-x429.google.com [IPv6:2a00:1450:4864:20::429]) by gabe.freedesktop.org (Postfix) with ESMTPS id EE84F6E4C5 for ; Wed, 26 May 2021 08:47:54 +0000 (UTC) Received: by mail-wr1-x429.google.com with SMTP id v12so204996wrq.6 for ; Wed, 26 May 2021 01:47:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=7zQBHzs8bUaTq312vSS5VlkiBcTZpiBpI37cda1Zuvw=; b=UYtZk9Vp8FVe1rY6Ub1SdN2wtVTZoiQfb1OhbnN4uLhKytekELKH71HLthvfaEEBMv wBIa/HxlnMC/sO10tzKeNoWt/ywjW06knZiDtCEVvOJXP3GjgFeCGsU+g9bXcJsaQn// Vc1DynqHbRBauWzVeIg1c5RZOgmjN9sfZv6lrByDjqxkdtSi169CuIVPeGtXEdLospw6 SwPcfZgQAz6smSpgvagmsFqAQwuZMUUhNAH4TGMj+Ee1bPlv7RADSi3mlU56zfRspTCD s/HwXup2wyf51Vbr455hzBeyzl6GzjAbR3I4/eIyvyWQ9iCzvPPFgN+trC6H456n4pdt 4UBw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=7zQBHzs8bUaTq312vSS5VlkiBcTZpiBpI37cda1Zuvw=; b=q8U4ROTr0FgNarw3xyDUWpDjexA0PE9fefViN6icQZLDlIe+jcDTdmtQTYMXm10Qeb MIfP/QE6ZuvXIu2Bmt0HchKz9OEfSEh1uFHpuKzv1zuw6Cps7+JvysCuCLA2WmvVqQk4 VnEaUhEcfYEvpfPIYJeOpTLhe9MjeNlqgcbYeHMcumq1OdfdefyOgKl0/vm6A9FdoDO2 K7QYVwSnahV1UTyaRD4XOWM9vjncUdcEY3ecgEYkhdiU44lcCVKJkSX7y94rmGX57mJ1 g/F4MO7uNpudoVat46GmuyxTmOgMnLKAoFnw0jid1/XOFwyNiUu7kPH2fwGWSqP9+peT diUg== X-Gm-Message-State: AOAM531v1XFaUcj0WDg5gmM+jp7Dw13wd/1jM/pr1o/+MSPWbqBkZd8Q PFcvzvpoccLGcpX/4PO+ij/leV6wKlnhVw== X-Received: by 2002:a5d:45c6:: with SMTP id b6mr31627763wrs.333.1622018873564; Wed, 26 May 2021 01:47:53 -0700 (PDT) Received: from dell.default ([91.110.221.223]) by smtp.gmail.com with ESMTPSA id l18sm18911918wrt.97.2021.05.26.01.47.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 26 May 2021 01:47:53 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Subject: [PATCH 22/34] drm/amd/display/dc/core/dc: Convert function headers to kernel-doc Date: Wed, 26 May 2021 09:47:14 +0100 Message-Id: <20210526084726.552052-23-lee.jones@linaro.org> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20210526084726.552052-1-lee.jones@linaro.org> References: <20210526084726.552052-1-lee.jones@linaro.org> MIME-Version: 1.0 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Leo Li , linux-kernel@vger.kernel.org, amd-gfx@lists.freedesktop.org, David Airlie , dri-devel@lists.freedesktop.org, Alex Deucher , =?utf-8?q?Christian_K=C3=B6nig?= Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" Fixes the following W=1 kernel build warning(s): drivers/gpu/drm/amd/amdgpu/../display/dc/core/dc.c:3324: warning: Cannot understand ***************************************************************************** drivers/gpu/drm/amd/amdgpu/../display/dc/core/dc.c:3344: warning: Cannot understand ***************************************************************************** drivers/gpu/drm/amd/amdgpu/../display/dc/core/dc.c:3417: warning: Cannot understand ***************************************************************************** Cc: Harry Wentland Cc: Leo Li Cc: Alex Deucher Cc: "Christian König" Cc: David Airlie Cc: Daniel Vetter Cc: amd-gfx@lists.freedesktop.org Cc: dri-devel@lists.freedesktop.org Signed-off-by: Lee Jones --- drivers/gpu/drm/amd/display/dc/core/dc.c | 46 ++++++------------------ 1 file changed, 11 insertions(+), 35 deletions(-) -- 2.31.1 diff --git a/drivers/gpu/drm/amd/display/dc/core/dc.c b/drivers/gpu/drm/amd/display/dc/core/dc.c index ef157b83bacd2..34c207f92df98 100644 --- a/drivers/gpu/drm/amd/display/dc/core/dc.c +++ b/drivers/gpu/drm/amd/display/dc/core/dc.c @@ -3335,18 +3335,10 @@ void dc_hardware_release(struct dc *dc) #endif /** - ***************************************************************************** - * Function: dc_enable_dmub_notifications + * dc_enable_dmub_notifications - Returns whether dmub notification can be enabled + * @dc: dc structure * - * @brief - * Returns whether dmub notification can be enabled - * - * @param - * [in] dc: dc structure - * - * @return - * True to enable dmub notifications, False otherwise - ***************************************************************************** + * Returns: True to enable dmub notifications, False otherwise */ bool dc_enable_dmub_notifications(struct dc *dc) { @@ -3355,21 +3347,13 @@ bool dc_enable_dmub_notifications(struct dc *dc) } /** - ***************************************************************************** - * Function: dc_process_dmub_aux_transfer_async - * - * @brief - * Submits aux command to dmub via inbox message - * Sets port index appropriately for legacy DDC - * - * @param - * [in] dc: dc structure - * [in] link_index: link index - * [in] payload: aux payload + * dc_process_dmub_aux_transfer_async - Submits aux command to dmub via inbox message + * Sets port index appropriately for legacy DDC + * @dc: dc structure + * @link_index: link index + * @payload: aux payload * - * @return - * True if successful, False if failure - ***************************************************************************** + * Returns: True if successful, False if failure */ bool dc_process_dmub_aux_transfer_async(struct dc *dc, uint32_t link_index, @@ -3428,16 +3412,8 @@ bool dc_process_dmub_aux_transfer_async(struct dc *dc, } /** - ***************************************************************************** - * Function: dc_disable_accelerated_mode - * - * @brief - * disable accelerated mode - * - * @param - * [in] dc: dc structure - * - ***************************************************************************** + * dc_disable_accelerated_mode - disable accelerated mode + * @dc: dc structure */ void dc_disable_accelerated_mode(struct dc *dc) {