Updated readme to unclutter top with bash upgrade

This commit is contained in:
emizzle 2018-09-18 10:27:29 +10:00
parent 10b706f7c1
commit dda49aa680
2 changed files with 17 additions and 15 deletions

View File

@ -13,21 +13,7 @@ run_embark
Note that the `run_embark demo` command will create an `embark_demo` directory in Note that the `run_embark demo` command will create an `embark_demo` directory in
the docker host's `$PWD`. the docker host's `$PWD`.
Note if you receive the error `ERROR: this script requires Bash version >= 4.0` on macOS, follow the steps below: Note if you're a macOS user and see `ERROR: this script requires Bash version >= 4.0`, please follow our [Bash upgrade instructions](./macOS-bash4-upgragde.md).
1. Install HomeBrew (if not already installed):
`ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"`
2. Update homebrew packet database and install bash:
`brew update && brew install bash`
3. Change your application to use the correct shell. For example, in Terminal, open Preferences, then change "Shells open with:" to "/usr/local/bin/bash":
![Terminal preferences](https://i.imgur.com/vDWQfO7.png)
In iTerm2, change Preferences > Profiles > (Select profile) > General > Command > Command to `/usr/local/bin/bash`:
![iTerm2 preferences](https://i.imgur.com/zUZE663.png)
4. `bash --version` should show version 4+:
`$ bash --version`
`GNU bash, version 4.4.23(1)-release (x86_64-apple-darwin17.5.0)
Copyright (C) 2016 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>`
5. There is a [guide to upgrading to bash 4 in macOS](http://clubmate.fi/upgrade-to-bash-4-in-mac-os-x/) if you need more help.
## Usage via `run.sh` ## Usage via `run.sh`

16
macOS-bash4-upgragde.md Normal file
View File

@ -0,0 +1,16 @@
# macOS Bash v4 Upgrade Instructions
When using the `run_embark <cmd>` commands, you receive the error `ERROR: this script requires Bash version >= 4.0` on macOS, follow the steps below to upgrade bash to v4:
1. Install HomeBrew (if not already installed):
`ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"`
2. Update HomeBrew packet database and install bash:
`brew update && brew install bash`
3. Change your application to use the correct shell. For example, in Terminal, open Preferences, then change *Shells open with:* to `/usr/local/bin/bash`:
![Terminal preferences](https://i.imgur.com/vDWQfO7.png)
In iTerm2, change *Preferences > Profiles > (Select profile) > General > Command > Command* to `/usr/local/bin/bash`:
![iTerm2 preferences](https://i.imgur.com/zUZE663.png)
4. `bash --version` should show version 4+:
`$ bash --version`
`GNU bash, version 4.4.23(1)-release (x86_64-apple-darwin17.5.0)
Copyright (C) 2016 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>`
5. There is a [guide to upgrading to bash 4 in macOS](http://clubmate.fi/upgrade-to-bash-4-in-mac-os-x/) if you need more help.