mirror of
https://github.com/zeldaret/oot.git
synced 2024-12-01 15:26:01 +00:00
5b0f79ec6e
* update readme * fixes * update permissions for various things * typos
87 lines
2.4 KiB
Markdown
87 lines
2.4 KiB
Markdown
# Building with Cygwin
|
|
|
|
If you want to use Cygwin, you will need to:
|
|
|
|
|
|
## 1. Install Cygwin (and required packages)
|
|
|
|
* Download and install [Cygwin](https://cygwin.com).
|
|
|
|
Run the installer and follow the steps to install a cygwin terminal.
|
|
|
|
After the "choose a download site" step, a window will pop up which will allow you to select packages.
|
|
Unlike a normal linux distribution, you must install packages from this interface within the setup program.
|
|
To install a package you can change View from "Pending" to "Full".
|
|
Then you can enter a package name to search. After finding the package you want, change the "Skip" drop down
|
|
to the version you want to install.
|
|
|
|
Use this interface to select the latest version for all of the following packages:
|
|
* make
|
|
* gcc-g++
|
|
* bison
|
|
* flex
|
|
* texinfo
|
|
* git
|
|
* libiconv
|
|
* dos2unix
|
|
* python3
|
|
* libpng-devel
|
|
* binutils (Make sure to check the "Src?" checkbox since we're interested in the source code)
|
|
|
|
## 2. Build mips-linux-binutils on Windows using Cygwin
|
|
For the following instructions, wherever you see `binutils-[...]`, the [...] represents the version number.
|
|
You can use tab auto-complete to fill this in.
|
|
|
|
Create destination dir for binutils
|
|
```bash
|
|
mkdir -p /opt/cross
|
|
```
|
|
|
|
Extract binutils source
|
|
```bash
|
|
cd /usr/src/binutils-[...].src/
|
|
tar -xf binutils-[...].tar.xz
|
|
```
|
|
|
|
Create and enter build dir
|
|
```bash
|
|
mkdir build-binutils
|
|
cd build-binutils
|
|
```
|
|
|
|
Configure the build
|
|
```bash
|
|
../binutils-[...]/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
|
|
make install -j
|
|
```
|
|
|
|
Add the new binutils binaries to your system PATH:
|
|
- Go to your home directory `cd`
|
|
- Open windows explorer in your current location `explorer.exe .`
|
|
- Open the `.bashrc` file in a text editor
|
|
- Scroll to the bottom and add `PATH=$PATH:/opt/cross/bin` to a new line and save the file
|
|
- Run `source .bashrc` or close and reopen cygwin
|
|
|
|
## 3. Install required Python packages
|
|
|
|
To install the Python dependencies simply run in a terminal:
|
|
|
|
```bash
|
|
python3 -m pip install colorama
|
|
```
|
|
|
|
## 4. Continue with Linux instructions
|
|
|
|
You should be able to continue from step [step 2](../README.md#2-clone-the-repository) of the Linux instructions.
|
|
|
|
**N.B.** Before building anything, you will need to run the following commands to fix line endings:
|
|
|
|
```bash
|
|
dos2unix fixle.sh
|
|
./fixle.sh
|
|
```
|