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 <[email protected]>
---
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
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
=====================================
-The need for a document like this one became apparent in the
-linux-kernel mailing list as the same questions, asking for pointers
-to information, appeared again and again.
+The need for a document like this one became apparent in the linux-kernel
+mailing list as the same questions, asking for pointers to information,
+appeared again and again.
-Fortunately, as more and more people get to GNU/Linux, more and more
-get interested in the Kernel. But reading the sources is not always
-enough. It is easy to understand the code, but miss the concepts, the
-philosophy and design decisions behind this code.
+Fortunately, as more and more people get to GNU/Linux, more and more get
+interested in the Kernel. But reading the sources is not always enough. It
+is easy to understand the code, but miss the concepts, the philosophy and
+design decisions behind this code.
-Unfortunately, not many documents are available for beginners to
-start. And, even if they exist, there was no "well-known" place which
-kept track of them. These lines try to cover this lack.
+Unfortunately, not many documents are available for beginners to start.
+And, even if they exist, there was no "well-known" place which kept track
+of them. These lines try to cover this lack.
PLEASE, if you know any paper not listed here or write a new document,
include a reference to it here, following the kernel's patch submission
process. Any corrections, ideas or comments are also welcome.
All documents are cataloged with the following fields: the document's
-"Title", the "Author"/s, the "URL" where they can be found, some
-"Keywords" helpful when searching for specific topics, and a brief
-"Description" of the Document.
+"Title", the "Author"/s, the "URL" where they can be found, some "Keywords"
+helpful when searching for specific topics, and a brief "Description" of
+the Document.
.. note::
@@ -72,9 +72,29 @@ On-line docs
programming. Lots of examples. Currently the new version is being
actively maintained at https://github.com/sysprog21/lkmpg.
+ * Title: **Rust for Linux**
+
+ :Author: various
+ :URL: https://rust-for-linux.com/
+ :Date: rolling version
+ :Keywords: glossary, terms, linux-kernel.
+ :Description: From the website: "Rust for Linux is the project adding
+ support for the Rust language to the Linux kernel. This website is
+ intended as a hub of links, documentation and resources related to
+ the project".
+
Published books
---------------
+ * Title: **Practical Linux System Administration: A Guide to
Installation, Configuration, and Management, 1st Edition**
+
+ :Author: Kenneth Hess
+ :Publisher: O'Reilly Media
+ :Date: May, 2023
+ :Pages: 246
+ :ISBN: 978-1098109035
+ :Notes: System administration
+
* Title: **Linux Kernel Debugging: Leverage proven tools and advanced
techniques to effectively debug Linux kernels and kernel modules**
:Author: Kaiwan N Billimoria
@@ -88,9 +108,9 @@ Published books
:Author: Kaiwan N Billimoria
:Publisher: Packt Publishing Ltd
- :Date: March, 2021
+ :Date: March, 2021 (Second Edition published in 2024)
:Pages: 754
- :ISBN: 978-1789953435
+ :ISBN: 978-1789953435 (Second Edition ISBN is 978-1803232225)
* Title: **Linux Kernel Programming Part 2 - Char Device Drivers and
Kernel Synchronization: Create user-kernel interfaces, work with peripheral
I/O, and handle hardware interrupts**
@@ -118,15 +138,6 @@ Published books
:ISBN: 978-0672329463
:Notes: Foundational book
- * Title: **Practical Linux System Administration: A Guide to
Installation, Configuration, and Management, 1st Edition**
-
- :Author: Kenneth Hess
- :Publisher: O'Reilly Media
- :Date: May, 2023
- :Pages: 246
- :ISBN: 978-1098109035
- :Notes: System administration
-
.. _ldd3_published:
* Title: **Linux Device Drivers, 3rd Edition**
@@ -201,6 +212,15 @@ Miscellaneous
:Description: Some of the linux-kernel mailing list archivers. If
you have a better/another one, please let me know.
+ * Name: **The Linux Foundation YouTube channel**
+
+ :URL: https://www.youtube.com/user/thelinuxfoundation
+ :Keywords: linux, videos, linux-foundation, youtube.
+ :Description: The Linux Foundation uploads video recordings of their
+ collaborative events, Linux conferences including LinuxCon, and
+ other original research and content related to Linux and software
+ development.
+
-------
This document was originally based on:
--
2.43.0
Carlos Bilbao <[email protected]> writes:
> 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 <[email protected]>
> ---
> Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------
> 1 file changed, 44 insertions(+), 24 deletions(-)
So I was going to apply this but ... it doesn't apply. It looks like
some sort of weird whitespace damage?
jon
On 5/30/24 14:34, Jonathan Corbet wrote:
> Carlos Bilbao <[email protected]> writes:
>
>> 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 <[email protected]>
>> ---
>> Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------
>> 1 file changed, 44 insertions(+), 24 deletions(-)
> So I was going to apply this but ... it doesn't apply. It looks like
> some sort of weird whitespace damage?
Apologies for the inconvenience. I found the issue so this should not
happen in future patches. Replying with the fixed patch now.
>
> jon
Thanks,
Carlos
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 <[email protected]>
---
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
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
=====================================
-The need for a document like this one became apparent in the
-linux-kernel mailing list as the same questions, asking for pointers
-to information, appeared again and again.
+The need for a document like this one became apparent in the linux-kernel
+mailing list as the same questions, asking for pointers to information,
+appeared again and again.
-Fortunately, as more and more people get to GNU/Linux, more and more
-get interested in the Kernel. But reading the sources is not always
-enough. It is easy to understand the code, but miss the concepts, the
-philosophy and design decisions behind this code.
+Fortunately, as more and more people get to GNU/Linux, more and more get
+interested in the Kernel. But reading the sources is not always enough. It
+is easy to understand the code, but miss the concepts, the philosophy and
+design decisions behind this code.
-Unfortunately, not many documents are available for beginners to
-start. And, even if they exist, there was no "well-known" place which
-kept track of them. These lines try to cover this lack.
+Unfortunately, not many documents are available for beginners to start.
+And, even if they exist, there was no "well-known" place which kept track
+of them. These lines try to cover this lack.
PLEASE, if you know any paper not listed here or write a new document,
include a reference to it here, following the kernel's patch submission
process. Any corrections, ideas or comments are also welcome.
All documents are cataloged with the following fields: the document's
-"Title", the "Author"/s, the "URL" where they can be found, some
-"Keywords" helpful when searching for specific topics, and a brief
-"Description" of the Document.
+"Title", the "Author"/s, the "URL" where they can be found, some "Keywords"
+helpful when searching for specific topics, and a brief "Description" of
+the Document.
.. note::
@@ -72,9 +72,29 @@ On-line docs
programming. Lots of examples. Currently the new version is being
actively maintained at https://github.com/sysprog21/lkmpg.
+ * Title: **Rust for Linux**
+
+ :Author: various
+ :URL: https://rust-for-linux.com/
+ :Date: rolling version
+ :Keywords: glossary, terms, linux-kernel.
+ :Description: From the website: "Rust for Linux is the project adding
+ support for the Rust language to the Linux kernel. This website is
+ intended as a hub of links, documentation and resources related to
+ the project".
+
Published books
---------------
+ * Title: **Practical Linux System Administration: A Guide to Installation, Configuration, and Management, 1st Edition**
+
+ :Author: Kenneth Hess
+ :Publisher: O'Reilly Media
+ :Date: May, 2023
+ :Pages: 246
+ :ISBN: 978-1098109035
+ :Notes: System administration
+
* Title: **Linux Kernel Debugging: Leverage proven tools and advanced techniques to effectively debug Linux kernels and kernel modules**
:Author: Kaiwan N Billimoria
@@ -88,9 +108,9 @@ Published books
:Author: Kaiwan N Billimoria
:Publisher: Packt Publishing Ltd
- :Date: March, 2021
+ :Date: March, 2021 (Second Edition published in 2024)
:Pages: 754
- :ISBN: 978-1789953435
+ :ISBN: 978-1789953435 (Second Edition ISBN is 978-1803232225)
* Title: **Linux Kernel Programming Part 2 - Char Device Drivers and Kernel Synchronization: Create user-kernel interfaces, work with peripheral I/O, and handle hardware interrupts**
@@ -118,15 +138,6 @@ Published books
:ISBN: 978-0672329463
:Notes: Foundational book
- * Title: **Practical Linux System Administration: A Guide to Installation, Configuration, and Management, 1st Edition**
-
- :Author: Kenneth Hess
- :Publisher: O'Reilly Media
- :Date: May, 2023
- :Pages: 246
- :ISBN: 978-1098109035
- :Notes: System administration
-
.. _ldd3_published:
* Title: **Linux Device Drivers, 3rd Edition**
@@ -201,6 +212,15 @@ Miscellaneous
:Description: Some of the linux-kernel mailing list archivers. If
you have a better/another one, please let me know.
+ * Name: **The Linux Foundation YouTube channel**
+
+ :URL: https://www.youtube.com/user/thelinuxfoundation
+ :Keywords: linux, videos, linux-foundation, youtube.
+ :Description: The Linux Foundation uploads video recordings of their
+ collaborative events, Linux conferences including LinuxCon, and
+ other original research and content related to Linux and software
+ development.
+
-------
This document was originally based on:
--
2.43.0
Carlos Bilbao <[email protected]> writes:
> 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 <[email protected]>
> ---
> Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------
> 1 file changed, 44 insertions(+), 24 deletions(-)
So I still am unable to apply this. There is some sort of whitespace
damage, perhaps some sort of non-breaking spaces?
jon
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 <[email protected]>
> ---
> 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...
> 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
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 <[email protected]>
>> ---
>> 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
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 <[email protected]>
>>> ---
>>> 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