From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-11.5 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH, MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,USER_AGENT_SANE_1 autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 073B8C433E0 for ; Wed, 15 Jul 2020 03:11:20 +0000 (UTC) Received: from merlin.infradead.org (merlin.infradead.org [205.233.59.134]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id C7B5020663 for ; Wed, 15 Jul 2020 03:11:19 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="Nby2jVoe"; dkim=fail reason="signature verification failed" (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="mCQYqHda" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org C7B5020663 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=linaro.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=merlin.20170209; h=Sender:Content-Transfer-Encoding: Content-Type:Cc:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:In-Reply-To:MIME-Version:References:Message-ID: Subject:To:From:Date:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=CLb03YoSLL7V5zI5NqXBjBjA0tIcPVcZrQtmi5d6t8E=; b=Nby2jVoebFi1EBCf3xHc2NucP Qi3YXuUInnpHiAPrGk22e8lJAwImZr7uiMDkhQG6mtwGSQcMnEa+7LlnvbN6Cy+AO0cBLCdjsztXB IPydAZ6SzfUOT8AnzLnfrA8tYp0TU/tJ3NR54EVNTVveUkIAI/eaxo7QAQ7fy6Kjdt5k3secrObJ1 xiC+bm43YO5fjsExuVHvLFjSYkQfy8VFbTVEc4VWaTOuxYIhaab2vB+o4qWG87ZfO93PQxqvEMtmJ q35+trhQf/mxg8RKtRxYvYwmeNFIoBPFRPjz8IplUxMrOg+eWVkCdVhf5gD74e1E5T4R0nQwdja5T tWRhY0Zag==; Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1jvXnt-0005Kr-SN; Wed, 15 Jul 2020 03:09:53 +0000 Received: from mail-pj1-x1043.google.com ([2607:f8b0:4864:20::1043]) by merlin.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1jvXnq-0005Js-No for linux-arm-kernel@lists.infradead.org; Wed, 15 Jul 2020 03:09:51 +0000 Received: by mail-pj1-x1043.google.com with SMTP id md7so1692394pjb.1 for ; Tue, 14 Jul 2020 20:09:50 -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:user-agent; bh=R8Gi68qr1aDvO0QyibD3Pq2zcXF2jU6VWUvfFWeUSio=; b=mCQYqHdaeQKSdh/0G0+UcnKbrk3gam4BRinxdpoSmGWJoo7YCrXU1HXoo+l5rldKPl 35He1pWMZF9+F9lDMZ/nN7jyxZJKlRGDfK/7qZh0qgnwbam4p/hkHtbfSI7oUXsU2MYb Cl+PWrpd57mmjpgbe9ZokVqqcc23el1nAOtpj4e4lZMjeIEieffTfWhCh5sYaAZxbY0f cj8Y2A3l/aKfqUHGS48stXID25o58xi/YqXfV+8OlDK+hbdWvRENKfBx96v9J21XA8MR XbeQrkCgsBNXAIX4Fy0Wa8z3FfdSfjqYRN7X6lpEEm36Z9uwGzkz8f8D2M1DjKiUWxtg tJWw== 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:user-agent; bh=R8Gi68qr1aDvO0QyibD3Pq2zcXF2jU6VWUvfFWeUSio=; b=D7AVdCOpHBm1rjCl8TopzqWj6xQtn3aiU/TPzB/HBhY9g3GPcxlGcj5KI55AVyPSYW TjxkefB2OVbWsi9UnGmUwOsYqIwuTjRFRDXGvgpTK6+GGUhheomhYR4QYusYNLjzrPsz sojzCXp+GemNODcmmdP7t9vJ5+YgzyDr1fIETpWYInou07hakNhFIj+EGty7b5MzYJpt tOacKXoE1uMySCG5fnWAD4wRIl6fwSeky3SL0iDLQ928xq3HBWqON7L2d/Zr4OQr486P Zqj3Y8BRh6TC5lrRr7XaB03IwOBLKJR5fmL5IJY/7AuisYqtSgZe5Ae2IknvMRoFeh1X wQhg== X-Gm-Message-State: AOAM532ONTVYuSumgaC54y0oa4b5EvDB7K+d7bmGAOUqvd+p+1mOMk2e R9RT/tLwqi0gWOHflYX9z4olKQ== X-Google-Smtp-Source: ABdhPJxLkRpCAh56OHvV9+ruY7Vzg+a1Z9+GxC17tANOkAOMf1eHdhsH69mrQ3UVDo33lzSRWmiORw== X-Received: by 2002:a17:902:82cb:: with SMTP id u11mr6359503plz.207.1594782588903; Tue, 14 Jul 2020 20:09:48 -0700 (PDT) Received: from localhost ([122.172.34.142]) by smtp.gmail.com with ESMTPSA id ml8sm369552pjb.47.2020.07.14.20.09.47 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Tue, 14 Jul 2020 20:09:48 -0700 (PDT) Date: Wed, 15 Jul 2020 08:39:46 +0530 From: Viresh Kumar To: Lee Jones Subject: Re: [PATCH 07/13] cpufreq: powernv-cpufreq: Fix a bunch of kerneldoc related issues Message-ID: <20200715030946.xxetozdxe5slvoid@vireshk-i7> References: <20200714145049.2496163-1-lee.jones@linaro.org> <20200714145049.2496163-8-lee.jones@linaro.org> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20200714145049.2496163-8-lee.jones@linaro.org> User-Agent: NeoMutt/20180716-391-311a52 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20200714_230951_100998_0F2B9CD0 X-CRM114-Status: GOOD ( 21.83 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: linux-pm@vger.kernel.org, Michael Ellerman , rjw@rjwysocki.net, linux-kernel@vger.kernel.org, Paul Mackerras , Benjamin Herrenschmidt , linuxppc-dev@lists.ozlabs.org, linux-arm-kernel@lists.infradead.org Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org On 14-07-20, 15:50, Lee Jones wrote: > Repair problems with formatting and missing attributes/parameters, and > demote header comments which do not meet the required standards > applicable to kerneldoc. > > Fixes the following W=1 kernel build warning(s): > > drivers/cpufreq/powernv-cpufreq.c:84: warning: Function parameter or member 'last_lpstate_idx' not described in 'global_pstate_info' > drivers/cpufreq/powernv-cpufreq.c:84: warning: Function parameter or member 'last_gpstate_idx' not described in 'global_pstate_info' > drivers/cpufreq/powernv-cpufreq.c:84: warning: Function parameter or member 'policy' not described in 'global_pstate_info' > drivers/cpufreq/powernv-cpufreq.c:182: warning: Function parameter or member 'i' not described in 'idx_to_pstate' > drivers/cpufreq/powernv-cpufreq.c:201: warning: Function parameter or member 'pstate' not described in 'pstate_to_idx' > drivers/cpufreq/powernv-cpufreq.c:670: warning: Function parameter or member 't' not described in 'gpstate_timer_handler' > drivers/cpufreq/powernv-cpufreq.c:670: warning: Excess function parameter 'data' description in 'gpstate_timer_handler' > > Cc: Michael Ellerman > Cc: Benjamin Herrenschmidt > Cc: Paul Mackerras > Cc: linuxppc-dev@lists.ozlabs.org > Signed-off-by: Lee Jones > --- > drivers/cpufreq/powernv-cpufreq.c | 11 ++++++----- > 1 file changed, 6 insertions(+), 5 deletions(-) > > diff --git a/drivers/cpufreq/powernv-cpufreq.c b/drivers/cpufreq/powernv-cpufreq.c > index 068cc53abe320..2e5a8b8a4abaa 100644 > --- a/drivers/cpufreq/powernv-cpufreq.c > +++ b/drivers/cpufreq/powernv-cpufreq.c > @@ -64,13 +64,14 @@ > * highest_lpstate_idx > * @last_sampled_time: Time from boot in ms when global pstates were > * last set > - * @last_lpstate_idx, Last set value of local pstate and global > - * last_gpstate_idx pstate in terms of cpufreq table index > + * @last_lpstate_idx: Last set value of local pstate and global > + * @last_gpstate_idx: pstate in terms of cpufreq table index > * @timer: Is used for ramping down if cpu goes idle for > * a long time with global pstate held high > * @gpstate_lock: A spinlock to maintain synchronization between > * routines called by the timer handler and > * governer's target_index calls > + * @policy: Associated CPUFreq policy > */ > struct global_pstate_info { > int highest_lpstate_idx; > @@ -170,7 +171,7 @@ static inline u8 extract_pstate(u64 pmsr_val, unsigned int shift) > > /* Use following functions for conversions between pstate_id and index */ > > -/** > +/* > * idx_to_pstate : Returns the pstate id corresponding to the > * frequency in the cpufreq frequency table > * powernv_freqs indexed by @i. > @@ -188,7 +189,7 @@ static inline u8 idx_to_pstate(unsigned int i) > return powernv_freqs[i].driver_data; > } > > -/** > +/* > * pstate_to_idx : Returns the index in the cpufreq frequencytable > * powernv_freqs for the frequency whose corresponding > * pstate id is @pstate. > @@ -660,7 +661,7 @@ static inline void queue_gpstate_timer(struct global_pstate_info *gpstates) > /** > * gpstate_timer_handler > * > - * @data: pointer to cpufreq_policy on which timer was queued > + * @t: Timer context used to fetch global pstate info struct > * > * This handler brings down the global pstate closer to the local pstate > * according quadratic equation. Queues a new timer if it is still not equal Acked-by: Viresh Kumar -- viresh _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel