mirrors/dotnet-installer
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

Merge pull request #644 from blackdwarf/isspage

Browse source 
Add a "Known issues" page to Documentation
This commit is contained in:
Zlatko Knezevic 2016-01-13 14:12:42 -08:00
commit c8421dd414
2 changed files with 67 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

62
Documentation/known-issues.md Normal file
View file

@ -0,0 +1,62 @@
Known issues & workarounds
==========================
## El Capitan support
If you try to use the `dotnet` commands on El Capitan (OS X 10.11), you will encounter errors as it is not currently
fully supported for all scenarios.
**Issues tracking this:**
* [#498](https://github.com/dotnet/cli/issues/498)
* [#291](https://github.com/dotnet/cli/issues/291)
**Affects:** most of the commands, but more than likely you will not be able to
use `dotnet compile` and `dotnet-run` on El Capitan. For others, there is a
workaround.
**Workaround:** use the --runtime switch with the value of `osx.10.11-x64` in
`dotnet restore` and `dotnet publish` and you will be able to run your app from
the published directory.
## Resolving the Standard library packages
The StdLib package is on a MyGet feed. In order to restore it, a MyGet feed needs to be added
to the NuGet feeds, either locally per application or in a central location.
**Issues tracking this:**
* [#535](https://github.com/dotnet/cli/issues/535)
**Affects:** `dotnet restore`
**Workaround:** update to the latest bits and run `dotnet new` in an empty directory. This will
now drop a `nuget.config` file that you can use in other applications.
If you cannot update, you can use the following `nuget.config`:
```xml
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<packageSources>
<!--To inherit the global NuGet package sources remove the <clear/> line below -->
<clear />
<add key="dotnet-core" value="https://www.myget.org/F/dotnet-core/api/v3/index.json" />
<add key="api.nuget.org" value="https://api.nuget.org/v3/index.json" />
</packageSources>
</configuration>
```
## Uninstalling/reinstalling the PKG on OS X
OS X doesn't really have an uninstall capacity for PKGs like Windows has for
MSIs. There is, however, a way to remove the bits as well as the "recipe" for
dotnet. More information can be found on [this SuperUser question](http://superuser.com/questions/36567/how-do-i-uninstall-any-apple-pkg-package-file).
# What is this document about?
This document outlines the known issues and workarounds for the current state of
the CLI tools. Issues will also have a workaround and affects sections if necessary. You can use this page to
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).

5
README.md
View file

@ -76,6 +76,11 @@ If you are building from source, take note that the build depends on NuGet packa
Also, when building from source, you need to set up the `DOTNET_HOME` environment variable. It needs to point to the parent directory of where `bin` and `runtime` directories are.
Known issues
------------
You can also consult the [known issues page](Documentation/known-issues.md) to find out the current issues and
to see the workarounds.
Questions & Comments
--------------------