Update Homebrew documentation (#3949)

With Homebrew 2.6.0:

> All brew cask commands have been deprecated in favour of brew commands (with --cask) when necessary. 

See https://brew.sh/2020/12/01/homebrew-2.6.0/.

Also, removed mention of openrefine-dev cask as this facility does not appear to be in use.
This commit is contained in:
Joe Wicentowski 2021-06-16 04:28:06 -04:00 committed by GitHub
parent 3fd686c5b9
commit e00c4280b9
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -111,30 +111,29 @@ Once you have downloaded the `.dmg` file, open it and drag the OpenRefine icon o
The quick version: The quick version:
1. Install [Homebrew](http://brew.sh) 1. Install [Homebrew](http://brew.sh)
2. In Terminal enter ` brew cask install openrefine` 2. In Terminal enter `brew install openrefine`
1. Then find OpenRefine in your Applications folder. 1. Then find OpenRefine in your Applications folder.
The long version: The long version:
[Homebrew](http://brew.sh) is a popular command-line package manager for Mac. Installing Homebrew is accomplished by pasting the installation command on the Homebrew website into a Terminal window. Once Homebrew is installed, applications like OpenRefine can be installed via a simple command. You can [install Homebrew from their website](http://brew.sh). [Homebrew](https://brew.sh) is a popular command-line package manager for Mac. Installing Homebrew is accomplished by pasting the installation command on the Homebrew website into a Terminal window. Once Homebrew is installed, applications like OpenRefine can be installed via a simple command. You can [install Homebrew from their website](https://brew.sh).
###### Install {#install} ###### Install {#install}
Install OpenRefine with this command: Install OpenRefine with this command:
``` ```
brew cask install openrefine brew install openrefine
``` ```
You should see output like this: You should see output like this:
``` ```
==> Downloading https://github.com/OpenRefine/OpenRefine/releases/download/2.7/openrefine-mac-2.7.dmg ==> Downloading https://github.com/OpenRefine/OpenRefine/releases/download/3.4.1/openrefine-mac-3.4.1.dmg
########################### 100.0% ######################################################################## 100.0%
==> Verifying checksum for Cask openrefine ==> Installing Cask openrefine
==> Installing Cask openrefine ==> Moving App 'OpenRefine.app' to '/Applications/OpenRefine.app'
==> Moving App 'OpenRefine.app' to '/Applications/OpenRefine.app'. 🍺 openrefine was successfully installed!
🍺 openrefine was successfully installed!
``` ```
Behind the scenes, this command causes Homebrew to download the OpenRefine installer, verify the files authenticity (using a SHA-256 checksum), mount the disk image, copy the `OpenRefine.app` application bundle into the Applications folder, unmount the disk image, and save a copy of the installer and metadata about the installation for future use. Behind the scenes, this command causes Homebrew to download the OpenRefine installer, verify the files authenticity (using a SHA-256 checksum), mount the disk image, copy the `OpenRefine.app` application bundle into the Applications folder, unmount the disk image, and save a copy of the installer and metadata about the installation for future use.
@ -146,39 +145,40 @@ If an existing `OpenRefine.app` is found in the Applications folder, Homebrew wi
To uninstall OpenRefine, paste this command into the Terminal: To uninstall OpenRefine, paste this command into the Terminal:
``` ```
brew cask uninstall openrefine brew uninstall openrefine
``` ```
You should see output like this: You should see output like this:
``` ```
==> Removing App '/Applications/OpenRefine.app'. ==> Uninstalling Cask openrefine
==> Backing App 'OpenRefine.app' up to '/usr/local/Caskroom/openrefine/3.4.1/OpenRefine.app'
==> Removing App '/Applications/OpenRefine.app'
==> Purging files for version 3.4.1 of Cask openrefine
``` ```
###### Update {#update} ###### Update {#update}
To update to the latest version of OpenRefine, paste this command into the Terminal: To update to the latest version of OpenRefine, paste these two commands into the Terminal:
``` ```
brew cask reinstall openrefine brew update
brew upgrade
``` ```
You should see output like this: You should see output like this:
``` ```
==> Downloading https://github.com/OpenRefine/OpenRefine/releases/download/2.7/openrefine-mac-2.7.dmg ==> Upgrading 1 outdated package:
########################### 100.0% openrefine 3.4.0-> 3.4.1
==> Verifying checksum for Cask openrefine ==> Upgrading openrefine
==> Removing App '/Applications/OpenRefine.app'. ==> Downloading https://github.com/OpenRefine/OpenRefine/releases/download/3.4.1/openrefine-mac-3.4.1.dmg
==> Moving App 'OpenRefine.app' to '/Applications/OpenRefine.app'. ######################################################################## 100.0%
🍺 openrefine was successfully installed! ==> Backing App 'OpenRefine.app' up to '/usr/local/Caskroom/openrefine/3.4.0/OpenRefine.app'
``` ==> Removing App '/Applications/OpenRefine.app'
==> Installing Cask openrefine
If you had previously installed the `openrefine-dev` cask (containing a release candidate) and you want to move to the stable release, you need to first uninstall the old cask and then install the new one: ==> Moving App 'OpenRefine.app' to '/Applications/OpenRefine.app'
🍺 openrefine was successfully upgraded!
```
brew cask uninstall openrefine-dev
brew cask install openrefine
``` ```
</TabItem> </TabItem>