linux-kernel - Re: [PATCH] docs: Extend and refactor index of further kernel docs

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: Windows password security audit tool. GUI, reports in PDF.

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

Message-ID: <5a2389c8-f64a-47c1-8924-c603628c52fb@infradead.org>
Date: Wed, 12 Jun 2024 16:07:47 -0700
From: Randy Dunlap <rdunlap@...radead.org>
To: Carlos Bilbao <carlos.bilbao.osdev@...il.com>,
 Jonathan Corbet <corbet@....net>, bilbao@...edu
Cc: linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH] docs: Extend and refactor index of further kernel docs



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@...il.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  >===============.<


> 
>> 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