svn commit: r51152 - head/en_US.ISO8859-1/books/developers-handbook/kernelbuild

[Eitan Adler]

Author: eadler
Date: Sun Oct 29 01:00:00 2017
New Revision: 51152
URL: https://svnweb.freebsd.org/changeset/doc/51152

Log:
  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

Modified:
  head/en_US.ISO8859-1/books/developers-handbook/kernelbuild/chapter.xml

Modified: head/en_US.ISO8859-1/books/developers-handbook/kernelbuild/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/developers-handbook/kernelbuild/chapter.xml	Sat Oct 28 07:20:22 2017	(r51151)
+++ head/en_US.ISO8859-1/books/developers-handbook/kernelbuild/chapter.xml	Sun Oct 29 01:00:00 2017	(r51152)
@@ -11,16 +11,12 @@
     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>
+  <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>
 
-    <listitem>
-      <para>The <quote>New</quote> Way</para>
-    </listitem>
-  </itemizedlist>
-
   <note>
     <para>It is supposed that the reader of this chapter is familiar
       with the information described in the <link xlink:href="../handbook/kernelconfig-building.html">Building and
@@ -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>