From 92cd1613b317ad10603f5e08ed652e1f98077a04 Mon Sep 17 00:00:00 2001
From: Nik Clayton <nik@FreeBSD.org>
Date: Thu, 16 Dec 1999 01:58:47 +0000
Subject: [PATCH] Update the information about building a debugging kernel. 
 Remove the individual steps, and replace with "make install".  Update the
 following note to explain that kernel is installed, while kernel.debug
 remains as a source of debugging symbols for gdb(1).

PR:             docs/14426
Submitted by:   Bruce Mah <bmah@acm.org>
---
 en_US.ISO8859-1/books/faq/book.sgml  | 36 +++++++---------------------
 en_US.ISO_8859-1/books/faq/book.sgml | 36 +++++++---------------------
 2 files changed, 18 insertions(+), 54 deletions(-)

diff --git a/en_US.ISO8859-1/books/faq/book.sgml b/en_US.ISO8859-1/books/faq/book.sgml
index ab1956d1e2..1da4beb455 100644
--- a/en_US.ISO8859-1/books/faq/book.sgml
+++ b/en_US.ISO8859-1/books/faq/book.sgml
@@ -10,7 +10,7 @@
 </author>
 </authorgroup>
 
-<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.25 1999/11/25 09:08:54 obrien Exp $</pubdate>
+<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.26 1999/12/14 17:01:19 nik Exp $</pubdate>
 
 <abstract><para>    This is the FAQ for FreeBSD versions 2.X and 3.X.  All entries are
     assumed to be relevant to FreeBSD 2.0.5 and later, unless otherwise noted.
@@ -8075,19 +8075,7 @@ some kind.)</para>
 </listitem>
 
 <listitem>
-<para><emphasis remap=tt>cp kernel kernel.debug</emphasis></para>
-</listitem>
-
-<listitem>
-<para><command>strip -d kernel</command></para>
-</listitem>
-
-<listitem>
-<para><emphasis remap=tt>mv </emphasis>kernel /kernel.orig/</para>
-</listitem>
-
-<listitem>
-<para><command>cp kernel /</command></para>
+<para><command>make install</command></para>
 </listitem>
 
 <listitem>
@@ -8096,19 +8084,13 @@ some kind.)</para>
 
 </itemizedlist>
 </para>
-  
-<para> <emphasis>[Note: Now that FreeBSD 3.x kernels are Elf by default,
-you should use <command>strip -g</command> instead of <command>strip -d</command>. If for some
-reason your kernel is still a.out, use <command>strip -aout -d</command>.]</emphasis></para>
-  
-<para> Note that YOU DO <acronym>NOT</acronym> WANT TO ACTUALLY BOOT THE KERNEL
-WITH ALL THE DEBUG SYMBOLS IN IT. A kernel compiled with <option>-g</option>
-can easily be close to 10MB in size. You don't have to actually
-boot this massive image: you only need it later for <command>gdb(1)</command>
-(<command>gdb(1)</command> wants the symbol table). Instead, you want to keep
-a copy of the full image and create a second image with the
-debug symbols stripped out using <command>strip -d</command>. It is this
-second stripped image that you want to boot.</para>
+
+	  <para>The &man.make.1; process will have built two kernels.
+	    <filename>kernel</filename> and
+	    <filename>kernel.debug</filename>.  <filename>kernel</filename>
+	    was installed as <filename>/kernel</filename>, while
+	    <filename>kernel.debug</filename> can be used as the source of
+	    debugging symbols for gdb(1).</para>
   
 <para> To make sure you capture a crash dump, you need edit
 <filename>/etc/rc.conf</filename> and set <emphasis remap=tt>dumpdev</emphasis> to point to your swap
diff --git a/en_US.ISO_8859-1/books/faq/book.sgml b/en_US.ISO_8859-1/books/faq/book.sgml
index ab1956d1e2..1da4beb455 100644
--- a/en_US.ISO_8859-1/books/faq/book.sgml
+++ b/en_US.ISO_8859-1/books/faq/book.sgml
@@ -10,7 +10,7 @@
 </author>
 </authorgroup>
 
-<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.25 1999/11/25 09:08:54 obrien Exp $</pubdate>
+<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.26 1999/12/14 17:01:19 nik Exp $</pubdate>
 
 <abstract><para>    This is the FAQ for FreeBSD versions 2.X and 3.X.  All entries are
     assumed to be relevant to FreeBSD 2.0.5 and later, unless otherwise noted.
@@ -8075,19 +8075,7 @@ some kind.)</para>
 </listitem>
 
 <listitem>
-<para><emphasis remap=tt>cp kernel kernel.debug</emphasis></para>
-</listitem>
-
-<listitem>
-<para><command>strip -d kernel</command></para>
-</listitem>
-
-<listitem>
-<para><emphasis remap=tt>mv </emphasis>kernel /kernel.orig/</para>
-</listitem>
-
-<listitem>
-<para><command>cp kernel /</command></para>
+<para><command>make install</command></para>
 </listitem>
 
 <listitem>
@@ -8096,19 +8084,13 @@ some kind.)</para>
 
 </itemizedlist>
 </para>
-  
-<para> <emphasis>[Note: Now that FreeBSD 3.x kernels are Elf by default,
-you should use <command>strip -g</command> instead of <command>strip -d</command>. If for some
-reason your kernel is still a.out, use <command>strip -aout -d</command>.]</emphasis></para>
-  
-<para> Note that YOU DO <acronym>NOT</acronym> WANT TO ACTUALLY BOOT THE KERNEL
-WITH ALL THE DEBUG SYMBOLS IN IT. A kernel compiled with <option>-g</option>
-can easily be close to 10MB in size. You don't have to actually
-boot this massive image: you only need it later for <command>gdb(1)</command>
-(<command>gdb(1)</command> wants the symbol table). Instead, you want to keep
-a copy of the full image and create a second image with the
-debug symbols stripped out using <command>strip -d</command>. It is this
-second stripped image that you want to boot.</para>
+
+	  <para>The &man.make.1; process will have built two kernels.
+	    <filename>kernel</filename> and
+	    <filename>kernel.debug</filename>.  <filename>kernel</filename>
+	    was installed as <filename>/kernel</filename>, while
+	    <filename>kernel.debug</filename> can be used as the source of
+	    debugging symbols for gdb(1).</para>
   
 <para> To make sure you capture a crash dump, you need edit
 <filename>/etc/rc.conf</filename> and set <emphasis remap=tt>dumpdev</emphasis> to point to your swap