From bed61bb6ad1626d1675b589ef8daa56b270a5ed3 Mon Sep 17 00:00:00 2001
From: Timothy Bauscher <timothy@linuxfromscratch.org>
Date: Sun, 22 Sep 2002 14:22:43 +0000
Subject: Applied Alex's grammatic-fixes patch.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2128 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
---
 chapter06/kernel-exp-headers.xml | 27 ++++++++++++++++-----------
 1 file changed, 16 insertions(+), 11 deletions(-)

(limited to 'chapter06/kernel-exp-headers.xml')

diff --git a/chapter06/kernel-exp-headers.xml b/chapter06/kernel-exp-headers.xml
index 525fe0f6b..4e42a1549 100644
--- a/chapter06/kernel-exp-headers.xml
+++ b/chapter06/kernel-exp-headers.xml
@@ -1,11 +1,11 @@
 <sect2>
 <title>Why we copy the kernel headers and don't symlink them</title>
 
-<para>In the past it was common practice for people to symlink the
-/usr/include/linux and asm directories to /usr/src/linux/include/linux
-and asm respectively.  This is a <emphasis>bad</emphasis> idea as 
-this extract from a post by Linus Torvalds to the Linux Kernel 
-Mailing List points out:</para>
+<para>In the past it was common practice to symlink the
+<filename class="directory">/usr/include/{linux,asm}</filename> directories
+to <filename class="directory">/usr/src/linux/include/{linux,asm}</filename>.
+This was a <emphasis>bad</emphasis> practice, as the following extract from a
+post by Linus Torvalds to the Linux Kernel Mailing List points out:</para>
 
 <screen>I would suggest that people who compile new kernels should: 
 
@@ -25,11 +25,16 @@ has that broken symlink, and people still remember that the linux
 sources should go into "/usr/src/linux" even though that hasn't been 
 true in a _loong_ time.</screen>
 
-<para>The relevant part here is where he states that the headers should
-be the ones which <emphasis>glibc was compiled against</emphasis>.  These are 
-the headers which should remain accessible and so by copying them, we ensure
-that we follow these guidelines.  Also note that as long as you don't have 
-those symlinks, it is perfectly fine to have the kernel sources 
-in <filename>/usr/src/linux</filename>.</para>
+<para>The essential part is where Linus states that the header files should be
+<emphasis>the ones which glibc was compiled against</emphasis>.  These are
+the headers that should be used when you later compile other packages, as they
+are the ones that match the object-code library files. By copying the headers,
+we ensure that they remain available if later you upgrade your kernel.</para>
+
+<para>Note, by the way, that it is perfectly all right to have the kernel sources
+in <filename class="directory">/usr/src/linux</filename>, as long as you don't
+have the <filename class="directory">/usr/include/{linux,asm}</filename>
+symlinks.</para>
 
 </sect2>
+
-- 
cgit v1.2.3-54-g00ecf