Received-SPF: pass (google.com: domain of linux-kernel+bounces-212350-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) client-ip=147.75.48.161;
Message-ID: <9179dbe6-d865-492f-a8e9-da91626c095d@infradead.org>
Date: Wed, 12 Jun 2024 16:10:33 -0700
Precedence: bulk
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: [PATCH] docs: Extend and refactor index of further kernel docs
From: Randy Dunlap <rdunlap@infradead.org>
To: Carlos Bilbao <carlos.bilbao.osdev@gmail.com>,
 Jonathan Corbet <corbet@lwn.net>, bilbao@vt.edu
Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
References: <fdf68be7-875a-421d-8bc3-034a21990679@gmail.com>
 <87ikyvccwc.fsf@meer.lwn.net>
 <2acd884f-2f04-4d39-b559-aac99f9ae35e@gmail.com>
 <53bd3bbf-0410-425e-84e7-1d34cac60412@infradead.org>
 <5a2389c8-f64a-47c1-8924-c603628c52fb@infradead.org>
Content-Language: en-US
In-Reply-To: <5a2389c8-f64a-47c1-8924-c603628c52fb@infradead.org>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit


On 6/12/24 4:07 PM, Randy Dunlap wrote:
> 
> 
> On 6/12/24 3:17 PM, Randy Dunlap wrote:
>>
>>
>> On 6/1/24 8:03 AM, Carlos Bilbao wrote:
>>> Extend the Index of Further Kernel Documentation by adding entries for the
>>> Rust for Linux website, the Linux Foundation's YouTube channel, and notes
>>> on the second edition of Billimoria's kernel programming book. Also,
>>> perform some refactoring: format the text to 75 characters per line and
>>> sort per-section content in chronological order of publication.
>>>
>>> Signed-off-by: Carlos Bilbao <carlos.bilbao.osdev@gmail.com>
>>> ---
>>>  Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------
>>>  1 file changed, 44 insertions(+), 24 deletions(-)
>>>
>>> diff --git a/Documentation/process/kernel-docs.rst
>>> b/Documentation/process/kernel-docs.rst
>>
>> The 2 lines above should be on one line, but fixing that doesn't fix everything.
>> 'patch' still says that it's a malformed patch.
>>
>> Carlos, please check Documentation/process/email-clients.rst section on
>> Thunderbird, especially for line length and line wrap.
>>
>> I'm still looking...
> 
> I don't know what is causing it, but there are a bunch of non-ASCII characters
> in the patch file. Specifically 0xc2 at the beginning of many lines. E.g., when
> I copy/paste only the "Index of Further" & ===== lines into a small text file:
> 
>> hd docs-chars.txt 
> 000000 c2 a0 49 6e 64 65 78 20 6f 66 20 46 75 72 74 68  >..Index of Furth<
> 000010 65 72 20 4b 65 72 6e 65 6c 20 44 6f 63 75 6d 65  >er Kernel Docume<
> 000020 6e 74 61 74 69 6f 6e 0a c2 a0 3d 3d 3d 3d 3d 3d  >ntation...======<
> 000030 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  >================<
> 000040 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a  >===============.<
> 

Ah, C2 A0 is a non-break space. My guess is that Thunderbird
is doing something here.

> 
>>
>>> index 8660493b91d0..6f3e290abd22 100644
>>> --- a/Documentation/process/kernel-docs.rst
>>> +++ b/Documentation/process/kernel-docs.rst
>>> @@ -3,27 +3,27 @@
>>>  Index of Further Kernel Documentation
>>>  =====================================
>>
>>
> 

-- 
~Randy