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=-5.7 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=no 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 E8938C64E7A for ; Tue, 1 Dec 2020 09:47:22 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 8917A206CA for ; Tue, 1 Dec 2020 09:47:22 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="j6J/Qqlf" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728340AbgLAJrU (ORCPT ); Tue, 1 Dec 2020 04:47:20 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:57908 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728350AbgLAJrU (ORCPT ); Tue, 1 Dec 2020 04:47:20 -0500 Received: from mail-wm1-x344.google.com (mail-wm1-x344.google.com [IPv6:2a00:1450:4864:20::344]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C59CBC0613D2 for ; Tue, 1 Dec 2020 01:46:33 -0800 (PST) Received: by mail-wm1-x344.google.com with SMTP id c198so1861178wmd.0 for ; Tue, 01 Dec 2020 01:46:33 -0800 (PST) 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:content-transfer-encoding:in-reply-to; bh=yc69n6TYS8s8mnl2FbsGRORIwflmhq2kMj7KnUSbA8k=; b=j6J/Qqlfd872o2nRB+YDqXzI7k4zFcKHVgUFc5Ab63Wu7cMN64yIeAnt2k/a/xb53l MtWSIH6oUfi68e3zbL4zpM389zXYEFyuieUcGBkf+qtAUlDcQavpVG6qVzsf+NXRByD5 SGogUzW8o7rpZh2HtMStj7vhHnblQQnpwwdqZRbJoPc7NZDm5/QlYlhroDNSsjpH8tTi U0whcFsBzSDBU7mpWG5Fk/ylTYb/IAwZJoztAb4RF4Qvs2byaDeKcdyUGIWwgOLQrrfG MP53rZxR6Ttla7TSW7GCFxnPLELTNL5XPtvRwH9sUYXcKTWkUZX2jGE+n5aoNz4WaD+C Dlgw== 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:content-transfer-encoding :in-reply-to; bh=yc69n6TYS8s8mnl2FbsGRORIwflmhq2kMj7KnUSbA8k=; b=Y82R/lyYDDne3Aes80yvrM/K1NJ/dmWyqIKAwKr5Gt4woCifZGNGt8EpxNUy5iv6CH 5tkXsYI6V6D5CdoDUz5FAO3tmOv3bKqnPD0FrzzKxW6pTqMYfwajohNXzts+zlr19bae 3bfqGNega67kLypXKPzs+Fk7bL1T864SnWSMPbUvQIlKpEkP+1MOpLDwdg8uxH+S8Hpd ZXWdLHFrIQAVzG+4K9lrMxEZlQkWUhKYM9DX9cPSs3qVTnTxgTBpmavX12W8BUctmhJc rQT0TcVtZ7g6RPUbjvxOSr7Z5m5JFJvYD0g79V8ObzG67UiAS4INWpl4+DZd4txG9vde n18w== X-Gm-Message-State: AOAM530f+wOFXMUv5vqg1VyA2HoYC5y4/2Fxc0IufWDIlsTKfOdMij8o SCxBF5KEiSjqhc6tU6kLD9/Esw== X-Google-Smtp-Source: ABdhPJz89N1wsgduPoOJWxEC6lffQ1jGcCwQStOOlbZe4E9zySHh35HkIlQMklSS8+ephNH5LixsPQ== X-Received: by 2002:a1c:55ca:: with SMTP id j193mr1816945wmb.87.1606815992493; Tue, 01 Dec 2020 01:46:32 -0800 (PST) Received: from dell ([91.110.221.235]) by smtp.gmail.com with ESMTPSA id v7sm2028079wma.26.2020.12.01.01.46.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 01 Dec 2020 01:46:31 -0800 (PST) Date: Tue, 1 Dec 2020 09:46:29 +0000 From: Lee Jones To: Sam Ravnborg Cc: Thomas Zimmermann , linux-fbdev@vger.kernel.org, dri-devel@lists.freedesktop.org, Vaibhav Gupta , Tetsuo Handa , Laurent Pinchart , Jiri Slaby , Arnd Bergmann , Florian Tobias Schandinat , Evgeny Novikov , Saeed Mirzamohammadi , Daniel Vetter , Thomas Winischhofer , Bartlomiej Zolnierkiewicz , Jani Nikula , Aditya Pakki , Xiaofei Tan , Nathan Chancellor , Alex Dewar , Jason Yan , Greg Kroah-Hartman , Qilong Zhang , Randy Dunlap , Gustavo Silva , Peter Rosin , George Kennedy , Kristoffer Ericson , Alexander Klimov , Jingoo Han , Joe Perches , Peilin Ye , Mike Rapoport Subject: Re: [PATCH v2 13/28] video: fbdev: riva: Fix kernel-doc and set but not used warnings Message-ID: <20201201094629.GG4801@dell> References: <20201128224114.1033617-1-sam@ravnborg.org> <20201128224114.1033617-14-sam@ravnborg.org> <53f3e91e-d8da-bce6-878c-7842250a7a7c@suse.de> <20201130183549.GA1498572@ravnborg.org> <20201201084718.GF4801@dell> <20201201090745.GA1980788@ravnborg.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20201201090745.GA1980788@ravnborg.org> Precedence: bulk List-ID: X-Mailing-List: linux-fbdev@vger.kernel.org On Tue, 01 Dec 2020, Sam Ravnborg wrote: > Hi Lee, > > > > > Cop-out! > > > > Do what I do and make something up (joke)! :'D > > If I thought anyone would actually read the comments then maybe yes. > But I assume that apart from this thread no-one will read it. > > > > > > > Well, it fixes the warning ;) > > > > > > Yeah, I could not dig up anything useful to say here. > > > Was tempted to just drop all the kernel-doc syntax but that > > > was a larger change. > > > > Did you trace it from it's origin down to it's final use? > Yeah, but not something that seemed useful. > I could have added "translating from pixels->bytes" as they > are described somewhere else. But I could not convince myself > this was right so I just silenced the warning. > > The only reason I kept the kernel-doc in the first place is > that I am told some editors use it. > > The only effect the kernel-doc in fbdev has right now is burning > effort that could have been spent (better?) somewhere else, and > I would personally prefer to drop the kernel-doc annotations. > > But I already discussed this in another thread (not fbdev related) > and I was told it was useful for some, so it is kept. I personally think they should be kept. Despite not being referenced by any kernel-doc:: key-words. As you say, it can be helpful as an in-code reference for driver writers, people debugging code, et al. Not sure I would just repeat the variable name just to silence the warning though - that is definitely a hack. In the thousands (literally!) of these that I've fixed thus far, I haven't needed to do that. -- Lee Jones [李琼斯] Senior Technical Lead - Developer Services Linaro.org │ Open source software for Arm SoCs Follow Linaro: Facebook | Twitter | Blog 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=-3.5 required=3.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SPF_HELO_NONE, SPF_PASS,URIBL_BLOCKED autolearn=no 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 58101C64E7B for ; Tue, 1 Dec 2020 09:46:36 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (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 C532F206C0 for ; Tue, 1 Dec 2020 09:46:35 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="j6J/Qqlf" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org C532F206C0 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=linaro.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id BFC6189D46; Tue, 1 Dec 2020 09:46:34 +0000 (UTC) Received: from mail-wm1-x341.google.com (mail-wm1-x341.google.com [IPv6:2a00:1450:4864:20::341]) by gabe.freedesktop.org (Postfix) with ESMTPS id DA43A89D46 for ; Tue, 1 Dec 2020 09:46:33 +0000 (UTC) Received: by mail-wm1-x341.google.com with SMTP id k10so1840239wmi.3 for ; Tue, 01 Dec 2020 01:46:33 -0800 (PST) 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:content-transfer-encoding:in-reply-to; bh=yc69n6TYS8s8mnl2FbsGRORIwflmhq2kMj7KnUSbA8k=; b=j6J/Qqlfd872o2nRB+YDqXzI7k4zFcKHVgUFc5Ab63Wu7cMN64yIeAnt2k/a/xb53l MtWSIH6oUfi68e3zbL4zpM389zXYEFyuieUcGBkf+qtAUlDcQavpVG6qVzsf+NXRByD5 SGogUzW8o7rpZh2HtMStj7vhHnblQQnpwwdqZRbJoPc7NZDm5/QlYlhroDNSsjpH8tTi U0whcFsBzSDBU7mpWG5Fk/ylTYb/IAwZJoztAb4RF4Qvs2byaDeKcdyUGIWwgOLQrrfG MP53rZxR6Ttla7TSW7GCFxnPLELTNL5XPtvRwH9sUYXcKTWkUZX2jGE+n5aoNz4WaD+C Dlgw== 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:content-transfer-encoding :in-reply-to; bh=yc69n6TYS8s8mnl2FbsGRORIwflmhq2kMj7KnUSbA8k=; b=AXQLMW15LodaRNOCRqMdmGXzoGXo+7vf9lZFjMQA0dS61zpBZEcI4SReXpMGHecnFy ZZhru9wzivBm9OYVTwR7EVVJ6Vf5VMkNTReHayh6a1a+DXRrTDlhaT7HJpW5zU5scuV9 kQtIA03oku1EcRXaiAxC2CBPofcc8Cix4vtQ4T7KYKBAXGWDq2MwIb/B/JG5tTMw4ICd L+5FxRkCuGqEveSs8HQFoJhARQivwhMirifFPyEH4X4xfw6k/vRPG46TDZaP7/PjtxkA sgJqnEIYAa5cQ/DO1HTeor1Tjww5PgXZjVt7/pVqq/l7b3sFTP2Aop1GkuRgTgNQrA4z ogxw== X-Gm-Message-State: AOAM531VJItS43fA1KIZexAT7C7z/BMJe/0FzUkLF4rbq5YzAJsGORHQ zRWqP/sQ6oFazJbcZfI+9Oakfw== X-Google-Smtp-Source: ABdhPJz89N1wsgduPoOJWxEC6lffQ1jGcCwQStOOlbZe4E9zySHh35HkIlQMklSS8+ephNH5LixsPQ== X-Received: by 2002:a1c:55ca:: with SMTP id j193mr1816945wmb.87.1606815992493; Tue, 01 Dec 2020 01:46:32 -0800 (PST) Received: from dell ([91.110.221.235]) by smtp.gmail.com with ESMTPSA id v7sm2028079wma.26.2020.12.01.01.46.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 01 Dec 2020 01:46:31 -0800 (PST) Date: Tue, 1 Dec 2020 09:46:29 +0000 From: Lee Jones To: Sam Ravnborg Subject: Re: [PATCH v2 13/28] video: fbdev: riva: Fix kernel-doc and set but not used warnings Message-ID: <20201201094629.GG4801@dell> References: <20201128224114.1033617-1-sam@ravnborg.org> <20201128224114.1033617-14-sam@ravnborg.org> <53f3e91e-d8da-bce6-878c-7842250a7a7c@suse.de> <20201130183549.GA1498572@ravnborg.org> <20201201084718.GF4801@dell> <20201201090745.GA1980788@ravnborg.org> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20201201090745.GA1980788@ravnborg.org> 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: linux-fbdev@vger.kernel.org, Vaibhav Gupta , Tetsuo Handa , Daniel Vetter , dri-devel@lists.freedesktop.org, Laurent Pinchart , Jiri Slaby , Florian Tobias Schandinat , Evgeny Novikov , Jani Nikula , Aditya Pakki , Alexander Klimov , Arnd Bergmann , Bartlomiej Zolnierkiewicz , Saeed Mirzamohammadi , Thomas Winischhofer , Xiaofei Tan , Nathan Chancellor , Alex Dewar , Jason Yan , Greg Kroah-Hartman , Qilong Zhang , Randy Dunlap , Gustavo Silva , Peilin Ye , George Kennedy , Kristoffer Ericson , Thomas Zimmermann , Jingoo Han , Joe Perches , Peter Rosin , Mike Rapoport Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" T24gVHVlLCAwMSBEZWMgMjAyMCwgU2FtIFJhdm5ib3JnIHdyb3RlOgoKPiBIaSBMZWUsCj4gCj4g PiAKPiA+IENvcC1vdXQhCj4gPiAKPiA+IERvIHdoYXQgSSBkbyBhbmQgbWFrZSBzb21ldGhpbmcg dXAgKGpva2UpISA6J0QKPiAKPiBJZiBJIHRob3VnaHQgYW55b25lIHdvdWxkIGFjdHVhbGx5IHJl YWQgdGhlIGNvbW1lbnRzIHRoZW4gbWF5YmUgeWVzLgo+IEJ1dCBJIGFzc3VtZSB0aGF0IGFwYXJ0 IGZyb20gdGhpcyB0aHJlYWQgbm8tb25lIHdpbGwgcmVhZCBpdC4KPiAKPiA+IAo+ID4gPiA+IFdl bGwsIGl0IGZpeGVzIHRoZSB3YXJuaW5nIDspCj4gPiA+IAo+ID4gPiBZZWFoLCBJIGNvdWxkIG5v dCBkaWcgdXAgYW55dGhpbmcgdXNlZnVsIHRvIHNheSBoZXJlLgo+ID4gPiBXYXMgdGVtcHRlZCB0 byBqdXN0IGRyb3AgYWxsIHRoZSBrZXJuZWwtZG9jIHN5bnRheCBidXQgdGhhdAo+ID4gPiB3YXMg YSBsYXJnZXIgY2hhbmdlLgo+ID4gCj4gPiBEaWQgeW91IHRyYWNlIGl0IGZyb20gaXQncyBvcmln aW4gZG93biB0byBpdCdzIGZpbmFsIHVzZT8KPiBZZWFoLCBidXQgbm90IHNvbWV0aGluZyB0aGF0 IHNlZW1lZCB1c2VmdWwuCj4gSSBjb3VsZCBoYXZlIGFkZGVkICJ0cmFuc2xhdGluZyBmcm9tIHBp eGVscy0+Ynl0ZXMiIGFzIHRoZXkKPiBhcmUgZGVzY3JpYmVkIHNvbWV3aGVyZSBlbHNlLiBCdXQg SSBjb3VsZCBub3QgY29udmluY2UgbXlzZWxmCj4gdGhpcyB3YXMgcmlnaHQgc28gSSBqdXN0IHNp bGVuY2VkIHRoZSB3YXJuaW5nLgo+IAo+IFRoZSBvbmx5IHJlYXNvbiBJIGtlcHQgdGhlIGtlcm5l bC1kb2MgaW4gdGhlIGZpcnN0IHBsYWNlIGlzCj4gdGhhdCBJIGFtIHRvbGQgc29tZSBlZGl0b3Jz IHVzZSBpdC4KPiAKPiBUaGUgb25seSBlZmZlY3QgdGhlIGtlcm5lbC1kb2MgaW4gZmJkZXYgaGFz IHJpZ2h0IG5vdyBpcyBidXJuaW5nCj4gZWZmb3J0IHRoYXQgY291bGQgaGF2ZSBiZWVuIHNwZW50 IChiZXR0ZXI/KSBzb21ld2hlcmUgZWxzZSwgYW5kCj4gSSB3b3VsZCBwZXJzb25hbGx5IHByZWZl ciB0byBkcm9wIHRoZSBrZXJuZWwtZG9jIGFubm90YXRpb25zLgo+IAo+IEJ1dCBJIGFscmVhZHkg ZGlzY3Vzc2VkIHRoaXMgaW4gYW5vdGhlciB0aHJlYWQgKG5vdCBmYmRldiByZWxhdGVkKQo+IGFu ZCBJIHdhcyB0b2xkIGl0IHdhcyB1c2VmdWwgZm9yIHNvbWUsIHNvIGl0IGlzIGtlcHQuCgpJIHBl cnNvbmFsbHkgdGhpbmsgdGhleSBzaG91bGQgYmUga2VwdC4gIERlc3BpdGUgbm90IGJlaW5nIHJl ZmVyZW5jZWQKYnkgYW55IGtlcm5lbC1kb2M6OiBrZXktd29yZHMuICBBcyB5b3Ugc2F5LCBpdCBj YW4gYmUgaGVscGZ1bCBhcyBhbgppbi1jb2RlIHJlZmVyZW5jZSBmb3IgZHJpdmVyIHdyaXRlcnMs IHBlb3BsZSBkZWJ1Z2dpbmcgY29kZSwgZXQgYWwuCgpOb3Qgc3VyZSBJIHdvdWxkIGp1c3QgcmVw ZWF0IHRoZSB2YXJpYWJsZSBuYW1lIGp1c3QgdG8gc2lsZW5jZSB0aGUKd2FybmluZyB0aG91Z2gg LSB0aGF0IGlzIGRlZmluaXRlbHkgYSBoYWNrLiAgSW4gdGhlIHRob3VzYW5kcwoobGl0ZXJhbGx5 ISkgb2YgdGhlc2UgdGhhdCBJJ3ZlIGZpeGVkIHRodXMgZmFyLCBJIGhhdmVuJ3QgbmVlZGVkIHRv IGRvCnRoYXQuCgotLSAKTGVlIEpvbmVzIFvmnY7nkLzmlq9dClNlbmlvciBUZWNobmljYWwgTGVh ZCAtIERldmVsb3BlciBTZXJ2aWNlcwpMaW5hcm8ub3JnIOKUgiBPcGVuIHNvdXJjZSBzb2Z0d2Fy ZSBmb3IgQXJtIFNvQ3MKRm9sbG93IExpbmFybzogRmFjZWJvb2sgfCBUd2l0dGVyIHwgQmxvZwpf X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpkcmktZGV2ZWwg bWFpbGluZyBsaXN0CmRyaS1kZXZlbEBsaXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0cHM6Ly9saXN0 cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9kcmktZGV2ZWwK