[Kernel-handbook-general] [PATCH 3/8] Add a section on disk space requirements for the official 'linux' package

[Ben Hutchings]

Include references to $TMPDIR and CONFIG_DEBUG_INFO (Closes: #681550)
---
 chapter-common-tasks.sgml |   24 ++++++++++++++++++++++++
 debian/changelog          |    2 ++
 2 files changed, 26 insertions(+)

diff --git a/chapter-common-tasks.sgml b/chapter-common-tasks.sgml
index 487b0b1..0dc34da 100644
--- a/chapter-common-tasks.sgml
+++ b/chapter-common-tasks.sgml
@@ -53,6 +53,30 @@ $ tar jxf /usr/src/linux-source-3.2.tar.bz2
 	      </item>
 	    </taglist>
 	  </p>
+	  <sect2>
+	    <heading>Disk space requirements</heading>
+	    <p>
+	      Building binary packages for a single kernel flavour
+	      with debug info enabled (currently true for
+	      the <tt>686-pae</tt>, <tt>amd64</tt>, <tt>rt-686-pae</tt>,
+	      <tt>rt-amd64</tt> and <tt>s390x</tt> configurations)
+	      requires up to 10 GB space in the package directory
+	      and 300 MB in <tt>/tmp</tt> (or <tt>$TMPDIR</tt>).
+	    </p>
+	    <p>
+	      Building with debug info disabled requires about
+	      2 GB and 25 MB respectively.  You can disable
+	      debug info by changing the value of <tt>debug-info</tt>
+	      to <tt>false</tt> in
+	      <tt>debian/config/</tt><var>arch</var><tt>/defines</tt>.
+	    </p>
+	    <p>
+	      Building all binary packages for i386 or amd64 currently
+	      requires about 20 GB space in the package
+	      directory.  Other architectures with no debug info or
+	      fewer drivers will require less space.
+	    </p>
+	  </sect2>
 	</sect1>
 	<sect1>
 	  <heading>Simple patching and building</heading>
diff --git a/debian/changelog b/debian/changelog
index 49962af..5b0bdcd 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,6 +2,8 @@ kernel-handbook (1.0.14) UNRELEASED; urgency=low
 
   * Remove custom version from 'make deb-pkg' example (Closes: #627838)
   * Fix introduction to say the handbook describes wheezy (Closes: #651467)
+  * Add a section on disk space requirements for the official'linux' package
+    (Closes: #681550)
 
  -- Ben Hutchings <ben at decadent.org.uk>  Sat, 21 Jul 2012 20:02:21 +0100
 


-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 828 bytes
Desc: This is a digitally signed message part
URL: <http://lists.alioth.debian.org/pipermail/kernel-handbook-general/attachments/20120721/8f8947e0/attachment.pgp>