Received: by 2002:a25:8b91:0:0:0:0:0 with SMTP id j17csp462843ybl; Thu, 23 Jan 2020 01:53:10 -0800 (PST) X-Google-Smtp-Source: APXvYqyIRvkR0pR32KRCBnMtA/Kcotzd1j5EiyYps5ALqyVJJCPvhJKlaPUDrlNKnNQfcTIDwuCy X-Received: by 2002:aca:4fc2:: with SMTP id d185mr10093831oib.33.1579773190531; Thu, 23 Jan 2020 01:53:10 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1579773190; cv=none; d=google.com; s=arc-20160816; b=K4h/u/dFsvMzp7O5ypTcQaD11ARmgGIeedwmj3qR8Ip6Cs1GkLU6GRFemvYFLsEZuG XxDyHtKEL3uxT47662ALBXSV4QVDn65dqU7YkmURmdeAsr90SNJF/oFjf6+QGBHnID56 Y1mviLahu7b8mXQvchUl5QApFXOvJRY85qubndMnF5HnIycknAMPOGgV5atKT9YRVLiY qYrTn/0mh7F+TQGV5msyaGRkZlM3p09wD97GGW/buuVSQLl4xx5VQRKK0T1BuWKGijLb opCsM9u9Hxow3TWMx9Z2SchzVbTKKAjMkjTiK4XY9LTPG+zAI1DrU3jdg2+QiUDy2mpW cwGw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding :content-language:in-reply-to:mime-version:user-agent:date :message-id:from:references:cc:to:subject; bh=hkYUI9w+WUJtP9xejit4icBTmnJ1uHLFjlMIhqR1DGU=; b=UV/Bdx/WSTUcUpwUrfBNZhuSYVuuqXXAuCveF7oX1tZwA1M/sAaGBxD/EBgk90/gVk 2B9EphjaQHB87ZK7UV7ZuGEd9Z/UVrB1Xyw/lk65ExfB/hQjesu9IDp7YhVCDMVPmO/4 2okNGb8RPBGwqSYtkM1yRjJHbClFvOcDn5N8BpG25Qv3ubjEqEQDKhs1prtM/wXTABfx p8zFBgfCWuCfBkdUdcYEdywLtHC6rLQ5NRRgzVjq3rXvzc169j/188h7v/pLywndyaM0 9YEN+c0ExvuHILThCU3nba51hWKQC2J4i3Tu6oXpQl2AL3hdv1FmRZSVZsuiEujKLVjV 5Nhw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id g17si892857otk.252.2020.01.23.01.52.59; Thu, 23 Jan 2020 01:53:10 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729050AbgAWJvf (ORCPT + 99 others); Thu, 23 Jan 2020 04:51:35 -0500 Received: from hostingweb31-40.netsons.net ([89.40.174.40]:45194 "EHLO hostingweb31-40.netsons.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728925AbgAWJvc (ORCPT ); Thu, 23 Jan 2020 04:51:32 -0500 Received: from [109.168.11.45] (port=37336 helo=[192.168.101.73]) by hostingweb31.netsons.net with esmtpsa (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128) (Exim 4.92) (envelope-from ) id 1iuZ98-000AeN-2k; Thu, 23 Jan 2020 10:51:30 +0100 Subject: Re: [PATCH 15/26] docs: i2c: smbus-protocol: enable kernel-doc function syntax To: Wolfram Sang , Jean Delvare Cc: linux-doc@vger.kernel.org, linux-i2c@vger.kernel.org, Peter Rosin , linux-kernel@vger.kernel.org References: <20200105224006.10321-1-luca@lucaceresoli.net> <20200105225012.11701-1-luca@lucaceresoli.net> <20200105225012.11701-15-luca@lucaceresoli.net> <20200120154444.7c1d3863@endymion> <211da679-154f-15e3-52d3-a24d50c526cf@lucaceresoli.net> <20200122152608.40f7c90c@endymion> <20200122153747.GA21343@ninjato> From: Luca Ceresoli Message-ID: <37504278-2fea-f894-542c-c0a4f142eb9e@lucaceresoli.net> Date: Thu, 23 Jan 2020 10:51:29 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.2.2 MIME-Version: 1.0 In-Reply-To: <20200122153747.GA21343@ninjato> Content-Type: text/plain; charset=windows-1252 Content-Language: en-US Content-Transfer-Encoding: 7bit X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - hostingweb31.netsons.net X-AntiAbuse: Original Domain - vger.kernel.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - lucaceresoli.net X-Get-Message-Sender-Via: hostingweb31.netsons.net: authenticated_id: luca+lucaceresoli.net/only user confirmed/virtual account not confirmed X-Authenticated-Sender: hostingweb31.netsons.net: luca@lucaceresoli.net X-Source: X-Source-Args: X-Source-Dir: Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi, On 22/01/20 16:37, Wolfram Sang wrote: > On Wed, Jan 22, 2020 at 03:26:08PM +0100, Jean Delvare wrote: >> On Tue, 21 Jan 2020 18:31:23 +0100, Luca Ceresoli wrote: >>> Good point. For v2 I added a new patch to use "Implemented by" also in >>> i2c-protocol.rst. >> >> BTW... I don't know how Wolfram feels about it, but I don't think >> documentation changes need to be split to such fine-grained patches. > > I don't mind too much. I think for a first version, fine grained can > make review more easy. Maybe the second version could be less patches. > Yet for me, since patchwork can handle series of patches, the amount > doesn't matter too much. I am super happy that Luca did the work and you > did the review! I initially split this work in fine-grained patches for better reviewing and also because some of the changes were not expected in the beginning: while working at an improvement I noticed an unrelated one was needed. But I agree the result is quite awkward. Coalescing some of them now would be painful, so I'm sending v2 as is. But I'm tackling the remaining sections later, and I'm going to do that work in a smaller number of patches. -- Luca