From 67fadbfc1f850d2b5a0a1e7000d41b5fb5173750 Mon Sep 17 00:00:00 2001 From: Mike McQuaid Date: Sat, 26 Jan 2019 19:28:56 +0000 Subject: [PATCH] Update installation and Linuxbrew documentation Update for the pending 2.0.0 release which will support Linux. --- docs/Installation.md | 17 +++++++++-------- docs/Linuxbrew.md | 8 ++++---- 2 files changed, 13 insertions(+), 12 deletions(-) diff --git a/docs/Installation.md b/docs/Installation.md index 5e4b64c94c..ea63cb6ef1 100644 --- a/docs/Installation.md +++ b/docs/Installation.md @@ -1,26 +1,27 @@ # Installation -The suggested and easiest way to install Homebrew is on the +The supported and best way to install Homebrew is on the [homepage](https://brew.sh). -The standard script installs Homebrew to `/usr/local` so that +This script installs Homebrew to `/usr/local` so that [you don’t need sudo](FAQ.md#why-does-homebrew-say-sudo-is-bad) when you `brew install`. It is a careful script; it can be run even if you have stuff installed to `/usr/local` already. It tells you exactly what it will do before -it does it too. And you have to confirm everything it will do before it starts. +it does it too. You have to confirm everything it will do before it starts. -## Requirements +## macOS Requirements * An 64-bit Intel CPU [1](#1) -* macOS 10.12 or higher [2](#2) +* macOS 10.12 (or higher) [2](#2) * Command Line Tools (CLT) for Xcode: `xcode-select --install`, [developer.apple.com/downloads](https://developer.apple.com/downloads) or [Xcode](https://itunes.apple.com/us/app/xcode/id497799835) [3](#3) -* A Bourne-compatible shell for installation (e.g. bash or zsh) [4](#4) +* A Bourne-compatible shell for installation (e.g. `bash` or `zsh`) [4](#4) ## Alternative Installs -### OS X Mountain Lion (10.8) and below -Because GitHub now only allows clients that support TLS 1.2 to access repositories over HTTPS, the Homebrew installer will use the Git protocol when run on systems older than OS X Mavericks (10.9). This requires the availability of a `git` binary, which can be provided by pre-installing the [Command Line Tools for Xcode](https://developer.apple.com/download/more/). Homebrew will also require the Command Line Tools or Xcode in order to automatically compile and install a newer `curl` and `git` with support for TLS 1.2. +### Linux or Windows 10 Subsystem for Linux + +Check out [the Linuxbrew installation documentation](Linuxbrew.md). ### Untar anywhere Just extract (or `git clone`) Homebrew wherever you want. Just avoid: diff --git a/docs/Linuxbrew.md b/docs/Linuxbrew.md index 87a9de9038..326bbdb514 100644 --- a/docs/Linuxbrew.md +++ b/docs/Linuxbrew.md @@ -2,7 +2,7 @@ # Linuxbrew -The Homebrew package manager may be used on Linux and Windows 10, using [Windows Subsystem for Linux (WSL)](https://docs.microsoft.com/en-us/windows/wsl/about). Homebrew is referred to as Linuxbrew when running on Linux or Windows. It can be installed in your home directory, in which case it does not use *sudo*. Linuxbrew does not use any libraries provided by your host system, except *glibc* and *gcc* if they are new enough. Linuxbrew can install its own current versions of *glibc* and *gcc* for older distribution of Linux. +The Homebrew package manager may be used on Linux and Windows 10, using [Windows Subsystem for Linux (WSL)](https://docs.microsoft.com/en-us/windows/wsl/about). Homebrew is referred to as Linuxbrew when running on Linux or WSL. It can be installed in your home directory, in which case it does not use *sudo*. Linuxbrew does not use any libraries provided by your host system, except *glibc* and *gcc* if they are new enough. Linuxbrew can install its own current versions of *glibc* and *gcc* for older distributions of Linux. [Features](#features), [dependencies](#dependencies) and [installation instructions](#install) are described below. Terminology (e.g. the difference between a Cellar, Tap, Cask and so forth) is [explained in the documentation](Formula-Cookbook.md#homebrew-terminology). @@ -40,12 +40,12 @@ brew install hello If you're using an older distribution of Linux, installing your first package will also install a recent version of `glibc` and `gcc`. Use `brew doctor` to troubleshoot common issues. -## Dependencies +## Linux/WSL Requirements + **GCC** 4.4 or newer + **Linux** 2.6.32 or newer + **Glibc** 2.12 or newer -+ **64-bit x86** CPU ++ **64-bit x86_64** CPU Paste at a terminal prompt: @@ -71,7 +71,7 @@ Linuxbrew does not currently support 32-bit x86 platforms. It would be possible ## Alternative Installation -Extract or `git clone` Linuxbrew wherever you want. Use `/home/linuxbrew/.linuxbrew` if possible. +Extract or `git clone` Linuxbrew wherever you want. Use `/home/linuxbrew/.linuxbrew` if possible (to enabled the use of binary packages). ```sh git clone https://github.com/Homebrew/brew ~/.linuxbrew/Homebrew