From 70ac91a2e94e10596922a0e7ea3e0c60609e9154 Mon Sep 17 00:00:00 2001
From: Eitan Adler <eadler@FreeBSD.org>
Date: Sun, 29 Oct 2017 01:00:00 +0000
Subject: [PATCH] Move up the correct way to compile the kernel

This makes the correct way more prominent.
Also removes references to FreeBSD 4.x

Reviewed By: allanjude
---
 .../kernelbuild/chapter.xml                   | 38 ++++++-------------
 1 file changed, 11 insertions(+), 27 deletions(-)

diff --git a/en_US.ISO8859-1/books/developers-handbook/kernelbuild/chapter.xml b/en_US.ISO8859-1/books/developers-handbook/kernelbuild/chapter.xml
index 7a76ff2d49..f6db3e4312 100644
--- a/en_US.ISO8859-1/books/developers-handbook/kernelbuild/chapter.xml
+++ b/en_US.ISO8859-1/books/developers-handbook/kernelbuild/chapter.xml
@@ -11,15 +11,11 @@
     build process.  To debug the &os; kernel it is required to be able
     to build one.  There are two known ways to do so:</para>
 
-  <itemizedlist>
-    <listitem>
-      <para>The <quote>Traditional</quote> Way</para>
-    </listitem>
-
-    <listitem>
-      <para>The <quote>New</quote> Way</para>
-    </listitem>
-  </itemizedlist>
+  <para>The supported procedure to build and install a kernel
+    is documented in the
+    <link xlink:href="../handbook/kernelconfig-building.html">Building and
+	Installing a Custom Kernel</link> chapter of the &os;
+      Handbook.</para>
 
   <note>
     <para>It is supposed that the reader of this chapter is familiar
@@ -31,18 +27,14 @@
   </note>
 
   <sect1 xml:id="kernelbuild-traditional">
-    <title>Building a Kernel the <quote>Traditional</quote> Way</title>
+    <title>Building the Faster but Brittle Way</title>
 
-    <para>Up to version 4.X of &os; this was the recommended way to
-      build a new kernel.  It can still be used on newer versions
-      (instead of the <quote>buildkernel</quote> target of the toplevel
-      <filename>/usr/src/</filename> makefiles).
-      Building the kernel this way may be useful when working on the
+    <para>Building the kernel this way may be useful when working on
+      the
       kernel code and it may actually be faster than the
-      <quote>New</quote> procedure when only a single option or two were
-      tweaked in the kernel configuration file.  On the other hand, it
-      might lead to unexpected kernel build breakage when used by
-      beginners on newer versions of &os;.</para>
+      documented procedure when only a single option or two were
+      tweaked in the kernel configuration file.  On the other hand,
+      it might lead to unexpected kernel build breakage.</para>
 
     <procedure>
       <step>
@@ -75,12 +67,4 @@
     </procedure>
   </sect1>
 
-  <sect1 xml:id="kernelbuild-new">
-    <title>Building a Kernel the <quote>New</quote> Way</title>
-
-    <para>This procedure is well supported and recommended under the
-      latest &os; releases and is documented in the <link xlink:href="../handbook/kernelconfig-building.html">Building and
-	Installing a Custom Kernel</link> chapter of the &os;
-      Handbook.</para>
-  </sect1>
 </chapter>