Skip to content

Latest commit

 

History

History
executable file
·
90 lines (81 loc) · 3.52 KB

GitBash.md

File metadata and controls

executable file
·
90 lines (81 loc) · 3.52 KB

Git Bash for Windows Users

  • Apple macOS: If you are using Apple macOS, you don't need to read nor do any of the following.
  • Microsoft Windows: If you are using Microsoft Windows, there is a good chance you don't have a make command already installed on your PC. The gist is we have you: install MSYS2, install make in MSYS2, add paths to Environment Variables, install Git Bash, then use Git Bash as a more empowered POSIX-like substitute for CMD.EXE and you can enjoy every aspect of Pronouns2.

Understanding the Terminology

  • Git for Windows: The complete software package that includes both Git and Unix tools for Windows
  • Git Bash: A terminal emulator (git-bash.exe) included with Git for Windows that provides a Unix-like command interface
  • git-cmd.exe: A Windows command prompt that adds Git to the PATH but uses Windows commands
  • GNU Bash: The actual shell program running inside Git Bash (current version 5.2.37)

Why Git Bash?

We recommend Git Bash because it:

  • Provides a Unix-like environment that works well with Windows
  • Includes Git and essential Unix tools in one installation
  • Can be enhanced with additional tools through MSYS2
  • Maintains compatibility with Windows commands and paths

Other options like MinGW, Cygwin, or WSL require more complex setup or provide more functionality than Pronouns2 needs.

Step-by-Step Setup Guide

1. Requirements

  • MSYS2 requires 64 bit Windows 10 or newer.
  • Git for Windows requires Windows 8.1 or later on i686 and x86_64 CPU architectures.
  • Git for Windows requires Windows 11 on ARM64 CPU architecture.

2. Install MSYS2:

  • Visit https://www.msys2.org
  • Download the installer (e.g., msys2-x86_64-20241208.exe).
  • Run the installer.
  • You may need to click through a Windows SmartScreen:
    • A popup says "Windows protected your PC / Microsoft Defender SmartScreen".
    • Click "More info" beneath the message.
    • Click "Run anyway" button.
  • Use default installation options.
  • Let it launch MSYS2 when finished

3. Install make in MSYS2:

  • In the MSYS2 console (UCRT64) that opens, run these commands: 
    pacman -Syu
pacman -S mingw-w64-x86_64-make
  • Type Y when prompted to proceed with installation.

4. Add MSYS2 to Windows PATH:

  • Quick path: Windows key + Start typing environment variables.
  • Either:
    • Windows 10-11: Settings → System → About → Advanced system settings
    • Windows 10: Control Panel → System and Security → System → Advanced system settings
  • Click Environment Variables.
  • Under System variables, find and edit Path.
  • Add these two new paths: 
    C:\msys64\mingw64\bin
C:\msys64\usr\bin

5. Install Git Bash:

  • Visit https://gitforwindows.org/.
  • Download the installer (e.g., Git-2.47.1-64-bit.exe).
  • Close and reopen Git Bash if it was already open.
  • Navigate to Pronouns2 using cd commands. (e.g., cd /c/Pronouns2)
  • Run Pronouns2 project make commands in Git Bash as needed.