From 87a6e752429a7821ae81dcf8bffc6cdf13803084 Mon Sep 17 00:00:00 2001 From: cadmic Date: Tue, 7 May 2024 08:52:18 -0700 Subject: [PATCH] Remove Cygwin support (#1951) --- README.md | 2 +- docs/BUILDING_CYGWIN.md | 79 ----------------------------------------- 2 files changed, 1 insertion(+), 80 deletions(-) delete mode 100644 docs/BUILDING_CYGWIN.md diff --git a/README.md b/README.md index 27972882f9..be57ba77cf 100644 --- a/README.md +++ b/README.md @@ -55,7 +55,7 @@ For Windows 10 or 11, install WSL and a distribution by following this [WSL Installation Guide](https://docs.microsoft.com/en-us/windows/wsl/install). We recommend using Ubuntu 20.04 as the Linux distribution. -For older versions of Windows, install a Linux VM or refer to either [Cygwin](docs/BUILDING_CYGWIN.md) or [Docker](docs/BUILDING_DOCKER.md) instructions. +For older versions of Windows, install a Linux VM or refer to [Docker](docs/BUILDING_DOCKER.md) instructions. ### Linux (Native or under WSL / VM) diff --git a/docs/BUILDING_CYGWIN.md b/docs/BUILDING_CYGWIN.md deleted file mode 100644 index c29d9acf64..0000000000 --- a/docs/BUILDING_CYGWIN.md +++ /dev/null @@ -1,79 +0,0 @@ -# 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. 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 -```