os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Move up the correct way to compile the kernel

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

Reviewed By: allanjude
This commit is contained in:
Eitan Adler 2017-10-29 01:00:00 +00:00
parent 8c452e36b4
commit 70ac91a2e9
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=51152
1 changed files with 11 additions and 27 deletions
Download patch file Download diff file Expand all files Collapse all files

38
en_US.ISO8859-1/books/developers-handbook/kernelbuild/chapter.xml
View file

@ -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>