Received: by 2002:a05:6358:e9c4:b0:b2:91dc:71ab with SMTP id hc4csp4804646rwb; Mon, 8 Aug 2022 07:19:11 -0700 (PDT) X-Google-Smtp-Source: AA6agR7qE0FyBG4XG61QqjKjrU+pFcMhIcedUEW5BI/q1tPYc2fLFXQ9rxjKg4bJ46gAohtWfGYP X-Received: by 2002:a05:6402:2802:b0:43a:9098:55a0 with SMTP id h2-20020a056402280200b0043a909855a0mr17639045ede.179.1659968351168; Mon, 08 Aug 2022 07:19:11 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1659968351; cv=none; d=google.com; s=arc-20160816; b=rpAILMAgWLyV9ThhNN/9h4ggRtx953dpomXwPcHItrKpsNBksLSJUP9T+k/rKcWlWw 2bJpCAWXa75zElw+nXlsC+1uHR4I39qpu/0HR+39ZVGRsye+l56l2PNogH/i4WqChV/u jgFyv1Inr+MoEOV1v8ESRH7MLaOoZ4eisal71VKqWcQbWiTvyEYvw0UQgZXyXoUcwdnM DseRq1JqDTuTj7ntWwvuHH/umQPpCleKZ7n6wYolpFr1HLRT0bHgL/CjLjsI9uNyHntZ 0z2bNviLJRaM/bd2neIKHqZiuHTwW+q9A8fxLzKxsLjiTRVCRIKXMmE1PdhWV/0yQKW7 bxMA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=5tqGvmnrSvsFcUDABYvSLRL0NMaC8Jssd6Lw6T4P0us=; b=C+vngSc97pilpAtF/iKSc6skbzhd7zt3BfQAf6N9yOOIX2IxkcacfBoaVqNESx8uMj N4YQ+QW5cgGYuFIkYinjDrgSr8xJA4sMHl22EKLgeweVebNjjW2Ndb1cxw+9CrMX6qqx gF1RV2vFJfLE/R3DKMmOJLV4YpqOMG24mEyXisqCZ3faLE7InYF8KIgDfkZEG/WhJ56p qHUzETrdC7E5gkpryGDJkus5WOhf4DET8mAQzhdTaelgiAjw54KFN6frczvcAaqzSy7M gUOF2ph6q9E0HOk/qymbSEpyNGZVYZKyBivKgQh+un/GA9nbkS5XdYg+yvr3pygcLOKn vl9Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=nJhMSKF0; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=bootlin.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id va27-20020a17090711db00b0072a84586c63si9576304ejb.564.2022.08.08.07.18.43; Mon, 08 Aug 2022 07:19:11 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=nJhMSKF0; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=bootlin.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S243288AbiHHORm (ORCPT + 99 others); Mon, 8 Aug 2022 10:17:42 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:46328 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235330AbiHHORk (ORCPT ); Mon, 8 Aug 2022 10:17:40 -0400 Received: from relay2-d.mail.gandi.net (relay2-d.mail.gandi.net [IPv6:2001:4b98:dc4:8::222]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CB023CDA; Mon, 8 Aug 2022 07:17:36 -0700 (PDT) Received: from booty.fritz.box (unknown [77.244.183.192]) (Authenticated sender: luca.ceresoli@bootlin.com) by mail.gandi.net (Postfix) with ESMTPA id 436E84000C; Mon, 8 Aug 2022 14:17:34 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1659968255; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding; bh=5tqGvmnrSvsFcUDABYvSLRL0NMaC8Jssd6Lw6T4P0us=; b=nJhMSKF0txxias8Dm3BW4cdofXFhLcuGgMTXRVDW0oVfgylj/SbPorciy3mdswFZcx+W/C 6zh4mr4IkLfB7Gx85SaGLAaLGI/YRsR8SG+m/1LdW5iCc9uWTXs+xpjsz9vlkLxLTjizwg VS+B6OVySPxGsV9oxsmZvEu5W5ugRJYx18cOWNzByK6r+r7xTM7i6mB9TP8we4Mg+RsPEV Vhn97WzHBEAQvV6W8BhvsTDXICAl/JBukjTVCb+YFPcqp+euwPklmYrE+HXx2xtztFUX10 B/Uto+5ewJFjJmORkOPFfK0Sk8OhWP0iQgITC9gbZJrFlNO84iBJ3w0x7K3xmA== From: luca.ceresoli@bootlin.com To: linux-doc@vger.kernel.org, linux-i2c@vger.kernel.org Cc: Luca Ceresoli , Wolfram Sang , Peter Rosin , linux-kernel@vger.kernel.org Subject: [PATCH 0/9] docs: i2c: rework I2C documentation, part II Date: Mon, 8 Aug 2022 16:16:59 +0200 Message-Id: <20220808141708.1021103-1-luca.ceresoli@bootlin.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW,SPF_HELO_NONE, SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Luca Ceresoli Back in January 2020 I sent a first batch of patches to improve I2C documentation, titled "docs: i2c: rework I2C documentation, part I" [0] and I wrote "I will continue to cover the rest of the sections later". After about 2.5y, here I am with part II! This series contains assorted improvements to the "Introduction" section. The plan is to cover the remaining sections "later", but hopefully sooner than in 2.5 more years. [0] https://lore.kernel.org/linux-i2c/20200123135103.20540-1-luca@lucaceresoli.net/ Luca Luca Ceresoli (9): docs: i2c: i2c-protocol: update introductory paragraph docs: i2c: i2c-protocol,smbus-protocol: remove nonsense words docs: i2c: i2c-protocol: remove unused legend items docs: i2c: smbus-protocol: improve DataLow/DataHigh definition docs: i2c: instantiating-devices: add syntax coloring to dts and C blocks docs: i2c: i2c-topology: fix incorrect heading docs: i2c: i2c-topology: reorder sections more logically docs: i2c: i2c-sysfs: improve wording docs: i2c: i2c-sysfs: fix hyperlinks Documentation/i2c/i2c-protocol.rst | 11 +- Documentation/i2c/i2c-sysfs.rst | 24 +-- Documentation/i2c/i2c-topology.rst | 209 ++++++++++---------- Documentation/i2c/instantiating-devices.rst | 16 +- Documentation/i2c/smbus-protocol.rst | 6 +- 5 files changed, 137 insertions(+), 129 deletions(-) -- 2.34.1