From dd74fc766608d616c9b49b13d446048e883d2d1b Mon Sep 17 00:00:00 2001 From: Ben Hutchings Date: Sat, 12 Dec 2009 00:53:57 +0000 Subject: [PATCH] Move contents of debian/README into debian/README.source svn path=/dists/trunk/linux-2.6/; revision=14773 --- debian/README | 34 ---------------------------------- debian/README.source | 35 ++++++++++++++++++++++++++++++++++- 2 files changed, 34 insertions(+), 35 deletions(-) delete mode 100644 debian/README diff --git a/debian/README b/debian/README deleted file mode 100644 index 461c7c1d2..000000000 --- a/debian/README +++ /dev/null @@ -1,34 +0,0 @@ -Kernel config files -------------------- -Configuration files are constructed dynamically from a number of config -files, as listed in debian/config//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: - -@version@ Upstream kernel version, for example 2.6.11. -@major@ The major version, for example 2.6 -@arch@ The Debian arch name, such as powerpc or i386. -@flavour@ The build flavour, such as 686 or k7-smp. -@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". -@longclass@ The CPU/architecture class; displayed in the extended - description. The same rules apply as in @class@. If - this is unset, it will default to @class@. -@desc@ (Potentially) multi-line verbiage that's appended to - -image descriptions. -@abiname@ Current abiname, a single digit. - -Normally, the arch-specific contents should be controlled by -adjusting the corresponding defines file. diff --git a/debian/README.source b/debian/README.source index 5afcc50ab..404d3b2d4 100644 --- a/debian/README.source +++ b/debian/README.source @@ -39,10 +39,43 @@ of 2.6.26-12: 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//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: + +@version@ Upstream kernel version, for example 2.6.11. +@major@ The major version, for example 2.6 +@arch@ The Debian arch name, such as powerpc or i386. +@flavour@ The build flavour, such as 686 or k7-smp. +@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". +@longclass@ The CPU/architecture class; displayed in the extended + description. The same rules apply as in @class@. If + this is unset, it will default to @class@. +@desc@ (Potentially) multi-line verbiage that's appended to + -image descriptions. +@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