Date: Sun, 29 Oct 2017 01:00:01 +0000 (UTC) From: Eitan Adler <eadler@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r51152 - head/en_US.ISO8859-1/books/developers-handbook/kernelbuild Message-ID: <201710290100.v9T101NZ059590@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201710290100.v9T101NZ059590>