Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

What is this

A collection of brown scripts that build brown compilers and libaries for the Atari ST series of computers.

Notable features

  • link-time whole-program optimisation (inter-module calls & inlining)

  • improved optimiser

  • C++14, C++17 support

  • named section support via C and asm

  • proper C++ initialise/finalise sequence

  • GST extended symbols

  • can preview code generation in Godbolt/68k (try it live at

  • path open for future gcc releases


The script will attempt to auto-fetch the required gcc/binutils/mintlib packages. If something goes wrong you'll have to modify the fetch URLs.

Make sure you have installed the following libraries and tools.


GMP/MPFR/MPC are required for building gcc (if you don't download prerequisites, see GLOBAL_DOWNLOAD_PREREQUISITES), flex and bison for building MiNTlib.


Use Macports and install:


Before running the script it is advised to open it and go through the "User definable stuff" settings. In brief they are:


Set this to A if you want a completely automated run.


Set this to 1 to build Fortran, anything else to skip building Fortran.


Set this to 1 to download prerequisite libs such as MPC and MPFR automatically (without having to install them on the host machine) via the contrib/download_prerequisites script inside each gcc. Not tested extensively but it seems to work with gcc 4.6.4.


Which gccs to build. 1=Build, anything else=Don't build. Can be toggled individually.


Only set this to nonzero when you do want to build mintlib. Note that if you don't build mintlib then libstdc++v3 will also fail to build, so you are advised to keep this on.


The actual names of the compilers used to build our set of gccs. The names aretuned for ubuntu 17.10 so your mileage may vary!

Also you might be able to build all gcc versions using one compiler. In Ubuntu 17.10 so many problems were encountered in Ubuntu (including Internal Compiler Errors) that this is now in full pendantic mode. Again, your mileage may vary!


At first this sounds redundant given that the script produces a cross compiler to begin with. This setting should be enabled if the cross compiler is not going to be executed in a different platform than it is built.

For example: We want to build a 68k cross compiler on a x86 PC that will execute on an ARM processor.


Where the compiler(s) will be installed. Defaults to ${HOME}/brown. Take care that you don't choose a path that requires root privileges. (In this case you will need to run the script as root)

Other notes

The script will install things to INSTALL_PREFIX and might need root privileges. Also it'll use $JMULT cores while building. If this is not to your liking then edit this script and change INSTALL_PREFIX to the path you would like to install to (including home folder) and SUDO to nothing if you don't need root rights. Also JMULT for number of build cores. Examples are inside the script's comments. Log files are written inside each build folder for each version of gcc built. So for example there's build-binutils-2.38/binutils_configure.log``, build-gcc-12.1.0/gcc_build.log``` and so on.


Inside the folder barebones there exist test projects to verify that your gcc installation is sane. Just type make on installations that have make installed or run build.bat under Windows (especially if you built the toolchain(s) using MinGW).

There is also a different example in the folder barebones-interop. This illustrates how to set up a project to work with C and assembly. Consult the inside that folder for more information.

This is a work-in-progress script. Currently it cannot build GEMlib properly. Patches welcome!

This is a work-in-progress script. Currently it cannot build GEMlib properly. Patches welcome!

Note for MinGW users

Be warned that the compilation can take a very very VERY long time! If you can spare the RAM, we really recommend using a RAM drive! Our tests have shown that imdisk ( works fine. Of course take notice that you're doing this on your own, we won't accept any liability if something goes wrong with that!!!!

Building the "barebones" examples

Download and build Brownout ( / and place it in the barebones directory.

If you have a command prompt that is able to run make (e.g. Linux, Cygwin, MinGW etc) then just type make (make sure your build cross gcc is in the PATH). Otherwise on Windows you can just run build.bat (edit GCCPATH to point to your toolchain path first).

Note that this will build only for the latest supported cross gcc version. For older versions, some simple find and replaces should be enough.


The bulk of the script was written by George 'GGN' Nakos, with enhancements from:

  • Douglas 'DML' Little
  • Patrice 'PMANDIN' Mandin
  • Troed 'TROED' Sångberg


No description, website, or topics provided.






No releases published


No packages published