From 7d58f6a9bf3e42b2a56448b3f48c336f909f5dba Mon Sep 17 00:00:00 2001 From: Rich Felker Date: Tue, 25 Aug 2015 19:58:17 +0000 Subject: [PATCH] add README --- README.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..1bf8aee --- /dev/null +++ b/README.md @@ -0,0 +1,32 @@ +musl-cross-make +=============== + +This is a quick and simple makefile-based alternative for producing +musl-based cross compilers. In addition to the build system, it +provides a number of patches, including: + +- Updated versions of the musl target patches going into upstream GCC + +- Static-PIE support and enabling PIE as default + +- Fixes for SH-specific bugs and bitrot in GCC + +- Support for J2 Core CPU target in GCC & binutils + +The current focus is on SH2/J2 Core targets and NOMMU (where PIE is +mandatory) since these are not adequately supported by other musl +cross-compiler toolchain build systems. + +Usage +----- + +To build, copy the provided config.mak.dist to config.mak and edit +then run make. Parallel builds are supported. The host needs to have +suitable gmp/mpfr/mpc libraries installed in the standard library +path, or you can add the appropriate --with options to GCC_CONFIG. + +At present only GCC 5.2.0 and Binutils 2.25.1 are supported. +Backporting of patches is needed to support other versions. + +The included patches should also be usable with Gregor's original +musl-cross or other build systems, if desired.