Add Cygwin support (#594)

* Add Cygwin support

* revert .gitignore changes

* Add Cygwin instructions

* corrections

* specify dependencies in README.md

1 files changed, 42 insertions, 0 deletions

diff --git a/docs/BUILDING_BINUTILS_CYGWIN.md b/docs/BUILDING_BINUTILS_CYGWIN.md
new file mode 100644
index 000000000..31fbdfe6c
--- /dev/null
+++ b/docs/BUILDING_BINUTILS_CYGWIN.md
@@ -0,0 +1,42 @@
+# Building mips-linux-binutils on Windows using Cygwin
+
+First, you will need to install the following packages using the Cygwin installer:
+- make
+- gcc-g++
+- bison
+- flex
+- texinfo
+- binutils (Make sure to check the "Src?" checkbox since we're interested in the source code. Once the download is finished, you will find it in `/usr/src/`)
+
+Create destination dir for binutils
+```bash
+sudo mkdir -p /opt/cross
+```
+Extract binutils source
+```bash
+cd /usr/src/binutils-[...].src/
+tar xjf binutils-[...].tar.bz2
+```
+
+Create and enter build dir
+```bash
+mkdir build-binutils
+cd build-binutils
+```
+
+Configure the build
+```bash
+../binutils-gdb/configure --target=mips-linux-gnu --prefix=/opt/cross --disable-gprof --disable-nls --disable-werror --disable-gdb --disable-libdecnumber --disable-readline --disable-sim
+```
+
+Make and install binutils
+```bash
+make -j
+sudo make install -j
+```
+
+Add the new binutils binaries to your system PATH:
+
+You can do that by adding `PATH=$PATH:/opt/cross/bin` to `~/.bashrc` and then reloading `~/.bashrc`.
+
+Alternatively you can edit the `Path` variable in `Edit the system environment variables`>`Environment Variables` (in which case you will need to relaunch your terminal).