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;
Message-ID: <66c525ff-1835-b4c7-c7ee-469060826ad6@axentia.se>
Date:   Tue, 23 Aug 2022 11:19:45 +0200
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:91.0) Gecko/20100101
 Thunderbird/91.12.0
Subject: Re: [PATCH v2 1/3] docs: i2c: i2c-topology: fix incorrect heading
Content-Language: en-US
To:     luca.ceresoli@bootlin.com, linux-doc@vger.kernel.org,
        linux-i2c@vger.kernel.org
Cc:     Wolfram Sang <wsa@kernel.org>, linux-kernel@vger.kernel.org
References: <20220822091050.47099-1-luca.ceresoli@bootlin.com>
 <20220822091050.47099-2-luca.ceresoli@bootlin.com>
From:   Peter Rosin <peda@axentia.se>
In-Reply-To: <20220822091050.47099-2-luca.ceresoli@bootlin.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?S3prdURrTTZuWDg0SWZQVUI3UzJKN05lUWZsa0l5NmpXZ3VEbHdzNzZPajdJ?=
 =?utf-8?B?RXA1Q3krQ2FXZUwrKzlQNGtjRmlZOE9ibTZQVldHWXRJMEhDSHVkWFExdVNa?=
 =?utf-8?B?MURNWEw1anF6NjZKdXpwNXFiWlVPOVdqd0hURC9NV2JBbnNsaElGeHY0aUNw?=
 =?utf-8?B?N1N4UnBqaWM5bllObXBhQ1lLNmdiUjVVanViZ1RtbklKaGdZZUVPM0lVbFNN?=
 =?utf-8?B?T1A1Zmw3ZkpPQVBnaXdSQ0QwUWFJc3Y1RnFoTzRLeGVEVHBPQ2FiaHhtUlA0?=
 =?utf-8?B?SXBrYjMrOVNmMVpJVTRtc1BqdXpUQzZVUmdjVDAzbldzb2FCdVRtaEVQRkVa?=
 =?utf-8?B?K3lNZ1ZhVUVFMm9veVlRcGlzRytvRjJuOWdJdHAxSkFFQzB6Tko5anY4bEtq?=
 =?utf-8?B?OFdmR2xvRWgrclpzNHIxSDBBVjludDdkMEsxVmpXWE5sZ1RsSHRyWWl2VDdi?=
 =?utf-8?B?MmV3aURXamtuL29iSkt3ZXpxdzkyS3JvWTBrVE1BSEE5cStCT2ZCMVhpaTVt?=
 =?utf-8?B?YUd6WGJJRm9zTEJFMDJ1akoyS3FiaXFGTWYvampFZUxWeWwyVjlhSGJUNHZK?=
 =?utf-8?B?SVhVYXc5UzBGRVhmenBEc2FJTWU5ZlVxVzZUbThSa2hBeU5mdGo5SUVQQmY2?=
 =?utf-8?B?UHFRZE9hd21tWDJYR1B3RzhibVZ0VHJscjVtL3Q0NXJvckVKeEVQNm9RV0JK?=
 =?utf-8?B?SlArc3NDbUswUmlFTDN5N1ZCNFlnd1lhWUhSS0lWUWUrZFVEZ3V2V3c3eWxa?=
 =?utf-8?B?QS9IWmR0NXNnc0JQVHZIWVduQWVwTjJCVWVFbDU2RFdKNFlrSFBvdld0c3lM?=
 =?utf-8?B?cndTTy91OUlNVlhWNjA2Qjc3SGtldEpxRWRPbldvOGtxakEyb2wzQUxzRVRW?=
 =?utf-8?B?KzlRRGdzaHhDc1hnektHdXlZY0c3ekRLNjZFZnUvSkl3MEowaWIyakRoY0xN?=
 =?utf-8?B?c2ZmOHZrc0U2NnJZQUgzeG0vUDdtNHRORmd1SE1jMzZFN1E2M3E2VEdTN2pM?=
 =?utf-8?B?MUlCemlteFZTMXZZVGhwR2JxUWNVWXVoejBvWEtjMjNZNmIvbFhKZThSeG5v?=
 =?utf-8?B?RmlzQ1ZpTjdxNldGQXFNa0V1UTljTGRuWVJEYUtTQ0xLdzMrVlJqd2I1Z1E0?=
 =?utf-8?B?SGo4NGJkR3h3b2NBaWI2OEJFaHRNTWRZSDY0dm5Sb2JkYWw1ZmRSVCtGUjN4?=
 =?utf-8?B?WFVCVUhGcTZRNDMxMGhVV2FremxBbHFoZEZLUE55a3BtWVhZSTRPZkZuYXJx?=
 =?utf-8?B?UTgyNFlHRmN6aWpzZkN6ay9Bd1Y3MHpsb0NkSTF5eDAwT09UN09uNTRHTmRr?=
 =?utf-8?B?V2o2WHdaOC9yZlFjemRIbkFZeEFLY1BGTG94cDIvZi9NeVNOOXQ5TE0vVjJu?=
 =?utf-8?B?ZmV0dFdSN2VOZ2pRV1V6NmM1akxKRVIzOHE0eENkQ0I0UEdkZHVBbnFvV1Q5?=
 =?utf-8?B?ZjhRNkt6d1ZvaHlvS2pyL08yRmNFRnhxMWwrRjltSjRLamwzYy9ZQ0JJRzRX?=
 =?utf-8?B?SStNYy9WRG8wZ3FXOXkrVTRWVnA2RTlwaGhqcWhqMXMwamRXNWV5UVJuUDlj?=
 =?utf-8?B?d1VxTVJqajYvMnRQVG43SFBMM09OY1NzRmhoQzFUSHkyQjFXV0ZPWXphQ1po?=
 =?utf-8?B?enA3VlFFM2lSM1BNL1VyejdLOTJzZHJCYW9SWjRMYnF3cUlhcWVXSWpKSDJS?=
 =?utf-8?B?U3JhbmxXTlpZTU9YMHp1blZsaWplaWt4ZGs0WFJ5TGRjb3lrUlZmSXdjRVdB?=
 =?utf-8?B?NksydnFOd2dWTHEvNGJvbm9nd25PVVVRWmpsSWptWWJvNlQzNUFvb1NaRGdD?=
 =?utf-8?B?MksydnExcnYzRUdsRWRxRFpROTZRT0c3TGM1TzZZcjR2bXUwU2lXb1RvaklS?=
 =?utf-8?B?bjJuWEFMbEROSXExVHdJYnBIM2FLSlNCSlh5M0Z4NUltZHRUZ0dtckVQendY?=
 =?utf-8?B?TDRmRzJOMitsZGFCeGtwZE1nc2FVc0xuMUQzT1pvd04wWUdMNzlMQXdkOSs2?=
 =?utf-8?B?ZG1ObnRSa0ZMUWJjVnJRU1gvU04yMG9JYTVuVXdKSjFCeHlwSU0zUXlVU1FK?=
 =?utf-8?B?emNqTkxTWWpLeVNwVzdOaEJMZ0FFVWhBM0V2THFFWXc2NXgrT001VHBLU2tR?=
 =?utf-8?Q?ytDkNL1uAF0TlMzInrhnnxpEp?=
X-OriginatorOrg: axentia.se
X-MS-Exchange-CrossTenant-Network-Message-Id: 37ced4d5-4839-42d5-93c6-08da84e89f81
X-MS-Exchange-CrossTenant-AuthSource: AM0PR02MB4436.eurprd02.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Aug 2022 09:19:47.1726
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 4ee68585-03e1-4785-942a-df9c1871a234
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: kJ81qy5Y3asHssOOVr/ETUY9m4AZ52Ji2oNQF+qBOxgZg71S1iBebjc+j05xLJDy
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PA4PR02MB7101
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,NICE_REPLY_A,RCVD_IN_DNSWL_NONE,
        RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,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: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

Hi!

[sorry for not responding to v1]

2022-08-22 at 11:10, luca.ceresoli@bootlin.com wrote:
> From: Luca Ceresoli <luca.ceresoli@bootlin.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@bootlin.com>

Acked-by: Peter Rosin <peda@axentia.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