From patchwork Thu Aug 27 07:37:18 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 248428 Delivered-To: patch@linaro.org Received: by 2002:a05:6e02:522:0:0:0:0 with SMTP id h2csp194325ils; Thu, 27 Aug 2020 00:37:26 -0700 (PDT) X-Google-Smtp-Source: ABdhPJw8+86fRvajDBuK3CUjlYron2c+k0AqBMJlnmJRmegE9wYt45n5AYAR8YxzrRIxIgZqNdod X-Received: by 2002:a17:906:76c7:: with SMTP id q7mr20629946ejn.541.1598513846152; Thu, 27 Aug 2020 00:37:26 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1598513846; cv=none; d=google.com; s=arc-20160816; b=K5fz6GHnuat5IETsaod1pWqVuSSugLiTNsDg7xyM8GY3WwO3xGeHPTuK6kmgquxZFb pmcZl4gBr34+MqGozw4Sas7lIowOr0bkHxew+75B8bGO7f0jWQCxSZL548ypX1Dm7RaJ V5ryIW0PuPzH9dukh6dHkUif4vvfvToolcAxi5ckJeJjk91OhVBgM0OMmPJKg+dsbWqM l12IXt6frISvV/wrNAs5Tq6J6d4LwciHTPlVxWCQCb2GXZNQm03s+EY0W95DSRgbiosL xDcON6VXHAzB5WJ/NHO1GTkM6Ei+msSYn8E1qp4XGQqf5lWgnEs0vP6Sc713FeCf+SQ1 Uczw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:in-reply-to:content-disposition :mime-version:references:message-id:subject:cc:to:from:date :dkim-signature; bh=urR5WKC0YHrLgprPWWXo12lMVDtV/KRxTWx7J20eMag=; b=u+u8lf108LJ8zdnTYhd14W5afcVmKJU/eAh3Fuv2/ManyxEzRFzvaf3lxDJbg6poJ1 iDjq9DKLgyqkDK5k7EqkUaGV7b03BlagYGBOwx6hgHxErws1hAA8rg8hqcT0flVvaDSM FUNLSxxvtsLMTAHDjwCMnGk2GVxgWQYLaS4qiVcUZCL1nSLtB65Neyvlea9l13rdLvs6 ygRwYjfXtvJnpxmLItySh5Wznmz0k0Q14ZNIbpWkAz1S7Pw8BFcM8OxaodG5n7GH3FEa SFgSt/Sri1AX9wNsgEtVSUi8FuKHoOJgB/keAwB4klMglwxrN3C5XZyXUwchDqEuOtAl Mmjg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=a0C34Bju; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id dc15si835883ejb.285.2020.08.27.00.37.25; Thu, 27 Aug 2020 00:37:26 -0700 (PDT) Received-SPF: pass (google.com: domain of netdev-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=@linaro.org header.s=google header.b=a0C34Bju; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728027AbgH0HhX (ORCPT + 9 others); Thu, 27 Aug 2020 03:37:23 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49856 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727931AbgH0HhW (ORCPT ); Thu, 27 Aug 2020 03:37:22 -0400 Received: from mail-wm1-x343.google.com (mail-wm1-x343.google.com [IPv6:2a00:1450:4864:20::343]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id F2710C061264 for ; Thu, 27 Aug 2020 00:37:21 -0700 (PDT) Received: by mail-wm1-x343.google.com with SMTP id b79so3606725wmb.4 for ; Thu, 27 Aug 2020 00:37:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=urR5WKC0YHrLgprPWWXo12lMVDtV/KRxTWx7J20eMag=; b=a0C34Bju6/PtF2HVbGdps+jvjmkH5VX28IIWmXqMUfuYbVudhp2bk8xBwXR8uNKw+o E3nFOa10HXBMiVQL1h8zH7EbQtL479qzCL4DwybQfDN2J5VlSTjXBvkkAmD3xryt8vzz LynWRE8fIQ0ilNTH7cX9yWUg4A0Yg5fiUbZxeO3DApzgKjBEknECJMkYtso5J8XFoUJK 6yEua+0LQhd6Chdj/b+NSRM1j2Enmb49/qh158+LRO5YLgiwrO8Jhj6eZcNL9GtMUdOl GgcNownqeuRxt4Spk7v03rpkNT7FusZRG/Oms4aC1D7SuT3wr663sfEVdiLo2F7Tq8NX Bs+Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=urR5WKC0YHrLgprPWWXo12lMVDtV/KRxTWx7J20eMag=; b=ZRP8DvlFhrvzEmY5JQJlvqJ6g45+UAofBfcnHAjMTTpGkOF1Idt/wZPNNvXoWAY+fp MstFhITonBQuQ/PTzT5cjfWnt/2y0AZLeLDtDbTPPSL1ZzjzO3tw/m6+oS30bM2ovJ2U X4UKl5IrDhqV24j229iqWkPFG//SoiV2wsoZNo0Al6pz/l8vn/cHF+CHoSTDLqN/Y+9N hfmt8wQO9Q301fT+cFlBe7E1dat7+psPUkEoyltRxsyYk+OUMlf2ppIlct7NW8F96Lln tpmVDl9fxpozGRzyFdLt9xoEAh4IVELmQV0jvhYNmk5dpAMM5iqJ5pQQBxztrPLMHpdJ wKqA== X-Gm-Message-State: AOAM532LnNv27y86vWBxjFLOJHFSI6FjFjqoeKglL1cudFbi58TI7RlL ZMZzCAlKf9L5wfmRg5pl4777tQ== X-Received: by 2002:a1c:1d17:: with SMTP id d23mr9716187wmd.187.1598513840622; Thu, 27 Aug 2020 00:37:20 -0700 (PDT) Received: from dell ([91.110.221.141]) by smtp.gmail.com with ESMTPSA id n24sm3140608wmi.36.2020.08.27.00.37.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 27 Aug 2020 00:37:20 -0700 (PDT) Date: Thu, 27 Aug 2020 08:37:18 +0100 From: Lee Jones To: kvalo@codeaurora.org, davem@davemloft.net, kuba@kernel.org Cc: linux-kernel@vger.kernel.org, linux-wireless@vger.kernel.org, netdev@vger.kernel.org, Maya Erez , wil6210@qti.qualcomm.com Subject: [PATCH v2 30/32] wireless: ath: wil6210: pmc: Demote a few nonconformant kernel-doc function headers Message-ID: <20200827073718.GV3248864@dell> References: <20200821071644.109970-1-lee.jones@linaro.org> <20200821071644.109970-31-lee.jones@linaro.org> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20200821071644.109970-31-lee.jones@linaro.org> Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/wireless/ath/wil6210/pmc.c:43: warning: Function parameter or member 'wil' not described in 'wil_pmc_alloc' drivers/net/wireless/ath/wil6210/pmc.c:43: warning: Function parameter or member 'num_descriptors' not described in 'wil_pmc_alloc' drivers/net/wireless/ath/wil6210/pmc.c:43: warning: Function parameter or member 'descriptor_size' not described in 'wil_pmc_alloc' drivers/net/wireless/ath/wil6210/pmc.c:229: warning: Function parameter or member 'wil' not described in 'wil_pmc_free' drivers/net/wireless/ath/wil6210/pmc.c:229: warning: Function parameter or member 'send_pmc_cmd' not described in 'wil_pmc_free' drivers/net/wireless/ath/wil6210/pmc.c:307: warning: Function parameter or member 'wil' not described in 'wil_pmc_last_cmd_status' drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'filp' not described in 'wil_pmc_read' drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'buf' not described in 'wil_pmc_read' drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'count' not described in 'wil_pmc_read' drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'f_pos' not described in 'wil_pmc_read' Cc: Maya Erez Cc: Kalle Valo Cc: "David S. Miller" Cc: Jakub Kicinski Cc: linux-wireless@vger.kernel.org Cc: wil6210@qti.qualcomm.com Cc: netdev@vger.kernel.org Signed-off-by: Lee Jones --- drivers/net/wireless/ath/wil6210/pmc.c | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) -- 2.25.1 diff --git a/drivers/net/wireless/ath/wil6210/pmc.c b/drivers/net/wireless/ath/wil6210/pmc.c index 9b4ca6b256d26..a2f7b4c1da48d 100644 --- a/drivers/net/wireless/ath/wil6210/pmc.c +++ b/drivers/net/wireless/ath/wil6210/pmc.c @@ -29,8 +29,7 @@ void wil_pmc_init(struct wil6210_priv *wil) mutex_init(&wil->pmc.lock); } -/** - * Allocate the physical ring (p-ring) and the required +/* Allocate the physical ring (p-ring) and the required * number of descriptors of required size. * Initialize the descriptors as required by pmc dma. * The descriptors' buffers dwords are initialized to hold @@ -221,8 +220,7 @@ void wil_pmc_alloc(struct wil6210_priv *wil, mutex_unlock(&pmc->lock); } -/** - * Traverse the p-ring and release all buffers. +/* Traverse the p-ring and release all buffers. * At the end release the p-ring memory */ void wil_pmc_free(struct wil6210_priv *wil, int send_pmc_cmd) @@ -299,8 +297,7 @@ void wil_pmc_free(struct wil6210_priv *wil, int send_pmc_cmd) mutex_unlock(&pmc->lock); } -/** - * Status of the last operation requested via debugfs: alloc/free/read. +/* Status of the last operation requested via debugfs: alloc/free/read. * 0 - success or negative errno */ int wil_pmc_last_cmd_status(struct wil6210_priv *wil) @@ -311,8 +308,7 @@ int wil_pmc_last_cmd_status(struct wil6210_priv *wil) return wil->pmc.last_cmd_status; } -/** - * Read from required position up to the end of current descriptor, +/* Read from required position up to the end of current descriptor, * depends on descriptor size configured during alloc request. */ ssize_t wil_pmc_read(struct file *filp, char __user *buf, size_t count,