Skip to contentSkip to conversation

docs: Extend and refactor index of further kernel docs

PATCH In review Carlos Bilbao 3 participants 14 messages May 25, 2024 – Jun 27, 2024

Subsystems (3)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 docs: Extend and refactor index of further kernel docs

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.

---
 Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------

 1 file changed, 44 insertions(+), 24 deletions(-)
(quoted diff) +0 -0

b/Documentation/process/kernel-docs.rst
index 8660493b91d0..6f3e290abd22 100644

Documentation/process/kernel-docs.rst +0 -0
@@ -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:

Signature · 1 line
2.43.0
maintainer
#1 lore raw
Quoted 10 lines · Carlos Bilbao

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.

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

#2 lore raw
Quoted 8 lines · Jonathan Corbet
Quoted 6 lines · Carlos Bilbao

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.

Quoted 6 lines
Quoted 4 lines

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

Quoted 2 lines

jon

Thanks,
Carlos

#3 lore raw

PATCH 1/1 docs: Extend and refactor index of further kernel docs

In reply to Jonathan Corbet

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.

---
 Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------

 1 file changed, 44 insertions(+), 24 deletions(-)
(quoted diff) +0 -0

b/Documentation/process/kernel-docs.rst
index 8660493b91d0..6f3e290abd22 100644

Documentation/process/kernel-docs.rst +0 -0
@@ -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:

Signature · 1 line
2.43.0
maintainer
#4 lore raw
Quoted 10 lines · Carlos Bilbao

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.

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

reviewer
#5 lore raw
In reply to Carlos Bilbao

Documentation/process/kernel-docs.rst

Quoted 13 lines · Carlos Bilbao

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.

---
 Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------

 1 file changed, 44 insertions(+), 24 deletions(-)
Documentation/process/kernel-docs.rst +0 -0

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

Quoted 6 lines

index 8660493b91d0..6f3e290abd22 100644

Documentation/process/kernel-docs.rst +0 -0
@@ -3,27 +3,27 @@

 Index of Further Kernel Documentation
 =====================================

Signature · 1 line
~Randy
reviewer
#6 lore raw
Quoted 20 lines · Randy Dunlap

Documentation/process/kernel-docs.rst

Quoted 13 lines · Carlos Bilbao

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.

---
 Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------

 1 file changed, 44 insertions(+), 24 deletions(-)
Documentation/process/kernel-docs.rst +0 -0

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.

Quoted 4 lines

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:

Quoted 1 line

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  >===============.<
Quoted 9 lines
Quoted 7 lines

index 8660493b91d0..6f3e290abd22 100644

Documentation/process/kernel-docs.rst +0 -0
@@ -3,27 +3,27 @@

 Index of Further Kernel Documentation
 =====================================

Signature · 1 line
~Randy
reviewer
#7 lore raw
Quoted 32 lines · Randy Dunlap
Quoted 20 lines · Randy Dunlap

Documentation/process/kernel-docs.rst

Quoted 13 lines · Carlos Bilbao

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.

---
 Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------

 1 file changed, 44 insertions(+), 24 deletions(-)
Documentation/process/kernel-docs.rst +0 -0

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.

Quoted 4 lines

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:

Quoted 7 lines
Quoted 1 line

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.

Quoted 11 lines
Quoted 10 lines
Quoted 8 lines

index 8660493b91d0..6f3e290abd22 100644

Documentation/process/kernel-docs.rst +0 -0
@@ -3,27 +3,27 @@

 Index of Further Kernel Documentation
 =====================================

Signature · 1 line
~Randy
#8 lore raw
In reply to Randy Dunlap

Hello folks,

Quoted 18 lines · Randy Dunlap

Documentation/process/kernel-docs.rst

Quoted 13 lines · Carlos Bilbao

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.

---
 Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------

 1 file changed, 44 insertions(+), 24 deletions(-)
Documentation/process/kernel-docs.rst +0 -0

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.

Quoted 4 lines

Carlos, please check Documentation/process/email-clients.rst section on Thunderbird, especially for line length and line wrap.

I'm still looking...

I followed the instructions for Thunderbird but atm I'm tired of trying to make it work. I'll just go back to using 'git send-email' for patches. I'm resending this patch like that.

Quoted 7 lines
Quoted 7 lines

index 8660493b91d0..6f3e290abd22 100644

Documentation/process/kernel-docs.rst +0 -0
@@ -3,27 +3,27 @@

 Index of Further Kernel Documentation
 =====================================

Thanks,
Carlos

reviewer
#9 lore raw
Quoted 25 lines · Carlos Bilbao

Hello folks,

Quoted 21 lines · Randy Dunlap

Documentation/process/kernel-docs.rst

Quoted 13 lines · Carlos Bilbao

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.

---
 Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------

 1 file changed, 44 insertions(+), 24 deletions(-)
Documentation/process/kernel-docs.rst +0 -0

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.

Quoted 7 lines
Quoted 1 line

I'm still looking...

I followed the instructions for Thunderbird but atm I'm tired of trying to make it work. I'll just go back to using 'git send-email' for patches. I'm resending this patch like that.

Good plan. :)

Quoted 11 lines
Quoted 8 lines
Quoted 8 lines

index 8660493b91d0..6f3e290abd22 100644

Documentation/process/kernel-docs.rst +0 -0
@@ -3,27 +3,27 @@

 Index of Further Kernel Documentation
 =====================================

Thanks,
Carlos

Signature · 1 line
~Randy
#10 lore raw

PATCH 1/1 docs: Extend and refactor index of further kernel docs

In reply to Randy Dunlap

From: Carlos Bilbao <[email protected]>

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.

---
 Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------
 1 file changed, 44 insertions(+), 24 deletions(-)
Documentation/process/kernel-docs.rst +44 -24
index 8660493b91d0..6f3e290abd22 100644
@@ -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:
Signature · 1 line
2.43.0
reviewer Tested-by Acked-by on v1 1/1
#11 lore raw
Quoted 9 lines · Carlos Bilbao

From: Carlos Bilbao <[email protected]>

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.

Thanks.

Quoted 4 lines
---
 Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------
 1 file changed, 44 insertions(+), 24 deletions(-)
Signature · 1 line
~Randy
maintainer
#12 lore raw
In reply to Carlos Bilbao
Quoted 8 lines · Carlos Bilbao

From: Carlos Bilbao <[email protected]>

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.

Quoted 4 lines
---
 Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------
 1 file changed, 44 insertions(+), 24 deletions(-)

Sending this as a reply to previous postings badly confused b4, but I did get it to apply this time, thanks.

jon

#13 lore raw
Quoted 10 lines · Jonathan Corbet
Quoted 8 lines · Carlos Bilbao

From: Carlos Bilbao <[email protected]>

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.

Quoted 6 lines
Quoted 4 lines
---
 Documentation/process/kernel-docs.rst | 68 +++++++++++++++++----------
 1 file changed, 44 insertions(+), 24 deletions(-)

Sending this as a reply to previous postings badly confused b4, but I did get it to apply this time, thanks.

Will avoid doing that next time, thanks!

Quoted 2 lines

jon

Regards,
Carlos