Received: by 2002:a25:8b91:0:0:0:0:0 with SMTP id j17csp2517874ybl; Thu, 9 Jan 2020 14:16:56 -0800 (PST) X-Google-Smtp-Source: APXvYqynJzyKncYufz9LDOn5VlAPxoO7I8pjYvCQZaCARoCOhkEJvK7AFsb2w8bV1arHSgB0pqtE X-Received: by 2002:a9d:62c2:: with SMTP id z2mr63944otk.309.1578608216207; Thu, 09 Jan 2020 14:16:56 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1578608216; cv=none; d=google.com; s=arc-20160816; b=txDZpDfr9k/mTkoWUtx3tA6tBUf9Kz4WKksEqVBHsxUwvA06h2RPMFhmWnTcJVM97A gw61578f95Ob0Hfz09xIvcwrJzuyazmK1qoqHMyBLzkQZKxC43+jT0qI2aN4ZSXzzKxT QBexD80pUWH84EFzftE9ehDIwokDTjrT8HWeoN8azPnytbj2FXfA8ktNQuJ8RaVHtLOi BNQDddTPV+JOPaiPwaf/zCj4AAxX09Z4xgKYgHF4pXwNltkRmn/n1Oqf6FT+b72vOczA Y6LWew73IvqPacTK0B0IvOUrC8jcc4gmeIO0zW+lv96C2V3dS9oLV0bdizFxDN2PbKvF FrKA== 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=GKpeqyg0wvTG+4WmtUG1NdJgaD1aA4XpVsWDO/xj9Lo=; b=GtitnXoiDR+USqF38bsdxW6cZz6EejrrLEhiMSuY4tOP7MDWWHTKDs48eA9o48CSWZ 01hlUoCuxIhB9K54uVCxfBbxvn6wzXUd2pUd7cSYoxPRqLHGawK846BHugSiSuvElLEx uams4SnaotCfY+3rxkffSXnTUNg2re9iPwlLJzvwoiI8SJeXO5ad2qyJsHJs0tbBmOEm ZH617ioEszvoX+CdpPXz0ww5OnNB55cnmTSrEB3qrk+0ibgh79wWAswGkI2EppI1Emqt 3Bq5CPXupUQt9vUoj0v/EvN1+d7SI16S9XfmRcCCPju8Kna1tnjvZKdGmyVUw6m6zAaY PHjQ== 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 f15si4320101oib.61.2020.01.09.14.16.43; Thu, 09 Jan 2020 14:16:56 -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 S1729020AbgAIWPf (ORCPT + 99 others); Thu, 9 Jan 2020 17:15:35 -0500 Received: from hostingweb31-40.netsons.net ([89.40.174.40]:55537 "EHLO hostingweb31-40.netsons.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725840AbgAIWPf (ORCPT ); Thu, 9 Jan 2020 17:15:35 -0500 Received: from [88.149.160.229] (port=59042 helo=[192.168.77.51]) by hostingweb31.netsons.net with esmtpsa (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128) (Exim 4.92) (envelope-from ) id 1ipg5U-003Orv-BB; Thu, 09 Jan 2020 23:15:32 +0100 Subject: Re: [PATCH v2] docs: i2c: Fix return value of i2c_smbus_xxx functions To: Jean Delvare , Wolfram Sang Cc: Lei YU , linux-i2c@vger.kernel.org, linux-kernel@vger.kernel.org References: <1574162632-65848-1-git-send-email-mine260309@gmail.com> <20191125144857.GA2412@kunai> <20191126115243.673fc164@endymion> <20200106130056.GA1290@ninjato> <20200109173929.1b42e0a6@endymion> From: Luca Ceresoli Message-ID: <0bf8bf55-525f-fd4e-0f10-fe0efad9ecb2@lucaceresoli.net> Date: Thu, 9 Jan 2020 23:15:31 +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: <20200109173929.1b42e0a6@endymion> Content-Type: text/plain; charset=utf-8 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 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 Jean, On 09/01/20 17:39, Jean Delvare wrote: > On Mon, 6 Jan 2020 14:01:09 +0100, Wolfram Sang wrote: >>> I would go further and move half of the document to i2c-tools. i2c-dev >>> itself only provides the ioctls. Everything on top of that is in libi2c >>> now, so the kernel documentation should point to libi2c and the >>> detailed documentation should come with libi2c. >>> >>> So I guess I should review the whole document now to see what needs to >>> be updated, what should stay, and what should move. >> >> Maybe you can collaborate with Luca on this who just revamped a lot of >> the docs? Putting him on CC and marking this patch as 'Deferred'. > > I'm resuming my work on this. Luca, can you point me to your changes to > Documentation/i2c/dev-interface.rst so that I can adjust my own changes > to fit on top? Commits 4 and 26 of this series: https://patchwork.ozlabs.org/project/linux-i2c/list/?series=151292 Pretty trivial patches anyway, I haven't really tackled that specific file so far, which is good as you are planning to remove all/most of it. -- Luca