linux-kernel - Re: [PATCH v2 1/3] docs: i2c: i2c-topology: fix incorrect heading

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <66c525ff-1835-b4c7-c7ee-469060826ad6@axentia.se>
Date:   Tue, 23 Aug 2022 11:19:45 +0200
From:   Peter Rosin <peda@...ntia.se>
To:     luca.ceresoli@...tlin.com, linux-doc@...r.kernel.org,
        linux-i2c@...r.kernel.org
Cc:     Wolfram Sang <wsa@...nel.org>, linux-kernel@...r.kernel.org
Subject: Re: [PATCH v2 1/3] docs: i2c: i2c-topology: fix incorrect heading

Hi!

[sorry for not responding to v1]

2022-08-22 at 11:10, luca.ceresoli@...tlin.com wrote:
> From: Luca Ceresoli <luca.ceresoli@...tlin.com>
> 
> "Etc" here was never meant to be a heading, it became one while converting
> to ReST.
> 
> It would be easy to just convert it to plain text, but rather remove it and
> add an introductory text before the list that conveys the same meaning but
> with a better reading flow.
> 
> Fixes: ccf988b66d69 ("docs: i2c: convert to ReST and add to driver-api bookset")
> Signed-off-by: Luca Ceresoli <luca.ceresoli@...tlin.com>

Acked-by: Peter Rosin <peda@...ntia.se>

Cheers,
Peter

> 
> ---
> 
> Changed in v2: none
> ---
>  Documentation/i2c/i2c-topology.rst | 5 ++---
>  1 file changed, 2 insertions(+), 3 deletions(-)
> 
> diff --git a/Documentation/i2c/i2c-topology.rst b/Documentation/i2c/i2c-topology.rst
> index 7cb53819778e..1b11535c8946 100644
> --- a/Documentation/i2c/i2c-topology.rst
> +++ b/Documentation/i2c/i2c-topology.rst
> @@ -5,6 +5,8 @@ I2C muxes and complex topologies
>  There are a couple of reasons for building more complex I2C topologies
>  than a straight-forward I2C bus with one adapter and one or more devices.
>  
> +Some example use cases are:
> +
>  1. A mux may be needed on the bus to prevent address collisions.
>  
>  2. The bus may be accessible from some external bus master, and arbitration
> @@ -14,9 +16,6 @@ than a straight-forward I2C bus with one adapter and one or more devices.
>     from the I2C bus, at least most of the time, and sits behind a gate
>     that has to be operated before the device can be accessed.
>  
> -Etc
> -===
> -
>  These constructs are represented as I2C adapter trees by Linux, where
>  each adapter has a parent adapter (except the root adapter) and zero or
>  more child adapters. The root adapter is the actual adapter that issues