From patchwork Sun Jan 5 22:39:40 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luca Ceresoli X-Patchwork-Id: 1217818 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (no SPF record) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=linux-i2c-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=lucaceresoli.net Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 47rYbx513yz9sPJ for ; Mon, 6 Jan 2020 09:44:29 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727080AbgAEWnP (ORCPT ); Sun, 5 Jan 2020 17:43:15 -0500 Received: from hostingweb31-40.netsons.net ([89.40.174.40]:48572 "EHLO hostingweb31-40.netsons.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726851AbgAEWnO (ORCPT ); Sun, 5 Jan 2020 17:43:14 -0500 Received: from [81.174.41.21] (port=58572 helo=melee.fritz.box) by hostingweb31.netsons.net with esmtpa (Exim 4.92) (envelope-from ) id 1ioEbs-00GPCc-B9; Sun, 05 Jan 2020 23:43:11 +0100 From: Luca Ceresoli 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 00/26] docs: i2c: rework I2C documentation, part I Date: Sun, 5 Jan 2020 23:39:40 +0100 Message-Id: <20200105224006.10321-1-luca@lucaceresoli.net> X-Mailer: git-send-email 2.24.1 MIME-Version: 1.0 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-i2c-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-i2c@vger.kernel.org Hi, this series is a list of improvements to the I2C documentation. It started as a simple reordering of index.rst from alphabetical order to a logical order. Then it grew to a mixture of various improvements to each section. I wanted to rework all the sections in a unique series, but after covering about one third of them the number of patches has already grown pretty long so I'm sending it in its current state. Let's see how this series is received, I will continue to cover the rest of the sections later. Each patch is quite self-standing, and most are trivial, so have a good reading. Luca Luca Ceresoli (26): docs: i2c: sort index logically docs: i2c: summary: extend introduction docs: i2c: summary: rewrite the "terminology" section docs: i2c: call it "I2C" consistently docs: i2c: fix typo docs: i2c: replace "I2C-transfer" -> "I2C transfer" consistently docs: i2c: i2c-protocol: fix kernel-doc function syntax docs: i2c: i2c-protocol: properly name start and stop conditions docs: i2c: i2c-protocol: remove unneeded colons from table docs: i2c: i2c-protocol: use proper names for ACK and NACK docs: i2c: smbus: fix link syntax docs: i2c: smbus-protocol: properly name start and stop conditions docs: i2c: smbus-protocol: remove unneeded colons from table docs: i2c: smbus-protocol: use proper names for ACK and NACK docs: i2c: smbus-protocol: enable kernel-doc function syntax docs: i2c: smbus-protocol: fix kernel-doc function syntax docs: i2c: i2c-protocol: fix typo docs: i2c: i2c-protocol: fix punctuation docs: i2c: smbus-protocol: improve I2C Block transactions description docs: i2c: instantiating-devices: fix internal hyperlink docs: i2c: instantiating-devices: rearrange static instatiation docs: i2c: instantiating-devices: use monospace for filenames docs: i2c: old-module-parameters: fix internal hyperlink docs: i2c: old-module-parameters: clarify this is for obsolete kernels docs: i2c: old-module-parameters: use monospace for filenames docs: i2c: rename sections so the overall picture is clearer Documentation/i2c/dev-interface.rst | 24 +- Documentation/i2c/dma-considerations.rst | 2 +- Documentation/i2c/i2c-protocol.rst | 45 +- Documentation/i2c/i2c-topology.rst | 72 +- Documentation/i2c/i2c.svg | 1341 +++++++++++++++++++ Documentation/i2c/index.rst | 21 +- Documentation/i2c/instantiating-devices.rst | 116 +- Documentation/i2c/old-module-parameters.rst | 30 +- Documentation/i2c/slave-interface.rst | 4 +- Documentation/i2c/smbus-protocol.rst | 107 +- Documentation/i2c/summary.rst | 61 +- Documentation/i2c/writing-clients.rst | 10 +- 12 files changed, 1611 insertions(+), 222 deletions(-) create mode 100644 Documentation/i2c/i2c.svg