[Kernel-handbook-general] [PATCH 2/1 kernel-handbook] Add a reminder to disable DEBUG_INFO in 'make deb-pkg' examples

[Ben Hutchings]

On Sat, 2012-07-21 at 18:06 -0500, Jonathan Nieder wrote:
> As mentioned in the "Disk space requirements" section, the
> stock configuration for i386, amd64, and s390x produces an
> absurdly large build tree and resulting kernel unless
> CONFIG_DEBUG_INFO is disabled.
> 
> Signed-off-by: Jonathan Nieder <jrnieder at gmail.com>
> ---
> A quick fix to the bisecting instructions.
> 
>  chapter-bugs.sgml         |    1 +
>  chapter-common-tasks.sgml |    2 ++
>  debian/changelog          |    1 +
>  3 files changed, 4 insertions(+)
> 
> diff --git a/chapter-bugs.sgml b/chapter-bugs.sgml
> index f7b551ef..ac6841b2 100644
> --- a/chapter-bugs.sgml
> +++ b/chapter-bugs.sgml
> @@ -395,6 +395,7 @@
>  # apt-get install git build-essential
>  $ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
>  $ cd linux
> +$ scripts/config --disable DEBUG_INFO

But we don't have any config at this point.

>  $ make localmodconfig; # minimal configuration
>  	  </example>
>  	  The above commands acquire and configure a vanilla kernel.
> diff --git a/chapter-common-tasks.sgml b/chapter-common-tasks.sgml
> index f629e17e..29bba694 100644
> --- a/chapter-common-tasks.sgml
> +++ b/chapter-common-tasks.sgml
> @@ -304,6 +304,7 @@ $ debian/rules orig
>  # apt-get install linux-source-3.2
>  $ tar xjf /usr/src/linux-source-3.2.tar.bz2
>  $ cd linux-source-3.2
> +$ scripts/config --disable DEBUG_INFO

Or here.

>            </example>
>  	  The kernel now needs to be configured, that is you have to
>  	  set the kernel options and select the drivers which are
> @@ -409,6 +410,7 @@ $ cd linux-3.4
>            The existing configuration file may be used as a starting point
>            <example>
>  $ cp /boot/config-3.2.0-2-686-pae ./.config
> +$ scripts/config --disable DEBUG_INFO

There are good reasons why some people want debug info, and they might
be surprised to lose it in a custom configuration.  It's a useful
suggestion but I don't think it should be part of the example.

Ben.

>            </example>
>            After the configuration with one of the configuration frontends (invoked by <tt>make oldconfig</tt>,
>            <tt>make config</tt>, <tt>make menuconfig</tt>, etc) is completed, the build 
> diff --git a/debian/changelog b/debian/changelog
> index be976167..437ae2af 100644
> --- a/debian/changelog
> +++ b/debian/changelog
> @@ -2,6 +2,7 @@ kernel-handbook (1.0.15) UNRELEASED; urgency=low
>  
>    * Fix capitalization in "Applying patches or configuration changes"
>      section
> +  * Add a reminder to disable CONFIG_DEBUG_INFO in 'make deb-pkg' examples
>  
>   -- Jonathan Nieder <jrnieder at gmail.com>  Sat, 21 Jul 2012 17:30:35 -0500
>  

-- 
Ben Hutchings
73.46% of all statistics are made up.
-------------- 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/20120722/b45b85f4/attachment.pgp>