Update known-issues.md (#3240)
Add updated information to the known issues document about the oh-my-zsh problem and how to solve it. skip ci please Fixes #3063, #1567
This commit is contained in:
parent
8ffba3c029
commit
763be30c08
1 changed files with 7 additions and 7 deletions
|
@ -22,20 +22,21 @@ sudo port -f uninstall openssl @0.9.8
|
|||
You can verify whether you have the right version using the `openssl version` command from the Terminal.
|
||||
|
||||
## Users of zsh (z shell) don't get `dotnet` on the path after install
|
||||
There is a problem with the way `path_helper` interacts with `zsh` which makes `dotnet` not appear on the path even though
|
||||
the install places the file properly in the `/etc/paths.d/` directory.
|
||||
There is a known issue in oh-my-zsh installer that interferes with how `path_helper` works on OS X systems. In short,
|
||||
the said installer creates a `.zshrc` file which contains the exploded path at the time of installation. This clobbers
|
||||
any dynamically generated path, such as the one generated by `path_helper`.
|
||||
|
||||
**Issues tracking this:**
|
||||
There is an [outstanding PR](https://github.com/robbyrussell/oh-my-zsh/pull/4925) on the oh-my-zsh repo for this.
|
||||
|
||||
* [#1567](https://github.com/dotnet/cli/issues/1567)
|
||||
|
||||
**Workaround:** symlink the `dotnet` binary in the installation directory to a place in the global path, e.g. `/usr/local/bin`.
|
||||
**Workaround 1:** symlink the `dotnet` binary in the installation directory to a place in the global path, e.g. `/usr/local/bin`.
|
||||
The command you can use is:
|
||||
|
||||
```console
|
||||
ln -s /usr/local/share/dotnet/dotnet /usr/local/bin
|
||||
```
|
||||
|
||||
**Workaround 2:** edit your `.zshrc` and/or `.zshprofile` files to add the `/usr/local/share/dotnet` to the $PATH.
|
||||
|
||||
## On dev builds of the tools, restoring default project from dotnet new fails
|
||||
When using non-release versions of the CLI, `dotnet restore` will fail to restore `Microsoft.NETCore.App` because for that particular version it exists on a NuGet feed that is not configured on the machine. This behavior is by design and does not happen with public releases (such as RC2).
|
||||
|
||||
|
@ -104,4 +105,3 @@ get information and get unblocked.
|
|||
# What is a "known issue"?
|
||||
A "known issue" is a major issue that block users in doing their everyday tasks and that affect all or
|
||||
most of the commands in the CLI tools. If you want to report or see minor issues, you can use the [issues list](https://github.com/dotnet/cli/issues).
|
||||
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue