Received: by 2002:a05:6a10:206:0:0:0:0 with SMTP id 6csp297984pxj; Wed, 26 May 2021 23:50:37 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwVQ6OE1i/Sh+pQYy+ike9vI5qPJq9UulKudSX8UfY50ckIIA1CiaYxfgXQlLh7gGlrFYFT X-Received: by 2002:a92:6705:: with SMTP id b5mr1313976ilc.55.1622098237568; Wed, 26 May 2021 23:50:37 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1622098237; cv=none; d=google.com; s=arc-20160816; b=sxp2SFi0iq+veXnh5SXORA0T9wGJMhb81ThY+tLCAbVNyYieMOA6dbG2AuIJvPzom8 Wj+7KJOh2f8MA4NCOtMUr4GJ+TEONMzUI0q07JlhMYoZWtKVDmdGuchdSO4cQhZ/nr4n 8Av0Uz9zSysUVrvcJCBDtVIVNUe73oL78FNoGjYLGFCxiJe2NC9Ubx22/MGahZ1W7ktq pM3f9t1OG+Q2eQtzB7ykJObYwJexo3IlUz0W4+GhBnKjmVbMxuuUbyFyZxS4XCWJ3D6/ jU47uW9rlDlr8f9ZwDU3rjmfkXR6DPsn95s7B8tR03VJLXb++UYtzNy4vN1l2Hwz1UJ5 WUAg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:cc:to:subject :message-id:date:from:in-reply-to:references:mime-version :dkim-signature; bh=ZT5FSoIiyDWBnTxiiZjSflnBrLIqWN4cLVY+j1uJuFw=; b=uGSzoX0oElxnGqZUmwQ6pI1ks8Bm1u6idw7xcXCDInYg3YsMz9BJbqMsgbol42UUEM ffOI5vlHJunGRJIYpi7H3TY+XgcnMhWZShJTrYHoh1i1muD7TFUzQB5KEtsyLYi9TgNY 6avxLyLSXZ1tUBgPxlPE1dS5HQwilgjXXF5Lh/pSaSpWk+zUXeQhjRV+Pi4N708vX2W5 y/FyRTA+YKGDTBtqsVnfqKhoJOvQA944Mfp9UXApGfwRhIysgqddfxwVrXpPyzplisjl je2Hn1khuZZcJkED6yLvKjmSyE28HKcSVUt3g/4rWLNHP1V8DPd/Z/j8VYFBJb7Eu8cC bcjw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=NOsebllS; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 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 vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id m13si1645293jat.19.2021.05.26.23.50.22; Wed, 26 May 2021 23:50:37 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=NOsebllS; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 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 S229812AbhE0E3R (ORCPT + 99 others); Thu, 27 May 2021 00:29:17 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:52544 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229692AbhE0E3Q (ORCPT ); Thu, 27 May 2021 00:29:16 -0400 Received: from mail-oi1-x233.google.com (mail-oi1-x233.google.com [IPv6:2607:f8b0:4864:20::233]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CCFB1C061574 for ; Wed, 26 May 2021 21:27:43 -0700 (PDT) Received: by mail-oi1-x233.google.com with SMTP id d21so3858445oic.11 for ; Wed, 26 May 2021 21:27:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=ZT5FSoIiyDWBnTxiiZjSflnBrLIqWN4cLVY+j1uJuFw=; b=NOsebllSQH9aGPkH2RcdDiA7CI9wsl8Hpi5SHlA5oOE4W2iuhAZkqa++V9Z05Auxds Evs7CXqCEtsKa8kFQEMlNAlypHu3MKIpvzzB8zzHtONxAbTp7+TZxZoEkhUzh5EujZwL Xb/5SuddSczb7ofmJlilPuHYw7Er6PtLPs5TIlfhQh2d6SV8eFem/zKXUFMnrA6GNEOp sSQlUdqSNzrenxnQKigNs0GMnzAqtYufSvIx1SNi+LwJlEqpdhgxbb39hDTnYReSHCkv T/TQs+TOWg8PqWnswYT8UFT28gEEyELwT6sYyrmtpl0Wraqt47p8zxpHv4WpStPXxhJq hVYA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=ZT5FSoIiyDWBnTxiiZjSflnBrLIqWN4cLVY+j1uJuFw=; b=Ms7EUkr5iyiYinPJMuu7jdLCkcKgdjCBhvrKZiHZ6rHH/gny0eh+jAvh/FcXo+W4Cg 2NW61tiaF46d1ffcusOgrEhX89C5EJynszmELuyRS1P8BGcbbiq3L2pDURLCBT5ZaXlz fsXGIUrBZmBw3BsXixZNnbnqrtDe5cYiZJ6W3mZTpxwxWjZKl/CyDuNDL3/Is/Zl3bFa fvp9c+lqKUqvzfwcfzo3Vi14YM1RhYk1wVVpQRSbqQBJUGME32e39GEWT8AoZCJrrha+ Qa6v+CLDzmupPRb/sgGwaKUwu8LtT9I5yG8ZcGCKYeCzpqMPtFXELm11NDxOEJsCEI37 PyQg== X-Gm-Message-State: AOAM533zZhITWM6zamaSJTouDJ/YK6hzmPjlZKOOy2e20THnXpRzR/ry nsQ9THhBOWrTxS2IgJYrSqX9QW9su3jC0lBmVJk= X-Received: by 2002:a05:6808:249:: with SMTP id m9mr1097793oie.120.1622089663253; Wed, 26 May 2021 21:27:43 -0700 (PDT) MIME-Version: 1.0 References: <20210526084726.552052-1-lee.jones@linaro.org> <20210526084726.552052-24-lee.jones@linaro.org> In-Reply-To: <20210526084726.552052-24-lee.jones@linaro.org> From: Alex Deucher Date: Thu, 27 May 2021 00:27:32 -0400 Message-ID: Subject: Re: [PATCH 23/34] drm/amd/display/dmub/src/dmub_srv_stat: Convert function header to kernel-doc To: Lee Jones Cc: Leo Li , Rodrigo Siqueira , LKML , amd-gfx list , Meenakshikumar Somasundaram , David Airlie , Maling list - DRI developers , Alex Deucher , Jun Lei , =?UTF-8?Q?Christian_K=C3=B6nig?= Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Applied. Thanks! On Wed, May 26, 2021 at 4:48 AM Lee Jones wrote: > > Fixes the following W=3D1 kernel build warning(s): > > drivers/gpu/drm/amd/amdgpu/../display/dmub/src/dmub_srv_stat.c:38: warni= ng: Cannot understand ****************************************************= ************************* > > Cc: Harry Wentland > Cc: Leo Li > Cc: Alex Deucher > Cc: "Christian K=C3=B6nig" > Cc: David Airlie > Cc: Daniel Vetter > Cc: Jun Lei > Cc: Meenakshikumar Somasundaram > Cc: Rodrigo Siqueira > Cc: amd-gfx@lists.freedesktop.org > Cc: dri-devel@lists.freedesktop.org > Signed-off-by: Lee Jones > --- > .../drm/amd/display/dmub/src/dmub_srv_stat.c | 19 ++++++------------- > 1 file changed, 6 insertions(+), 13 deletions(-) > > diff --git a/drivers/gpu/drm/amd/display/dmub/src/dmub_srv_stat.c b/drive= rs/gpu/drm/amd/display/dmub/src/dmub_srv_stat.c > index e6f3bfab33d3e..70766d534c9c8 100644 > --- a/drivers/gpu/drm/amd/display/dmub/src/dmub_srv_stat.c > +++ b/drivers/gpu/drm/amd/display/dmub/src/dmub_srv_stat.c > @@ -35,20 +35,13 @@ > */ > > /** > - ***********************************************************************= ****** > - * Function: dmub_srv_stat_get_notification > + * dmub_srv_stat_get_notification - Retrieves a dmub outbox notification= , set up dmub notification > + * structure with message information. = Also a pending bit if queue > + * is having more notifications > + * @dmub: dmub srv structure > + * @notify: dmub notification structure to be filled up > * > - * @brief > - * Retrieves a dmub outbox notification, set up dmub notific= ation > - * structure with message information. Also a pending bit if= queue > - * is having more notifications > - * > - * @param [in] dmub: dmub srv structure > - * @param [out] pnotify: dmub notification structure to be filled up > - * > - * @return > - * dmub_status > - ***********************************************************************= ****** > + * Returns: dmub_status > */ > enum dmub_status dmub_srv_stat_get_notification(struct dmub_srv *dmub, > struct dmub_notification = *notify) > -- > 2.31.1 >