[kernel] r14773 - dists/trunk/linux-2.6/debian

[Ben Hutchings]

Author: benh
Date: Sat Dec 12 00:53:57 2009
New Revision: 14773

Log:
Move contents of debian/README into debian/README.source

Deleted:
   dists/trunk/linux-2.6/debian/README
Modified:
   dists/trunk/linux-2.6/debian/README.source

Modified: dists/trunk/linux-2.6/debian/README.source
==============================================================================
--- dists/trunk/linux-2.6/debian/README.source	Fri Dec 11 15:16:51 2009	(r14772)
+++ dists/trunk/linux-2.6/debian/README.source	Sat Dec 12 00:53:57 2009	(r14773)
@@ -39,10 +39,43 @@
 The same syntax applies for specifing the patches, but an additional
 argument is needed which specifies the featureset the patch applies to.
 
+Kernel config files
+===================
+Configuration files are constructed dynamically from a number of config
+files, as listed in debian/config/<arch>/defines.
 
+Control file
+============
+The master control file debian/control must be generated before
+the package is uploaded. debian/rules contains the debian/control 
+target, which generates the control file by invoking the 
+debian/bin/gencontrol.py script, which combines the templates from
+the templates directory and architecture-specific defines file to
+produce the debian/control file. Note that this target is intentionally
+made to fail with a non-zero exit code to make sure that it is never
+run during an automatic build. The following variables are substituted
+into the templates:
+
+ at version@      Upstream kernel version, for example 2.6.11.
+ at major@        The major version, for example 2.6
+ at arch@         The Debian arch name, such as powerpc or i386.
+ at flavour@      The build flavour, such as 686 or k7-smp.
+ at class@        The CPU/architecture class; displayed in synopsis.  It should
+               be fairly short, as the synopsis is supposed to be <80 chars.
+               It should be in the form "foo class", and will show up in the
+	       description as "foo class machines".
+ at longclass@    The CPU/architecture class; displayed in the extended
+               description.  The same rules apply as in @class at .  If
+	       this is unset, it will default to @class at .
+ at desc@         (Potentially) multi-line verbiage that's appended to
+               -image descriptions.
+ at abiname@      Current abiname, a single digit.
+
+Normally, the arch-specific contents should be controlled by
+adjusting the corresponding defines file.
 
 TODO:
 - Generating DFSG tarballs
 - How to define a flavour
-- Generation of debian/control and configs
+- More detail on generation of debian/control and configs