2016-03-19 12:51:34

by Luis de Bethencourt

[permalink] [raw]
Subject: [PATCH 1/5] Documentation: add Linux Kernel Development book

The Linux Kernel Development book by Robert Love has been recommended to me
by multiple kernel hackers. Worth having in the list of books in
kernel-docs.txt for newbies looking for good learning resources.

Signed-off-by: Luis de Bethencourt <[email protected]>
---
Hi,

I really enjoyed this book and I think it deserves being listed in the
kernel-docs.txt list.

Thanks,
Luis

Documentation/kernel-docs.txt | 7 +++++++
1 file changed, 7 insertions(+)

diff --git a/Documentation/kernel-docs.txt b/Documentation/kernel-docs.txt
index fe217c1..b250360 100644
--- a/Documentation/kernel-docs.txt
+++ b/Documentation/kernel-docs.txt
@@ -609,6 +609,13 @@
Pages: 432.
ISBN: 0-201-63338-8

+ * Title: "Linux Kernel Development, 3rd Edition"
+ Author: Robert Love
+ Publisher: Addison-Wesley.
+ Date: July, 2010
+ Pages: 440
+ ISBN: 978-0672329463
+
MISCELLANEOUS:

* Name: linux/Documentation
--
2.5.1


2016-03-19 12:51:38

by Luis de Bethencourt

[permalink] [raw]
Subject: [PATCH 3/5] Documentation: update URL of Analysis of the Ext2fs structure

The current URL has been down for some time, updating it to a working one.

Signed-off-by: Luis de Bethencourt <[email protected]>
---
Documentation/kernel-docs.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/kernel-docs.txt b/Documentation/kernel-docs.txt
index 9a1b0d3..488bda7 100644
--- a/Documentation/kernel-docs.txt
+++ b/Documentation/kernel-docs.txt
@@ -250,7 +250,7 @@

* Title: "Analysis of the Ext2fs structure"
Author: Louis-Dominique Dubeau.
- URL: http://www.nondot.org/sabre/os/files/FileSystems/ext2fs/
+ URL: http://teaching.csse.uwa.edu.au/units/CITS2002/fs-ext2/
Keywords: ext2, filesystem, ext2fs.
Description: Description of ext2's blocks, directories, inodes,
bitmaps, invariants...
--
2.5.1

2016-03-19 12:51:42

by Luis de Bethencourt

[permalink] [raw]
Subject: [PATCH 5/5] Documentation: update URL for Porting Linux 2.0 Drivers to 2.2

The URL format of Linux Magazine articles has changed. Updating the URL
of the "Porting Linux 2.0 Drivers to Linux 2.2" article by Alan Cox.

Signed-off-by: Luis de Bethencourt <[email protected]>
---
Documentation/kernel-docs.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/kernel-docs.txt b/Documentation/kernel-docs.txt
index 04f6d73..bfca1ed 100644
--- a/Documentation/kernel-docs.txt
+++ b/Documentation/kernel-docs.txt
@@ -376,7 +376,7 @@
* Title: "Porting Linux 2.0 Drivers To Linux 2.2: Changes and New
Features "
Author: Alan Cox.
- URL: http://www.linux-mag.com/1999-05/gear_01.html
+ URL: http://www.linux-mag.com/id/216/
Keywords: ports, porting.
Description: Article from Linux Magazine on porting from 2.0 to
2.2 kernels.
--
2.5.1

2016-03-19 12:52:11

by Luis de Bethencourt

[permalink] [raw]
Subject: [PATCH 4/5] Documentation: update URLs for Richard Gooch's articles

Current URL for "Kernel API changes from 2.0 to 2.2" hasn't been available
for some time, updating. The second article about changes from 2.2 to 2.4
is missing a URL, adding it.

Signed-off-by: Luis de Bethencourt <[email protected]>
---
Documentation/kernel-docs.txt | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/kernel-docs.txt b/Documentation/kernel-docs.txt
index 488bda7..04f6d73 100644
--- a/Documentation/kernel-docs.txt
+++ b/Documentation/kernel-docs.txt
@@ -266,14 +266,14 @@

* Title: "Kernel API changes from 2.0 to 2.2"
Author: Richard Gooch.
- URL:
- http://www.linuxhq.com/guides/LKMPG/node28.html
+ URL: http://www.safe-mbox.com/~rgooch/linux/docs/porting-to-2.2.html
Keywords: 2.2, changes.
Description: Kernel functions/structures/variables which changed
from 2.0.x to 2.2.x.

* Title: "Kernel API changes from 2.2 to 2.4"
Author: Richard Gooch.
+ URL: http://www.safe-mbox.com/~rgooch/linux/docs/porting-to-2.4.html
Keywords: 2.4, changes.
Description: Kernel functions/structures/variables which changed
from 2.2.x to 2.4.x.
--
2.5.1

2016-03-19 12:52:45

by Luis de Bethencourt

[permalink] [raw]
Subject: [PATCH 2/5] Documentation: update URL for Michael K. Johnson's articles

The URL for "Writing Linux Device Drivers" hasn't been available in some
time. Updating it to the URL of Michael K. Johnson's "Linux Kernel Hackers'
Guide"

Signed-off-by: Luis de Bethencourt <[email protected]>
---
Documentation/kernel-docs.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/kernel-docs.txt b/Documentation/kernel-docs.txt
index b250360..9a1b0d3 100644
--- a/Documentation/kernel-docs.txt
+++ b/Documentation/kernel-docs.txt
@@ -196,7 +196,7 @@

* Title: "Writing Linux Device Drivers"
Author: Michael K. Johnson.
- URL: http://users.evitech.fi/~tk/rtos/writing_linux_device_d.html
+ URL: http://www.tldp.org/LDP/khg/HyperNews/get/khg.html
Keywords: files, VFS, file operations, kernel interface, character
vs block devices, I/O access, hardware interrupts, DMA, access to
user memory, memory allocation, timers.
--
2.5.1

2016-03-19 13:01:00

by Luis de Bethencourt

[permalink] [raw]
Subject: Re: [PATCH 2/5] Documentation: update URL for Michael K. Johnson's articles

On 19/03/16 12:51, Luis de Bethencourt wrote:
> The URL for "Writing Linux Device Drivers" hasn't been available in some
> time. Updating it to the URL of Michael K. Johnson's "Linux Kernel Hackers'
> Guide"
>
> Signed-off-by: Luis de Bethencourt <[email protected]>
> ---
> Documentation/kernel-docs.txt | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/kernel-docs.txt b/Documentation/kernel-docs.txt
> index b250360..9a1b0d3 100644
> --- a/Documentation/kernel-docs.txt
> +++ b/Documentation/kernel-docs.txt
> @@ -196,7 +196,7 @@
>
> * Title: "Writing Linux Device Drivers"
> Author: Michael K. Johnson.
> - URL: http://users.evitech.fi/~tk/rtos/writing_linux_device_d.html
> + URL: http://www.tldp.org/LDP/khg/HyperNews/get/khg.html
> Keywords: files, VFS, file operations, kernel interface, character
> vs block devices, I/O access, hardware interrupts, DMA, access to
> user memory, memory allocation, timers.
>

Hi,

I separated the docs URL updates into individual commits so they can easily
be cherry-picked. I am happy to squash them all into one if you think it is
better.

Thanks :)
Luis

2016-03-31 06:49:28

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH 1/5] Documentation: add Linux Kernel Development book

On Sat, 19 Mar 2016 12:51:20 +0000
Luis de Bethencourt <[email protected]> wrote:

> The Linux Kernel Development book by Robert Love has been recommended to me
> by multiple kernel hackers. Worth having in the list of books in
> kernel-docs.txt for newbies looking for good learning resources.

Applied to the docs tree, thanks.

jon

2016-03-31 06:50:27

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH 2/5] Documentation: update URL for Michael K. Johnson's articles

On Sat, 19 Mar 2016 12:51:21 +0000
Luis de Bethencourt <[email protected]> wrote:

> The URL for "Writing Linux Device Drivers" hasn't been available in some
> time. Updating it to the URL of Michael K. Johnson's "Linux Kernel Hackers'
> Guide"

But that's a different work, I don't think it makes sense to just
substitute in the URL. It would be better, I think, to turn this into an
entry for the KHG if we really want that.

Thanks,

jon

2016-03-31 06:51:12

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH 3/5] Documentation: update URL of Analysis of the Ext2fs structure

On Sat, 19 Mar 2016 12:51:22 +0000
Luis de Bethencourt <[email protected]> wrote:

> The current URL has been down for some time, updating it to a working one.

Applied to the docs tree, thanks.

jon

2016-03-31 06:51:49

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH 4/5] Documentation: update URLs for Richard Gooch's articles

On Sat, 19 Mar 2016 12:51:23 +0000
Luis de Bethencourt <[email protected]> wrote:

> Current URL for "Kernel API changes from 2.0 to 2.2" hasn't been available
> for some time, updating. The second article about changes from 2.2 to 2.4
> is missing a URL, adding it.

Applied to the docs tree, thanks.

jon

2016-03-31 06:52:57

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH 5/5] Documentation: update URL for Porting Linux 2.0 Drivers to 2.2

On Sat, 19 Mar 2016 12:51:24 +0000
Luis de Bethencourt <[email protected]> wrote:

> - URL: http://www.linux-mag.com/1999-05/gear_01.html
> + URL: http://www.linux-mag.com/id/216/

So this URL doesn't appear to work for me..?

Thanks,

jon

2016-03-31 10:50:51

by Luis de Bethencourt

[permalink] [raw]
Subject: Re: [PATCH 5/5] Documentation: update URL for Porting Linux 2.0 Drivers to 2.2

On 31/03/16 07:52, Jonathan Corbet wrote:
> On Sat, 19 Mar 2016 12:51:24 +0000
> Luis de Bethencourt <[email protected]> wrote:
>
>> - URL: http://www.linux-mag.com/1999-05/gear_01.html
>> + URL: http://www.linux-mag.com/id/216/
>
> So this URL doesn't appear to work for me..?
>
> Thanks,
>
> jon
>

I tried here and it works, but maybe it is flacky and it isn't permanently
available.

Dropping the patch if that is the case.

Thanks for looking at it Jon :)

Luis