Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Homebrew to install docs #3838

Merged
merged 5 commits into from
Aug 7, 2017
Merged

Conversation

joeyaiello
Copy link
Contributor

Fixes #1779

It would be awesome if someone who actually has a Mac (like @JamesWTruher or @BrucePay) can validate these instructions before we merge them.

Also, it would be great to know how accurate these directions currently are. The reference to .NET Core 1.0.0 makes me think it might be a little outdated.

If you PowerShell with Homebrew, uninstallation is easy:

```sh
brew uninstall powershell
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i needed to do brew cask uninstall powershell

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed.


```sh
brew update
brew upgrade powershell
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i don't think these are right - they're not working for me. I get an error message:

brew upgrade powershell
Error: No available formula with the name "powershell" 

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about brew cask upgrade powershell?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

brew cask reinstall powershell

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wait, reinstall is the upgrade command?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, interesting...thanks for the pointer. Looks like that's the way to go now. I'm updating the docs accordingly.

@mirichmo mirichmo self-assigned this May 24, 2017
@SteveL-MSFT SteveL-MSFT removed their request for review June 1, 2017 16:37
Just install [Homebrew-Cask][cask] and then you can install PowerShell:

```sh
brew tap caskroom/cask
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This line is installation instruction for cask.
It's not clear from the comment that these two lines correspond to two steps above.

I'd break it down into two parts.

@@ -352,9 +379,14 @@ sudo installer -pkg powershell-6.0.0-beta.1-osx.10.12-x64.pkg -target /

### Uninstallation - macOS 10.12

PowerShell on MacOS must be removed manually.
If you PowerShell with Homebrew, uninstallation is easy:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe If you PowerShell installed with Homebrew ? Not an English expert, but this language feels too playful :)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hahahaha, I just accidentally a word.


Also install [Homebrew's OpenSSL][openssl]:
The easiest fix is to install [Homebrew's OpenSSL][openssl]:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is auto-included in powershell brew formula (it's a dependency I think)
Worth pointing out here that it's not required as a separate step with brew.

@mirichmo
Copy link
Member

mirichmo commented Jun 6, 2017

@joeyaiello Don't forget about this one

@joeyaiello
Copy link
Contributor Author

joeyaiello commented Jun 6, 2017

@mirichmo I hadn't! I just didn't realize anyone had responded yet. It's hard for me to get this one right because I don't actually have a Mac....

@mirichmo
Copy link
Member

@vors - Are all your concerns addressed?

@joeyaiello
Copy link
Contributor Author

@mirichmo sorry, this is on me. I've been meaning to grab the Macbook from @daxian-dbw, gotta do my validation real quick.

@joeyaiello
Copy link
Contributor Author

Okay, sorry for taking so long on this. @mirichmo: it should be good to go now. I validated all the instructions on a Macbook. :)

@mirichmo
Copy link
Member

@vors Do you have any additional comments or concerns?

@jpogran
Copy link

jpogran commented Jul 11, 2017

FWIW, followed these instructions on macOS 10.12.5 with homebrew and cask and it worked for me

@joeyaiello
Copy link
Contributor Author

@mirichmo I think I have enough approval (and have adequately addressed @vors' concerns).

@mirichmo mirichmo merged commit 487159d into PowerShell:master Aug 7, 2017
@joeyaiello joeyaiello deleted the HomebrewDocs branch August 8, 2017 01:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Area-Maintainers-Documentation specific to documentation in this repo
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants