Briefly document i686-linux-eglibc bootstrap.

1 files changed, 76 insertions, 0 deletions

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.