aboutsummaryrefslogtreecommitdiffstats
path: root/HOWTO
diff options
context:
space:
mode:
authorGreg Kroah-Hartman <gregkh@suse.de>2005-11-15 12:53:58 -0800
committerGreg Kroah-Hartman <gregkh@suse.de>2005-11-15 12:53:58 -0800
commitb1fa5df46e2bd7106c31f891d0eaa8ab7e3b1d8c (patch)
treee33d1d4ac992d0263467afac5513b3946a0c4ed6 /HOWTO
parentb6d4c837a60c00e7f011857c88f893ee7ab25d00 (diff)
downloadpatches-b1fa5df46e2bd7106c31f891d0eaa8ab7e3b1d8c.tar.gz
added locations of different development trees.
Diffstat (limited to 'HOWTO')
-rw-r--r--HOWTO58
1 files changed, 41 insertions, 17 deletions
diff --git a/HOWTO b/HOWTO
index 846662d3465d04..d3c14b9a5a657c 100644
--- a/HOWTO
+++ b/HOWTO
@@ -10,8 +10,8 @@ to the maintainer of this file, who is listed at the bottom of the
document.
-Intro
------
+Introduction
+------------
So, you want to learn how to become a Linux kernel developer? Or you
have been told by your manager, "Go write a Linux driver for this
@@ -52,7 +52,6 @@ are well documented; do not expect people to adapt to you or your
company's way of doing things.
-
Legal Issues
------------
@@ -135,7 +134,6 @@ required reading:
create it, and how to apply it to the different development branches
of the kernel.
-
The kernel also has a large number of documents that can be
automatically generated from the source code itself. This includes a
full description of the in-kernel API, and rules on how to handle
@@ -197,10 +195,8 @@ branches. These different branches are:
- 2.6.x -mm kernel patches
- subsystem specific kernel trees and patches
-
2.6.x kernel tree
-----------------
-
2.6.x kernels are maintained by Linus Torvalds, and can be found on
kernel.org in the pub/linux/kernel/v2.6/ directory. It's development process
is as follows:
@@ -231,10 +227,8 @@ mailing list about kernel releases:
released according to perceived bug status, not according to a
preconceived timeline."
-
2.6.x.y -stable kernel tree
---------------------------
-
Kernels with 4 digit versions are -stable kernels. They contain
relativly small and critical fixes for security problems or significant
regressions discovered in a given 2.6.x kernel.
@@ -253,10 +247,8 @@ The file Documentation/stable_kernel_rules.txt in the kernel tree
documents what kinds of changes are acceptable for the -stable tree, and
how the release process works.
-
2.6.x -git patches
------------------
-
These are daily snapshots of Linus' kernel tree which is managed in a
git repository (hence the name.) These patches are usually released
daily and represent the current state of Linus' tree. They are more
@@ -265,7 +257,6 @@ without even a cursory glance to see if they are sane.
2.6.x -mm kernel patches
------------------------
-
These are experimental kernel patches released by Andrew Morton. Andrew
takes all of the different subsystem kernel trees and patches and mushes
them together, along with a lot of patches that have been plucked from
@@ -294,14 +285,49 @@ The -mm kernels are not released on a fixed schedule, but usually a few
Subsystem Specific kernel trees and patches
-------------------------------------------
-
A number of the different kernel subsystem developers expose their
development trees so that others can see what is happening in the
different areas of the kernel. These trees are pulled into the -mm
kernel releases as described above.
Here is a list of some of the different kernel trees available:
- -
+ git trees:
+ - Kbuild development tree, Sam Ravnborg <sam@ravnborg.org>
+ kernel.org:/pub/scm/linux/kernel/git/sam/kbuild.git
+
+ - ACPI development tree, Len Brown <len.brown@intel.com>
+ kernel.org:/pub/scm/linux/kernel/git/lenb/linux-acpi-2.6.git
+
+ - Block development tree, Jens Axboe <axboe@suse.de>
+ kernel.org:/pub/scm/linux/kernel/git/axboe/linux-2.6-block.git
+
+ - DRM development tree, Dave Airlie <airlied@linux.ie>
+ kernel.org:/pub/scm/linux/kernel/git/airlied/drm-2.6.git
+
+ - ia64 development tree, Tony Luck <tony.luck@intel.com>
+ kernel.org:/pub/scm/linux/kernel/git/aegl/linux-2.6.git
+
+ - ieee1394 development tree, Jody McIntyre <scjody@modernduck.com>
+ kernel.org:/pub/scm/linux/kernel/git/scjody/ieee1394.git
+
+ - infiniband, Roland Dreier <rolandd@cisco.com>
+ kernel.org:/pub/scm/linux/kernel/git/roland/infiniband.git
+
+ - libata, Jeff Garzik <jgarzik@pobox.com>
+ kernel.org:/pub/scm/linux/kernel/git/jgarzik/libata-dev.git
+
+ - network drivers, Jeff Garzik <jgarzik@pobox.com>
+ kernel.org:/pub/scm/linux/kernel/git/jgarzik/netdev-2.6.git
+
+ - pcmcia, Dominik Brodowski <linux@dominikbrodowski.net>
+ kernel.org:/pub/scm/linux/kernel/git/brodo/pcmcia-2.6.git
+
+ - SCSI, James Bottomley <James.Bottomley@SteelEye.com>
+ kernel.org:/pub/scm/linux/kernel/git/jejb/scsi-misc-2.6.git
+
+ quilt trees:
+ - USB, PCI, Driver Core, and I2C, Greg Kroah-Hartman <gregkh@suse.de>
+ kernel.org/pub/linux/kernel/people/gregkh/gregkh-2.6/
Bug Reporting
@@ -317,7 +343,6 @@ of information is needed by the kernel developers to help track down the
problem.
-
Mailing lists
-------------
@@ -370,7 +395,6 @@ mail program fixed or change it until it works.
Above all, please remember to show respect to other subscribers.
-
Working with the community
--------------------------
@@ -501,7 +525,7 @@ solution and working together with the community and discuss your
unfinished work. Therefore it is good to get early in the process to
get feedback to improve your work, but also keep your changes in small
chunks that they may get already accepted, even when your whole task is
-not ready for inclusion now.
+not ready for inclusion now.
Also realize that it is not acceptable to send patches for inclusion
that are unfinished and will be "fixed up later."
@@ -534,6 +558,7 @@ ChangeLog section of the document:
+
All of these things are sometimes very hard to do. It can take years to
perfect these practices (if at all). It's a continuous process of
improvement that requires a lot of patience and determination. But
@@ -555,4 +580,3 @@ this document.
Maintainer: Greg Kroah-Hartman <greg@kroah.com>
-