changeset 531:4828f4597ede

Documentation tweak talking about mini-native, and warning that the last section or two aren't updated yet.
author Rob Landley <rob@landley.net>
date Wed, 10 Dec 2008 05:52:01 -0600
parents ea7a010e5c47
children dc66aafc2049
files www/documentation.html
diffstat 1 files changed, 12 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/www/documentation.html	Wed Dec 10 05:36:41 2008 -0600
+++ b/www/documentation.html	Wed Dec 10 05:52:01 2008 -0600
@@ -960,6 +960,10 @@
 step to build a kernel and root filesystem for the target.  The resulting
 system should boot and run under an emulator, or on real target hardware.</p>
 
+<p>If you really want to learn how to cross compile a target system, this
+is the script you want to read, and possibly append your own packages to.
+That said: please don't, and here's why:</p>
+
 <p>Because cross-compiling is persnickety and difficult, we do as little of
 it as possible.  This script should perform all the cross compiling anyone ever
 needs to do.  It uses the cross-compiler to generate the simplest possible
@@ -1025,6 +1029,12 @@
 
 <p>We unconditionally install the development files (headers and static
 libraries), and delete them later if $NATIVE_TOOLCHAIN isn't set.</p>
+
+<p>Right after installing the C library, we export the environment variable
+$WRAPPER_TOPDIR which tells the compiler wrapper to links against the new
+headers and shared libraries we've installed into the new root filesystem,
+rather than the ones out of the cross compiler's include and lib
+directories.</p>
 </li>
 
 <li><p><b>toybox</b> - Build optional command line utilities.</p>
@@ -1251,6 +1261,8 @@
 
 <a name="why"><h1>Why do things this way</h1></a>
 
+<h1>NOTE: FROM HERE TO THE END OF THIS FILE IS OUT OF DATE</h1>
+
 <p>This section has some historical information.  It describes the evolution
 of the firmware Linux build process, but hasn't been brought up to date
 in all the particulars.</p>