Don't *include* the shell scripts, but *link* to them.

This is for a reason: I manage them in a RCS and from time to time publish
updates.  They're not going to be maintained inside the wiki system, but will
eventually be included in the Hurd's source code base.

1 files changed, 5 insertions, 519 deletions

diff --git a/hurd/building/cross-compiling.mdwn b/hurd/building/cross-compiling.mdwn
index 51508d20..5a5e3f60 100644
--- a/hurd/building/cross-compiling.mdwn
+++ b/hurd/building/cross-compiling.mdwn
@@ -18,6 +18,11 @@ Mach, GNU Hurd.
 
 [[Thomas_Schwinge|tschwinge]] has written a shell script for building a
 complete cross-build environment for GNU/Hurd systems.
+
+For now, find the shell scripts at
+<http://nic-nac-project.de/~schwinge/tmp/cross-gnu> and
+<http://nic-nac-project.de/~schwinge/tmp/cross-gnu-env>.
+
 Read through it.  Understand it.  Then use it.
 
 /!\ Be made aware that -- while it is of course possible to build a working
@@ -30,525 +35,6 @@ definitely needed for the glibc, Hurd and GCC source packages, as there are a
 bunch of outstanding patches that are needed for getting a functional build.
 
 
-<pre>
-#!/bin/sh
-
-# Cross compile a GNU build environment.
-
-# Written by Thomas Schwinge <tschwinge@gnu.org>.
-
-# This script is placed into the public domain; nevertheless, please feel free
-# to send any suggestions, improvements, etc. back to me.
-
-# The files are canonically found at
-# <http://nic-nac-project.de/~schwinge/tmp/cross-gnu> and
-# <http://nic-nac-project.de/~schwinge/tmp/cross-gnu-env>.
-
-# Thanks to
-# * Thadeu Lima de Souza Cascardo for updating the instructions about getting
-#   the source code of GCC using the Subversion repositories.
-
-# Prerequisites:
-#
-# A build environment for the system you're running the script on is required,
-# i.e. a C compiler with the basic libraries and `make'.  You might also need
-# `flex' and `bison'.
-
-# Usage:
-#
-# Place `cross-gnu' and `cross-gnu-env' somewhere in `$PATH', e.g. in `~/bin/'.
-
-# Get the source code of the
-
-# * GNU Binutils, <http://gnu.org/software/binutils/>, `src/binutils'
-#
-#   $ cvs -d:pserver:anoncvs@sources.redhat.com:/cvs/src \
-#       co -r binutils-2_17-branch binutils
-#   $ mv src binutils-2_17-branch
-#
-#   Or fetch a tarball from <ftp://ftp.gnu.org/gnu/binutils/>.
-
-# * GNU Compiler Collection, <http://gcc.gnu.org/>, `src/gcc'
-#
-#   $ svn co svn://gcc.gnu.org/svn/gcc/branches/BRANCH gcc
-#   $ mv gcc BRANCH
-#
-#   BRANCH is one of `gcc-3_3-branch', `gcc-3_4-branch', `gcc-4_0-branch',
-#   `gcc-4_1-branch' or the tag of a released version like `gcc_3_4_3_release'.
-#   Or fetch a tarball from <ftp://ftp.gnu.org/gnu/gcc/>.
-
-# * GNU C Library, <http://gnu.org/software/libc/>, `src/glibc'
-#
-#   $ cvs -d:pserver:anoncvs@sources.redhat.com:/cvs/glibc \
-#       co -r glibc-2_3-branch glibc
-#   $ mv libc glibc-2_3-branch
-#
-#   Change `glibc-2_3-branch' to `glibc-2_5-branch' to get the glibc 2.5 branch
-#   or omit `-r glibc-2_3-branch' if you want to get the trunk, i.e. the glibc
-#   2.6 branch, but note that building both of them currently won't work
-#   without heavy patching.
-#
-#   Or fetch a tarball from <ftp://ftp.gnu.org/gnu/glibc/>.
-#
-#   If you want to use GCC 4.1 or newer, you'll also need to apply the
-#   following patch, for both glibc-2_3-branch and glibc-2_5-branch:
-#   <http://nic-nac-project.de/~schwinge/tmp/init-first.c_vs._GCC_4.1.patch>.
-#
-#   If you use a GNU Make version newer than 3.80, you also need to apply the
-#   following patch to glibc-2_3-branch:
-#   <http://sourceware.org/bugzilla/show_bug.cgi?id=2507#c2>.
-
-# * GNU Hurd, <http://hurd.gnu.org/>, `src/hurd'
-#
-#   $ cvs -d:pserver:anoncvs@cvs.gnu.org:/cvsroot/hurd co hurd
-
-# * GNU Mach (gnumach-1-branch), <http://hurd.gnu.org/>, `src/gnumach'
-#
-#   $ cvs -d:pserver:anoncvs@cvs.gnu.org:/cvsroot/hurd \
-#       co -r gnumach-1-branch gnumach
-#   $ mv gnumach gnumach-1-branch
-
-# * GNU Mach Interface Generator, <http://hurd.gnu.org/>, `src/mig'
-#
-#   $ cvs -d:pserver:anoncvs@cvs.gnu.org:/cvsroot/hurd co mig
-
-# * GNU Debugger, <http://gnu.org/software/gdb/>, `src/gdb'
-#
-#   This is optional and will only be compiled if present.
-#
-#   $ cvs -d:pserver:anoncvs@sources.redhat.com:/cvs/src \
-#       co -r gdb_6_6-branch gdb
-#   $ mv src gdb_6_6-branch
-#
-#   Or fetch a tarball from <ftp://ftp.gnu.org/gnu/gdb/>.
-
-# Unpack the tarballs if you downloaded any.
-
-# Create a directory where the cross build shall take place and `cd' to that
-# directory.  Create a subdirectory `src' and create symbolic links for every
-# of the above packages: from `src/PACKAGE' to where you stored or unpacked it.
-# If you don't intend to build several cross compilers or use the source trees
-# otherwise, you can also directly store the source trees in `src/'.  The
-# source trees can be shared between multiple cross build trees since the
-# package's build systems are supposed not to modify the files in the source
-# trees.  Not all packages adhere to that, but they fail to do so only for
-# pre-processed documentation, etc., as far as I can tell.
-
-# Run
-# $ ROOT=. cross-gnu
-# ... to create the cross build environment in the current directory from the
-# sources in `src/'.
-
-# Later, run
-# $ ROOT=WHERE_THE_ROOT_OF_THE_CROSS_BUILD_TREE_IS; . cross-gnu-env
-# ... to set up `$PATH' (and some other environment variables; have a look at
-# cross-gnu-env), so that you can easily use e.g. the cross compiler running
-# `$TARGET-gcc'.
-
-# Notes:
-
-# You can re-run `cross-gnu' to rebuild the parts of the sources that have
-# changed since the last run.  This might save a lot of time and is especially
-# useful if you aren't working with unpacked tarballs, but on CVS's branches or
-# want to quickly get a new tool chain with patches you applied to the source
-# trees.
-# I would, however, _not_ recommend to use this technique when doing major
-# changes to the source trees, like switching from gcc-3.3 to gcc-3.4.
-
-# There are several parts marked with `TODO' in this file; feel free to have a
-# look at these issues and send the outcome back to me.
-
-
-# Set up the environment.
-
-. cross-gnu-env
-
-case $? in 0) :;; *) (exit "$?");; esac &&
-
-
-# Be verbose.
-
-set -x &&
-
-
-# Create directories.
-
-mkdir -p "$ROOT" &&
-cd "$ROOT" &&
-mkdir -p bin "$SYS_ROOT"/{include,lib} "$TARGET" &&
-ln -sfn "$SYS_ROOT"/{include,lib} "$TARGET"/ &&
-
-
-# Install the cross GNU Binutils.
-
-mkdir -p "$BINUTILS_SRC".obj &&
-cd "$BINUTILS_SRC".obj &&
-# We use `config.status''s existence as an indicator whether the package was
-# configured already.  (E.g. when running cross-gnu a second time to update the
-# tool chain.)
-if ./config.status --version > /dev/null 2>&1; then :; else
-  "$BINUTILS_SRC"/configure \
-    --target="$TARGET" \
-    --prefix="$ROOT" \
-    --with-sysroot="$SYS_ROOT" \
-    --disable-nls
-fi &&
-"$MAKE" \
-  all \
-  install &&
-
-
-# Install a minimal cross GCC to build a cross MIG and the GNU C Library.
-
-mkdir -p "$GCC_SRC".obj &&
-cd "$GCC_SRC".obj &&
-# Perhaps we already have a complete cross GCC?
-if "$TARGET"-gcc --version > /dev/null 2>&1; then :; else
-  if ./config.status > /dev/null 2>&1; then :; else
-    "$GCC_SRC"/configure \
-      --target="$TARGET" \
-      --prefix="$ROOT" \
-      --with-sysroot="$SYS_ROOT" \
-      --disable-nls \
-      --disable-shared \
-      --without-headers \
-      --with-newlib \
-      --enable-languages=c
-  fi &&
-
-# TODO: GCC 3.3 and GCC 3.4 need this for building libgcc.a.  Not needed for
-# GCC 4.0.
-  : > "$SYS_ROOT"/include/signal.h &&
-  mkdir -p "$SYS_ROOT"/include/sys &&
-  : > "$SYS_ROOT"/include/sys/ucontext.h &&
-
-  if "$MAKE" \
-      all-gcc \
-      install-gcc &&
-# TODO: Make glibc happy.  We can not yet build libgcc_eh, but glibc's build
-# system wants to link against that library.  A totally empty file is fine for
-# binutils-2.16, but not for binutils-2.15.
-# <http://sources.redhat.com/ml/libc-alpha/2003-09/msg00100.html>.
-      echo '/* Empty.  */' > "$SYS_ROOT"/lib/libgcc_eh.a
-  then
-    # Remove the bogus files if building the cross compiler succeesded.
-    rm config.status "$SYS_ROOT"/include/{signal.h,sys/ucontext.h}
-  else
-    # That indication file might already have been installed, but we do not yet
-    # have a complete, working cross compiler.
-    rm -f "$ROOT"/bin/"$TARGET"-gcc &&
-    exit 100
-  fi
-fi &&
-
-
-# Install GNU Mach's header files.
-
-mkdir -p "$GNUMACH_SRC".obj &&
-cd "$GNUMACH_SRC".obj &&
-if ./config.status --version > /dev/null 2>&1; then :; else
-  # `$TARGET-gcc' doesn't work yet (to satisfy the Autoconf checks), but isn't
-  # needed either.
-  CC=gcc \
-  "$GNUMACH_SRC"/configure \
-    --host="$TARGET" \
-    --prefix=
-fi &&
-if grep -q install-data "$GNUMACH_SRC"/Makefile.in; then
-  "$MAKE" \
-    DESTDIR="$SYS_ROOT" \
-    install-data
-else
-  # Old.
-  "$MAKE" \
-    prefix="$SYS_ROOT" \
-    no_deps=t \
-    install-headers
-fi &&
-
-
-# Install a cross GNU MIG.
-
-mkdir -p "$MIG_SRC".obj &&
-cd "$MIG_SRC".obj &&
-if ./config.status > /dev/null 2>&1; then :; else
-  "$MIG_SRC"/configure \
-    --target="$TARGET" \
-    --prefix="$ROOT"
-fi &&
-"$MAKE" \
-  all \
-  install &&
-
-
-# Install the GNU Hurd's header files.
-
-mkdir -p "$HURD_SRC".obj &&
-cd "$HURD_SRC".obj &&
-if ./config.status --version > /dev/null 2>&1; then :; else
-  # `$TARGET-gcc' doesn't work yet (to satisfy the Autoconf checks), but isn't
-  # needed either.
-  CC=gcc \
-  "$HURD_SRC"/configure \
-    --host="$TARGET" \
-    --prefix= \
-    --disable-profile
-fi &&
-"$MAKE" \
-  prefix="$SYS_ROOT" \
-  no_deps=t \
-  install-headers &&
-# Below, we will reconfigure for allowing to build the pthreads library.
-if grep -q '^CC = gcc$' config.make
-then rm config.status
-else :
-fi &&
-
-
-# Install the GNU C Library.
-
-# Do we already have the GNU C library installed?
-if test -h "$SYS_ROOT"/lib/ld.so; then :; else
-  mkdir -p "$GLIBC_SRC".obj &&
-  cd "$GLIBC_SRC".obj &&
-  if ./config.status > /dev/null 2>&1; then :; else
-    # `--build' has to be set to make sure that glibc is cross compiled.
-    # TODO: Unless overridden, the build system is forced to think that the
-    # linker doesn't support the `-z relro' flag, because there are unfixed
-    # bugs in glibc w.r.t. that flag.  Likewise for `--without-tls'.
-    "$GLIBC_SRC"/configure \
-      --without-cvs \
-      --build="`"$GLIBC_SRC"/scripts/config.guess`" \
-      --host="$TARGET" \
-      --prefix= \
-      --with-headers="$SYS_ROOT"/include \
-      --disable-profile \
-      ${CROSS_GNU_TLS---without-tls} \
-      ${CROSS_GNU_Z_RELRO-libc_cv_z_relro=no}
-  fi &&
-  if "$MAKE" \
-       install_root="$SYS_ROOT" \
-       all \
-       install
-  then
-    # TODO: Why doesn't `make install' do that?
-    ln -sf ld.so.1 "$SYS_ROOT"/lib/ld.so &&
-    if [ "$CROSS_GNU_REINSTALL_GLIBC" = n ]; then :; else
-      # Force re-linking files once libgcc_eh is available.  TODO: Is the
-      # following enough?
-      rm -f "$GLIBC_SRC".obj/config.status
-#      rm -rf "$GLIBC_SRC".obj
-    fi
-  else
-    # That indication file might already have been installed, but we do not yet
-    # have a complete, working installation of the GNU C library.
-    rm -f "$SYS_ROOT"/lib/ld.so
-    exit 100
-  fi
-fi &&
-
-
-# Install the GNU Hurd's pthreads library.
-
-cd "$HURD_SRC".obj &&
-if ./config.status --version > /dev/null 2>&1; then :; else
-  "$HURD_SRC"/configure \
-    --host="$TARGET" \
-    --prefix= \
-    --disable-profile
-fi &&
-"$MAKE" \
-  libpthread &&
-"$MAKE" \
-  prefix="$SYS_ROOT" \
-  libihash-install libpthread-install &&
-
-
-# Install a complete cross GCC.
-
-cd "$GCC_SRC".obj &&
-if ./config.status > /dev/null 2>&1; then :; else
-  # TODO: At the moment we only configure for creating a C compiler.
-  "$GCC_SRC"/configure \
-    --target="$TARGET" \
-    --prefix="$ROOT" \
-    --with-sysroot="$SYS_ROOT" \
-    --disable-nls \
-    --enable-languages=c
-fi &&
-# Remove the bogus libgcc_eh.
-rm -f "$SYS_ROOT"/lib/libgcc_eh.a &&
-"$MAKE" \
-  all \
-  install &&
-
-
-# Install the GNU C Library.
-
-mkdir -p "$GLIBC_SRC".obj &&
-cd "$GLIBC_SRC".obj &&
-if ./config.status > /dev/null 2>&1; then :; else
-  # `--build' has to be set to make sure that glibc is cross compiled.
-  # TODO: Unless overridden, the build system is forced to think that the
-  # linker doesn't support the `-z relro' flag, because there are unfixed
-  # bugs in glibc w.r.t. that flag.  Likewise for `--without-tls'.
-  "$GLIBC_SRC"/configure \
-    --without-cvs \
-    --build="`"$GLIBC_SRC"/scripts/config.guess`" \
-    --host="$TARGET" \
-    --prefix= \
-    --with-headers="$SYS_ROOT"/include \
-    --disable-profile \
-    ${CROSS_GNU_TLS---without-tls} \
-    ${CROSS_GNU_Z_RELRO-libc_cv_z_relro=no}
-fi &&
-"$MAKE" \
-  install_root="$SYS_ROOT" \
-  all \
-  install &&
-
-
-# Install a cross GDB, if requested.
-
-if test -d "$GDB_SRC"/; then
-  mkdir -p "$GDB_SRC".obj &&
-  cd "$GDB_SRC".obj &&
-  if ./config.status > /dev/null 2>&1; then :; else
-    "$GDB_SRC"/configure \
-      --target="$TARGET" \
-      --prefix="$ROOT" \
-      --with-sysroot="$SYS_ROOT" \
-      --disable-nls
-  fi &&
-  "$MAKE" \
-    all \
-    install &&
-
-
-  # If possible, install a cross compiled `gdbserver' to be ran on the TARGET
-  # system.
-
-  if grep -q '86-\*-gnu\*' "$GDB_SRC"/gdb/gdbserver/README; then
-    mkdir -p gdb/gdbserver &&
-    cd gdb/gdbserver &&
-    if ./config.status > /dev/null 2>&1; then :; else
-      "$GDB_SRC"/gdb/gdbserver/configure \
-        --host="$TARGET" \
-        --prefix="$SYS_ROOT"
-    fi &&
-    "$MAKE" \
-      all \
-      install
-  else :
-  fi
-fi &&
-
-
-# Success.
-
-echo "$0"': Everything should be in place now.'
-</pre>
-
-## cross-gnu-env
-
-<pre>
-#!/bin/sh
-
-# Cross compile a GNU build environment.
-
-# Written by Thomas Schwinge <tschwinge@gnu.org>.
-
-# This script is placed into the public domain; nevertheless, please feel free
-# to send any suggestions, improvements, etc. back to me.
-
-# The files are canonically found at
-# <http://nic-nac-project.de/~schwinge/tmp/cross-gnu> and
-# <http://nic-nac-project.de/~schwinge/tmp/cross-gnu-env>.
-
-
-# Functions from Paul Jarc's prjlibs available at
-# <http://code.dogmap.org/prjlibs/>.
-
-# sh/set.sh
-case $? in 0) :;; *) (exit "$?");; esac &&
-prj_set() {
-  eval "$1=\${2?}"
-}
-
-# sh/set_default.sh
-case $? in 0) :;; *) (exit "$?");; esac &&
-prj_set_default() {
-  : "${2?}" &&
-  eval "
-  if test \"\${$1+x}\" = x; then :; else
-    $1=\$2
-  fi"
-}
-
-# sh/unset.sh
-case $? in 0) :;; *) (exit "$?");; esac &&
-prj_unset() {
-  while test "$#" != 0; do
-    { eval "$1=" &&
-      unset "$1" &&
-      shift
-    } || return "$?"
-  done
-}
-
-# sh/x2.sh
-case $? in 0) :;; *) (exit "$?");; esac &&
-prj_x2() {
-  : "${2?}" &&
-  "$@" &&
-  export "$2"
-}
-
-case $? in 0) :;; *) (exit "$?");; esac &&
-
-
-# Create a clean environment.
-
-prj_x2 prj_set LC_ALL C &&
-prj_unset ASFLAGS CFLAGS CPPFLAGS CXXFLAGS LDFLAGS &&
-prj_unset MAKEFLAGS &&
-
-
-# Environment variables.
-
-# `$ROOT' defaults to `~/tmp/gnu'.
-prj_x2 prj_set_default ROOT ~/tmp/gnu &&
-# `$ROOT' must specify an absolute path.
-case $ROOT in
-  /*)
-    :;;
-  *)
-    ROOT=`cd "$ROOT" && pwd`;;
-esac &&
-
-prj_x2 prj_set_default SYS_ROOT "$ROOT"/sys_root &&
-
-prj_x2 prj_set_default TARGET i586-pc-gnu &&
-
-prj_x2 prj_set_default BINUTILS_SRC "$ROOT"/src/binutils &&
-prj_x2 prj_set_default GCC_SRC "$ROOT"/src/gcc &&
-prj_x2 prj_set_default GDB_SRC "$ROOT"/src/gdb &&
-prj_x2 prj_set_default GLIBC_SRC "$ROOT"/src/glibc &&
-prj_x2 prj_set_default GNUMACH_SRC "$ROOT"/src/gnumach &&
-prj_x2 prj_set_default HURD_SRC "$ROOT"/src/hurd &&
-prj_x2 prj_set_default MIG_SRC "$ROOT"/src/mig &&
-
-# TODO.  See cross-gnu.
-prj_x2 prj_set_default CROSS_GNU_REINSTALL_GLIBC y &&
-
-prj_x2 prj_set PATH "$ROOT"/bin:"$PATH" &&
-
-if gmake --version 2> /dev/null | grep -q GNU
-then prj_x2 prj_set MAKE gmake
-else prj_x2 prj_set MAKE make
-fi
-</pre>
-
 ## References
 
 * <http://lists.gnu.org/archive/html/bug-hurd/2004-09/msg00030.html>