[Clfs-commits] commit: r4935 - in /trunk/BOOK: cross-tools/alpha/ cross-tools/mips/ cross-tools/native/ cross-tools/ppc/ cross-tools/sparc/ cross-tools/sparc64/ cross-tools/x86/ cross-tools/x86_64/ final-system/common/ introduction/common/

svn at cross-lfs.org svn at cross-lfs.org
Thu Apr 16 09:15:04 PDT 2009


Author: chris at beaker67.com
Date: Thu Apr 16 16:15:03 2009
New Revision: 4935

Log:
Added command explanation to Linux-Headers pages

Modified:
    trunk/BOOK/cross-tools/alpha/linux-headers.xml
    trunk/BOOK/cross-tools/mips/linux-headers.xml
    trunk/BOOK/cross-tools/native/linux-headers.xml
    trunk/BOOK/cross-tools/ppc/linux-headers.xml
    trunk/BOOK/cross-tools/sparc/linux-headers.xml
    trunk/BOOK/cross-tools/sparc64/linux-headers.xml
    trunk/BOOK/cross-tools/x86/linux-headers.xml
    trunk/BOOK/cross-tools/x86_64/linux-headers.xml
    trunk/BOOK/final-system/common/linux-headers.xml
    trunk/BOOK/introduction/common/changelog.xml

Modified: trunk/BOOK/cross-tools/alpha/linux-headers.xml
==============================================================================
--- trunk/BOOK/cross-tools/alpha/linux-headers.xml (original)
+++ trunk/BOOK/cross-tools/alpha/linux-headers.xml Thu Apr 16 16:15:03 2009
@@ -36,6 +36,34 @@
 make ARCH=alpha INSTALL_HDR_PATH=dest headers_install
 cp -rv dest/include/* /tools/include</userinput></screen>
 
+    <variablelist os="d">
+      <title>The meaning of the make commands:</title>
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../../final-system/common/linux-headers.xml"
+    xpointer="xpointer(//*[@os='d1'])"/>
+
+      <varlistentry os="d2">
+        <term><parameter>make ARCH=alpha headers_check</parameter></term>
+        <listitem>
+          <para>Sanitizes the raw kernel headers so that they can be used
+          by userspace programs.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry os="d3">
+        <term><parameter>make ARCH=alpha INSTALL_HDR_PATH=dest headers_install</parameter></term>
+        <listitem>
+          <para>Normally the headers_install target removes the entire
+          destination directory (default
+          <filename class="directory">/usr/include</filename>) before
+          installing the headers. To prevent this, we tell the kernel to
+          install the headers to a directory inside the source dir.</para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
   </sect2>
 
   <sect2 role="content">

Modified: trunk/BOOK/cross-tools/mips/linux-headers.xml
==============================================================================
--- trunk/BOOK/cross-tools/mips/linux-headers.xml (original)
+++ trunk/BOOK/cross-tools/mips/linux-headers.xml Thu Apr 16 16:15:03 2009
@@ -36,6 +36,34 @@
 make ARCH=mips INSTALL_HDR_PATH=dest headers_install
 cp -rv dest/include/* /tools/include</userinput></screen>
 
+    <variablelist os="d">
+      <title>The meaning of the make commands:</title>
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../../final-system/common/linux-headers.xml"
+    xpointer="xpointer(//*[@os='d1'])"/>
+
+      <varlistentry os="d2">
+        <term><parameter>make ARCH=mips headers_check</parameter></term>
+        <listitem>
+          <para>Sanitizes the raw kernel headers so that they can be used
+          by userspace programs.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry os="d3">
+        <term><parameter>make ARCH=mips INSTALL_HDR_PATH=dest headers_install</parameter></term>
+        <listitem>
+          <para>Normally the headers_install target removes the entire
+          destination directory (default
+          <filename class="directory">/usr/include</filename>) before
+          installing the headers. To prevent this, we tell the kernel to
+          install the headers to a directory inside the source dir.</para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
   </sect2>
 
   <sect2 role="content">

Modified: trunk/BOOK/cross-tools/native/linux-headers.xml
==============================================================================
--- trunk/BOOK/cross-tools/native/linux-headers.xml (original)
+++ trunk/BOOK/cross-tools/native/linux-headers.xml Thu Apr 16 16:15:03 2009
@@ -36,6 +36,10 @@
 make INSTALL_HDR_PATH=dest headers_install
 cp -rv dest/include/* /tools/include</userinput></screen>
 
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../../final-system/common/linux-headers.xml"
+    xpointer="xpointer(//*[@os='d'])"/>
+
   </sect2>
 
   <sect2 role="content">

Modified: trunk/BOOK/cross-tools/ppc/linux-headers.xml
==============================================================================
--- trunk/BOOK/cross-tools/ppc/linux-headers.xml (original)
+++ trunk/BOOK/cross-tools/ppc/linux-headers.xml Thu Apr 16 16:15:03 2009
@@ -36,6 +36,34 @@
 make ARCH=powerpc INSTALL_HDR_PATH=dest headers_install
 cp -rv dest/include/* /tools/include</userinput></screen>
 
+    <variablelist os="d">
+      <title>The meaning of the make commands:</title>
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../../final-system/common/linux-headers.xml"
+    xpointer="xpointer(//*[@os='d1'])"/>
+
+      <varlistentry os="d2">
+        <term><parameter>make ARCH=powerpc headers_check</parameter></term>
+        <listitem>
+          <para>Sanitizes the raw kernel headers so that they can be used
+          by userspace programs.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry os="d3">
+        <term><parameter>make ARCH=powerpc INSTALL_HDR_PATH=dest headers_install</parameter></term>
+        <listitem>
+          <para>Normally the headers_install target removes the entire
+          destination directory (default
+          <filename class="directory">/usr/include</filename>) before
+          installing the headers. To prevent this, we tell the kernel to
+          install the headers to a directory inside the source dir.</para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
   </sect2>
 
   <sect2 role="content">

Modified: trunk/BOOK/cross-tools/sparc/linux-headers.xml
==============================================================================
--- trunk/BOOK/cross-tools/sparc/linux-headers.xml (original)
+++ trunk/BOOK/cross-tools/sparc/linux-headers.xml Thu Apr 16 16:15:03 2009
@@ -36,6 +36,34 @@
 make ARCH=sparc INSTALL_HDR_PATH=dest headers_install
 cp -rv dest/include/* /tools/include</userinput></screen>
 
+    <variablelist os="d">
+      <title>The meaning of the make commands:</title>
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../../final-system/common/linux-headers.xml"
+    xpointer="xpointer(//*[@os='d1'])"/>
+
+      <varlistentry os="d2">
+        <term><parameter>make ARCH=sparc headers_check</parameter></term>
+        <listitem>
+          <para>Sanitizes the raw kernel headers so that they can be used
+          by userspace programs.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry os="d3">
+        <term><parameter>make ARCH=sparc INSTALL_HDR_PATH=dest headers_install</parameter></term>
+        <listitem>
+          <para>Normally the headers_install target removes the entire
+          destination directory (default
+          <filename class="directory">/usr/include</filename>) before
+          installing the headers. To prevent this, we tell the kernel to
+          install the headers to a directory inside the source dir.</para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
   </sect2>
 
   <sect2 role="content">

Modified: trunk/BOOK/cross-tools/sparc64/linux-headers.xml
==============================================================================
--- trunk/BOOK/cross-tools/sparc64/linux-headers.xml (original)
+++ trunk/BOOK/cross-tools/sparc64/linux-headers.xml Thu Apr 16 16:15:03 2009
@@ -36,6 +36,34 @@
 make ARCH=sparc64 INSTALL_HDR_PATH=dest headers_install
 cp -rv dest/include/* /tools/include</userinput></screen>
 
+    <variablelist os="d">
+      <title>The meaning of the make commands:</title>
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../../final-system/common/linux-headers.xml"
+    xpointer="xpointer(//*[@os='d1'])"/>
+
+      <varlistentry os="d2">
+        <term><parameter>make ARCH=sparc64 headers_check</parameter></term>
+        <listitem>
+          <para>Sanitizes the raw kernel headers so that they can be used
+          by userspace programs.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry os="d3">
+        <term><parameter>make ARCH=sparc64 INSTALL_HDR_PATH=dest headers_install</parameter></term>
+        <listitem>
+          <para>Normally the headers_install target removes the entire
+          destination directory (default
+          <filename class="directory">/usr/include</filename>) before
+          installing the headers. To prevent this, we tell the kernel to
+          install the headers to a directory inside the source dir.</para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
   </sect2>
 
   <sect2 role="content">

Modified: trunk/BOOK/cross-tools/x86/linux-headers.xml
==============================================================================
--- trunk/BOOK/cross-tools/x86/linux-headers.xml (original)
+++ trunk/BOOK/cross-tools/x86/linux-headers.xml Thu Apr 16 16:15:03 2009
@@ -36,6 +36,34 @@
 make ARCH=i386 INSTALL_HDR_PATH=dest headers_install
 cp -rv dest/include/* /tools/include</userinput></screen>
 
+    <variablelist os="d">
+      <title>The meaning of the make commands:</title>
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../../final-system/common/linux-headers.xml"
+    xpointer="xpointer(//*[@os='d1'])"/>
+
+      <varlistentry os="d2">
+        <term><parameter>make ARCH=i386 headers_check</parameter></term>
+        <listitem>
+          <para>Sanitizes the raw kernel headers so that they can be used
+          by userspace programs.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry os="d3">
+        <term><parameter>make ARCH=i386 INSTALL_HDR_PATH=dest headers_install</parameter></term>
+        <listitem>
+          <para>Normally the headers_install target removes the entire
+          destination directory (default
+          <filename class="directory">/usr/include</filename>) before
+          installing the headers. To prevent this, we tell the kernel to
+          install the headers to a directory inside the source dir.</para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
   </sect2>
 
   <sect2 role="content">

Modified: trunk/BOOK/cross-tools/x86_64/linux-headers.xml
==============================================================================
--- trunk/BOOK/cross-tools/x86_64/linux-headers.xml (original)
+++ trunk/BOOK/cross-tools/x86_64/linux-headers.xml Thu Apr 16 16:15:03 2009
@@ -36,6 +36,34 @@
 make ARCH=x86_64 INSTALL_HDR_PATH=dest headers_install
 cp -rv dest/include/* /tools/include</userinput></screen>
 
+    <variablelist os="d">
+      <title>The meaning of the make commands:</title>
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../../final-system/common/linux-headers.xml"
+    xpointer="xpointer(//*[@os='d1'])"/>
+
+      <varlistentry os="d2">
+        <term><parameter>make ARCH=x86_64 headers_check</parameter></term>
+        <listitem>
+          <para>Sanitizes the raw kernel headers so that they can be used
+          by userspace programs.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry os="d3">
+        <term><parameter>make ARCH=x86_64 INSTALL_HDR_PATH=dest headers_install</parameter></term>
+        <listitem>
+          <para>Normally the headers_install target removes the entire
+          destination directory (default
+          <filename class="directory">/usr/include</filename>) before
+          installing the headers. To prevent this, we tell the kernel to
+          install the headers to a directory inside the source dir.</para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
   </sect2>
 
   <sect2 role="content">

Modified: trunk/BOOK/final-system/common/linux-headers.xml
==============================================================================
--- trunk/BOOK/final-system/common/linux-headers.xml (original)
+++ trunk/BOOK/final-system/common/linux-headers.xml Thu Apr 16 16:15:03 2009
@@ -34,6 +34,37 @@
 make INSTALL_HDR_PATH=dest headers_install
 cp -rv dest/include/* /usr/include</userinput></screen>
 
+    <variablelist os="d">
+      <title>The meaning of the make commands:</title>
+
+      <varlistentry os="d1">
+        <term><parameter>make mrproper</parameter></term>
+        <listitem>
+          <para>Ensures that the kernel source dir is clean.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry os="d2">
+        <term><parameter>make headers_check</parameter></term>
+        <listitem>
+          <para>Sanitizes the raw kernel headers so that they can be used
+          by userspace programs.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry os="d3">
+        <term><parameter>make INSTALL_HDR_PATH=dest headers_install</parameter></term>
+        <listitem>
+          <para>Normally the headers_install target removes the entire
+          destination directory (default
+          <filename class="directory">/usr/include</filename>) before
+          installing the headers. To prevent this, we tell the kernel to
+          install the headers to a directory inside the source dir.</para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
   </sect2>
 
   <sect2 id="contents-linux-headers" role="content">

Modified: trunk/BOOK/introduction/common/changelog.xml
==============================================================================
--- trunk/BOOK/introduction/common/changelog.xml (original)
+++ trunk/BOOK/introduction/common/changelog.xml Thu Apr 16 16:15:03 2009
@@ -35,6 +35,16 @@
       </itemizedlist>
     </listitem>
 -->
+
+    <listitem>
+      <para>April 16, 2009</para>
+      <itemizedlist>
+        <listitem>
+          <para>[Chris] - Added command explanations to Linux-Headers
+          pages.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
 
     <listitem>
       <para>April 15, 2009</para>




More information about the Clfs-commits mailing list