MS2/Extra source code building
==============================

First - be sure you have read and understood LICENSE-SOURCE.txt and LICENSE.txt
within the source. 

WINDOWS
=======
Cygwin is required.
Go to http://www.cygwin.com/ and download and install. Be sure to include
development packages such as 'make' and 'tar'

Note - all building of the MS2/Extra code is from the commandline.

S12X build tools (gcc/binutils) are required.
Go to http://www.msextra.com/tools/ download and extract the Windows binaries
package. Then follow the included README.
Once extracted, the binaries will be in /usr/bin for Cygwin.

To edit source files, use a text editor (not a word processor.) Don't try to
use Notepad as it lacks many features needed for code development. Perhaps try
vim, gedit, notepad+

LINUX
=====
Note - all building of the MS2/Extra code is from the commandline.

S12X build tools (gcc/binutils) are required.
Go to http://www.msextra.com/tools/ download and extract the Linux binaries
package. Then follow the included README.
Once extracted, the binaries will be in /usr/bin

To edit source files, use a text editor (not a word processor.)

MAC
===
A pre-built toolchain is not provided at this time. Try the source.

GENERAL build notes
===================
To build MS2/Extra code for MS2 type 'make' in the ms2extra source directory,
this will generate a new 'ms2_extra.s19'

To build MS2/Extra code for Microsquirt or Microsquirt module type
'make us' in the ms2extra source directory, this will generate a new
'ms2_extra_us.s19'

After major changes or when changing between 'ms2' and 'us' build options be
sure to run 'make clean'

Having built your new s19, make sure that the downloader is seeing it.
Typically you will copy the new s19 to the same directory as the downloader.
(e.g. cp *s19 ..)

12 November 2011
