21 Sep, 2016
15 commits
-
Reorder the on-line documents based on their timestamp or
copyright notes. More updated documents come first.While here, add the number of pages for POSIX4 document.
Signed-off-by: Mauro Carvalho Chehab
-
It is a way better to have a timestamp to help identifying
when something is too old.So, retrieve the dates marked on the existing documents.
Signed-off-by: Mauro Carvalho Chehab
-
There are still some broken docs: the URLs point to somewhere,
however, the texts are not there anymore. I was able to
find the texts on other URLs for some of those, but they're all
too old. So, just get rid of them.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
There are three places where it mentions in-kernel docs.
Move them to a separate topic.
Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
The Linux Kernel - This book is for Kernel 2.0.33
Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
Add two books from my own bookshelf. I found them useful by
the time I bought; so it could be useful to others ;)Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
Instead of using a random order, place the books on publication
date, from the newest to the oldest.Signed-off-by: Mauro Carvalho Chehab
-
- remove LDD versions 1 and 2, as there's already an entry for
LDD3;
- add a link between LDD online and published entries.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
- Use lower case for sections, as this is the standard used on
the other ReST files;
- The latest version of this document is at the Kernel source, and
not at the listed URL. So, move it to the end of the doc.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
This introduces a consistent indenting of 4 spaces for all
lists.[mchehab@s-opensource.com: rebased to apply before rename]
Signed-off-by: Richard Sailer
Signed-off-by: Mauro Carvalho Chehab -
Background/Reasoning:
Books:
------
* Linux Kernel Networking by Rami Rosen
While some parts are quite short and could be
more carefully explained it's still a good recomendation
for understanding linux kernel networking, (IMHO)* Linux Treiber entwickeln:
It sure is a drawback that this is a german book.
But it's quite recent, well structured and there are also
other non-english (spanish) books/papers in this list.Papers:
-------* On Submitting kernel Patches
Contains 2 case studies of bigger patch sets and how (or how not)
they were merged. I found it helpful* Tracing the Way of Data in a TCP Connection through the Linux Kernel
Since this was written by me this inclusion may be a bit biased :p
Neitherless I think this gives a good introduction on
understanding/exploring linux internals using ftrace and an overview
of Linux TCP internals.[mchehab@s-opensource.com: rebased to apply before rename]
Signed-off-by: Richard Sailer
Signed-off-by: Mauro Carvalho Chehab -
The dots at the ends of the list elements introduced
unnecesarry newlines in the "compiled" document.While this was not "mission critical" it's not nice to look at
either.[mchehab@s-opensource.com: rebased to apply before rename]
Signed-off-by: Richard Sailer
Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
This removes all dead links to online docs which
are dead according to Jon and Mauro in
https://lkml.kernel.org/r/20160916182849.2a7101ea () vento ! lanAdditionally some references to very old articles refering to
linux 2.2 and 2.0 are deleted.[mchehab@s-opensource.com: rebased to apply before rename]
Signed-off-by: Richard Sailer
Signed-off-by: Mauro Carvalho Chehab -
Add cross references for the documents mentioned at HOWTO and
are under the Documentation/ directory, using the ReST notation.It should be noticed that HOWTO also mentions the /README file.
We opted to not touch it, for now, as making it build on
Sphinx would require it to be moved to a Documentation/foo
directory.Signed-off-by: Mauro Carvalho Chehab
Acked-by: Greg Kroah-Hartman
Signed-off-by: Jonathan Corbet -
This one required lots of manual work, for it to be properly
displayed.Signed-off-by: Mauro Carvalho Chehab
16 Apr, 2016
1 commit
-
The URL for "Writing Linux Device Drivers" hasn't been available in some
time. Updating the entry to Michael K. Johnson's "Linux Kernel Hackers'
Guide"Signed-off-by: Luis de Bethencourt
Signed-off-by: Jonathan Corbet
31 Mar, 2016
3 commits
-
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
Signed-off-by: Jonathan Corbet -
The current URL has been down for some time, updating it to a working one.
Signed-off-by: Luis de Bethencourt
Signed-off-by: Jonathan Corbet -
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
Signed-off-by: Jonathan Corbet
12 Jan, 2016
1 commit
-
The old link to source code cross reference does not work now. Though
the link has updated by commit 1d12554f0abbc7d17dce8d1b7b25f4e27555e6d7
("Documentation: HOWTO: update code cross reference link"), there are
few obsolete links yet. This commit update them.Signed-off-by: SeongJae Park
Signed-off-by: Jonathan Corbet
12 Oct, 2015
1 commit
-
The #kernelnewbies irc channel is no longer hosted on
irc.openprojects.net but on irc.oftc.net.
Removed pointer to different regional servers since oftc already uses
geo-IP load balancing.The "description" quoted from the website no longer exists,
therefore removed the reference, quotes and carets.The paragraph also contains a pointer to the kernelnewbies.org website.
Therefore changing the title to:
"Kernel Newbies IRC Channel and Website."Signed-off-by: Richard Sailer
Signed-off-by: Jonathan Corbet
28 Sep, 2011
1 commit
-
There are numerous broken references to Documentation files (in other
Documentation files, in comments, etc.). These broken references are
caused by typo's in the references, and by renames or removals of the
Documentation files. Some broken references are simply odd.Fix these broken references, sometimes by dropping the irrelevant text
they were part of.Signed-off-by: Paul Bolle
Signed-off-by: Jiri Kosina
14 Aug, 2011
1 commit
-
Dropping LSD (Linux Source Driver) since it hasn't been available
for a long time.Signed-off-by: Luis de Bethencourt
Signed-off-by: Randy Dunlap
Signed-off-by: Linus Torvalds
07 Jan, 2011
1 commit
-
Fixed typos, and removed duplicated entries.
Signed-off-by: Nicolas Kaiser
Signed-off-by: Randy Dunlap
Signed-off-by: Linus Torvalds
04 Aug, 2010
1 commit
-
Below you will find an updated version from the original series bunching all patches into one big patch
updating broken web addresses that are located in Documentation/*
Some of the addresses date as far far back as 1995 etc... so searching became a bit difficult,
the best way to deal with these is to use web.archive.org to locate these addresses that are outdated.
Now there are also some addresses pointing to .spec files some are located, but some(after searching
on the companies site)where still no where to be found. In this case I just changed the address
to the company site this way the users can contact the company and they can locate them for the users.Signed-off-by: Justin P. Mattock
Signed-off-by: Thomas Weber
Signed-off-by: Mike Frysinger
Cc: Paulo Marques
Cc: Randy Dunlap
Cc: Michael Neuling
Signed-off-by: Jiri Kosina
23 Apr, 2010
1 commit
-
Fix obvious cases of "it's" being used when "its" was meant.
Signed-off-by: Francis Galiegue
Acked-by: Randy Dunlap
Signed-off-by: Jiri Kosina
07 Jun, 2008
1 commit
-
Update status and URL for the "Gary's Encyclopedia" entry.
Signed-off-by: Paul Jackson
Signed-off-by: Andrew Morton
Signed-off-by: Linus Torvalds
20 Oct, 2007
1 commit
-
Most of these fixes were already submitted for old kernel versions, and were
approved, but for some reason they never made it into the releases.Because this is a consolidation of a couple old missed patches, it touches both
Kconfigs and documentation texts.Signed-off-by: Matt LaPlante
Acked-by: Randy Dunlap
Signed-off-by: Adrian Bunk
09 May, 2007
1 commit
-
Convert files within the Documentation directory to UTF-8.
Adrian Bunk:
small additional fixesSigned-off-by: John Anthony Kazos Jr.
Signed-off-by: Adrian Bunk
18 Feb, 2007
1 commit
-
Signed-off-by: James Nelson
Signed-off-by: Adrian Bunk
04 Oct, 2006
1 commit
-
Now that devfs is removed, there's no longer any need to document how to
do this or that with devfs.This patch includes some improvements by Joe Perches.
Signed-off-by: Adrian Bunk
23 Nov, 2005
1 commit
-
Correct lots of URLs in Documentation/ Also a few minor whitespace cleanups
and typo/spello fixes. Sadly there are still a lot of bad URLs remaining.Signed-off-by: Randy Dunlap
Signed-off-by: Andrew Morton
Signed-off-by: Linus Torvalds
17 Apr, 2005
1 commit
-
Initial git repository build. I'm not bothering with the full history,
even though we have it. We can create a separate "historical" git
archive of that later if we want to, and in the meantime it's about
3.2GB when imported into git - space that would just make the early
git days unnecessarily complicated, when we don't have a lot of good
infrastructure for it.Let it rip!