aboutsummaryrefslogtreecommitdiffstats
path: root/chapter06/kernel-exp.xml
diff options
context:
space:
mode:
Diffstat (limited to 'chapter06/kernel-exp.xml')
-rw-r--r--chapter06/kernel-exp.xml38
1 files changed, 18 insertions, 20 deletions
diff --git a/chapter06/kernel-exp.xml b/chapter06/kernel-exp.xml
index cb9352c25..ed087d4f0 100644
--- a/chapter06/kernel-exp.xml
+++ b/chapter06/kernel-exp.xml
@@ -1,38 +1,36 @@
<sect2>
<title>Command explanations</title>
-<para><userinput>ln -s /static/bin/pwd /bin/pwd</userinput>: The kernel
-source hard-wires the path to <filename>pwd</filename> to be
-<filename>/bin/pwd</filename> so we create a temporary symlink to deal with
-it.</para>
+<para><userinput>ln -s /static/bin/pwd /bin/pwd</userinput>: In the kernel
+source, the path to the <filename>pwd</filename> program is hard-wired as
+<filename>/bin/pwd</filename>, so we create a temporary symlink to account
+for that. At the end we remove it again.</para>
-<para><userinput>make mrproper:</userinput> This will ensure that the kernel
-tree is absolutely clean. We do this because the kernel team recommend
-that this is done prior to <emphasis>each</emphasis> kernel compilation,
-and that we shouldn't rely on the source tree being automatically clean
-after untarring.</para>
+<para><userinput>make mrproper</userinput>: This ensures that the kernel
+tree is absolutely clean. The kernel team recommends that this command be
+issued prior to <emphasis>each</emphasis> kernel compilation, and that you
+shouldn't rely on the source tree being clean after untarring.</para>
<para><userinput>make include/linux/version.h</userinput> and
<userinput>make symlinks</userinput>: This creates the
-<filename>include/linux/version.h</filename>, as well as the <filename
-class="symlink">include/asm</filename> symlink.</para>
+<filename>include/linux/version.h</filename> file and the platform-specific
+<filename class="symlink">include/asm</filename> symlink.</para>
<para><userinput>mkdir /usr/include/asm</userinput>
, <userinput>cp include/asm/* /usr/include/asm</userinput> and
-<userinput>cp include/asm-generic /usr/include</userinput>:
-This copies the platform-specific assembler kernel header files to
+<userinput>cp -R include/asm-generic /usr/include</userinput>:
+These commands copy the platform-specific assembler kernel header files to
<filename class="directory">/usr/include/asm</filename> and <filename
-class="directory">/usr/include/asm-generic</filename></para>
+class="directory">/usr/include/asm-generic</filename>.</para>
<para><userinput>cp -R include/linux /usr/include</userinput>:
This command copies the cross-platform kernel header files to
-<filename>/usr/include</filename></para>
+<filename>/usr/include</filename>.</para>
-<para><userinput>touch /usr/include/linux/autoconf.h</userinput>: Some
-kernel header files include this <filename>autoconf.h</filename> file, but
-outside the Linux source tree, that file has no meaning so we just create
-an empty one so we don't get compile errors whenever it happens to be a
-dependency of another kernel header file.</para>
+<para><userinput>touch /usr/include/linux/autoconf.h</userinput>: This
+creates an empty <filename>autoconf.h</filename> file. As we do not yet
+configure the kernel, we have to create this file ourselves for those few
+kernel header files that make use of it, to avoid compilation failures.</para>
</sect2>