diff --git a/debian/README b/debian/README
index de7d78b49..97c24f1eb 100644
--- a/debian/README
+++ b/debian/README
@@ -61,12 +61,19 @@ common templates for it and substituting the variables:
 
 @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.
+@subarch@      The subarch - only used by powerpc right now.
+@flavour@      The build flavour, such as 686 or k7-smp.
+@smpflavour@   Same as flavour, but turns k7-smp into "multiprocessor k7".
+@shortsmpflavour@   Same as smpflavour, but turns k7-smp into "SMP k7".
 @ltver@        linux-tree version, a single digit.
 @srcver@       Source version, extracted from the changelog.
                This is normally @version@-@ltver@.
 @lt_depends@   The Depends field for the linux-tree package.   
 @lt_provides@  The Provides field for the linux-tree package.
 @abiname@      Current abiname, a single digit.
+@allheaders@   Given the arch, a list of all the linux-headers packages for the
+               arch - used for kernel-headers-x.y.z-n-arch.
 
 For each kernel image build the control.source.in template from
 templates directory is concatenated with the control.in file from the