Briefly document i686-linux-eglibc bootstrap.

2 files changed, 79 insertions, 1 deletions

diff --git a/dev/ports/core-linux-eglibc-bootstrap.mdwn b/dev/ports/core-linux-eglibc-bootstrap.mdwn
index 53a2d69..647b15a 100644
--- a/dev/ports/core-linux-eglibc-bootstrap.mdwn
+++ b/dev/ports/core-linux-eglibc-bootstrap.mdwn
@@ -18,7 +18,9 @@ and that the following architecture table is present at
     k8-linux-eglibc        x86_64-pc-linux-gnu          x86
     cortexa8-linux-eglibc  arm-cortex_a8-linux-gnueabi  arm
 
-Subsequent ports may simply be built from the core-linux-eglibc port.
+Subsequent ports like
+[[i686-linux-eglibc|dev/ports/i686-linux-eglibc-bootstrap]] may simply be cross
+built from the core-linux-eglibc port.
 
 1.  Build the following base system packages for amd64-linux-eglibc using
     Debian's GNU toolchain:
diff --git a/dev/ports/i686-linux-eglibc-bootstrap.mdwn b/dev/ports/i686-linux-eglibc-bootstrap.mdwn
new file mode 100644
index 0000000..110ecd8
--- /dev/null
+++ b/dev/ports/i686-linux-eglibc-bootstrap.mdwn
@@ -0,0 +1,76 @@
+[[!meta title="Bootstrap of the i686-linux-eglibc Port"]]
+
+Following is the planned procedure to bootstrap the i686-linux-eglibc port from
+a core-linux-eglibc system.
+
+This procedure assumes that all base system and build essential packages are
+installed, along with libgmp-dev, libmpfr-dev, and libmpc-dev.
+
+These steps are overly simplified and useful only as a reference.
+
+
+1. Build a Compiler That Can Build Headers
+==========================================
+
+Natively build Binutils with the following architecture specifications:
+
+  * Build arch: core-linux-eglibc
+  * Host-arch: core-linux-eglibc
+  * Target arch: i686-linux-eglibc
+
+Natively build GCC without building shared libraries and without linking
+against libc with the following architecture specifications:
+
+  * Build arch: core-linux-eglibc
+  * Host-arch: core-linux-eglibc
+  * Target arch: i686-linux-eglibc
+
+
+2. Build Headers
+================
+
+Cross build Linux headers with the following architecture specifications:
+
+  * Build arch: core-linux-eglibc
+  * Host-arch: i686-linux-eglibc
+
+Cross build EGLIBC headers with the following architecture specifications:
+
+  * Build arch: core-linux-eglibc
+  * Host-arch: i686-linux-eglibc
+
+
+3. Build a Compiler That Can Build a C Library
+==============================================
+
+Natively build GCC without building shared libraries with the following
+architecture specifications:
+
+  * Build arch: core-linux-eglibc
+  * Host-arch: core-linux-eglibc
+  * Target arch: i686-linux-eglibc
+
+
+4. Build a C Library
+====================
+
+Cross build EGLIBC with the following architecture specifications:
+
+  * Build arch: core-linux-eglibc
+  * Host-arch: i686-linux-eglibc
+
+
+5. Build a Final Compiler
+=========================
+
+Natively build GCC with the following architecture specifications:
+
+  * Build arch: core-linux-eglibc
+  * Host-arch: core-linux-eglibc
+  * Target arch: i686-linux-eglibc
+
+
+6. Build Everything for the Target
+==================================
+
+Using the new cross toolchain, cross build all packages for i686-linux-eglibc.