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=-1.0 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, 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 7F8F4C433DF for ; Mon, 29 Jun 2020 08:48:38 +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 4C1822313B for ; Mon, 29 Jun 2020 08:48:38 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="DWULB8jr"; dkim=fail reason="signature verification failed" (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="CHK622U1" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 4C1822313B 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=Yb6EpAhBZXwXCppA7idz50x28BJzmL5bDB9yVCgtDts=; b=DWULB8jrPedg4c8pLghjMInOE 58LSPtb29G0r/AiVGViT5Ct0WZ4gv51RPcUQlbzmXFdeVXtQ62ArNZlIHcWDH86uhCcU2VfpHu6wc UEswHv7HETZddpFQJBnS9SpEODctB/LAqPnoGMDlIadcgsiI9FS/253TaKhwxasQDuLnWbP0pNeFk e2rhEPew7QYk8ajU+R0Glywx3T25Ppp/b7iKXYsvHeGf8TYWm1rPZGLS6adX6E/oWwEu+2oV0COnd 8ckVDf5OjNYkZ8kpteFasvhupX2nRAu277nHrOqpwvqDhBlQnVlcswRb3zbzflhxoN4Qse+JnUGjr ujiVzlVrw==; Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1jppRR-0001Po-Er; Mon, 29 Jun 2020 08:47:05 +0000 Received: from mail-wr1-x443.google.com ([2a00:1450:4864:20::443]) by merlin.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1jppRP-0001Pb-6y for linux-arm-kernel@lists.infradead.org; Mon, 29 Jun 2020 08:47:04 +0000 Received: by mail-wr1-x443.google.com with SMTP id g18so15701417wrm.2 for ; Mon, 29 Jun 2020 01:47:02 -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:content-transfer-encoding:in-reply-to; bh=buEQVHi4pYkYNi5xR5+kq0TuOVW4rWY7G/qVT+msh3E=; b=CHK622U1BVBtpIrk5fAZb9epzcn8u+EYAoOwW9EKuHtj3CnEYWctFHBkGa+CdPTx7U jEzR0bJBVp/+IRiDk1elxRlwcZgYuXAtj4v7XKjXobEORe+ppJIZ9z0M5CCibHMkXvLJ BspjreQUVgczs1OCbvG73J0zXVXrd4OCoZ5d5+ciCL5ys7zkADOCMezlXYMxdrh48B/4 VnV/Xy33royF/SH39pMdpvokXsGHrjKRq0b/hQXHM6A/c1PJ2K7BEJbOWx/qmkmfN29H 1jMDcocpaT8rLEmUVHbKvS+LX1IzFj/MuI9XaAj+TN+f2uyDdU2VUEkU/ntcZytpj4Nl xhgg== 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=buEQVHi4pYkYNi5xR5+kq0TuOVW4rWY7G/qVT+msh3E=; b=HTZLwq60lBpUOqEIX24el5+Ped+6VJ7qfdYxvXoADfpxK1Lh40oj2aOBQL9Az4N67L J7TJTwjET9fUN7+8RbltiNKAB+sC4I/vxu3N1yMjc6eP5ZUw1zMRMU0sSiixMZd2ovxM YYI+JsIRZ3sth8a9phoqHesUgj1gTCX6DuUqjQQy284Ppb7IA9k7NWyJd8kkyw9samoH V6nTqH8s4TLlNB4yl/AZoNzAUp+9Sxvei6EVf+rrmJPVDXMCRoX99Zy1co07q3s1FGFc 5U2lBm4xrtV+R1TBWnLn2siBx0osBddBgTDX5FSY3X2+fCfEg9CYWt31d8JREuGBd2En 6UYA== X-Gm-Message-State: AOAM532BhFIlLPUo+Sv+n/e+z8UHMZDFGIy5EMyPaTh11fBS1dhmqJzT Z/J6K38m6j0ewJv5ZOWekDSz2g== X-Google-Smtp-Source: ABdhPJzJclim0XefS2p9RYY3YoriemGjq3Rc/tzqywjW3o/beIt1fh72+EyPBH2YUhKJtI9OuNcyVA== X-Received: by 2002:a5d:6746:: with SMTP id l6mr16093673wrw.346.1593420421939; Mon, 29 Jun 2020 01:47:01 -0700 (PDT) Received: from dell ([2.27.35.144]) by smtp.gmail.com with ESMTPSA id b62sm17113004wmh.38.2020.06.29.01.47.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Jun 2020 01:47:01 -0700 (PDT) Date: Mon, 29 Jun 2020 09:46:59 +0100 From: Lee Jones To: Wolfram Sang Subject: Re: [PATCH 06/10] misc: eeprom: eeprom_93cx6: Repair function arg descriptions Message-ID: <20200629084659.GI177734@dell> References: <20200626130525.389469-1-lee.jones@linaro.org> <20200626130525.389469-7-lee.jones@linaro.org> <20200627203357.GA954@ninjato> <20200629081436.GH177734@dell> <20200629082037.GA1063@kunai> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20200629082037.GA1063@kunai> 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: gregkh@linuxfoundation.org, linux-arm-kernel@lists.infradead.org, arnd@arndb.de, linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org T24gTW9uLCAyOSBKdW4gMjAyMCwgV29sZnJhbSBTYW5nIHdyb3RlOgoKPiAKPiA+ID4gPiBAQCAt MjcwLDcgKzI3MCw3IEBAIEVYUE9SVF9TWU1CT0xfR1BMKGVlcHJvbV85M2N4Nl9yZWFkYik7Cj4g PiA+ID4gICAqIEBlZXByb206IFBvaW50ZXIgdG8gZWVwcm9tIHN0cnVjdHVyZQo+ID4gPiA+ICAg KiBAYnl0ZTogSW5kZXggZnJvbSB3aGVyZSB3ZSBzaG91bGQgc3RhcnQgcmVhZGluZwo+ID4gPiA+ ICAgKiBAZGF0YTogdGFyZ2V0IHBvaW50ZXIgd2hlcmUgdGhlIGluZm9ybWF0aW9uIHdpbGwgaGF2 ZSB0byBiZSBzdG9yZWQKPiA+ID4gPiAtICogQHdvcmRzOiBOdW1iZXIgb2YgYnl0ZXMgdGhhdCBz aG91bGQgYmUgcmVhZC4KPiA+ID4gPiArICogQGJ5dGVzOiBOdW1iZXIgb2YgYnl0ZXMgdGhhdCBz aG91bGQgYmUgcmVhZC4KPiA+ID4gCj4gPiA+IE5vdyB3ZSBoYXZlICdieXRlJyBhbmQgJ2J5dGVz JyBoZXJlIGFzIGFyZ3VtZW50cyB3aGljaCBpcyBjb25mdXNpbmcuIEkKPiA+ID4gdGhpbmsgcmVu YW1pbmcgJ3dvcmRzJyBpbnRvICdudW1fYnl0ZXMnIHdvdWxkIGJlIGV2ZW4gYmV0dGVyLgo+ID4g Cj4gPiBJIGF3YWl0IHlvdXIgcGF0Y2ggd2l0aCBiYXRlZCBicmVhdGguIDopCj4gCj4gPyBZb3Ug YXJlIHRvdWNoaW5nIGl0IGFscmVhZHksIHdoeSBhIHNlY29uZCBwYXRjaD8KCkJlY2F1c2UgaXQn cyBhIGRpZmZlcmVudCBjaGFuZ2UuICBPbmUgdGhhdCdzIG9ydGhvZ29uYWwgdG8gdGhpcyBzZXQs CndoaWNoIGlzIGRlc2lnbmVkIHNpbXBseSB0byBlbnN1cmUgdGhlIGRvY3VtZW50YXRpb24gbWF0 Y2hlcyByZWFsaXR5LgoKVGhlIGF1dGhvciBkZWNpZGVkIG9uIHRoaXMgKGxlc3MgdGhhbiBpZGVh bCBbaW4gb3VyIGh1bWJsZSBvcGluaW9uXSkKbm9tZW5jbGF0dXJlIGZyb20gdGhlIGZ1bmN0aW9u J3MgaW5jZXB0aW9uIGJhY2sgaW4gMjAxMy4gIE1heWJlIHRoZXJlCmFyZSBnb29kIHJlYXNvbnMg Zm9yIGl0IHRvIGJlIHRoaXMgd2F5LiAgRWl0aGVyIHdheSwgaXQgbWlnaHQgcmVxdWlyZQphIGRp YWxvZ3VlLiAgRm9yIHRoaXMgc2V0IEknZCByYXRoZXIgc3RpY2sgdG8gdGhlIHNjcmlwdC4KClRo YXQgc2FpZCwgSSBnZW51aW5lbHkgZG9uJ3QgbWluZCBkcmFmdGluZyBhIHBhdGNoIHRvIGZpeCB0 aGlzLiAgSWYgSQphbSB0byBkbyBzbywgaXQgd291bGQgYWxzbyBiZSBhcyBwYXJ0IGFzIGEgc3Vi c2VxdWVudCBlZmZvcnQuCgpZb3Ugb3IgbWUgLSB5b3VyIGNhbGwuICBIYXBweSBlaXRoZXIgd2F5 LgoKLS0gCkxlZSBKb25lcyBb5p2O55C85pavXQpTZW5pb3IgVGVjaG5pY2FsIExlYWQgLSBEZXZl bG9wZXIgU2VydmljZXMKTGluYXJvLm9yZyDilIIgT3BlbiBzb3VyY2Ugc29mdHdhcmUgZm9yIEFy bSBTb0NzCkZvbGxvdyBMaW5hcm86IEZhY2Vib29rIHwgVHdpdHRlciB8IEJsb2cKCl9fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmxpbnV4LWFybS1rZXJuZWwg bWFpbGluZyBsaXN0CmxpbnV4LWFybS1rZXJuZWxAbGlzdHMuaW5mcmFkZWFkLm9yZwpodHRwOi8v bGlzdHMuaW5mcmFkZWFkLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2xpbnV4LWFybS1rZXJuZWwK 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=-1.1 required=3.0 tests=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 2A7F6C433DF for ; Mon, 29 Jun 2020 20:50:17 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 02411206C0 for ; Mon, 29 Jun 2020 20:50:17 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="CHK622U1" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1733085AbgF2UuP (ORCPT ); Mon, 29 Jun 2020 16:50:15 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43360 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1731430AbgF2TNh (ORCPT ); Mon, 29 Jun 2020 15:13:37 -0400 Received: from mail-wr1-x444.google.com (mail-wr1-x444.google.com [IPv6:2a00:1450:4864:20::444]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 32C0CC008759 for ; Mon, 29 Jun 2020 01:47:03 -0700 (PDT) Received: by mail-wr1-x444.google.com with SMTP id k6so15681957wrn.3 for ; Mon, 29 Jun 2020 01:47:03 -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:content-transfer-encoding:in-reply-to; bh=buEQVHi4pYkYNi5xR5+kq0TuOVW4rWY7G/qVT+msh3E=; b=CHK622U1BVBtpIrk5fAZb9epzcn8u+EYAoOwW9EKuHtj3CnEYWctFHBkGa+CdPTx7U jEzR0bJBVp/+IRiDk1elxRlwcZgYuXAtj4v7XKjXobEORe+ppJIZ9z0M5CCibHMkXvLJ BspjreQUVgczs1OCbvG73J0zXVXrd4OCoZ5d5+ciCL5ys7zkADOCMezlXYMxdrh48B/4 VnV/Xy33royF/SH39pMdpvokXsGHrjKRq0b/hQXHM6A/c1PJ2K7BEJbOWx/qmkmfN29H 1jMDcocpaT8rLEmUVHbKvS+LX1IzFj/MuI9XaAj+TN+f2uyDdU2VUEkU/ntcZytpj4Nl xhgg== 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=buEQVHi4pYkYNi5xR5+kq0TuOVW4rWY7G/qVT+msh3E=; b=e088zRqcfOFcmMq0/d1cNgEqschNo071FBAkZL83a0cZabaVk/O20e3pA3IKqKVxGY njXmEWdzR+slXkT2/o7EK54LtUtQAq7VGbB1cTrT4LTpH6OkEqgUddikxIt/241XnXVN ozzgyaHoeDPoKx1PIrD8iUxsDbBTR9S82f2fjQqVkEqYBCbnY3yWzZXNV/rKkJ9eRYRb 37AcyAGJVRb4DYyo9IC26NKC8R+ruj2h7UhB2nK4/6X9vbfAQB35zClGSOQgSXwXEqHK hWvGqulpBqJAeWB2xek9x+CJQa2lUv0HMAZdqJBTuvH5gJOZ8luu9qBOjxZEfHIMz1oq PT1A== X-Gm-Message-State: AOAM533y0gWbpC3fJBELrNqVILqur7JOCpNWTpxdVYnrH8LOrY+OIzpn /wfYXbIx0tV1t7TRLEPdFaCRfw== X-Google-Smtp-Source: ABdhPJzJclim0XefS2p9RYY3YoriemGjq3Rc/tzqywjW3o/beIt1fh72+EyPBH2YUhKJtI9OuNcyVA== X-Received: by 2002:a5d:6746:: with SMTP id l6mr16093673wrw.346.1593420421939; Mon, 29 Jun 2020 01:47:01 -0700 (PDT) Received: from dell ([2.27.35.144]) by smtp.gmail.com with ESMTPSA id b62sm17113004wmh.38.2020.06.29.01.47.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Jun 2020 01:47:01 -0700 (PDT) Date: Mon, 29 Jun 2020 09:46:59 +0100 From: Lee Jones To: Wolfram Sang Cc: arnd@arndb.de, gregkh@linuxfoundation.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH 06/10] misc: eeprom: eeprom_93cx6: Repair function arg descriptions Message-ID: <20200629084659.GI177734@dell> References: <20200626130525.389469-1-lee.jones@linaro.org> <20200626130525.389469-7-lee.jones@linaro.org> <20200627203357.GA954@ninjato> <20200629081436.GH177734@dell> <20200629082037.GA1063@kunai> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20200629082037.GA1063@kunai> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, 29 Jun 2020, Wolfram Sang wrote: > > > > > @@ -270,7 +270,7 @@ EXPORT_SYMBOL_GPL(eeprom_93cx6_readb); > > > > * @eeprom: Pointer to eeprom structure > > > > * @byte: Index from where we should start reading > > > > * @data: target pointer where the information will have to be stored > > > > - * @words: Number of bytes that should be read. > > > > + * @bytes: Number of bytes that should be read. > > > > > > Now we have 'byte' and 'bytes' here as arguments which is confusing. I > > > think renaming 'words' into 'num_bytes' would be even better. > > > > I await your patch with bated breath. :) > > ? You are touching it already, why a second patch? Because it's a different change. One that's orthogonal to this set, which is designed simply to ensure the documentation matches reality. The author decided on this (less than ideal [in our humble opinion]) nomenclature from the function's inception back in 2013. Maybe there are good reasons for it to be this way. Either way, it might require a dialogue. For this set I'd rather stick to the script. That said, I genuinely don't mind drafting a patch to fix this. If I am to do so, it would also be as part as a subsequent effort. You or me - your call. Happy either way. -- Lee Jones [李琼斯] Senior Technical Lead - Developer Services Linaro.org │ Open source software for Arm SoCs Follow Linaro: Facebook | Twitter | Blog