Merge branch 'release/2.1.3xx' into merges/release/2.1.2xx-to-release/2.1.3xx

.editorconfig

@@ -0,0 +1,149 @@
+# editorconfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Default settings:
+# A newline ending every file
+# Use 4 spaces as indentation
+[*]
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+
+[project.json]
+indent_size = 2
+
+# C# files
+[*.cs]
+# New line preferences
+csharp_new_line_before_open_brace = all
+csharp_new_line_before_else = true
+csharp_new_line_before_catch = true
+csharp_new_line_before_finally = true
+csharp_new_line_before_members_in_object_initializers = true
+csharp_new_line_before_members_in_anonymous_types = true
+csharp_new_line_within_query_expression_clauses = true
+
+# Indentation preferences
+csharp_indent_block_contents = true
+csharp_indent_braces = false
+csharp_indent_case_contents = true
+csharp_indent_switch_labels = true
+csharp_indent_labels = flush_left
+
+# avoid this. unless absolutely necessary
+dotnet_style_qualification_for_field = false:suggestion
+dotnet_style_qualification_for_property = false:suggestion
+dotnet_style_qualification_for_method = false:suggestion
+dotnet_style_qualification_for_event = false:suggestion
+
+# only use var when it's obvious what the variable type is
+csharp_style_var_for_built_in_types = false:none
+csharp_style_var_when_type_is_apparent = false:none
+csharp_style_var_elsewhere = false:suggestion
+
+# use language keywords instead of BCL types
+dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
+dotnet_style_predefined_type_for_member_access = true:suggestion
+
+# name all constant fields using PascalCase
+dotnet_naming_rule.constant_fields_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.constant_fields_should_be_pascal_case.symbols  = constant_fields
+dotnet_naming_rule.constant_fields_should_be_pascal_case.style    = pascal_case_style
+
+dotnet_naming_symbols.constant_fields.applicable_kinds   = field
+dotnet_naming_symbols.constant_fields.required_modifiers = const
+
+dotnet_naming_style.pascal_case_style.capitalization = pascal_case
+
+# internal and private fields should be _camelCase
+dotnet_naming_rule.camel_case_for_private_internal_fields.severity = suggestion
+dotnet_naming_rule.camel_case_for_private_internal_fields.symbols  = private_internal_fields
+dotnet_naming_rule.camel_case_for_private_internal_fields.style    = camel_case_underscore_style
+
+dotnet_naming_symbols.private_internal_fields.applicable_kinds = field
+dotnet_naming_symbols.private_internal_fields.applicable_accessibilities = private, internal
+
+dotnet_naming_style.camel_case_underscore_style.required_prefix = _
+dotnet_naming_style.camel_case_underscore_style.capitalization = camel_case 
+
+# Code style defaults
+dotnet_sort_system_directives_first = true
+csharp_preserve_single_line_blocks = true
+csharp_preserve_single_line_statements = false
+
+# Expression-level preferences
+dotnet_style_object_initializer = true:suggestion
+dotnet_style_collection_initializer = true:suggestion
+dotnet_style_explicit_tuple_names = true:suggestion
+dotnet_style_coalesce_expression = true:suggestion
+dotnet_style_null_propagation = true:suggestion
+
+# Expression-bodied members
+csharp_style_expression_bodied_methods = false:none
+csharp_style_expression_bodied_constructors = false:none
+csharp_style_expression_bodied_operators = false:none
+csharp_style_expression_bodied_properties = true:none
+csharp_style_expression_bodied_indexers = true:none
+csharp_style_expression_bodied_accessors = true:none
+
+# Pattern matching
+csharp_style_pattern_matching_over_is_with_cast_check = true:suggestion
+csharp_style_pattern_matching_over_as_with_null_check = true:suggestion
+csharp_style_inlined_variable_declaration = true:suggestion
+
+# Null checking preferences
+csharp_style_throw_expression = true:suggestion
+csharp_style_conditional_delegate_call = true:suggestion
+
+# Space preferences
+csharp_space_after_cast = false
+csharp_space_after_colon_in_inheritance_clause = true
+csharp_space_after_comma = true
+csharp_space_after_dot = false
+csharp_space_after_keywords_in_control_flow_statements = true
+csharp_space_after_semicolon_in_for_statement = true
+csharp_space_around_binary_operators = before_and_after
+csharp_space_around_declaration_statements = do_not_ignore
+csharp_space_before_colon_in_inheritance_clause = true
+csharp_space_before_comma = false
+csharp_space_before_dot = false
+csharp_space_before_open_square_brackets = false
+csharp_space_before_semicolon_in_for_statement = false
+csharp_space_between_empty_square_brackets = false
+csharp_space_between_method_call_empty_parameter_list_parentheses = false
+csharp_space_between_method_call_name_and_opening_parenthesis = false
+csharp_space_between_method_call_parameter_list_parentheses = false
+csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
+csharp_space_between_method_declaration_name_and_open_parenthesis = false
+csharp_space_between_method_declaration_parameter_list_parentheses = false
+csharp_space_between_parentheses = false
+csharp_space_between_square_brackets = false
+
+# C++ Files
+[*.{cpp,h,in}]
+curly_bracket_next_line = true
+indent_brace_style = Allman
+
+# Xml project files
+[*.{csproj,vcxproj,vcxproj.filters,proj,nativeproj,locproj}]
+indent_size = 2
+
+# Xml build files
+[*.builds]
+indent_size = 2
+
+# Xml files
+[*.{xml,stylecop,resx,ruleset}]
+indent_size = 2
+
+# Xml config files
+[*.{props,targets,config,nuspec}]
+indent_size = 2
+
+# Shell scripts
+[*.sh]
+end_of_line = lf
+[*.{cmd, bat}]
+end_of_line = crlf

.gitattributes

@@ -51,4 +51,5 @@
 *.vbproj text=auto
 *.fsproj text=auto
 *.dbproj text=auto
+*.xlf text=auto
 *.sln text=auto eol=crlf

.gitignore

@@ -99,6 +99,7 @@ dlldata.c
 # DNX
 project.lock.json
 artifacts/
+bin/
 
 *_i.c
 *_p.c

Directory.Build.props

@@ -0,0 +1,71 @@
+<Project ToolsVersion="15.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+
+<!--
+Projects which don't import dir.props:
+
+build\RestoreDependency.proj
+build\Signing.proj
+build\package\Installer.DEB.proj
+build\sdks\sdks.csproj
+build\templates\templates.csproj
+build\test\RunTest.proj
+build_projects\Microsoft.DotNet.Cli.Build.SelfTest\InvokeWithStage2.proj
+build_projects\update-dependencies\update-dependencies.csproj
+tools\TestAssetsDependencies\TestAssetsDependencies.csproj
+
+-->
+
+  <PropertyGroup>
+    <RepoRoot>$(MSBuildThisFileDirectory)</RepoRoot>
+
+    <NuGetPackagesDir>$(NUGET_PACKAGES)</NuGetPackagesDir>
+    <NuGetPackagesDir Condition=" '$(NuGetPackagesDir)' == '' ">$(RepoRoot)/.nuget/packages</NuGetPackagesDir>
+
+    <RelativeCLIBuildBinaries>build_projects/dotnet-cli-build/bin</RelativeCLIBuildBinaries>
+    <RelativeCLIBuildDllName>dotnet-cli-build.dll</RelativeCLIBuildDllName>
+    <CLIBuildDll>$(RepoRoot)/$(RelativeCLIBuildBinaries)/$(RelativeCLIBuildDllName)</CLIBuildDll>
+    <BuildTasksFeedDll>$(RepoRoot)/build_projects/dotnet-cli-build/bin/Microsoft.DotNet.Build.Tasks.Feed.dll</BuildTasksFeedDll>
+
+    <DisableImplicitFrameworkReferences>true</DisableImplicitFrameworkReferences>
+    <DisableImplicitPackageTargetFallback>true</DisableImplicitPackageTargetFallback>
+
+    <CliTargetFramework>netcoreapp2.1</CliTargetFramework>
+  </PropertyGroup>
+
+  <Import Project="build/InitRepo.props" />
+  <Import Condition=" '$(GeneratePropsFile)' != 'true' " Project="$(GitCommitInfoProps)" />
+  <Import Condition=" '$(GeneratePropsFile)' != 'true' " Project="$(HostInfoProps)" />
+  <Import Condition=" '$(GeneratePropsFile)' != 'true' " Project="$(BuildInfoProps)" />
+
+  <Import Project="build/BranchInfo.props" />
+  <Import Project="build/AzureInfo.props" />
+
+  <Import Project="build/DependencyVersions.props" />
+  <Import Project="build/Version.props" />
+  <Import Project="build/DerivedHostMachineInfo.props" />
+  <Import Project="build/Branding.props" />
+
+  <Import Project="build/FileExtensions.props" />
+  <Import Project="build/InputDirectories.props" />
+  <Import Project="build/MSBuildExtensions.props" />
+  <Import Project="build/SetupPreviousStage.props" />
+  <Import Project="build/OutputDirectories.props" />
+
+  <ImportGroup Condition=" '$(BuildingSigningProject)' != 'true' ">
+    <!-- These imports aren't required for signing, and some of them have syntax which isn't supported in MSBuild 14,
+         which is what the signing build uses -->
+    <Import Project="build/BundledTools.props" />
+    <Import Project="build/BundledSdks.props" />
+    <Import Project="build/BundledTemplates.props" />
+    <Import Project="build/BundledDotnetTools.props" />
+
+    <Import Project="build/BuildDefaults.props" />
+    <Import Project="build/BundledRuntimes.props" />
+    <Import Project="build/CrossGen.props" />
+    <Import Project="build/BackwardsCompatibilityRuntimes.props" />
+
+    <Import Project="build/InstallerInfo.props" />
+    <Import Project="build/GenerateResxSource.targets" />
+  </ImportGroup>
+  
+</Project>

Documentation/README.md

@@ -8,6 +8,7 @@ Documents Index
 - [.NET Core native pre-requisities document](https://github.com/dotnet/core/blob/master/Documentation/prereqs.md)
 - [Roadmap and OS support](https://github.com/dotnet/core/blob/master/roadmap.md)
 - [Comprehensive CLI documentation](https://docs.microsoft.com/en-us/dotnet/articles/core/preview3/tools/)
+- [ASP.NET Core Command Line Tools](general/aspnetcore-tools.md)
 
 ## Working with the CLI repo
 
@@ -16,7 +17,7 @@ Documents Index
 
 ## Troubleshooting and issues reporting
 
-- [CLI Known Issues](https://github.com/dotnet/core/blob/master/cli/known-issues.md)
+- [CLI Known Issues](https://github.com/dotnet/core/blob/master/release-notes/2.0/2.0.0-known-issues.md)
 - [Filing migration issues](migration-issues.md)
 
 ## Specifications

Documentation/general/aspnetcore-tools.md

@@ -0,0 +1,10 @@
+ASP.NET Core Command Line Tools
+===============================
+
+The .NET Core CLI includes some commands that are specific to ASP.NET Core projects.
+
+ - dotnet dev-certs
+ - dotnet user-secrets
+ - dotnet sql-cache
+
+For more information on these tools, see <https://github.com/aspnet/DotNetTools>.

Documentation/general/intro-to-cli.md

@@ -45,7 +45,7 @@ The way the `dotnet` driver finds the command it is instructed to run using `dot
 Adding a new command to the .NET Core CLI 
 =========================================
 
-If you want to contribute to the actual .NET Core CLI by adding a new command that you think would be useful, please refer to the [developer guide](developer-guide.md) in this directory. It contains all of the guidance on both the process as well as the infrastructure that you need to adhere to when adding a new command to the CLI toolchain. 
+If you want to contribute to the actual .NET Core CLI by adding a new command that you think would be useful, please refer to the [developer guide](../project-docs/developer-guide.md) in this directory. It contains all of the guidance on both the process as well as the infrastructure that you need to adhere to when adding a new command to the CLI toolchain. 
 
 After you familiarize yourself with the process of working with the source code in the repo, please consult the [CLI UX guidelines](cli-ux-guidelines.md) to get to know the user experience tenants the CLI has. 
 

Documentation/general/tab-completion.md

@@ -1,6 +1,6 @@
 # .NET CLI Tab Completion
 
-In version 2.0 of the .NET Core CLI, we have added support for providing suggestions when you press `tab`. While it's not yet enabled by default, you can try it out today by installing a [preview build](https://github.com/dotnet/cli#installers-and-binaries) from the master branch or by building from source. 
+In version 2.0 of the .NET Core CLI, we have added support for providing suggestions when you press `tab`. While it's not yet enabled by default, you can try it out in PowerShell, bash, or zsh by following the instructions below. 
 
 Here are some examples of what it provides:
 
@@ -26,17 +26,18 @@ If you just installed `dotnet` you may see the first-run output:
 ```
 Welcome to .NET Core!
 ---------------------
-Learn more about .NET Core @ https://aka.ms/dotnet-docs. Use dotnet --help to see available commands or go to https://aka.ms/dotnet-cli-docs.
+Learn more about .NET Core: https://aka.ms/dotnet-docs
+Use 'dotnet --help' to see available commands or visit: https://aka.ms/dotnet-cli-docs
 
 Telemetry
---------------
+---------
-The .NET Core tools collect usage data in order to improve your experience. The data is anonymous and does not include command-line arguments. The data is collected by Microsoft and shared with the community.
+The .NET Core tools collect usage data in order to help us improve your experience. The data is anonymous and doesn't include command-line arguments. The data is collected by Microsoft and shared with the community. You can opt-out of telemetry by setting the DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell.
-You can opt out of telemetry by setting a DOTNET_CLI_TELEMETRY_OPTOUT environment variable to 1 using your favorite shell.
+
-You can read more about .NET Core tools telemetry @ https://aka.ms/dotnet-cli-telemetry.
+Read more about .NET Core CLI Tools telemetry: https://aka.ms/dotnet-cli-telemetry
 
 Configuring...
--------------------
+--------------
-A command is running to initially populate your local package cache, to improve restore speed and enable offline access. This command will take up to a minute to complete and will only happen once.
+A command is running to populate your local package cache to improve restore speed and enable offline access. This command takes up to one minute to complete and only runs once.
 Decompressing 100% 4936 ms
 Expanding 100% 17195 ms
 ```
@@ -68,4 +69,4 @@ To enable tab completion in zsh, edit your `.zshrc` file to add the contents of
 
 ## How it works
 
-Each of these scripts provides a hook for completions for its respective shell. The logic that determines which suggestions to provide is in the CLI itself, configured using [our new parser](https://github.com/dotnet/CliCommandLineParser). You can see a code example [here](https://github.com/dotnet/cli/blob/master/src/dotnet/commands/dotnet-add/dotnet-add-package/AddPackageParser.cs#L23). 
+Each of these scripts provides a hook for completions for its respective shell. The logic that determines which suggestions to provide is in the CLI itself, configured using [our new parser](https://github.com/dotnet/CliCommandLineParser). You can see a code example [here](https://github.com/dotnet/cli/blob/master/src/dotnet/commands/dotnet-add/dotnet-add-package/AddPackageParser.cs). 

Documentation/manpages/sdk/dotnet-add-package.1

@@ -0,0 +1,90 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet add package command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet add package
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ add\ package\f[] \- Adds a package reference to a project file.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ add\ [<PROJECT>]\ package\ <PACKAGE_NAME>\ [\-h|\-\-help]\ [\-v|\-\-version]\ [\-f|\-\-framework]\ [\-n|\-\-no\-restore]\ [\-s|\-\-source]\ [\-\-package\-directory]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ add\ package\f[] command provides a convenient option to add a package reference to a project file.
+After running the command, there's a compatibility check to ensure the package is compatible with the frameworks in the project.
+If the check passes, a \f[C]<PackageReference>\f[] element is added to the project file and dotnet restore is run.
+.PP
+.PP
+For example, adding \f[C]Newtonsoft.Json\f[] to \f[I]ToDo.csproj\f[] produces output similar to the following example:
+.IP
+.nf
+\f[C]
+\ \ Writing\ C:\\Users\\mairaw\\AppData\\Local\\Temp\\tmp95A8.tmp
+info\ :\ Adding\ PackageReference\ for\ package\ \[aq]Newtonsoft.Json\[aq]\ into\ project\ \[aq]C:\\projects\\ToDo\\ToDo.csproj\[aq].
+log\ \ :\ Restoring\ packages\ for\ C:\\projects\\ToDo\\ToDo.csproj...
+info\ :\ \ \ GET\ https://api.nuget.org/v3\-flatcontainer/newtonsoft.json/index.json
+info\ :\ \ \ OK\ https://api.nuget.org/v3\-flatcontainer/newtonsoft.json/index.json\ 235ms
+info\ :\ Package\ \[aq]Newtonsoft.Json\[aq]\ is\ compatible\ with\ all\ the\ specified\ frameworks\ in\ project\ \[aq]C:\\projects\\ToDo\\ToDo.csproj\[aq].
+info\ :\ PackageReference\ for\ package\ \[aq]Newtonsoft.Json\[aq]\ version\ \[aq]10.0.3\[aq]\ added\ to\ file\ \[aq]C:\\projects\\ToDo\\ToDo.csproj\[aq].
+\f[]
+.fi
+.PP
+The \f[I]ToDo.csproj\f[] file now contains a \f[C]<PackageReference>\f[] element for the referenced package.
+.IP
+.nf
+\f[C]
+<PackageReference\ Include="Newtonsoft.Json"\ Version="9.0.1"\ />
+\f[]
+.fi
+.SS Arguments
+.PP
+\f[C]PROJECT\f[]
+.PP
+Specifies the project file.
+If not specified, the command searches the current directory for one.
+.PP
+\f[C]PACKAGE_NAME\f[]
+.PP
+The package reference to add.
+.SH OPTIONS
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-v|\-\-version\ <VERSION>\f[]
+.PP
+Version of the package.
+.PP
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
+.PP
+Adds a package reference only when targeting a specific framework.
+.PP
+\f[C]\-n|\-\-no\-restore\f[]
+.PP
+Adds a package reference without performing a restore preview and compatibility check.
+.PP
+\f[C]\-s|\-\-source\ <SOURCE>\f[]
+.PP
+Uses a specific NuGet package source during the restore operation.
+.PP
+\f[C]\-\-package\-directory\ <PACKAGE_DIRECTORY>\f[]
+.PP
+Restores the package to the specified directory.
+.SH EXAMPLES
+.PP
+Add \f[C]Newtonsoft.Json\f[] NuGet package to a project:
+.PP
+\f[C]dotnet\ add\ package\ Newtonsoft.Json\f[]
+.PP
+Add a specific version of a package to a project:
+.PP
+\f[C]dotnet\ add\ ToDo.csproj\ package\ Microsoft.Azure.DocumentDB.Core\ \-v\ 1.0.0\f[]
+.PP
+Add a package using a specific NuGet source:
+.PP
+\f[C]dotnet\ add\ package\ Microsoft.AspNetCore.StaticFiles\ \-s\ https://dotnet.myget.org/F/dotnet\-core/api/v3/index.json\f[]
+.SH AUTHORS
+mairaw.

Documentation/manpages/sdk/dotnet-add-reference.1

@@ -0,0 +1,62 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet\-add reference command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet\-add reference
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ add\ reference\f[] \- Adds project\-to\-project (P2P) references.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ add\ [<PROJECT>]\ reference\ [\-f|\-\-framework]\ <PROJECT_REFERENCES>\ [\-h|\-\-help]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ add\ reference\f[] command provides a convenient option to add project references to a project.
+After running the command, the \f[C]<ProjectReference>\f[] elements are added to the project file.
+.IP
+.nf
+\f[C]
+<ItemGroup>
+\ \ <ProjectReference\ Include="app.csproj"\ />
+\ \ <ProjectReference\ Include="..\\lib2\\lib2.csproj"\ />
+\ \ <ProjectReference\ Include="..\\lib1\\lib1.csproj"\ />
+</ItemGroup>
+\f[]
+.fi
+.SS Arguments
+.PP
+\f[C]PROJECT\f[]
+.PP
+Specifies the project file.
+If not specified, the command searches the current directory for one.
+.PP
+\f[C]PROJECT_REFERENCES\f[]
+.PP
+Project\-to\-project (P2P) references to add.
+Specify one or more projects.
+Glob patterns are supported on Unix/Linux\-based systems.
+.SH OPTIONS
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
+.PP
+Adds project references only when targeting a specific framework.
+.SH EXAMPLES
+.PP
+Add a project reference:
+.PP
+\f[C]dotnet\ add\ app/app.csproj\ reference\ lib/lib.csproj\f[]
+.PP
+Add multiple project references to the project in the current directory:
+.PP
+\f[C]dotnet\ add\ reference\ lib1/lib1.csproj\ lib2/lib2.csproj\f[]
+.PP
+Add multiple project references using a globbing pattern on Linux/Unix:
+.PP
+\f[C]dotnet\ add\ app/app.csproj\ reference\ **/*.csproj\f[]
+.SH AUTHORS
+mairaw.

Documentation/manpages/sdk/dotnet-build.1

@@ -1,96 +1,195 @@
-.\" Automatically generated by Pandoc 1.15.1
+.\" Automatically generated by Pandoc 2.1.3
 .\"
+.TH "dotnet build command \- .NET Core CLI" "1" "" "" ".NET Core"
 .hy
-.TH "DOTNET\-BUILD" "1" "April 2016" "" ""
+.SH dotnet\-build
-.SS NAME
 .PP
-dotnet\-build \-\- Builds a project and all of its dependencies
+.SH NAME
-.SS SYNOPSIS
 .PP
-\f[C]dotnet\ build\ [\-\-output]\ \ \ \ \ \ \ [\-\-build\-base\-path]\ [\-\-framework]\ \ \ \ \ \ \ [\-\-configuration]\ \ [\-\-runtime]\ [\-\-version\-suffix]\ \ \ \ \ [\-\-build\-profile]\ \ [\-\-no\-incremental]\ [\-\-no\-dependencies]\ \ \ \ \ [<project>]\f[]
+\f[C]dotnet\ build\f[] \- Builds a project and all of its dependencies.
-.SS DESCRIPTION
+.SH SYNOPSIS
-.PP
+.SS .NET Core 2.x
-The \f[C]dotnet\ build\f[] command builds multiple source file from a
-source project and its dependencies into a binary.
-The binary will be in Intermediate Language (IL) by default and will
-have a DLL extension.
-\f[C]dotnet\ build\f[] will also drop a \f[C]\\*.deps\f[] file which
-outlines what the host needs to run the application.
-.PP
-Building requires the existence of a lock file, which means that you
-have to run \f[C]dotnet\ restore\f[] (dotnet-restore.md) prior to
-building your code.
-.PP
-Before any compilation begins, the build verb analyzes the project and
-its dependencies for incremental safety checks.
-If all checks pass, then build proceeds with incremental compilation of
-the project and its dependencies; otherwise, it falls back to
-non\-incremental compilation.
-Via a profile flag, users can choose to receive additional information
-on how they can improve their build times.
-.PP
-All projects in the dependency graph that need compilation must pass the
-following safety checks in order for the compilation process to be
-incremental: \- not use pre/post compile scripts \- not load compilation
-tools from PATH (for example, resgen, compilers) \- use only known
-compilers (csc, vbc, fsc)
-.PP
-In order to build an executable application, you need a special
-configuration section in your project.json file:
 .IP
 .nf
 \f[C]
-{\ 
+dotnet\ build\ [<PROJECT>]\ [\-c|\-\-configuration]\ [\-f|\-\-framework]\ [\-\-force]\ [\-\-no\-dependencies]\ [\-\-no\-incremental]
-\ \ \ \ "compilerOptions":\ {
+\ \ \ \ [\-\-no\-restore]\ [\-o|\-\-output]\ [\-r|\-\-runtime]\ [\-v|\-\-verbosity]\ [\-\-version\-suffix]
-\ \ \ \ \ \ "emitEntryPoint":\ true
+dotnet\ build\ [\-h|\-\-help]
-\ \ \ \ }
+\f[]
-}
+.fi
+.SS .NET Core 1.x
+.IP
+.nf
+\f[C]
+dotnet\ build\ [<PROJECT>]\ [\-c|\-\-configuration]\ [\-f|\-\-framework]\ [\-\-no\-dependencies]\ [\-\-no\-incremental]\ [\-o|\-\-output]
+\ \ \ \ [\-r|\-\-runtime]\ [\-v|\-\-verbosity]\ [\-\-version\-suffix]
+dotnet\ build\ [\-h|\-\-help]
 \f[]
 .fi
-.SS OPTIONS
 .PP
-\f[C]\-o\f[], \f[C]\-\-output\f[] [DIR]
+   *   *   *   *   *
+.SH DESCRIPTION
 .PP
-Directory in which to place the built binaries.
+The \f[C]dotnet\ build\f[] command builds the project and its dependencies into a set of binaries.
+The binaries include the project's code in Intermediate Language (IL) files with a \f[I].dll\f[] extension and symbol files used for debugging with a \f[I].pdb\f[] extension.
+A dependencies JSON file (\f[I]*.deps.json\f[]) is produced that lists the dependencies of the application.
+A \f[I]*.runtimeconfig.json\f[] file is produced, which specifies the shared runtime and its version for the application.
 .PP
-\f[C]\-b\f[], \f[C]\-\-build\-base\-path\f[] [DIR]
+If the project has third\-party dependencies, such as libraries from NuGet, they're resolved from the NuGet cache and aren't available with the project's built output.
+With that in mind, the product of \f[C]dotnet\ build\f[] isn't ready to be transferred to another machine to run.
+This is in contrast to the behavior of the .NET Framework in which building an executable project (an application) produces output that's runnable on any machine where the .NET Framework is installed.
+To have a similar experience with .NET Core, you need to use the dotnet publish command.
+For more information, see .NET Core Application Deployment.
 .PP
-Directory in which to place temporary outputs.
+Building requires the \f[I]project.assets.json\f[] file, which lists the dependencies of your application.
+The file is created when \f[C]dotnet\ restore\f[] is executed.
+Without the assets file in place, the tooling cannot resolve reference assemblies, which results in errors.
+With .NET Core 1.x SDK, you needed to explicitily run the \f[C]dotnet\ restore\f[] before running \f[C]dotnet\ build\f[].
+Starting with .NET Core 2.0 SDK, \f[C]dotnet\ restore\f[] runs implicitily when you run \f[C]dotnet\ build\f[].
+If you want to disable implicit restore when running the build command, you can pass the \f[C]\-\-no\-restore\f[] option.
 .PP
-\f[C]\-f\f[], \f[C]\-\-framework\f[] [FRAMEWORK]
+.PP
+\f[C]dotnet\ build\f[] uses MSBuild to build the project; thus, it supports both parallel and incremental builds.
+Refer to Incremental Builds for more information.
+.PP
+In addition to its options, the \f[C]dotnet\ build\f[] command accepts MSBuild options, such as \f[C]/p\f[] for setting properties or \f[C]/l\f[] to define a logger.
+Learn more about these options in the MSBuild Command\-Line Reference.
+.PP
+Whether the project is executable or not is determined by the \f[C]<OutputType>\f[] property in the project file.
+The following example shows a project that will produce executable code:
+.IP
+.nf
+\f[C]
+<PropertyGroup>
+\ \ <OutputType>Exe</OutputType>
+</PropertyGroup>
+\f[]
+.fi
+.PP
+In order to produce a library, omit the \f[C]<OutputType>\f[] property.
+The main difference in built output is that the IL DLL for a library doesn't contain entry points and can't be executed.
+.SS Arguments
+.PP
+\f[C]PROJECT\f[]
+.PP
+The project file to build.
+If a project file is not specified, MSBuild searches the current working directory for a file that has a file extension that ends in \f[I]proj\f[] and uses that file.
+.SH OPTIONS
+.SS .NET Core 2.x
+.PP
+\f[C]\-c|\-\-configuration\ {Debug|Release}\f[]
+.PP
+Defines the build configuration.
+The default value is \f[C]Debug\f[].
+.PP
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
 .PP
 Compiles for a specific framework.
-The framework needs to be defined in the project.json file.
+The framework must be defined in the project file.
 .PP
-\f[C]\-c\f[], \f[C]\-\-configuration\f[] [Debug|Release]
+\f[C]\-\-force\f[]
 .PP
-Defines a configuration under which to build.
+Forces all dependencies to be resolved even if the last restore was successful.
-If omitted, it defaults to Debug.
+This is equivalent to deleting the \f[I]project.assets.json\f[] file.
 .PP
-\f[C]\-r\f[], \f[C]\-\-runtime\f[] [RUNTIME_IDENTIFIER]
+\f[C]\-h|\-\-help\f[]
 .PP
-Target runtime to build for.
+Prints out a short help for the command.
 .PP
-\-\-version\-suffix [VERSION_SUFFIX]
+\f[C]\-\-no\-dependencies\f[]
 .PP
-Defines what \f[C]*\f[] should be replaced with in the version field in
+Ignores project\-to\-project (P2P) references and only builds the root project specified to build.
-the project.json file.
-The format follows NuGet\[aq]s version guidelines.
-.PP
-\f[C]\-\-build\-profile\f[]
-.PP
-Prints out the incremental safety checks that users need to address in
-order for incremental compilation to be automatically turned on.
 .PP
 \f[C]\-\-no\-incremental\f[]
 .PP
 Marks the build as unsafe for incremental build.
-This turns off incremental compilation and forces a clean rebuild of the
+This turns off incremental compilation and forces a clean rebuild of the project's dependency graph.
-project dependency graph.
+.PP
+\f[C]\-\-no\-restore\f[]
+.PP
+Doesn't perform an implicit restore during build.
+.PP
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Directory in which to place the built binaries.
+You also need to define \f[C]\-\-framework\f[] when you specify this option.
+.PP
+\f[C]\-r|\-\-runtime\ <RUNTIME_IDENTIFIER>\f[]
+.PP
+Specifies the target runtime.
+For a list of Runtime Identifiers (RIDs), see the RID catalog.
+.PP
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
+.PP
+\f[C]\-\-version\-suffix\ <VERSION_SUFFIX>\f[]
+.PP
+Defines the version suffix for an asterisk (\f[C]*\f[]) in the version field of the project file.
+The format follows NuGet's version guidelines.
+.SS .NET Core 1.x
+.PP
+\f[C]\-c|\-\-configuration\ {Debug|Release}\f[]
+.PP
+Defines the build configuration.
+The default value is \f[C]Debug\f[].
+.PP
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
+.PP
+Compiles for a specific framework.
+The framework must be defined in the project file.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
 .PP
 \f[C]\-\-no\-dependencies\f[]
 .PP
-Ignores project\-to\-project references and only builds the root project
+Ignores project\-to\-project (P2P) references and only builds the root project specified to build.
-specified to build.
+.PP
+\f[C]\-\-no\-incremental\f[]
+.PP
+Marks the build as unsafe for incremental build.
+This turns off incremental compilation and forces a clean rebuild of the project's dependency graph.
+.PP
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Directory in which to place the built binaries.
+You also need to define \f[C]\-\-framework\f[] when you specify this option.
+.PP
+\f[C]\-r|\-\-runtime\ <RUNTIME_IDENTIFIER>\f[]
+.PP
+Specifies the target runtime.
+For a list of Runtime Identifiers (RIDs), see the RID catalog.
+.PP
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
+.PP
+\f[C]\-\-version\-suffix\ <VERSION_SUFFIX>\f[]
+.PP
+Defines the version suffix for an asterisk (\f[C]*\f[]) in the version field of the project file.
+The format follows NuGet's version guidelines.
+.PP
+   *   *   *   *   *
+.SH EXAMPLES
+.PP
+Build a project and its dependencies:
+.PP
+\f[C]dotnet\ build\f[]
+.PP
+Build a project and its dependencies using Release configuration:
+.PP
+\f[C]dotnet\ build\ \-\-configuration\ Release\f[]
+.PP
+Build a project and its dependencies for a specific runtime (in this example, Ubuntu 16.04):
+.PP
+\f[C]dotnet\ build\ \-\-runtime\ ubuntu.16.04\-x64\f[]
+.PP
+Build the project and use the specified NuGet package source during the restore operation (.NET Core SDK 2.0 and later versions):
+.PP
+\f[C]dotnet\ build\ \-\-source\ c:\\packages\\mypackages\f[]
 .SH AUTHORS
-Microsoft Corporation dotnetclifeedback\@microsoft.com.
+mairaw.

Documentation/manpages/sdk/dotnet-clean.1

@@ -0,0 +1,113 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet clean command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet\-clean
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ clean\f[] \- Cleans the output of a project.
+.SH SYNOPSIS
+.SS .NET Core 2.x
+.IP
+.nf
+\f[C]
+dotnet\ clean\ [<PROJECT>]\ [\-c|\-\-configuration]\ [\-f|\-\-framework]\ [\-o|\-\-output]\ [\-r|\-\-runtime]\ [\-v|\-\-verbosity]
+dotnet\ clean\ [\-h|\-\-help]
+\f[]
+.fi
+.SS .NET Core 1.x
+.IP
+.nf
+\f[C]
+dotnet\ clean\ [<PROJECT>]\ [\-c|\-\-configuration]\ [\-f|\-\-framework]\ [\-o|\-\-output]\ [\-v|\-\-verbosity]
+dotnet\ clean\ [\-h|\-\-help]
+\f[]
+.fi
+.PP
+   *   *   *   *   *
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ clean\f[] command cleans the output of the previous build.
+It's implemented as an MSBuild target, so the project is evaluated when the command is run.
+Only the outputs created during the build are cleaned.
+Both intermediate (\f[I]obj\f[]) and final output (\f[I]bin\f[]) folders are cleaned.
+.SS Arguments
+.PP
+\f[C]PROJECT\f[]
+.PP
+The MSBuild project to clean.
+If a project file is not specified, MSBuild searches the current working directory for a file that has a file extension that ends in \f[I]proj\f[] and uses that file.
+.SH OPTIONS
+.SS .NET Core 2.x
+.PP
+\f[C]\-c|\-\-configuration\ {Debug|Release}\f[]
+.PP
+Defines the build configuration.
+The default value is \f[C]Debug\f[].
+This option is only required when cleaning if you specified it during build time.
+.PP
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
+.PP
+The framework that was specified at build time.
+The framework must be defined in the project file.
+If you specified the framework at build time, you must specify the framework when cleaning.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Directory in which the build outputs are placed.
+Specify the \f[C]\-f|\-\-framework\ <FRAMEWORK>\f[] switch with the output directory switch if you specified the framework when the project was built.
+.PP
+\f[C]\-r|\-\-runtime\ <RUNTIME_IDENTIFIER>\f[]
+.PP
+Cleans the output folder of the specified runtime.
+This is used when a self\-contained deployment was created.
+.PP
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed levels are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic].
+.SS .NET Core 1.x
+.PP
+\f[C]\-c|\-\-configuration\ {Debug|Release}\f[]
+.PP
+Defines the build configuration.
+The default value is \f[C]Debug\f[].
+This option is only required when cleaning if you specified it during build time.
+.PP
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
+.PP
+The framework that was specified at build time.
+The framework must be defined in the project file.
+If you specified the framework at build time, you must specify the framework when cleaning.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Directory in which the build outputs are placed.
+Specify the \f[C]\-f|\-\-framework\ <FRAMEWORK>\f[] switch with the output directory switch if you specified the framework when the project was built.
+.PP
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed levels are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic].
+.PP
+   *   *   *   *   *
+.SH EXAMPLES
+.PP
+Clean a default build of the project:
+.PP
+\f[C]dotnet\ clean\f[]
+.PP
+Clean a project built using the Release configuration:
+.PP
+\f[C]dotnet\ clean\ \-\-configuration\ Release\f[]
+.SH AUTHORS
+mairaw.

Documentation/manpages/sdk/dotnet-help.1

@@ -0,0 +1,33 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet help command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet help reference
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ help\f[] \- Shows more detailed documentation online for the specified command.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ help\ <COMMAND_NAME>\ [\-h|\-\-help]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ help\f[] command opens up the reference page for more detailed information about the specified command at docs.microsoft.com.
+.SS Arguments
+.PP
+\f[C]COMMAND_NAME\f[]
+.PP
+Name of the .NET Core CLI command.
+For a list of the valid CLI commands, see CLI commands.
+.SH OPTIONS
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.SH EXAMPLES
+.PP
+Opens the documentation page for the dotnet new command:
+.PP
+\f[C]dotnet\ help\ new\f[]
+.SH AUTHORS
+mairaw.

Documentation/manpages/sdk/dotnet-install-script.1

@@ -0,0 +1,175 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet\-install scripts" "1" "" "" ".NET Core"
+.hy
+.SH dotnet\-install scripts reference
+.SH NAME
+.PP
+\f[C]dotnet\-install.ps1\f[] | \f[C]dotnet\-install.sh\f[] \- Script used to install the .NET Core CLI tools and the shared runtime.
+.SH SYNOPSIS
+.PP
+Windows:
+.PP
+\f[C]dotnet\-install.ps1\ [\-Channel]\ [\-Version]\ [\-InstallDir]\ [\-Architecture]\ [\-SharedRuntime]\ [\-DryRun]\ [\-NoPath]\ [\-AzureFeed]\ [\-ProxyAddress]\ [\-\-Verbose]\ [\-\-Help]\f[]
+.PP
+macOS/Linux:
+.PP
+\f[C]dotnet\-install.sh\ [\-\-channel]\ [\-\-version]\ [\-\-install\-dir]\ [\-\-architecture]\ [\-\-shared\-runtime]\ [\-\-dry\-run]\ [\-\-no\-path]\ [\-\-azure\-feed]\ [\-\-verbose]\ [\-\-help]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\-install\f[] scripts are used to perform a non\-admin installation of the .NET Core SDK, which includes the .NET Core CLI tools and the shared runtime.
+.PP
+We recommend that you use the stable version that is hosted on .NET Core main website.
+The direct paths to the scripts are:
+.IP \[bu] 2
+https://dot.net/v1/dotnet\-install.sh (bash, UNIX)
+.IP \[bu] 2
+https://dot.net/v1/dotnet\-install.ps1 (Powershell, Windows)
+.PP
+The main usefulness of these scripts is in automation scenarios and non\-admin installations.
+There are two scripts: One is a PowerShell script that works on Windows.
+The other script is a bash script that works on Linux/macOS.
+Both scripts have the same behavior.
+The bash script also reads PowerShell switches, so you can use PowerShell switches with the script on Linux/macOS systems.
+.PP
+The installation scripts download the ZIP/tarball file from the CLI build drops and proceed to install it in either the default location or in a location specified by \f[C]\-InstallDir|\-\-install\-dir\f[].
+By default, the installation scripts download the SDK and install it.
+If you wish to only obtain the shared runtime, specify the \f[C]\-\-shared\-runtime\f[] argument.
+.PP
+By default, the script adds the install location to the $PATH for the current session.
+Override this default behavior by specifying the \f[C]\-\-no\-path\f[] argument.
+.PP
+Before running the script, install the required dependencies.
+.PP
+You can install a specific version using the \f[C]\-\-version\f[] argument.
+The version must be specified as a 3\-part version (for example, 1.0.0\-13232).
+If omitted, it uses the \f[C]latest\f[] version.
+.SH OPTIONS
+.PP
+\f[C]\-Channel\ <CHANNEL>\f[]
+.PP
+Specifies the source channel for the installation.
+The possible values are:
+.IP \[bu] 2
+\f[C]Current\f[] \- Current release
+.IP \[bu] 2
+\f[C]LTS\f[] \- Long\-Term Support channel (current supported release)
+.IP \[bu] 2
+Two\-part version in X.Y format representing a specific release (for example, \f[C]2.0\f[] or \f[C]1.0\f[])
+.IP \[bu] 2
+Branch name [for example, \f[C]release/2.0.0\f[], \f[C]release/2.0.0\-preview2\f[], or \f[C]master\f[] for the latest from the \f[C]master\f[] branch (\[lq]bleeding edge\[rq] nightly releases)]
+.PP
+The default value is \f[C]LTS\f[].
+For more information on .NET support channels, see the .NET Core Support Lifecycle topic.
+.PP
+\f[C]\-Version\ <VERSION>\f[]
+.PP
+Represents a specific build version.
+The possible values are:
+.IP \[bu] 2
+\f[C]latest\f[] \- Latest build on the channel (used with the \f[C]\-Channel\f[] option)
+.IP \[bu] 2
+\f[C]coherent\f[] \- Latest coherent build on the channel; uses the latest stable package combination (used with Branch name \f[C]\-Channel\f[] options)
+.IP \[bu] 2
+Three\-part version in X.Y.Z format representing a specific build version; supersedes the \f[C]\-Channel\f[] option.
+For example: \f[C]2.0.0\-preview2\-006120\f[]
+.PP
+If omitted, \f[C]\-Version\f[] defaults to \f[C]latest\f[].
+.PP
+\f[C]\-InstallDir\ <DIRECTORY>\f[]
+.PP
+Specifies the installation path.
+The directory is created if it doesn't exist.
+The default value is \f[I]%LocalAppData%.dotnet\f[].
+Note that binaries are placed directly in the directory.
+.PP
+\f[C]\-Architecture\ <ARCHITECTURE>\f[]
+.PP
+Architecture of the .NET Core binaries to install.
+Possible values are \f[C]auto\f[], \f[C]x64\f[], and \f[C]x86\f[].
+The default value is \f[C]auto\f[], which represents the currently running OS architecture.
+.PP
+\f[C]\-SharedRuntime\f[]
+.PP
+If set, this switch limits installation to the shared runtime.
+The entire SDK isn't installed.
+.PP
+\f[C]\-DryRun\f[]
+.PP
+If set, the script won't perform the installation; but instead, it displays what command line to use to consistently install the currently requested version of the .NET Core CLI.
+For example if you specify version \f[C]latest\f[], it displays a link with the specific version so that this command can be used deterministically in a build script.
+It also displays the binary's location if you prefer to install or download it yourself.
+.PP
+\f[C]\-NoPath\f[]
+.PP
+If set, the prefix/installdir are not exported to the path for the current session.
+By default, the script will modify the PATH, which makes the CLI tools available immediately after install.
+.PP
+\f[C]\-AzureFeed\f[]
+.PP
+Specifies the URL for the Azure feed to the installer.
+It isn't recommended that you change this value.
+The default is \f[C]https://dotnetcli.azureedge.net/dotnet\f[].
+.PP
+\f[C]\-ProxyAddress\f[]
+.PP
+If set, the installer uses the proxy when making web requests.
+(Only valid for Windows)
+.PP
+\f[C]\-\-verbose\f[]
+.PP
+Display diagnostics information.
+.PP
+\f[C]\-\-help\f[]
+.PP
+Prints out help for the script.
+.SH EXAMPLES
+.PP
+Install the latest long\-term supported (LTS) version to the default location:
+.PP
+Windows:
+.PP
+\f[C]\&./dotnet\-install.ps1\ \-Channel\ LTS\f[]
+.PP
+macOS/Linux:
+.PP
+\f[C]\&./dotnet\-install.sh\ \-\-channel\ LTS\f[]
+.PP
+Install the latest version from 2.0 channel to the specified location:
+.PP
+Windows:
+.PP
+\f[C]\&./dotnet\-install.ps1\ \-Channel\ 2.0\ \-InstallDir\ C:\\cli\f[]
+.PP
+macOS/Linux:
+.PP
+\f[C]\&./dotnet\-install.sh\ \-\-channel\ 2.0\ \-\-install\-dir\ ~/cli\f[]
+.PP
+Install the 1.1.0 version of the shared runtime:
+.PP
+Windows:
+.PP
+\f[C]\&./dotnet\-install.ps1\ \-SharedRuntime\ \-Version\ 1.1.0\f[]
+.PP
+macOS/Linux:
+.PP
+\f[C]\&./dotnet\-install.sh\ \-\-shared\-runtime\ \-\-version\ 1.1.0\f[]
+.PP
+Obtain script and install .NET Core CLI one\-liner examples:
+.PP
+Windows:
+.PP
+\f[C]\@powershell\ \-NoProfile\ \-ExecutionPolicy\ unrestricted\ \-Command\ "&([scriptblock]::Create((Invoke\-WebRequest\ \-useb\ \[aq]https://dot.net/v1/dotnet\-install.ps1\[aq])))\ <additional\ install\-script\ args>"\f[]
+.PP
+macOS/Linux:
+.PP
+\f[C]curl\ \-sSL\ https://dot.net/v1/dotnet\-install.sh\ |\ bash\ /dev/stdin\ <additional\ install\-script\ args>\f[]
+.SS See also
+.PP
+\&.NET Core releases
+.PD 0
+.P
+.PD
+\&.NET Core Runtime and SDK download archive
+.SH AUTHORS
+blackdwarf.

Documentation/manpages/sdk/dotnet-list-reference.1

@@ -0,0 +1,37 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet list reference command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet list reference
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ list\ reference\f[] \- Lists project to project references.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ list\ [<PROJECT>]\ reference\ [\-h|\-\-help]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ list\ reference\f[] command provides a convenient option to list project references for a given project.
+.SS Arguments
+.PP
+\f[C]PROJECT\f[]
+.PP
+Specifies the project file to use for listing references.
+If not specified, the command will search the current directory for a project file.
+.SH OPTIONS
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.SH EXAMPLES
+.PP
+List the project references for the specified project:
+.PP
+\f[C]dotnet\ list\ app/app.csproj\ reference\f[]
+.PP
+List the project references for the project in the current directory:
+.PP
+\f[C]dotnet\ list\ reference\f[]
+.SH AUTHORS
+mairaw.

Documentation/manpages/sdk/dotnet-migrate.1

@@ -0,0 +1,106 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet migrate command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet migrate
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ migrate\f[] \- Migrates a Preview 2 .NET Core project to a .NET Core SDK 1.0 project.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ migrate\ [<SOLUTION_FILE|PROJECT_DIR>]\ [\-t|\-\-template\-file]\ [\-v|\-\-sdk\-package\-version]\ [\-x|\-\-xproj\-file]\ [\-s|\-\-skip\-project\-references]\ [\-r|\-\-report\-file]\ [\-\-format\-report\-file\-json]\ [\-\-skip\-backup]\ [\-h|\-\-help]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ migrate\f[] command migrates a valid Preview 2 \f[I]project.json\f[]\-based project to a valid .NET Core SDK 1.0 \f[I]csproj\f[] project.
+.PP
+By default, the command migrates the root project and any project references that the root project contains.
+This behavior is disabled using the \f[C]\-\-skip\-project\-references\f[] option at runtime.
+.PP
+Migration is performed on the following:
+.IP \[bu] 2
+A single project by specifying the \f[I]project.json\f[] file to migrate.
+.IP \[bu] 2
+All of the directories specified in the \f[I]global.json\f[] file by passing in a path to the \f[I]global.json\f[] file.
+.IP \[bu] 2
+A \f[I]solution.sln\f[] file, where it migrates the projects referenced in the solution.
+.IP \[bu] 2
+On all sub\-directories of the given directory recursively.
+.PP
+The \f[C]dotnet\ migrate\f[] command keeps the migrated \f[I]project.json\f[] file inside a \f[C]backup\f[] directory, which it creates if the directory doesn't exist.
+This behavior is overridden using the \f[C]\-\-skip\-backup\f[] option.
+.PP
+By default, the migration operation outputs the state of the migration process to standard output (STDOUT).
+If you use the \f[C]\-\-report\-file\ <REPORT_FILE>\f[] option, the output is saved to the file specify.
+.PP
+The \f[C]dotnet\ migrate\f[] command only supports valid Preview 2 \f[I]project.json\f[]\-based projects.
+This means that you cannot use it to migrate DNX or Preview 1 \f[I]project.json\f[]\-based projects directly to MSBuild/csproj projects.
+You first need to manually migrate the project to a Preview 2 \f[I]project.json\f[]\-based project and then use the \f[C]dotnet\ migrate\f[] command to migrate the project.
+.SS Arguments
+.PP
+\f[C]PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR\f[]
+.PP
+The path to one of the following:
+.IP \[bu] 2
+a \f[I]project.json\f[] file to migrate.
+.IP \[bu] 2
+a \f[I]global.json\f[] file, it will migrate the folders specified in \f[I]global.json\f[].
+.IP \[bu] 2
+a \f[I]solution.sln\f[] file, it will migrate the projects referenced in the solution.
+.IP \[bu] 2
+a directory to migrate, it will recursively search for \f[I]project.json\f[] files to migrate.
+.PP
+Defaults to current directory if nothing is specified.
+.SH OPTIONS
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-t|\-\-template\-file\ <TEMPLATE_FILE>\f[]
+.PP
+Template csproj file to use for migration.
+By default, the same template as the one dropped by \f[C]dotnet\ new\ console\f[] is used.
+.PP
+\f[C]\-v|\-\-sdk\-package\-version\ <VERSION>\f[]
+.PP
+The version of the sdk package that's referenced in the migrated app.
+The default is the version of the SDK in \f[C]dotnet\ new\f[].
+.PP
+\f[C]\-x|\-\-xproj\-file\ <FILE>\f[]
+.PP
+The path to the xproj file to use.
+Required when there is more than one xproj in a project directory.
+.PP
+\f[C]\-s|\-\-skip\-project\-references\ [Debug|Release]\f[]
+.PP
+Skip migrating project references.
+By default, project references are migrated recursively.
+.PP
+\f[C]\-r|\-\-report\-file\ <REPORT_FILE>\f[]
+.PP
+Output migration report to a file in addition to the console.
+.PP
+\f[C]\-\-format\-report\-file\-json\ <REPORT_FILE>\f[]
+.PP
+Output migration report file as JSON rather than user messages.
+.PP
+\f[C]\-\-skip\-backup\f[]
+.PP
+Skip moving \f[I]project.json\f[], \f[I]global.json\f[], and \f[I]*.xproj\f[] to a \f[C]backup\f[] directory after successful migration.
+.SH EXAMPLES
+.PP
+Migrate a project in the current directory and all of its project\-to\-project dependencies:
+.PP
+\f[C]dotnet\ migrate\f[]
+.PP
+Migrate all projects that \f[I]global.json\f[] file includes:
+.PP
+\f[C]dotnet\ migrate\ path/to/global.json\f[]
+.PP
+Migrate only the current project and no project\-to\-project (P2P) dependencies.
+Also, use a specific SDK version:
+.PP
+\f[C]dotnet\ migrate\ \-s\ \-v\ 1.0.0\-preview4\f[]
+.SH AUTHORS
+mairaw.

Documentation/manpages/sdk/dotnet-msbuild.1

@@ -0,0 +1,38 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet msbuild command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet msbuild
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ msbuild\f[] \- Builds a project and all of its dependencies.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ msbuild\ <msbuild_arguments>\ [\-h]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ msbuild\f[] command allows access to a fully functional MSBuild.
+.PP
+The command has the exact same capabilities as existing MSBuild command\-line client.
+The options are all the same.
+Use the MSBuild Command\-Line Reference to obtain information on the available options.
+.SH EXAMPLES
+.PP
+Build a project and its dependencies:
+.PP
+\f[C]dotnet\ msbuild\f[]
+.PP
+Build a project and its dependencies using Release configuration:
+.PP
+\f[C]dotnet\ msbuild\ /p:Configuration=Release\f[]
+.PP
+Run the publish target and publish for the \f[C]osx.10.11\-x64\f[] RID:
+.PP
+\f[C]dotnet\ msbuild\ /t:Publish\ /p:RuntimeIdentifiers=osx.10.11\-x64\f[]
+.PP
+See the whole project with all targets included by the SDK:
+.PP
+\f[C]dotnet\ msbuild\ /pp\f[]
+.SH AUTHORS
+mairaw.

Documentation/manpages/sdk/dotnet-new.1

@@ -1,81 +1,602 @@
-.\" Automatically generated by Pandoc 1.15.1
+.\"t
+.\" Automatically generated by Pandoc 2.1.3
 .\"
+.TH "dotnet new command \- .NET Core CLI" "1" "" "" ".NET Core"
 .hy
-.TH "DOTNET\-NEW" "1" "June 2016" "" ""
+.SH dotnet new
-.SS NAME
 .PP
-dotnet\-new \-\- Create a new sample .NET Core project
+.SH NAME
-.SS SYNOPSIS
 .PP
-dotnet new [\-\-type] [\-\-lang]
+\f[C]dotnet\ new\f[] \- Creates a new project, configuration file, or solution based on the specified template.
-.SS DESCRIPTION
+.SH SYNOPSIS
+.SS .NET Core 2.0
+.IP
+.nf
+\f[C]
+dotnet\ new\ <TEMPLATE>\ [\-\-force]\ [\-i|\-\-install]\ [\-lang|\-\-language]\ [\-n|\-\-name]\ [\-o|\-\-output]\ [\-u|\-\-uninstall]\ [Template\ options]
+dotnet\ new\ <TEMPLATE>\ [\-l|\-\-list]\ [\-\-type]
+dotnet\ new\ [\-h|\-\-help]
+\f[]
+.fi
+.SS .NET Core 1.x
+.IP
+.nf
+\f[C]
+dotnet\ new\ <TEMPLATE>\ [\-lang|\-\-language]\ [\-n|\-\-name]\ [\-o|\-\-output]\ [\-all|\-\-show\-all]\ [\-h|\-\-help]\ [Template\ options]
+dotnet\ new\ <TEMPLATE>\ [\-l|\-\-list]
+dotnet\ new\ [\-all|\-\-show\-all]
+dotnet\ new\ [\-h|\-\-help]
+\f[]
+.fi
 .PP
-The \f[C]dotnet\ new\f[] command provides a convenient way to initialize
+   *   *   *   *   *
-a valid .NET Core project and sample source code to try out the Command
+.SH DESCRIPTION
-Line Interface (CLI) toolset.
 .PP
-This command is invoked in the context of a directory.
+The \f[C]dotnet\ new\f[] command provides a convenient way to initialize a valid .NET Core project.
-When invoked, the command will result in two main artifacts being
-dropped to the directory:
-.IP "1." 3
-A \f[C]Program.cs\f[] (or \f[C]Program.fs\f[]) file that contains a
-sample "Hello World" program.
-.IP "2." 3
-A valid \f[C]project.json\f[] file.
 .PP
-After this, the project is ready to be compiled and/or edited further.
+The command calls the template engine to create the artifacts on disk based on the specified template and options.
-.SS Options
+.SS Arguments
 .PP
-\f[C]\-l\f[], \f[C]\-\-lang\ [C#|F#]\f[]
+\f[C]TEMPLATE\f[]
 .PP
-Language of the project.
+The template to instantiate when the command is invoked.
-Defaults to \f[C]C#\f[].
+Each template might have specific options you can pass.
-\f[C]csharp\f[] (\f[C]fsharp\f[]) or \f[C]cs\f[] (\f[C]fs\f[]) are also
+For more information, see Template options.
-valid options.
+.SS .NET Core 2.0
 .PP
-\f[C]\-t\f[], \f[C]\-\-type\f[]
+The command contains a default list of templates.
+Use \f[C]dotnet\ new\ \-l\f[] to obtain a list of the available templates.
+The following table shows the templates that come pre\-installed with the .NET Core 2.0 SDK.
+The default language for the template is shown inside the brackets.
 .PP
-Type of the project.
+.TS
-Valid values for C# are:
+tab(@);
-.IP \[bu] 2
+l l l.
+T{
+Template description
+T}@T{
+Template name
+T}@T{
+Languages
+T}
+_
+T{
+Console application
+T}@T{
 \f[C]console\f[]
-.IP \[bu] 2
+T}@T{
+[C#], F#, VB
+T}
+T{
+Class library
+T}@T{
+\f[C]classlib\f[]
+T}@T{
+[C#], F#, VB
+T}
+T{
+Unit test project
+T}@T{
+\f[C]mstest\f[]
+T}@T{
+[C#], F#, VB
+T}
+T{
+xUnit test project
+T}@T{
+\f[C]xunit\f[]
+T}@T{
+[C#], F#, VB
+T}
+T{
+ASP.NET Core empty
+T}@T{
 \f[C]web\f[]
-.IP \[bu] 2
+T}@T{
-\f[C]lib\f[]
+[C#], F#
-.IP \[bu] 2
+T}
-\f[C]xunittest\f[]
+T{
+ASP.NET Core Web App (Model\-View\-Controller)
+T}@T{
+\f[C]mvc\f[]
+T}@T{
+[C#], F#
+T}
+T{
+ASP.NET Core Web App
+T}@T{
+\f[C]razor\f[]
+T}@T{
+[C#]
+T}
+T{
+ASP.NET Core with Angular
+T}@T{
+\f[C]angular\f[]
+T}@T{
+[C#]
+T}
+T{
+ASP.NET Core with React.js
+T}@T{
+\f[C]react\f[]
+T}@T{
+[C#]
+T}
+T{
+ASP.NET Core with React.js and Redux
+T}@T{
+\f[C]reactredux\f[]
+T}@T{
+[C#]
+T}
+T{
+ASP.NET Core Web API
+T}@T{
+\f[C]webapi\f[]
+T}@T{
+[C#], F#
+T}
+T{
+global.json file
+T}@T{
+\f[C]globaljson\f[]
+T}@T{
+T}
+T{
+Nuget config
+T}@T{
+\f[C]nugetconfig\f[]
+T}@T{
+T}
+T{
+Web config
+T}@T{
+\f[C]webconfig\f[]
+T}@T{
+T}
+T{
+Solution file
+T}@T{
+\f[C]sln\f[]
+T}@T{
+T}
+T{
+Razor page
+T}@T{
+\f[C]page\f[]
+T}@T{
+T}
+T{
+MVC ViewImports
+T}@T{
+\f[C]viewimports\f[]
+T}@T{
+T}
+T{
+MVC ViewStart
+T}@T{
+\f[C]viewstart\f[]
+T}@T{
+T}
+.TE
+.SS .NET Core 1.x
 .PP
-Valid values for F# are:
+The command contains a default list of templates.
-.IP \[bu] 2
+Use \f[C]dotnet\ new\ \-all\f[] to obtain a list of the available templates.
+The following table shows the templates that come pre\-installed with the .NET Core 1.x SDK.
+The default language for the template is shown inside the brackets.
+.PP
+.TS
+tab(@);
+l l l.
+T{
+Template description
+T}@T{
+Template name
+T}@T{
+Languages
+T}
+_
+T{
+Console application
+T}@T{
 \f[C]console\f[]
-.SS EXAMPLES
+T}@T{
+[C#], F#
+T}
+T{
+Class library
+T}@T{
+\f[C]classlib\f[]
+T}@T{
+[C#], F#
+T}
+T{
+Unit test project
+T}@T{
+\f[C]mstest\f[]
+T}@T{
+[C#], F#
+T}
+T{
+xUnit test project
+T}@T{
+\f[C]xunit\f[]
+T}@T{
+[C#], F#
+T}
+T{
+ASP.NET Core empty
+T}@T{
+\f[C]web\f[]
+T}@T{
+[C#]
+T}
+T{
+ASP.NET Core Web App
+T}@T{
+\f[C]mvc\f[]
+T}@T{
+[C#], F#
+T}
+T{
+ASP.NET Core Web API
+T}@T{
+\f[C]webapi\f[]
+T}@T{
+[C#]
+T}
+T{
+Nuget config
+T}@T{
+\f[C]nugetconfig\f[]
+T}@T{
+T}
+T{
+Web config
+T}@T{
+\f[C]webconfig\f[]
+T}@T{
+T}
+T{
+Solution file
+T}@T{
+\f[C]sln\f[]
+T}@T{
+T}
+.TE
 .PP
-\f[C]dotnet\ new\f[]
+   *   *   *   *   *
+.SH OPTIONS
+.SS .NET Core 2.0
+.PP
+\f[C]\-\-force\f[]
+.PP
+Forces content to be generated even if it would change existing files.
+This is required when the output directory already contains a project.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out help for the command.
+It can be invoked for the \f[C]dotnet\ new\f[] command itself or for any template, such as \f[C]dotnet\ new\ mvc\ \-\-help\f[].
+.PP
+\f[C]\-i|\-\-install\ <PATH|NUGET_ID>\f[]
+.PP
+Installs a source or template pack from the \f[C]PATH\f[] or \f[C]NUGET_ID\f[] provided.
+If you want to install a prerelease version of a template package, you need to specify the version in the format of \f[C]<package\-name>::<package\-version>\f[].
+By default, \f[C]dotnet\ new\f[] passes * for the version, which represents the last stable package version.
+See an example at the Examples section.
+.PP
+For information on creating custom templates, see Custom templates for dotnet new.
+.PP
+\f[C]\-l|\-\-list\f[]
+.PP
+Lists templates containing the specified name.
+If invoked for the \f[C]dotnet\ new\f[] command, it lists the possible templates available for the given directory.
+For example if the directory already contains a project, it doesn't list all project templates.
+.PP
+\f[C]\-lang|\-\-language\ {C#|F#|VB}\f[]
+.PP
+The language of the template to create.
+The language accepted varies by the template (see defaults in the arguments section).
+Not valid for some templates.
 .IP
 .nf
 \f[C]
-Drops\ a\ sample\ C##\ project\ in\ the\ current\ directory.
+>\ [!NOTE]
+>\ Some\ shells\ interpret\ `#`\ as\ a\ special\ character.\ In\ those\ cases,\ you\ need\ to\ enclose\ the\ language\ parameter\ value,\ such\ as\ `dotnet\ new\ console\ \-lang\ "F#"`.
 \f[]
 .fi
 .PP
-\f[C]dotnet\ new\ \-\-lang\ f##\f[]
+\f[C]\-n|\-\-name\ <OUTPUT_NAME>\f[]
+.PP
+The name for the created output.
+If no name is specified, the name of the current directory is used.
+.PP
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Location to place the generated output.
+The default is the current directory.
+.PP
+\f[C]\-\-type\f[]
+.PP
+Filters templates based on available types.
+Predefined values are \[lq]project\[rq], \[lq]item\[rq] or \[lq]other\[rq].
+.PP
+\f[C]\-u|\-\-uninstall\ <PATH|NUGET_ID>\f[]
+.PP
+Uninstalls a source or template pack at the \f[C]PATH\f[] or \f[C]NUGET_ID\f[] provided.
+.RS
+.PP
+[!NOTE] To uninstall a template using a \f[C]PATH\f[], you need to fully qualify the path.
+For example, \f[I]C:/Users/<USER>/Documents/Templates/GarciaSoftware.ConsoleTemplate.CSharp\f[] will work, but \f[I]./GarciaSoftware.ConsoleTemplate.CSharp\f[] from the containing folder will not.
+Additionally, do not include a final terminating directory slash on your template path.
+.RE
+.SS .NET Core 1.x
+.PP
+\f[C]\-all|\-\-show\-all\f[]
+.PP
+Shows all templates for a specific type of project when running in the context of the \f[C]dotnet\ new\f[] command alone.
+When running in the context of a specific template, such as \f[C]dotnet\ new\ web\ \-all\f[], \f[C]\-all\f[] is interpreted as a force creation flag.
+This is required when the output directory already contains a project.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out help for the command.
+It can be invoked for the \f[C]dotnet\ new\f[] command itself or for any template, such as \f[C]dotnet\ new\ mvc\ \-\-help\f[].
+.PP
+\f[C]\-l|\-\-list\f[]
+.PP
+Lists templates containing the specified name.
+If invoked for the \f[C]dotnet\ new\f[] command, it lists the possible templates available for the given directory.
+For example if the directory already contains a project, it doesn't list all project templates.
+.PP
+\f[C]\-lang|\-\-language\ {C#|F#}\f[]
+.PP
+The language of the template to create.
+The language accepted varies by the template (see defaults in the arguments section).
+Not valid for some templates.
 .IP
 .nf
 \f[C]
-Drops\ a\ sample\ F##\ project\ in\ the\ current\ directory.
+>\ [!NOTE]
+>\ Some\ shells\ interpret\ `#`\ as\ a\ special\ character.\ In\ those\ cases,\ you\ need\ to\ enclose\ the\ language\ parameter\ value,\ such\ as\ `dotnet\ new\ console\ \-lang\ "F#"`.
 \f[]
 .fi
 .PP
-\f[C]dotnet\ new\ \-\-lang\ c##\f[]
+\f[C]\-n|\-\-name\ <OUTPUT_NAME>\f[]
-.IP
-.nf
-\f[C]
-Drops\ a\ sample\ C##\ project\ in\ the\ current\ directory.
-\f[]
-.fi
-.SH SEE ALSO
 .PP
-dotnet\-run(1)
+The name for the created output.
+If no name is specified, the name of the current directory is used.
+.PP
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Location to place the generated output.
+The default is the current directory.
+.PP
+   *   *   *   *   *
+.SS Template options
+.PP
+Each project template may have additional options available.
+The core templates have the following additional options:
+.SS .NET Core 2.0
+.PP
+\f[B]console, angular, react, reactredux\f[]
+.PP
+\f[C]\-\-no\-restore\f[] \- Doesn't perform an implicit restore during project creation.
+.PP
+\f[B]classlib\f[]
+.PP
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[] \- Specifies the framework to target.
+Values: \f[C]netcoreapp2.0\f[] to create a .NET Core Class Library or \f[C]netstandard2.0\f[] to create a .NET Standard Class Library.
+The default value is \f[C]netstandard2.0\f[].
+.PP
+\f[C]\-\-no\-restore\f[] \- Doesn't perform an implicit restore during project creation.
+.PP
+\f[B]mstest, xunit\f[]
+.PP
+\f[C]\-p|\-\-enable\-pack\f[] \- Enables packaging for the project using dotnet pack.
+.PP
+\f[C]\-\-no\-restore\f[] \- Doesn't perform an implicit restore during project creation.
+.PP
+\f[B]globaljson\f[]
+.PP
+\f[C]\-\-sdk\-version\ <VERSION_NUMBER>\f[] \- Specifies the version of the .NET Core SDK to use in the \f[I]global.json\f[] file.
+.PP
+\f[B]web\f[]
+.PP
+\f[C]\-\-use\-launch\-settings\f[] \- Includes \f[I]launchSettings.json\f[] in the generated template output.
+.PP
+\f[C]\-\-no\-restore\f[] \- Doesn't perform an implicit restore during project creation.
+.PP
+\f[B]webapi\f[]
+.PP
+\f[C]\-au|\-\-auth\ <AUTHENTICATION_TYPE>\f[] \- The type of authentication to use.
+The possible values are:
+.IP \[bu] 2
+\f[C]None\f[] \- No authentication (Default).
+.IP \[bu] 2
+\f[C]IndividualB2C\f[] \- Individual authentication with Azure AD B2C.
+.IP \[bu] 2
+\f[C]SingleOrg\f[] \- Organizational authentication for a single tenant.
+.IP \[bu] 2
+\f[C]Windows\f[] \- Windows authentication.
+.PP
+\f[C]\-\-aad\-b2c\-instance\ <INSTANCE>\f[] \- The Azure Active Directory B2C instance to connect to.
+Use with \f[C]IndividualB2C\f[] authentication.
+The default value is \f[C]https://login.microsoftonline.com/tfp/\f[].
+.PP
+\f[C]\-ssp|\-\-susi\-policy\-id\ <ID>\f[] \- The sign\-in and sign\-up policy ID for this project.
+Use with \f[C]IndividualB2C\f[] authentication.
+.PP
+\f[C]\-\-aad\-instance\ <INSTANCE>\f[] \- The Azure Active Directory instance to connect to.
+Use with \f[C]SingleOrg\f[] authentication.
+The default value is \f[C]https://login.microsoftonline.com/\f[].
+.PP
+\f[C]\-\-client\-id\ <ID>\f[] \- The Client ID for this project.
+Use with \f[C]IndividualB2C\f[] or \f[C]SingleOrg\f[] authentication.
+The default value is \f[C]11111111\-1111\-1111\-11111111111111111\f[].
+.PP
+\f[C]\-\-domain\ <DOMAIN>\f[] \- The domain for the directory tenant.
+Use with \f[C]SingleOrg\f[] or \f[C]IndividualB2C\f[] authentication.
+The default value is \f[C]qualified.domain.name\f[].
+.PP
+\f[C]\-\-tenant\-id\ <ID>\f[] \- The TenantId ID of the directory to connect to.
+Use with \f[C]SingleOrg\f[] authentication.
+The default value is \f[C]22222222\-2222\-2222\-2222\-222222222222\f[].
+.PP
+\f[C]\-r|\-\-org\-read\-access\f[] \- Allows this application read\-access to the directory.
+Only applies to \f[C]SingleOrg\f[] or \f[C]MultiOrg\f[] authentication.
+.PP
+\f[C]\-\-use\-launch\-settings\f[] \- Includes \f[I]launchSettings.json\f[] in the generated template output.
+.PP
+\f[C]\-uld|\-\-use\-local\-db\f[] \- Specifies LocalDB should be used instead of SQLite.
+Only applies to \f[C]Individual\f[] or \f[C]IndividualB2C\f[] authentication.
+.PP
+\f[C]\-\-no\-restore\f[] \- Doesn't perform an implicit restore during project creation.
+.PP
+\f[B]mvc, razor\f[]
+.PP
+\f[C]\-au|\-\-auth\ <AUTHENTICATION_TYPE>\f[] \- The type of authentication to use.
+The possible values are:
+.IP \[bu] 2
+\f[C]None\f[] \- No authentication (Default).
+.IP \[bu] 2
+\f[C]Individual\f[] \- Individual authentication.
+.IP \[bu] 2
+\f[C]IndividualB2C\f[] \- Individual authentication with Azure AD B2C.
+.IP \[bu] 2
+\f[C]SingleOrg\f[] \- Organizational authentication for a single tenant.
+.IP \[bu] 2
+\f[C]MultiOrg\f[] \- Organizational authentication for multiple tenants.
+.IP \[bu] 2
+\f[C]Windows\f[] \- Windows authentication.
+.PP
+\f[C]\-\-aad\-b2c\-instance\ <INSTANCE>\f[] \- The Azure Active Directory B2C instance to connect to.
+Use with \f[C]IndividualB2C\f[] authentication.
+The default value is \f[C]https://login.microsoftonline.com/tfp/\f[] .
+.PP
+\f[C]\-ssp|\-\-susi\-policy\-id\ <ID>\f[] \- The sign\-in and sign\-up policy ID for this project.
+Use with \f[C]IndividualB2C\f[] authentication.
+.PP
+\f[C]\-rp|\-\-reset\-password\-policy\-id\ <ID>\f[] \- The reset password policy ID for this project.
+Use with \f[C]IndividualB2C\f[] authentication.
+.PP
+\f[C]\-ep|\-\-edit\-profile\-policy\-id\ <ID>\f[] \- The edit profile policy ID for this project.
+Use with \f[C]IndividualB2C\f[] authentication.
+.PP
+\f[C]\-\-aad\-instance\ <INSTANCE>\f[] \- The Azure Active Directory instance to connect to.
+Use with \f[C]SingleOrg\f[] or \f[C]MultiOrg\f[] authentication.
+The default value is \f[C]https://login.microsoftonline.com/\f[].
+.PP
+\f[C]\-\-client\-id\ <ID>\f[] \- The Client ID for this project.
+Use with \f[C]IndividualB2C\f[], \f[C]SingleOrg\f[], or \f[C]MultiOrg\f[] authentication.
+The default value is \f[C]11111111\-1111\-1111\-11111111111111111\f[].
+.PP
+\f[C]\-\-domain\ <DOMAIN>\f[] \- The domain for the directory tenant.
+Use with \f[C]SingleOrg\f[] or \f[C]IndividualB2C\f[] authentication..
+The default value is \f[C]qualified.domain.name\f[].
+.PP
+\f[C]\-\-tenant\-id\ <ID>\f[] \- The TenantId ID of the directory to connect to.
+Use with \f[C]SingleOrg\f[] authentication..
+The default value is \f[C]22222222\-2222\-2222\-2222\-222222222222\f[].
+.PP
+\f[C]\-\-callback\-path\ <PATH>\f[] \- The request path within the application's base path of the redirect URI.
+Use with \f[C]SingleOrg\f[] or \f[C]IndividualB2C\f[] authentication..
+The default value is \f[C]/signin\-oidc\f[].
+.PP
+\f[C]\-r|\-\-org\-read\-access\f[] \- Allows this application read\-access to the directory.
+Only applies to \f[C]SingleOrg\f[] or \f[C]MultiOrg\f[] authentication.
+.PP
+\f[C]\-\-use\-launch\-settings\f[] \- Includes \f[I]launchSettings.json\f[] in the generated template output.
+.PP
+\f[C]\-\-use\-browserlink\f[] \- Includes BrowserLink in the project.
+.PP
+\f[C]\-uld|\-\-use\-local\-db\f[] \- Specifies LocalDB should be used instead of SQLite.
+Only applies to \f[C]Individual\f[] or \f[C]IndividualB2C\f[] authentication.
+.PP
+\f[C]\-\-no\-restore\f[] \- Doesn't perform an implicit restore during project creation.
+.PP
+\f[B]page\f[]
+.PP
+\f[C]\-na|\-\-namespace\ <NAMESPACE_NAME>\f[]\- Namespace for the generated code.
+The default value is \f[C]MyApp.Namespace\f[].
+.PP
+\f[C]\-np|\-\-no\-pagemodel\f[] \- Creates the page without a PageModel.
+.PP
+\f[B]viewimports\f[]
+.PP
+\f[C]\-na|\-\-namespace\ <NAMESPACE_NAME>\f[]\- Namespace for the generated code.
+The default value is \f[C]MyApp.Namespace\f[].
+.SS .NET Core 1.x
+.PP
+\f[B]console, xunit, mstest, web, webapi\f[]
+.PP
+\f[C]\-f|\-\-framework\f[] \- Specifies the framework to target.
+Values: \f[C]netcoreapp1.0\f[] or \f[C]netcoreapp1.1\f[].
+The default value is \f[C]netcoreapp1.0\f[].
+.PP
+\f[B]classlib\f[]
+.PP
+\f[C]\-f|\-\-framework\f[] \- Specifies the framework to target.
+Values: \f[C]netcoreapp1.0\f[], \f[C]netcoreapp1.1\f[], or \f[C]netstandard1.0\f[] to \f[C]netstandard1.6\f[].
+The default value is \f[C]netstandard1.4\f[].
+.PP
+\f[B]mvc\f[]
+.PP
+\f[C]\-f|\-\-framework\f[] \- Specifies the framework to target.
+Values: \f[C]netcoreapp1.0\f[] or \f[C]netcoreapp1.1\f[].
+The default value is \f[C]netcoreapp1.0\f[].
+.PP
+\f[C]\-au|\-\-auth\f[] \- The type of authentication to use.
+Values: \f[C]None\f[] or \f[C]Individual\f[].
+The default value is \f[C]None\f[].
+.PP
+\f[C]\-uld|\-\-use\-local\-db\f[] \- Specifies whether or not to use LocalDB instead of SQLite.
+Values: \f[C]true\f[] or \f[C]false\f[].
+The default value is \f[C]false\f[].
+.PP
+   *   *   *   *   *
+.SH EXAMPLES
+.PP
+Create an F# console application project in the current directory:
+.PP
+\f[C]dotnet\ new\ console\ \-lang\ F#\f[]
+.PP
+Create a .NET Standard class library project in the specified directory (available only with .NET Core 2.0 SDK or later versions):
+.PP
+\f[C]dotnet\ new\ classlib\ \-lang\ VB\ \-o\ MyLibrary\f[]
+.PP
+Create a new ASP.NET Core C# MVC application project in the current directory with no authentication targeting .NET Core 2.0:
+.PP
+\f[C]dotnet\ new\ mvc\ \-au\ None\ \-f\ netcoreapp2.0\f[]
+.PP
+Create a new xUnit application targeting .NET Core 2.0:
+.PP
+\f[C]dotnet\ new\ xunit\ \-\-framework\ netcoreapp2.0\f[]
+.PP
+List all templates available for MVC:
+.PP
+\f[C]dotnet\ new\ mvc\ \-l\f[]
+.PP
+Install version 2.0 of the Single Page Application templates for ASP.NET Core (command option available for .NET Core SDK 1.1 and later versions only):
+.PP
+\f[C]dotnet\ new\ \-i\ Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0\f[]
+.SS See also
+.PP
+Custom templates for dotnet new
+.PD 0
+.P
+.PD
+Create a custom template for dotnet new
+.PD 0
+.P
+.PD
+dotnet/dotnet\-template\-samples GitHub repo
+.PD 0
+.P
+.PD
+Available templates for dotnet new
 .SH AUTHORS
-Microsoft Corporation dotnetclifeedback\@microsoft.com.
+mairaw.

Documentation/manpages/sdk/dotnet-nuget-delete.1

@@ -0,0 +1,59 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet nuget delete command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet nuget delete
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ nuget\ delete\f[] \- Deletes or unlists a package from the server.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ nuget\ delete\ [<PACKAGE_NAME>\ <PACKAGE_VERSION>]\ [\-s|\-\-source]\ [\-\-non\-interactive]\ [\-k|\-\-api\-key]\ [\-\-force\-english\-output]\ [\-h|\-\-help]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ nuget\ delete\f[] command deletes or unlists a package from the server.
+For nuget.org, the action is to unlist the package.
+.SS Arguments
+.PP
+\f[C]PACKAGE_NAME\f[]
+.PP
+Package to delete.
+.PP
+\f[C]PACKAGE_VERSION\f[]
+.PP
+Version of the package to delete.
+.SH OPTIONS
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-s|\-\-source\ <SOURCE>\f[]
+.PP
+Specifies the server URL.
+Supported URLs for nuget.org include \f[C]http://www.nuget.org\f[], \f[C]http://www.nuget.org/api/v3\f[], and \f[C]http://www.nuget.org/api/v2/package\f[].
+For private feeds, substitute the host name (for example, \f[C]%hostname%/api/v3\f[]).
+.PP
+\f[C]\-\-non\-interactive\f[]
+.PP
+Doesn't prompt for user input or confirmations.
+.PP
+\f[C]\-k|\-\-api\-key\ <API_KEY>\f[]
+.PP
+The API key for the server.
+.PP
+\f[C]\-\-force\-english\-output\f[]
+.PP
+Forces command\-line output in English.
+.SH EXAMPLES
+.PP
+Deletes version 1.0 of package \f[C]Microsoft.AspNetCore.Mvc\f[]:
+.PP
+\f[C]dotnet\ nuget\ delete\ Microsoft.AspNetCore.Mvc\ 1.0\f[]
+.PP
+Deletes version 1.0 of package \f[C]Microsoft.AspNetCore.Mvc\f[], not prompting user for credentials or other input:
+.PP
+\f[C]dotnet\ nuget\ delete\ Microsoft.AspNetCore.Mvc\ 1.0\ \-\-non\-interactive\f[]
+.SH AUTHORS
+karann\-msft.

Documentation/manpages/sdk/dotnet-nuget-locals.1

@@ -0,0 +1,77 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet nuget locals command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet nuget locals
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ nuget\ locals\f[] \- Clears or lists local NuGet resources.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ nuget\ locals\ <CACHE_LOCATION>\ [(\-c|\-\-clear)|(\-l|\-\-list)]\ [\-\-force\-english\-output]\ [\-h|\-\-help]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ nuget\ locals\f[] command clears or lists local NuGet resources in the http\-request cache, temporary cache, or machine\-wide global packages folder.
+.SS Arguments
+.PP
+\f[C]CACHE_LOCATION\f[]
+.PP
+One of the following values:
+.IP \[bu] 2
+\f[C]all\f[] \- Indicates that the specified operation is applied to all cache types: http\-request cache, global packages cache, and the temporary cache.
+.IP \[bu] 2
+\f[C]http\-cache\f[] \- Indicates that the specified operation is applied only to the http\-request cache.
+The other cache locations are not affected.
+.IP \[bu] 2
+\f[C]global\-packages\f[] \- Indicates that the specified operation is applied only to the global packages cache.
+The other cache locations are not affected.
+.IP \[bu] 2
+\f[C]temp\f[] \- Indicates that the specified operation is applied only to the temporary cache.
+The other cache locations are not affected.
+.SH OPTIONS
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-c|\-\-clear\f[]
+.PP
+The clear option performs a clear operation on the specified cache type.
+The contents of the cache directories are deleted recursively.
+The executing user/group must have permission to the files in the cache directories.
+If not, an error is displayed indicating the files/folders which were not cleared.
+.PP
+\f[C]\-l|\-\-list\f[]
+.PP
+The list option is used to display the location of the specified cache type.
+.PP
+\f[C]\-\-force\-english\-output\f[]
+.PP
+Forces command\-line output in English.
+.SH EXAMPLES
+.PP
+Displays the paths of all the local cache directories (http\-cache directory, global\-packages cache directory, and temporary cache directory):
+.PP
+\f[C]dotnet\ nuget\ locals\ \[en]l\ all\f[]
+.PP
+Displays the path for the local http\-cache directory:
+.PP
+\f[C]dotnet\ nuget\ locals\ \-\-list\ http\-cache\f[]
+.PP
+Clears all files from all local cache directories (http\-cache directory, global\-packages cache directory, and temporary cache directory):
+.PP
+\f[C]dotnet\ nuget\ locals\ \-\-clear\ all\f[]
+.PP
+Clears all files in local global\-packages cache directory:
+.PP
+\f[C]dotnet\ nuget\ locals\ \-c\ global\-packages\f[]
+.PP
+Clears all files in local temporary cache directory:
+.PP
+\f[C]dotnet\ nuget\ locals\ \-c\ temp\f[]
+.SS Troubleshooting
+.PP
+For information on common problems and errors while using the \f[C]dotnet\ nuget\ locals\f[] command, see Managing the NuGet cache.
+.SH AUTHORS
+karann\-msft.

Documentation/manpages/sdk/dotnet-nuget-push.1

@@ -0,0 +1,94 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet nuget push command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet nuget push
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ nuget\ push\f[] \- Pushes a package to the server and publishes it.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ nuget\ push\ [<ROOT>]\ [\-s|\-\-source]\ [\-ss|\-\-symbol\-source]\ [\-t|\-\-timeout]\ [\-k|\-\-api\-key]\ [\-sk|\-\-symbol\-api\-key]\ [\-d|\-\-disable\-buffering]\ [\-n|\-\-no\-symbols]\ [\-\-force\-english\-output]\ [\-h|\-\-help]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ nuget\ push\f[] command pushes a package to the server and publishes it.
+The push command uses server and credential details found in the system's NuGet config file or chain of config files.
+For more information on config files, see Configuring NuGet Behavior.
+NuGet's default configuration is obtained by loading \f[I]%AppData%.config\f[] (Windows) or \f[I]$HOME/.local/share\f[] (Linux/macOS), then loading any \f[I]nuget.config\f[] or \f[I].nuget.config\f[] starting from the root of drive and ending in the current directory.
+.SS Arguments
+.PP
+\f[C]ROOT\f[]
+.PP
+Specifies the file path to the package to be pushed.
+.SH OPTIONS
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-s|\-\-source\ <SOURCE>\f[]
+.PP
+Specifies the server URL.
+This option is required unless \f[C]DefaultPushSource\f[] config value is set in the NuGet config file.
+.PP
+\f[C]\-\-symbol\-source\ <SOURCE>\f[]
+.PP
+Specifies the symbol server URL.
+.PP
+\f[C]\-t|\-\-timeout\ <TIMEOUT>\f[]
+.PP
+Specifies the timeout for pushing to a server in seconds.
+Defaults to 300 seconds (5 minutes).
+Specifying 0 (zero seconds) applies the default value.
+.PP
+\f[C]\-k|\-\-api\-key\ <API_KEY>\f[]
+.PP
+The API key for the server.
+.PP
+\f[C]\-\-symbol\-api\-key\ <API_KEY>\f[]
+.PP
+The API key for the symbol server.
+.PP
+\f[C]\-d|\-\-disable\-buffering\f[]
+.PP
+Disables buffering when pushing to an HTTP(S) server to decrease memory usage.
+.PP
+\f[C]\-n|\-\-no\-symbols\f[]
+.PP
+Doesn't push symbols (even if present).
+.PP
+\f[C]\-\-force\-english\-output\f[]
+.PP
+Forces all logged output in English.
+.SH EXAMPLES
+.PP
+Pushes \f[I]foo.nupkg\f[] to the default push source, providing an API key:
+.PP
+\f[C]dotnet\ nuget\ push\ foo.nupkg\ \-k\ 4003d786\-cc37\-4004\-bfdf\-c4f3e8ef9b3a\f[]
+.PP
+Push \f[I]foo.nupkg\f[] to the custom push source \f[C]http://customsource\f[], providing an API key:
+.PP
+\f[C]dotnet\ nuget\ push\ foo.nupkg\ \-k\ 4003d786\-cc37\-4004\-bfdf\-c4f3e8ef9b3a\ \-s\ http://customsource/\f[]
+.PP
+Pushes \f[I]foo.nupkg\f[] to the default push source:
+.PP
+\f[C]dotnet\ nuget\ push\ foo.nupkg\f[]
+.PP
+Pushes \f[I]foo.symbols.nupkg\f[] to the default symbols source:
+.PP
+\f[C]dotnet\ nuget\ push\ foo.symbols.nupkg\f[]
+.PP
+Pushes \f[I]foo.nupkg\f[] to the default push source, specifying a 360 second timeout:
+.PP
+\f[C]dotnet\ nuget\ push\ foo.nupkg\ \-\-timeout\ 360\f[]
+.PP
+Pushes all \f[I].nupkg\f[] files in the current directory to the default push source:
+.PP
+\f[C]dotnet\ nuget\ push\ *.nupkg\f[]
+.PP
+Pushes all \f[I].nupkg\f[] files in the current directory to the default push source, specifying a custom config file \f[I]./config/My.Config\f[]:
+.PP
+\f[C]dotnet\ nuget\ push\ *.nupkg\ \-\-config\-file\ ./config/My.Config\f[]
+.SH AUTHORS
+karann\-msft.

Documentation/manpages/sdk/dotnet-pack.1

@@ -1,91 +1,190 @@
-.\" Automatically generated by Pandoc 1.15.1
+.\" Automatically generated by Pandoc 2.1.3
 .\"
+.TH "dotnet pack command \- .NET Core CLI" "1" "" "" ".NET Core"
 .hy
-.TH "DOTNET\-PACK" "1" "June 2016" "" ""
+.SH dotnet pack
-.SS NAME
 .PP
-\f[C]dotnet\-pack\f[] \- Packs the code into a NuGet package
+.SH NAME
-.SS SYNOPSIS
 .PP
-\f[C]dotnet\ pack\ [\-\-output]\ \ \ \ \ \ \ [\-\-no\-build]\ [\-\-build\-base\-path]\ \ \ \ \ \ \ [\-\-configuration]\ \ [\-\-version\-suffix]\ \ \ \ \ [<project>]\f[]
+\f[C]dotnet\ pack\f[] \- Packs the code into a NuGet package.
-.SS DESCRIPTION
+.SH SYNOPSIS
-.PP
+.SS .NET Core 2.x
-The \f[C]dotnet\ pack\f[] command builds the project and creates NuGet
-packages.
-The result of this operation is two packages with the \f[C]nupkg\f[]
-extension.
-One package contains the code and the other contains the debug symbols.
-.PP
-NuGet dependencies of the project being packed are added to the nuspec
-file, so they are able to be resolved when the package is installed.
-Project\-to\-project references are not packaged inside the project by
-default.
-If you wish to do this, you need to reference the required project in
-your dependencies node with a \f[C]type\f[] set to "build" like in the
-following example:
 .IP
 .nf
 \f[C]
-{
+dotnet\ pack\ [<PROJECT>]\ [\-c|\-\-configuration]\ [\-\-force]\ [\-\-include\-source]\ [\-\-include\-symbols]\ [\-\-no\-build]\ [\-\-no\-dependencies]
-\ \ \ \ "version":\ "1.0.0\-*",
+\ \ \ \ [\-\-no\-restore]\ [\-o|\-\-output]\ [\-\-runtime]\ [\-s|\-\-serviceable]\ [\-v|\-\-verbosity]\ [\-\-version\-suffix]
-\ \ \ \ "dependencies":\ {
+dotnet\ pack\ [\-h|\-\-help]
-\ \ \ \ \ \ \ \ "ProjectA":\ {
+\f[]
-\ \ \ \ \ \ \ \ \ \ \ \ "target":\ "project",
+.fi
-\ \ \ \ \ \ \ \ \ \ \ \ "type":\ "build"
+.SS .NET Core 1.x
-\ \ \ \ \ \ \ \ }
+.IP
-\ \ \ \ }
+.nf
-}
+\f[C]
+dotnet\ pack\ [<PROJECT>]\ [\-c|\-\-configuration]\ [\-\-include\-source]\ [\-\-include\-symbols]\ [\-\-no\-build]\ [\-o|\-\-output]\ [\-s|\-\-serviceable]\ [\-v|\-\-verbosity]\ [\-\-version\-suffix]
+dotnet\ pack\ [\-h|\-\-help]
 \f[]
 .fi
 .PP
-\f[C]dotnet\ pack\f[] by default first builds the project.
+   *   *   *   *   *
-If you wish to avoid this, pass the \f[C]\-\-no\-build\f[] option.
+.SH DESCRIPTION
-This can be useful in Continuous Integration (CI) build scenarios in
-which you know the code was just previously built, for example.
-.SS OPTIONS
 .PP
-\f[C][project]\f[]
+The \f[C]dotnet\ pack\f[] command builds the project and creates NuGet packages.
+The result of this command is a NuGet package.
+If the \f[C]\-\-include\-symbols\f[] option is present, another package containing the debug symbols is created.
+.PP
+NuGet dependencies of the packed project are added to the \f[I].nuspec\f[] file, so they're properly resolved when the package is installed.
+Project\-to\-project references aren't packaged inside the project.
+Currently, you must have a package per project if you have project\-to\-project dependencies.
+.PP
+By default, \f[C]dotnet\ pack\f[] builds the project first.
+If you wish to avoid this behavior, pass the \f[C]\-\-no\-build\f[] option.
+This is often useful in Continuous Integration (CI) build scenarios where you know the code was previously built.
+.PP
+You can provide MSBuild properties to the \f[C]dotnet\ pack\f[] command for the packing process.
+For more information, see NuGet metadata properties and the MSBuild Command\-Line Reference.
+The Examples section shows how to use the MSBuild /p switch for a couple of different scenarios.
+.PP
+.SS Arguments
+.PP
+\f[C]PROJECT\f[]
 .PP
 The project to pack.
-It can be either a path to a \f[C]project.json\f[] file or to a
+It's either a path to a csproj file or to a directory.
-directory.
+If omitted, it defaults to the current directory.
-If omitted, it will default to the current directory.
+.SH OPTIONS
+.SS .NET Core 2.x
 .PP
-\f[C]\-o\f[], \f[C]\-\-output\f[] [DIR]
+\f[C]\-c|\-\-configuration\ {Debug|Release}\f[]
 .PP
-Places the built packages in the directory specified.
+Defines the build configuration.
+The default value is \f[C]Debug\f[].
+.PP
+\f[C]\-\-force\f[] Forces all dependencies to be resolved even if the last restore was successful.
+This is equivalent to deleting the \f[I]project.assets.json\f[] file.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-\-include\-source\f[]
+.PP
+Includes the source files in the NuGet package.
+The sources files are included in the \f[C]src\f[] folder within the \f[C]nupkg\f[].
+.PP
+\f[C]\-\-include\-symbols\f[]
+.PP
+Generates the symbols \f[C]nupkg\f[].
 .PP
 \f[C]\-\-no\-build\f[]
 .PP
-Skips the building phase of the packing process.
+Doesn't build the project before packing.
 .PP
-\f[C]\-\-build\-base\-path\f[]
+\f[C]\-\-no\-dependencies\f[]
 .PP
-Places the temporary build artifacts in the specified directory.
+Ignores project\-to\-project references and only restores the root project.
-By default, they go to the obj directory in the current directory.
 .PP
-\f[C]\-c\f[], \f[C]\-\-configuration\ [Debug|Release]\f[]
+\f[C]\-\-no\-restore\f[]
 .PP
-Configuration to use when building the project.
+Doesn't perform an implicit restore when running the command.
-If not specified, will default to "Debug".
+.PP
-.SS EXAMPLES
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Places the built packages in the directory specified.
+.PP
+\f[C]\-r|\-\-runtime\ <RUNTIME_IDENTIFIER>\f[]
+.PP
+Specifies the target runtime to restore packages for.
+For a list of Runtime Identifiers (RIDs), see the RID catalog.
+.PP
+\f[C]\-s|\-\-serviceable\f[]
+.PP
+Sets the serviceable flag in the package.
+For more information, see .NET Blog: .NET 4.5.1 Supports Microsoft Security Updates for .NET NuGet Libraries.
+.PP
+\f[C]\-\-version\-suffix\ <VERSION_SUFFIX>\f[]
+.PP
+Defines the value for the \f[C]$(VersionSuffix)\f[] MSBuild property in the project.
+.PP
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
+.SS .NET Core 1.x
+.PP
+\f[C]\-c|\-\-configuration\ {Debug|Release}\f[]
+.PP
+Defines the build configuration.
+The default value is \f[C]Debug\f[].
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-\-include\-source\f[]
+.PP
+Includes the source files in the NuGet package.
+The sources files are included in the \f[C]src\f[] folder within the \f[C]nupkg\f[].
+.PP
+\f[C]\-\-include\-symbols\f[]
+.PP
+Generates the symbols \f[C]nupkg\f[].
+.PP
+\f[C]\-\-no\-build\f[]
+.PP
+Doesn't build the project before packing.
+.PP
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Places the built packages in the directory specified.
+.PP
+\f[C]\-s|\-\-serviceable\f[]
+.PP
+Sets the serviceable flag in the package.
+For more information, see .NET Blog: .NET 4.5.1 Supports Microsoft Security Updates for .NET NuGet Libraries.
+.PP
+\f[C]\-\-version\-suffix\ <VERSION_SUFFIX>\f[]
+.PP
+Defines the value for the \f[C]$(VersionSuffix)\f[] MSBuild property in the project.
+.PP
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
+.PP
+   *   *   *   *   *
+.SH EXAMPLES
+.PP
+Pack the project in the current directory:
 .PP
 \f[C]dotnet\ pack\f[]
 .PP
-Packs the current project.
+Pack the \f[C]app1\f[] project:
 .PP
-\f[C]dotnet\ pack\ ~/projects/app1/project.json\f[]
+\f[C]dotnet\ pack\ ~/projects/app1/project.csproj\f[]
 .PP
-Packs the app1 project.
+Pack the project in the current directory and place the resulting packages into the \f[C]nupkgs\f[] folder:
 .PP
 \f[C]dotnet\ pack\ \-\-output\ nupkgs\f[]
 .PP
-Packs the current application and place the resulting packages into the
+Pack the project in the current directory into the \f[C]nupkgs\f[] folder and skip the build step:
-specified folder.
 .PP
 \f[C]dotnet\ pack\ \-\-no\-build\ \-\-output\ nupkgs\f[]
 .PP
-Packs the current project into the specified folder and skips the build
+With the project's version suffix configured as \f[C]<VersionSuffix>$(VersionSuffix)</VersionSuffix>\f[] in the \f[I].csproj\f[] file, pack the current project and update the resulting package version with the given suffix:
-step.
+.PP
+\f[C]dotnet\ pack\ \-\-version\-suffix\ "ci\-1234"\f[]
+.PP
+Set the package version to \f[C]2.1.0\f[] with the \f[C]PackageVersion\f[] MSBuild property:
+.PP
+\f[C]dotnet\ pack\ /p:PackageVersion=2.1.0\f[]
+.PP
+Pack the project for a specific target framework:
+.PP
+\f[C]dotnet\ pack\ /p:TargetFrameworks=net45\f[]
+.PP
+Pack the project and use a specific runtime (Windows 10) for the restore operation (.NET Core SDK 2.0 and later versions):
+.PP
+\f[C]dotnet\ pack\ \-\-runtime\ win10\-x64\f[]
 .SH AUTHORS
-Microsoft Corporation dotnetclifeedback\@microsoft.com.
+mairaw.

Documentation/manpages/sdk/dotnet-publish.1

@@ -1,107 +1,190 @@
-.\" Automatically generated by Pandoc 1.15.1
+.\" Automatically generated by Pandoc 2.1.3
 .\"
+.TH "dotnet publish command \- .NET Core CLI" "1" "" "" ".NET Core"
 .hy
-.TH "DOTNET\-PUBLISH" "1" "June 2016" "" ""
+.SH dotnet publish
-.SS NAME
 .PP
-\f[C]dotnet\-publish\f[] \- Packs the application and all of its
+.SH NAME
-dependencies into a folder getting it ready for publishing
-.SS SYNOPSIS
 .PP
-\f[C]dotnet\ publish\ [\-\-framework]\ \ \ \ \ \ \ [\-\-runtime]\ [\-\-build\-base\-path]\ [\-\-output]\ \ \ \ \ \ \ [\-\-version\-suffix]\ [\-\-configuration]\ \ \ \ \ \ \ [<project>]\f[]
+\f[C]dotnet\ publish\f[] \- Packs the application and its dependencies into a folder for deployment to a hosting system.
-.SS DESCRIPTION
+.SH SYNOPSIS
+.SS .NET Core 2.x
+.IP
+.nf
+\f[C]
+dotnet\ publish\ [<PROJECT>]\ [\-c|\-\-configuration]\ [\-f|\-\-framework]\ [\-\-force]\ [\-\-manifest]\ [\-\-no\-dependencies]\ [\-\-no\-restore]\ [\-o|\-\-output]\ [\-r|\-\-runtime]\ [\-\-self\-contained]\ [\-v|\-\-verbosity]\ [\-\-version\-suffix]
+dotnet\ publish\ [\-h|\-\-help]
+\f[]
+.fi
+.SS .NET Core 1.x
+.IP
+.nf
+\f[C]
+dotnet\ publish\ [<PROJECT>]\ [\-c|\-\-configuration]\ [\-f|\-\-framework]\ [\-o|\-\-output]\ [\-r|\-\-runtime]\ [\-v|\-\-verbosity]\ [\-\-version\-suffix]
+dotnet\ publish\ [\-h|\-\-help]
+\f[]
+.fi
 .PP
-\f[C]dotnet\ publish\f[] compiles the application, reads through its
+   *   *   *   *   *
-dependencies specified in the \f[C]project.json\f[] file and publishes
+.SH DESCRIPTION
-the resulting set of files to a directory.
 .PP
-Depending on the type of portable app, the resulting directory will
+\f[C]dotnet\ publish\f[] compiles the application, reads through its dependencies specified in the project file, and publishes the resulting set of files to a directory.
-contain the following:
+The output will contain the following:
-.IP "1." 3
-\f[B]Portable application\f[] \- application\[aq]s intermediate language
-(IL) code and all of application\[aq]s managed dependencies.
-.RS 4
 .IP \[bu] 2
-\f[B]Portable application with native dependencies\f[] \- same as above
+Intermediate Language (IL) code in an assembly with a \f[I]dll\f[] extension.
-with a sub\-directory for the supported platform of each native
+.IP \[bu] 2
-dependency.
+\f[I].deps.json\f[] file that contains all of the dependencies of the project.
-.RE
+.IP \[bu] 2
-.IP "2." 3
+\f[I].runtime.config.json\f[] file that specifies the shared runtime that the application expects, as well as other configuration options for the runtime (for example, garbage collection type).
-\f[B]Self\-contained application\f[] \- same as above plus the entire
+.IP \[bu] 2
-runtime for the targeted platform.
+The application's dependencies.
+These are copied from the NuGet cache into the output folder.
 .PP
-The above types are covered in more details in the types of portable
+The \f[C]dotnet\ publish\f[] command's output is ready for deployment to a hosting system (for example, a server, PC, Mac, laptop) for execution and is the only officially supported way to prepare the application for deployment.
-applications (../../app-types.md) topic.
+Depending on the type of deployment that the project specifies, the hosting system may or may not have the .NET Core shared runtime installed on it.
-.SS OPTIONS
+For more information, see .NET Core Application Deployment.
+For the directory structure of a published application, see Directory structure.
 .PP
-\f[C][project]\f[]
+.SS Arguments
 .PP
-\f[C]dotnet\ publish\f[] needs access to the \f[C]project.json\f[] file
+\f[C]PROJECT\f[]
-to work.
-If it is not specified on invocation via [project],
-\f[C]project.json\f[] in the current directory will be the default.
-.PD 0
-.P
-.PD
-If no \f[C]project.json\f[] can be found, \f[C]dotnet\ publish\f[] will
-throw an error.
 .PP
-\f[C]\-f\f[], \f[C]\-\-framework\f[] [FID]
+The project to publish, which defaults to the current directory if not specified.
+.SH OPTIONS
+.SS .NET Core 2.x
 .PP
-Publishes the application for a given framework identifier (FID).
+\f[C]\-c|\-\-configuration\ {Debug|Release}\f[]
-If not specified, FID is read from \f[C]project.json\f[].
-In no valid framework is found, the command will throw an error.
-If multiple valid frameworks are found, the command will publish for all
-valid frameworks.
 .PP
-\f[C]\-r\f[], \f[C]\-\-runtime\f[] [RID]
+Defines the build configuration.
+The default value is \f[C]Debug\f[].
+.PP
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
+.PP
+Publishes the application for the specified target framework.
+You must specify the target framework in the project file.
+.PP
+\f[C]\-\-force\f[]
+.PP
+Forces all dependencies to be resolved even if the last restore was successful.
+This is equivalent to deleting the \f[I]project.assets.json\f[] file.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-\-manifest\ <PATH_TO_MANIFEST_FILE>\f[]
+.PP
+Specifies one or several target manifests to use to trim the set of packages published with the app.
+The manifest file is part of the output of the \f[C]dotnet\ store\f[].
+To specify multiple manifests, add a \f[C]\-\-manifest\f[] option for each manifest.
+This option is available starting with .NET Core 2.0 SDK.
+.PP
+\f[C]\-\-no\-dependencies\f[]
+.PP
+Ignores project\-to\-project references and only restores the root project.
+.PP
+\f[C]\-\-no\-restore\f[]
+.PP
+Doesn't perform an implicit restore when running the command.
+.PP
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Specifies the path for the output directory.
+If not specified, it defaults to \f[I]./bin/[configuration]/[framework]/\f[] for a framework\-dependent deployment or \f[I]./bin/[configuration]/[framework]/[runtime]\f[] for a self\-contained deployment.
+If a relative path is provided, the output directory generated is relative to the project file location, not to the current working directory.
+.PP
+\f[C]\-\-self\-contained\f[]
+.PP
+Publishes the .NET Core runtime with your application so the runtime doesn't need to be installed on the target machine.
+If a runtime identifier is specified, its default value is \f[C]true\f[].
+For more information about the different deployment types, see .NET Core application deployment.
+.PP
+\f[C]\-r|\-\-runtime\ <RUNTIME_IDENTIFIER>\f[]
 .PP
 Publishes the application for a given runtime.
+This is used when creating a self\-contained deployment (SCD).
+For a list of Runtime Identifiers (RIDs), see the RID catalog.
+Default is to publish a framework\-dependent deployment (FDD).
 .PP
-\f[C]\-b\f[], \f[C]\-\-build\-base\-path\f[] [DIR]
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
 .PP
-Directory in which to place temporary outputs.
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
 .PP
-\f[C]\-o\f[], \f[C]\-\-output\f[]
+\f[C]\-\-version\-suffix\ <VERSION_SUFFIX>\f[]
 .PP
-Specify the path where to place the directory.
+Defines the version suffix to replace the asterisk (\f[C]*\f[]) in the version field of the project file.
-If not specified, it will default to
+.SS .NET Core 1.x
-\f[I]\&./bin/[configuration]/[framework]/\f[] for portable applications
-or \f[I]\&./bin/[configuration]/[framework]/[runtime]\f[] for
-self\-contained applications.
 .PP
-\-\-version\-suffix [VERSION_SUFFIX]
+\f[C]\-c|\-\-configuration\ {Debug|Release}\f[]
 .PP
-Defines what \f[C]*\f[] should be replaced with in the version field in
+Defines the build configuration.
-the project.json file.
+The default value is \f[C]Debug\f[].
 .PP
-\f[C]\-c\f[], \f[C]\-\-configuration\ [Debug|Release]\f[]
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
 .PP
-Configuration to use when publishing.
+Publishes the application for the specified target framework.
-The default value is Debug.
+You must specify the target framework in the project file.
-.SS EXAMPLES
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-\-manifest\ <PATH_TO_MANIFEST_FILE>\f[]
+.PP
+Specifies one or several target manifests to use to trim the set of packages published with the app.
+The manifest file is part of the output of the \f[C]dotnet\ store\f[].
+To specify multiple manifests, add a \f[C]\-\-manifest\f[] option for each manifest.
+This option is available starting with .NET Core 2.0 SDK.
+.PP
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Specifies the path for the output directory.
+If not specified, it defaults to \f[I]./bin/[configuration]/[framework]/\f[] for a framework\-dependent deployment or \f[I]./bin/[configuration]/[framework]/[runtime]\f[] for a self\-contained deployment.
+If a relative path is provided, the output directory generated is relative to the project file location, not to the current working directory.
+.PP
+\f[C]\-r|\-\-runtime\ <RUNTIME_IDENTIFIER>\f[]
+.PP
+Publishes the application for a given runtime.
+This is used when creating a self\-contained deployment (SCD).
+For a list of Runtime Identifiers (RIDs), see the RID catalog.
+Default is to publish a framework\-dependent deployment (FDD).
+.PP
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
+.PP
+\f[C]\-\-version\-suffix\ <VERSION_SUFFIX>\f[]
+.PP
+Defines the version suffix to replace the asterisk (\f[C]*\f[]) in the version field of the project file.
+.PP
+   *   *   *   *   *
+.SH EXAMPLES
+.PP
+Publish the project in the current directory:
 .PP
 \f[C]dotnet\ publish\f[]
 .PP
-Publishes an application using the framework found in
+Publish the application using the specified project file:
-\f[C]project.json\f[].
-If \f[C]project.json\f[] contains \f[C]runtimes\f[] node, publish for
-the RID of the current platform.
 .PP
-\f[C]dotnet\ publish\ ~/projects/app1/project.json\f[]
+\f[C]dotnet\ publish\ ~/projects/app1/app1.csproj\f[]
 .PP
-Publishes the application using the specified \f[C]project.json\f[].
+Publish the project in the current directory using the \f[C]netcoreapp1.1\f[] framework:
 .PP
-\f[C]dotnet\ publish\ \-\-framework\ netcoreapp1.0\f[]
+\f[C]dotnet\ publish\ \-\-framework\ netcoreapp1.1\f[]
 .PP
-Publishes the current application using the \f[C]netcoreapp1.0\f[]
+Publish the current application using the \f[C]netcoreapp1.1\f[] framework and the runtime for \f[C]OS\ X\ 10.10\f[] (you must list this RID in the project file).
-framework.
 .PP
-\f[C]dotnet\ publish\ \-\-framework\ netcoreapp1.0\ \-\-runtime\ osx.10.11\-x64\f[]
+\f[C]dotnet\ publish\ \-\-framework\ netcoreapp1.1\ \-\-runtime\ osx.10.11\-x64\f[]
 .PP
-Publishes the current application using the \f[C]netcoreapp1.0\f[]
+Publish the current application but don't restore project\-to\-project (P2P) references, just the root project during the restore operation (.NET Core SDK 2.0 and later versions):
-framework and runtime for \f[C]OS\ X\ 10.10\f[].
+.PP
-This RID has to exist in the \f[C]project.json\f[] \f[C]runtimes\f[]
+\f[C]dotnet\ publish\ \-\-no\-dependencies\f[]
-node.
+.SS See also
+.IP \[bu] 2
+Target frameworks
+.IP \[bu] 2
+Runtime IDentifier (RID) catalog
 .SH AUTHORS
-Microsoft Corporation dotnetclifeedback\@microsoft.com.
+mairaw.

Documentation/manpages/sdk/dotnet-remove-package.1

@@ -0,0 +1,37 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet remove package command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet remove package
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ remove\ package\f[] \- Removes package reference from a project file.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ remove\ [<PROJECT>]\ package\ <PACKAGE_NAME>\ [\-h|\-\-help]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ remove\ package\f[] command provides a convenient option to remove a NuGet package reference from a project.
+.SS Arguments
+.PP
+\f[C]PROJECT\f[]
+.PP
+Specifies the project file.
+If not specified, the command will search the current directory for one.
+.PP
+\f[C]PACKAGE_NAME\f[]
+.PP
+The package reference to remove.
+.SH OPTIONS
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.SH EXAMPLES
+.PP
+Removes \f[C]Newtonsoft.Json\f[] NuGet package from a project in the current directory:
+.PP
+\f[C]dotnet\ remove\ package\ Newtonsoft.Json\f[]
+.SH AUTHORS
+mairaw.

Documentation/manpages/sdk/dotnet-remove-reference.1

@@ -0,0 +1,51 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet remove reference command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet remove reference
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ remove\ reference\f[] \- Removes project\-to\-project references.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ remove\ [<PROJECT>]\ reference\ [\-f|\-\-framework]\ <PROJECT_REFERENCES>\ [\-h|\-\-help]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ remove\ reference\f[] command provides a convenient option to remove project references from a project.
+.SS Arguments
+.PP
+\f[C]PROJECT\f[]
+.PP
+Target project file.
+If not specified, the command searches the current directory for one.
+.PP
+\f[C]PROJECT_REFERENCES\f[]
+.PP
+Project to project (P2P references to remove.
+You can specify one or multiple projects.
+Glob patterns are supported on Unix/Linux based terminals.
+.SH OPTIONS
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
+.PP
+Removes the reference only when targeting a specific framework.
+.SH EXAMPLES
+.PP
+Remove a project reference from the specified project:
+.PP
+\f[C]dotnet\ remove\ app/app.csproj\ reference\ lib/lib.csproj\f[]
+.PP
+Remove multiple project references from the project in the current directory:
+.PP
+\f[C]dotnet\ remove\ reference\ lib1/lib1.csproj\ lib2/lib2.csproj\f[]
+.PP
+Remove multiple project references using a glob pattern on Unix/Linux:
+.PP
+\f[C]dotnet\ remove\ app/app.csproj\ reference\ **/*.csproj\f[]
+.SH AUTHORS
+mairaw.

Documentation/manpages/sdk/dotnet-restore.1

@@ -1,97 +1,198 @@
-.\" Automatically generated by Pandoc 1.15.1
+.\" Automatically generated by Pandoc 2.1.3
 .\"
+.TH "dotnet restore command \- .NET Core CLI" "1" "" "" ".NET Core"
 .hy
-.TH "DOTNET\-RESTORE" "1" "June 2016" "" ""
+.SH dotnet restore
-.SS NAME
 .PP
-\f[C]dotnet\-restore\f[] \- Restores the dependencies and tools of a
+.SH NAME
-project
-.SS SYNOPSIS
 .PP
-\f[C]dotnet\ restore\ [\-\-source]\ \ \ \ \ \ \ [\-\-packages]\ [\-\-disable\-parallel]\ \ \ \ \ \ \ [\-\-fallbacksource]\ [\-\-configfile]\ [\-\-verbosity]\ \ \ \ \ [<root>]\f[]
+\f[C]dotnet\ restore\f[] \- Restores the dependencies and tools of a project.
-.SS DESCRIPTION
+.SH SYNOPSIS
+.SS .NET Core 2.x
+.IP
+.nf
+\f[C]
+dotnet\ restore\ [<ROOT>]\ [\-\-configfile]\ [\-\-disable\-parallel]\ [\-\-force]\ [\-\-ignore\-failed\-sources]\ [\-\-no\-cache]\ [\-\-no\-dependencies]\ [\-\-packages]\ [\-r|\-\-runtime]\ [\-s|\-\-source]\ [\-v|\-\-verbosity]
+dotnet\ restore\ [\-h|\-\-help]
+\f[]
+.fi
+.SS .NET Core 1.x
+.IP
+.nf
+\f[C]
+dotnet\ restore\ [<ROOT>]\ [\-\-configfile]\ [\-\-disable\-parallel]\ [\-\-ignore\-failed\-sources]\ [\-\-no\-cache]\ [\-\-no\-dependencies]\ [\-\-packages]\ [\-r|\-\-runtime]\ [\-s|\-\-source]\ [\-v|\-\-verbosity]
+dotnet\ restore\ [\-h|\-\-help]
+\f[]
+.fi
 .PP
-The \f[C]dotnet\ restore\f[] command uses NuGet to restore dependencies
+   *   *   *   *   *
-as well as project\-specific tools that are specified in the
+.SH DESCRIPTION
-project.json file.
-By default, the restoration of dependencies and tools are done in
-parallel.
 .PP
-In order to restore the dependencies, NuGet needs the feeds where the
+The \f[C]dotnet\ restore\f[] command uses NuGet to restore dependencies as well as project\-specific tools that are specified in the project file.
-packages are located.
+By default, the restoration of dependencies and tools are performed in parallel.
-Feeds are usually provided via the NuGet.config configuration file; a
-default one is present when the CLI tools are installed.
-You can specify more feeds by creating your own NuGet.config file in the
-project directory.
-Feeds can also be specified per invocation on the command line.
 .PP
-For dependencies, you can specify where the restored packages are placed
-during the restore operation using the \f[C]\-\-packages\f[] argument.
-If not specified, the default NuGet package cache is used.
-It is found in the \f[C]\&.nuget/packages\f[] directory in the
-user\[aq]s home directory on all operating systems (for example,
-\f[C]/home/user1\f[] on Linux or \f[C]C:\\Users\\user1\f[] on Windows).
 .PP
-For project\-specific tooling, \f[C]dotnet\ restore\f[] first restores
+In order to restore the dependencies, NuGet needs the feeds where the packages are located.
-the package in which the tool is packed, and then proceeds to restore
+Feeds are usually provided via the \f[I]NuGet.config\f[] configuration file.
-the tool\[aq]s dependencies as specified in its project.json.
+A default configuration file is provided when the CLI tools are installed.
-.SS OPTIONS
+You specify additional feeds by creating your own \f[I]NuGet.config\f[] file in the project directory.
+You also specify additional feeds per invocation at a command prompt.
 .PP
-\f[C][root]\f[]
+For dependencies, you specify where the restored packages are placed during the restore operation using the \f[C]\-\-packages\f[] argument.
+If not specified, the default NuGet package cache is used, which is found in the \f[C]\&.nuget/packages\f[] directory in the user's home directory on all operating systems (for example, \f[I]/home/user1\f[] on Linux or \f[I]C:1\f[] on Windows).
 .PP
-A list of projects or project folders to restore.
+For project\-specific tooling, \f[C]dotnet\ restore\f[] first restores the package in which the tool is packed, and then proceeds to restore the tool's dependencies as specified in its project file.
-The list can contain either a path to a \f[C]project.json\f[] file, or a
-path to \f[C]global.json\f[] file or folder.
-The restore operation runs recursively for all subdirectories and
-restores for each given project.json file it finds.
 .PP
-\f[C]\-s\f[], \f[C]\-\-source\f[] [SOURCE]
+The behavior of the \f[C]dotnet\ restore\f[] command is affected by some of the settings in the \f[I]Nuget.Config\f[] file, if present.
+For example, setting the \f[C]globalPackagesFolder\f[] in \f[I]NuGet.Config\f[] places the restored NuGet packages in the specified folder.
+This is an alternative to specifying the \f[C]\-\-packages\f[] option on the \f[C]dotnet\ restore\f[] command.
+For more information, see the NuGet.Config reference.
+.SS Implicit \f[C]dotnet\ restore\f[]
 .PP
-Specifies a source to use during the restore operation.
+Starting with .NET Core 2.0, \f[C]dotnet\ restore\f[] is run implicitly if necessary when you issue the following commands:
-This overrides all of the sources specified in the NuGet.config file(s).
+.IP \[bu] 2
+\f[C]dotnet\ new\f[]
+.IP \[bu] 2
+\f[C]dotnet\ build\f[]
+.IP \[bu] 2
+\f[C]dotnet\ run\f[]
+.IP \[bu] 2
+\f[C]dotnet\ test\f[]
+.IP \[bu] 2
+\f[C]dotnet\ publish\f[]
+.IP \[bu] 2
+\f[C]dotnet\ pack\f[]
 .PP
-\f[C]\-\-packages\f[] [DIR]
+In most cases, you no longer need to explicitly use the \f[C]dotnet\ restore\f[] command.
 .PP
-Specifies the directory to place the restored packages in.
+In some cases, it is inconvenient for \f[C]dotnet\ restore\f[] to run implicitly.
+For example, some automated systems, such as build systems, need to call \f[C]dotnet\ restore\f[] explicitly to control when the restore occurs so that they can control network usage.
+To prevent \f[C]dotnet\ restore\f[] from running implicitly, you can use the \f[C]\-\-no\-restore\f[] switch with any of these commands to disable implicit restore.
+.SS Arguments
+.PP
+\f[C]ROOT\f[]
+.PP
+Optional path to the project file to restore.
+.SH OPTIONS
+.SS .NET Core 2.x
+.PP
+\f[C]\-\-configfile\ <FILE>\f[]
+.PP
+The NuGet configuration file (\f[I]NuGet.config\f[]) to use for the restore operation.
 .PP
 \f[C]\-\-disable\-parallel\f[]
 .PP
 Disables restoring multiple projects in parallel.
 .PP
-\f[C]\-f\f[], \f[C]\-\-fallbacksource\f[] [FEED]
+\f[C]\-\-force\f[]
 .PP
-Specifies a fallback source that will be used in the restore operation
+Forces all dependencies to be resolved even if the last restore was successful.
-if all other sources fail.
+This is equivalent to deleting the \f[I]project.assets.json\f[] file.
-All valid feed formats are allowed.
 .PP
-\f[C]\-\-configfile\f[] [FILE]
+\f[C]\-h|\-\-help\f[]
 .PP
-Configuration file (NuGet.config) to use for the restore operation.
+Prints out a short help for the command.
 .PP
-\f[C]\-\-verbosity\f[] [LEVEL]
+\f[C]\-\-ignore\-failed\-sources\f[]
 .PP
-The verbosity of logging to use.
+Only warn about failed sources if there are packages meeting the version requirement.
-Allowed values: Debug, Verbose, Information, Minimal, Warning, or Error.
+.PP
-.SS EXAMPLES
+\f[C]\-\-no\-cache\f[]
+.PP
+Specifies to not cache packages and HTTP requests.
+.PP
+\f[C]\-\-no\-dependencies\f[]
+.PP
+When restoring a project with project\-to\-project (P2P) references, restores the root project and not the references.
+.PP
+\f[C]\-\-packages\ <PACKAGES_DIRECTORY>\f[]
+.PP
+Specifies the directory for restored packages.
+.PP
+\f[C]\-r|\-\-runtime\ <RUNTIME_IDENTIFIER>\f[]
+.PP
+Specifies a runtime for the package restore.
+This is used to restore packages for runtimes not explicitly listed in the \f[C]<RuntimeIdentifiers>\f[] tag in the \f[I].csproj\f[] file.
+For a list of Runtime Identifiers (RIDs), see the RID catalog.
+Provide multiple RIDs by specifying this option multiple times.
+.PP
+\f[C]\-s|\-\-source\ <SOURCE>\f[]
+.PP
+Specifies a NuGet package source to use during the restore operation.
+This overrides all of the sources specified in the \f[I]NuGet.config\f[] files.
+Multiple sources can be provided by specifying this option multiple times.
+.PP
+\f[C]\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
+.SS .NET Core 1.x
+.PP
+\f[C]\-\-configfile\ <FILE>\f[]
+.PP
+The NuGet configuration file (\f[I]NuGet.config\f[]) to use for the restore operation.
+.PP
+\f[C]\-\-disable\-parallel\f[]
+.PP
+Disables restoring multiple projects in parallel.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-\-ignore\-failed\-sources\f[]
+.PP
+Only warn about failed sources if there are packages meeting the version requirement.
+.PP
+\f[C]\-\-no\-cache\f[]
+.PP
+Specifies to not cache packages and HTTP requests.
+.PP
+\f[C]\-\-no\-dependencies\f[]
+.PP
+When restoring a project with project\-to\-project (P2P) references, restores the root project and not the references.
+.PP
+\f[C]\-\-packages\ <PACKAGES_DIRECTORY>\f[]
+.PP
+Specifies the directory for restored packages.
+.PP
+\f[C]\-r|\-\-runtime\ <RUNTIME_IDENTIFIER>\f[]
+.PP
+Specifies a runtime for the package restore.
+This is used to restore packages for runtimes not explicitly listed in the \f[C]<RuntimeIdentifiers>\f[] tag in the \f[I].csproj\f[] file.
+For a list of Runtime Identifiers (RIDs), see the RID catalog.
+Provide multiple RIDs by specifying this option multiple times.
+.PP
+\f[C]\-s|\-\-source\ <SOURCE>\f[]
+.PP
+Specifies a NuGet package source to use during the restore operation.
+This overrides all of the sources specified in the \f[I]NuGet.config\f[] files.
+Multiple sources can be provided by specifying this option multiple times.
+.PP
+\f[C]\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
+.SH EXAMPLES
+.PP
+Restore dependencies and tools for the project in the current directory:
 .PP
 \f[C]dotnet\ restore\f[]
 .PP
-Restores dependencies and tools for the project in the current
+Restore dependencies and tools for the \f[C]app1\f[] project found in the given path:
-directory.
 .PP
-\f[C]dotnet\ restore\ ~/projects/app1/project.json\f[]
+\f[C]dotnet\ restore\ ~/projects/app1/app1.csproj\f[]
 .PP
-Restores dependencies and tools for the \f[C]app1\f[] project found in
+Restore the dependencies and tools for the project in the current directory using the file path provided as the source:
-the given path.
 .PP
-\f[C]dotnet\ restore\ \-\-f\ c:\\packages\\mypackages\f[]
+\f[C]dotnet\ restore\ \-s\ c:\\packages\\mypackages\f[]
 .PP
-Restores the dependencies and tools for the project in the current
+Restore the dependencies and tools for the project in the current directory using the two file paths provided as sources:
-directory using the file path provided as the fallback source.
 .PP
-\f[C]dotnet\ restore\ \-\-verbosity\ Error\f[]
+\f[C]dotnet\ restore\ \-s\ c:\\packages\\mypackages\ \-s\ c:\\packages\\myotherpackages\f[]
 .PP
-Restores dependencies and tools for the project in the current directory
+Restore dependencies and tools for the project in the current directory and shows only minimal output:
-and shows only errors in the output.
+.PP
+\f[C]dotnet\ restore\ \-\-verbosity\ minimal\f[]
 .SH AUTHORS
-Microsoft Corporation dotnetclifeedback\@microsoft.com.
+mairaw.

Documentation/manpages/sdk/dotnet-run.1

@@ -1,88 +1,168 @@
-.\" Automatically generated by Pandoc 1.15.1
+.\" Automatically generated by Pandoc 2.1.3
 .\"
+.TH "dotnet run command \- .NET Core CLI" "1" "" "" ".NET Core"
 .hy
-.TH "DOTNET\-RUN" "1" "June 2016" "" ""
+.SH dotnet run
-.SS NAME
 .PP
-dotnet\-run \-\- Runs source code \[aq]in\-place\[aq] without any
+.SH NAME
-explicit compile or launch commands.
-.SS SYNOPSIS
 .PP
-\f[C]dotnet\ run\ [\-\-framework]\ [\-\-configuration]\ \ \ \ \ [\-\-project]\ [\-\-help]\ [\-\-]\f[]
+\f[C]dotnet\ run\f[] \- Runs source code without any explicit compile or launch commands.
-.SS DESCRIPTION
+.SH SYNOPSIS
+.SS .NET Core 2.x
+.IP
+.nf
+\f[C]
+dotnet\ run\ [\-c|\-\-configuration]\ [\-f|\-\-framework]\ [\-\-force]\ [\-\-launch\-profile]\ [\-\-no\-build]\ [\-\-no\-dependencies]\ [\-\-no\-launch\-profile]\ [\-\-no\-restore]\ [\-p|\-\-project]\ [\-\-runtime]\ [[\-\-]\ [application\ arguments]]
+dotnet\ run\ [\-h|\-\-help]
+\f[]
+.fi
+.SS .NET Core 1.x
+.IP
+.nf
+\f[C]
+dotnet\ run\ [\-c|\-\-configuration]\ [\-f|\-\-framework]\ [\-p|\-\-project]\ [[\-\-]\ [application\ arguments]]
+dotnet\ run\ [\-h|\-\-help]
+\f[]
+.fi
 .PP
-The \f[C]dotnet\ run\f[] command provides a convenient option to run
+   *   *   *   *   *
-your application from the source code with one command.
+.SH DESCRIPTION
-It compiles source code, generates an output program and then runs that
-program.
-This command is useful for fast iterative development and can also be
-used to run a source\-distributed program (for example, a website).
 .PP
-This command relies on \f[C]dotnet\ build\f[] (dotnet-build.md) to build
+The \f[C]dotnet\ run\f[] command provides a convenient option to run your application from the source code with one command.
-source inputs to a .NET assembly, before launching the program.
+It's useful for fast iterative development from the command line.
-The requirements for this command and the handling of source inputs are
+The command depends on the \f[C]dotnet\ build\f[] command to build the code.
-all inherited from the build command.
+Any requirements for the build, such as that the project must be restored first, apply to \f[C]dotnet\ run\f[] as well.
-The documentation for the build command provides more information on
-those requirements.
 .PP
-Output files are written to the child \f[C]bin\f[] folder, which will be
+Output files are written into the default location, which is \f[C]bin/<configuration>/<target>\f[].
-created if it doesn\[aq]t exist.
+For example if you have a \f[C]netcoreapp1.0\f[] application and you run \f[C]dotnet\ run\f[], the output is placed in \f[C]bin/Debug/netcoreapp1.0\f[].
-Files will be overwritten as needed.
+Files are overwritten as needed.
-Temporary files are written to the child \f[C]obj\f[] folder.
+Temporary files are placed in the \f[C]obj\f[] directory.
 .PP
-In case of a project with multiple specified frameworks,
+If the project specifies multiple frameworks, executing \f[C]dotnet\ run\f[] results in an error unless the \f[C]\-f|\-\-framework\ <FRAMEWORK>\f[] option is used to specify the framework.
-\f[C]dotnet\ run\f[] will first select the .NET Core frameworks.
-If those do not exist, it will error out.
-To specify other frameworks, use the \f[C]\-\-framework\f[] argument.
 .PP
-The \f[C]dotnet\ run\f[] command must be used in the context of
+The \f[C]dotnet\ run\f[] command is used in the context of projects, not built assemblies.
-projects, not built assemblies.
+If you're trying to run a framework\-dependent application DLL instead, you must use dotnet without a command.
-If you\[aq]re trying to execute a DLL instead, you should use
+For example, to run \f[C]myapp.dll\f[], use:
-\f[C]dotnet\f[] (dotnet.md) without any command like in the following
+.IP
-example:
+.nf
+\f[C]
+dotnet\ myapp.dll
+\f[]
+.fi
 .PP
-\f[C]dotnet\ myapp.dll\f[]
+For more information on the \f[C]dotnet\f[] driver, see the .NET Core Command Line Tools (CLI) topic.
 .PP
-For more information about the \f[C]dotnet\f[] driver, see the \&.NET
+In order to run the application, the \f[C]dotnet\ run\f[] command resolves the dependencies of the application that are outside of the shared runtime from the NuGet cache.
-Core Command Line Tools (CLI) (overview.md) topic.
+Because it uses cached dependencies, it's not recommended to use \f[C]dotnet\ run\f[] to run applications in production.
-.SS OPTIONS
+Instead, create a deployment using the \f[C]dotnet\ publish\f[] command and deploy the published output.
+.PP
+.SH OPTIONS
+.SS .NET Core 2.x
 .PP
 \f[C]\-\-\f[]
 .PP
-Delimits arguments to \f[C]dotnet\ run\f[] from arguments for the
+Delimits arguments to \f[C]dotnet\ run\f[] from arguments for the application being run.
-application being run.
+All arguments after this one are passed to the application run.
-All arguments after this one will be passed to the application being
-run.
 .PP
-\f[C]\-f\f[], \f[C]\-\-framework\f[] [FID]
+\f[C]\-c|\-\-configuration\ {Debug|Release}\f[]
 .PP
-Runs the application for a given framework identifier (FID).
+Defines the build configuration.
+The default value is \f[C]Debug\f[].
 .PP
-\f[C]\-c\f[], \f[C]\-\-configuration\ [Debug|Release]\f[]
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
 .PP
-Configuration to use when publishing.
+Builds and runs the app using the specified framework.
-The default value is "Debug".
+The framework must be specified in the project file.
 .PP
-\f[C]\-p\f[], \f[C]\-\-project\ [PATH]\f[]
+\f[C]\-\-force\f[]
 .PP
-Specifies which project to run.
+Forces all dependencies to be resolved even if the last restore was successful.
-It can be a path to a project.json file or to a directory containing a
+This is equivalent to deleting \f[I]project.assets.json\f[].
-project.json file.
+.PP
-It defaults to current directory if not specified.
+\f[C]\-h|\-\-help\f[]
-.SS EXAMPLES
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-\-launch\-profile\ <NAME>\f[]
+.PP
+The name of the launch profile (if any) to use when launching the application.
+Launch profiles are defined in the \f[I]launchSettings.json\f[] file and are typically called \f[C]Development\f[], \f[C]Staging\f[] and \f[C]Production\f[].
+For more information, see Working with multiple environments.
+.PP
+\f[C]\-\-no\-build\f[]
+.PP
+Doesn't build the project before running.
+.PP
+\f[C]\-\-no\-dependencies\f[]
+.PP
+When restoring a project with project\-to\-project (P2P) references, restores the root project and not the references.
+.PP
+\f[C]\-\-no\-launch\-profile\f[]
+.PP
+Doesn't attempt to use \f[I]launchSettings.json\f[] to configure the application.
+.PP
+\f[C]\-\-no\-restore\f[]
+.PP
+Doesn't perform an implicit restore when running the command.
+.PP
+\f[C]\-p|\-\-project\ <PATH>\f[]
+.PP
+Specifies the path of the project file to run (folder name or full path).
+It defaults to the current directory if not specified.
+.PP
+\f[C]\-\-runtime\ <RUNTIME_IDENTIFIER>\f[]
+.PP
+Specifies the target runtime to restore packages for.
+For a list of Runtime Identifiers (RIDs), see the RID catalog.
+.SS .NET Core 1.x
+.PP
+\f[C]\-\-\f[]
+.PP
+Delimits arguments to \f[C]dotnet\ run\f[] from arguments for the application being run.
+All arguments after this one are passed to the application run.
+.PP
+\f[C]\-c|\-\-configuration\ {Debug|Release}\f[]
+.PP
+Defines the build configuration.
+The default value is \f[C]Debug\f[].
+.PP
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
+.PP
+Builds and runs the app using the specified framework.
+The framework must be specified in the project file.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-p|\-\-project\ <PATH/PROJECT.csproj>\f[]
+.PP
+Specifies the path and name of the project file.
+(See the NOTE.) It defaults to the current directory if not specified.
+.RS
+.PP
+[!NOTE] Use the path and name of the project file with the \f[C]\-p|\-\-project\f[] option.
+A regression in the CLI prevents providing a folder path with .NET Core SDK 1.x.
+For more information about this issue, see dotnet run \-p, can not start a project (dotnet/cli #5992).
+.RE
+.PP
+   *   *   *   *   *
+.SH EXAMPLES
+.PP
+Run the project in the current directory:
 .PP
 \f[C]dotnet\ run\f[]
 .PP
-Runs the project in the current directory.
+Run the specified project:
 .PP
-\f[C]dotnet\ run\ \-\-project\ /projects/proj1/project.json\f[]
+\f[C]dotnet\ run\ \-\-project\ /projects/proj1/proj1.csproj\f[]
 .PP
-Runs the project specified.
+Run the project in the current directory (the \f[C]\-\-help\f[] argument in this example is passed to the application, since the \f[C]\-\-\f[] argument is used):
 .PP
 \f[C]dotnet\ run\ \-\-configuration\ Release\ \-\-\ \-\-help\f[]
 .PP
-Runs the project in the current directory.
+Restore dependencies and tools for the project in the current directory only showing minimal output and then run the project: (.NET Core SDK 2.0 and later versions):
-The \f[C]\-\-help\f[] argument above is passed to the application being
+.PP
-run, since the \f[C]\-\-\f[] argument was used.
+\f[C]dotnet\ run\ \-\-verbosity\ m\f[]
 .SH AUTHORS
-Microsoft Corporation dotnetclifeedback\@microsoft.com.
+mairaw.

Documentation/manpages/sdk/dotnet-sln.1

@@ -0,0 +1,82 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet sln command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet sln
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ sln\f[] \- Modifies a .NET Core solution file.
+.SH SYNOPSIS
+.IP
+.nf
+\f[C]
+dotnet\ sln\ [<SOLUTION_NAME>]\ add\ <PROJECT>\ <PROJECT>\ ...
+dotnet\ sln\ [<SOLUTION_NAME>]\ add\ <GLOBBING_PATTERN>
+dotnet\ sln\ [<SOLUTION_NAME>]\ remove\ <PROJECT>\ <PROJECT>\ ...
+dotnet\ sln\ [<SOLUTION_NAME>]\ remove\ <GLOBBING_PATTERN>
+dotnet\ sln\ [<SOLUTION_NAME>]\ list
+dotnet\ sln\ [\-h|\-\-help]
+\f[]
+.fi
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\ sln\f[] command provides a convenient way to add, remove, and list projects in a solution file.
+.SS Commands
+.PP
+\f[C]add\ <PROJECT>\ ...\f[]
+.PP
+\f[C]add\ <GLOBBING_PATTERN>\f[]
+.PP
+Adds a project or multiple projects to the solution file.
+Globbing patterns are supported on Unix/Linux based terminals.
+.PP
+\f[C]remove\ <PROJECT>\ ...\f[]
+.PP
+\f[C]remove\ <GLOBBING_PATTERN>\f[]
+.PP
+Removes a project or multiple projects from the solution file.
+Globbing patterns are supported on Unix/Linux based terminals.
+.PP
+\f[C]list\f[]
+.PP
+Lists all projects in a solution file.
+.SS Arguments
+.PP
+\f[C]SOLUTION_NAME\f[]
+.PP
+Solution file to use.
+If not specified, the command searches the current directory for one.
+If there are multiple solution files in the directory, one must be specified.
+.SH OPTIONS
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.SH EXAMPLES
+.PP
+Add a C# project to a solution:
+.PP
+\f[C]dotnet\ sln\ todo.sln\ add\ todo\-app/todo\-app.csproj\f[]
+.PP
+Remove a C# project from a solution:
+.PP
+\f[C]dotnet\ sln\ todo.sln\ remove\ todo\-app/todo\-app.csproj\f[]
+.PP
+Add multiple C# projects to a solution:
+.PP
+\f[C]dotnet\ sln\ todo.sln\ add\ todo\-app/todo\-app.csproj\ back\-end/back\-end.csproj\f[]
+.PP
+Remove multiple C# projects from a solution:
+.PP
+\f[C]dotnet\ sln\ todo.sln\ remove\ todo\-app/todo\-app.csproj\ back\-end/back\-end.csproj\f[]
+.PP
+Add multiple C# projects to a solution using a globbing pattern:
+.PP
+\f[C]dotnet\ sln\ todo.sln\ add\ **/*.csproj\f[]
+.PP
+Remove multiple C# projects from a solution using a globbing pattern:
+.PP
+\f[C]dotnet\ sln\ todo.sln\ remove\ **/*.csproj\f[]
+.SH AUTHORS
+mairaw.

Documentation/manpages/sdk/dotnet-store.1

@@ -0,0 +1,81 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet store command" "1" "" "" ".NET Core"
+.hy
+.SH dotnet store
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\ store\f[] \- Stores the specified assemblies in the runtime package store.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ store\ \-m|\-\-manifest\ \-f|\-\-framework\ \-r|\-\-runtime\ \ [\-\-framework\-version]\ [\-h|\-\-help]\ [\-\-output]\ [\-\-skip\-optimization]\ [\-\-skip\-symbols]\ [\-v|\-\-verbosity]\ [\-\-working\-dir]\f[]
+.SH DESCRIPTION
+.PP
+\f[C]dotnet\ store\f[] stores the specified assemblies in the runtime package store.
+By default, assemblies are optimized for the target runtime and framework.
+For more information, see the runtime package store topic.
+.SS Required options
+.PP
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
+.PP
+Specifies the target framework.
+.PP
+\f[C]\-m|\-\-manifest\ <PATH_TO_MANIFEST_FILE>\f[]
+.PP
+The \f[I]package store manifest file\f[] is an XML file that contains the list of packages to store.
+The format of the manifest file is compatible with the \f[I]csproj\f[] format.
+So, a \f[I]csproj\f[] project file that references the desired packages can be used with the \f[C]\-m|\-\-manifest\f[] option to store assemblies in the runtime package store.
+To specify multiple manifest files, repeat the option and path for each file: \f[C]\-\-manifest\ packages1.csproj\ \-\-manifest\ packages2.csproj\f[].
+.PP
+\f[C]\-r|\-\-runtime\ <RUNTIME_IDENTIFIER>\f[]
+.PP
+The runtime identifier to target.
+.SS Optional options
+.PP
+\f[C]\-\-framework\-version\ <FRAMEWORK_VERSION>\f[]
+.PP
+Specifies the .NET Core SDK version.
+This option enables you to select a specific framework version beyond the framework specified by the \f[C]\-f|\-\-framework\f[] option.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Shows help information.
+.PP
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Specifies the path to the runtime package store.
+If not specified, it defaults to the \f[I]store\f[] subdirectory of the user profile .NET Core installation directory.
+.PP
+\f[C]\-\-skip\-optimization\f[]
+.PP
+Skips the optimization phase.
+.PP
+\f[C]\-\-skip\-symbols\f[]
+.PP
+Skips symbol generation.
+Currently, you can only generate symbols on Windows and Linux.
+.PP
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
+.PP
+\f[C]\-w|\-\-working\-dir\ <INTERMEDIATE_WORKING_DIRECTORY>\f[]
+.PP
+The working directory used by the command.
+If not specified, it uses the \f[I]obj\f[] subdirectory of the current directory.
+.SH EXAMPLES
+.PP
+Store the packages specified in the \f[I]packages.csproj\f[] project file for .NET Core 2.0.0:
+.PP
+\f[C]dotnet\ store\ \-\-manifest\ packages.csproj\ \-\-framework\-version\ 2.0.0\f[]
+.PP
+Store the packages specified in the \f[I]packages.csproj\f[] without optimization:
+.PP
+\f[C]dotnet\ store\ \-\-manifest\ packages.csproj\ \-\-skip\-optimization\f[]
+.SS See also
+.PP
+Runtime package store
+.SH AUTHORS
+bleroy.

Documentation/manpages/sdk/dotnet-test.1

@@ -1,170 +1,281 @@
-.\" Automatically generated by Pandoc 1.15.1
+.\"t
+.\" Automatically generated by Pandoc 2.1.3
 .\"
+.TH "dotnet test command \- .NET Core CLI" "1" "" "" ".NET Core"
 .hy
-.TH "DOTNET\-TEST" "1" "April 2016" "" ""
+.SH dotnet test
-.SH Dotnet Test, Adapters and Test Runners
 .PP
-This document covers the interactions between dotnet test, a potential
+.SH NAME
-adapter (like VS) and test runners (like
-xunit (https://github.com/dotnet/coreclr.xunit)).
 .PP
-It describes the communication protocol for these agents, the parameters
+\f[C]dotnet\ test\f[] \- .NET test driver used to execute unit tests.
-that the runner needs to support and the modes on which dotnet test and
+.SH SYNOPSIS
-the runner work.
+.SS .NET Core 2.x
-.SS Running modes
+.IP
+.nf
+\f[C]
+dotnet\ test\ [<PROJECT>]\ [\-a|\-\-test\-adapter\-path]\ [\-c|\-\-configuration]\ [\-\-collect]\ [\-d|\-\-diag]\ [\-f|\-\-framework]\ [\-\-filter]\ [\-l|\-\-logger]\ [\-\-no\-build]\ [\-\-no\-restore]\ [\-o|\-\-output]\ [\-r|\-\-results\-directory]\ [\-s|\-\-settings]\ [\-t|\-\-list\-tests]\ [\-v|\-\-verbosity]
+dotnet\ test\ [\-h|\-\-help]
+\f[]
+.fi
+.SS .NET Core 1.x
+.IP
+.nf
+\f[C]
+dotnet\ test\ [<PROJECT>]\ [\-a|\-\-test\-adapter\-path]\ [\-c|\-\-configuration]\ [\-d|\-\-diag]\ [\-f|\-\-framework]\ [\-\-filter]\ [\-l|\-\-logger]\ [\-\-no\-build]\ [\-o|\-\-output]\ [\-s|\-\-settings]\ [\-t|\-\-list\-tests]\ \ [\-v|\-\-verbosity]
+dotnet\ test\ [\-h|\-\-help]
+\f[]
+.fi
 .PP
-Dotnet test supports two running modes:
+   *   *   *   *   *
-.IP "1." 3
+.SH DESCRIPTION
-Console: In console mode, dotnet test simply executes fully whatever
-command gets passed to it and outputs the results.
-Anytime you invoke dotnet test without passing \-\-port, it will run in
-console mode, which in turn will cause the runner to run in console
-mode.
-.IP "2." 3
-Design time: Anytime you pass a port to dotnet test, we will run in
-design time.
-That means that dotnet test will connect to that port using TCP and will
-then exchange a established set of messages with whatever else is
-connected to that port.
-When this happens, the runner also receives a port (a new one, mind you)
-that dotnet test will use to communicate with it.
-The reason why the runner also uses TCP to communicate with dotnet test
-is because in design mode, it is not sufficient to just output results
-to the console.
-We need to send the adapter structure messages containing the results of
-the test execution.
-.SS Communication protocol in design time.
-.IP "1." 3
-Because during design time, dotnet test connects to a port when it
-starts up, the adapter needs to be listening on that port otherwise
-dotnet test will fail.
-We did it like this so that the adapter could reserve all the ports it
-needs by binding and listening to them before dotnet test ran and tried
-to get ports for the runner.
-.IP "2." 3
-Once dotnet test starts, it sends a TestSession.Connected message to the
-adapter indicating that it is ready to receive messages.
-.IP "3." 3
-It is possible to send an optional version
-check (https://github.com/dotnet/cli/blob/rel/1.0.0/src/Microsoft.Extensions.Testing.Abstractions/Messages/ProtocolVersionMessage.cs)
-message with the adapter version of the protocol in it.
-Dotnet test will send back the version of the protocol that it supports.
 .PP
-All messages have the format described here:
+The \f[C]dotnet\ test\f[] command is used to execute unit tests in a given project.
-Message.cs (https://github.com/dotnet/cli/blob/rel/1.0.0/src/Microsoft.Extensions.Testing.Abstractions/Messages/Message.cs).
+The \f[C]dotnet\ test\f[] command launches the test runner console application specified for a project.
-The payload formats for each message is described in links to the
+The test runner executes the tests defined for a unit test framework (for example, MSTest, NUnit, or xUnit) and reports the success or failure of each test.
-classes used to de/serialize the information in the description of the
+The test runner and the unit test library are packaged as NuGet packages and are restored as ordinary dependencies for the project.
-protocol.
-.SS Test Execution
 .PP
-[IMAGE: alt
+Test projects specify the test runner using an ordinary \f[C]<PackageReference>\f[] element, as seen in the following sample project file:
-tag (../../../../Documentation/images/DotnetTestExecuteTests.png)]
-.IP "1." 3
-After the optional version check, the adapter sends a
-TestExecution.GetTestRunnerProcessStartInfo, with the
-tests (https://github.com/dotnet/cli/blob/rel/1.0.0/src/Microsoft.Extensions.Testing.Abstractions/Messages/RunTestsMessage.cs)
-it wants to execute inside of it.
-Dotnet test sends back a FileName and Arguments inside a
-TestStartInfo (https://github.com/dotnet/cli/blob/rel/1.0.0/src/dotnet/commands/dotnet-test/TestStartInfo.cs)
-payload that the adapter can use to start the runner.
-In the past, we would send the list of tests to run as part of that
-argument, but we were actually going over the command line size limit
-for some test projects.
-.IP "2." 3
-As part of the arguments, we send a port that the runner should connect
-to and for executing tests, a \-\-wait\-command flag, that indicates
-that the runner should connect to the port and wait for commands,
-instead of going ahead and executing the tests.
-.IP "3." 3
-At this point, the adapter can launch the runner (and attach to it for
-debugging if it chooses to).
-.IP "4." 3
-Once the runner starts, it sends dotnet test a TestRunner.WaitCommand
-message that indicates it is ready to receive commands, at which point
-dotnet test sends a TestRunner.Execute with the list of
-tests (https://github.com/dotnet/cli/blob/rel/1.0.0/src/Microsoft.Extensions.Testing.Abstractions/Messages/RunTestsMessage.cs)
-to run.
-This bypasses the command line size limit described above.
-.IP "5." 3
-The runner then sends dotnet test (and it passes forward to the adapter)
-a TestExecution.TestStarted for each tests as they start with the
-test (https://github.com/dotnet/cli/blob/rel/1.0.0/src/Microsoft.Extensions.Testing.Abstractions/Test.cs)
-information inside of it.
-.IP "6." 3
-The runner also sends dotnet test (and it forwards to the adapter) a
-TestExecution.TestResult for each test with the individual
-result (https://github.com/dotnet/cli/blob/rel/1.0.0/src/Microsoft.Extensions.Testing.Abstractions/TestResult.cs)
-of the test.
-.IP "7." 3
-After all tests finish, the runner sends a TestRunner.Completed message
-to dotnet test, which dotnet test sends as TestExecution.Completed to
-the adapter.
-.IP "8." 3
-Once the adapter is done, it sends dotnet test a TestSession.Terminate
-which will cause dotnet test to shutdown.
-.SS Test discovery
 .PP
-[IMAGE: alt
+[!code\-xmlXUnit Basic Template]
-tag (../../../..//Documentation/images/DotnetTestDiscoverTests.png)]
+.SS Arguments
-.IP "1." 3
-After the optional version check, the adapter sends a
-TestDiscovery.Start message.
-Because in this case, the adapter does not need to attach to the
-process, dotnet test will start the runner itself.
-Also, since there is no long list of arguments to be passed to the
-runner, no \-\-wait\-command flag is needed to be passed to the runner.
-dotnet test only passes a \-\-list argument to the runner, which means
-the runner should not run the tests, just list them.
-.IP "2." 3
-The runner then sends dotnet test (and it passes forward to the adapter)
-a TestDiscovery.TestFound for each
-test (https://github.com/dotnet/cli/blob/rel/1.0.0/src/Microsoft.Extensions.Testing.Abstractions/Test.cs)
-found.
-.IP "3." 3
-After all tests are discovered, the runner sends a TestRunner.Completed
-message to dotnet test, which dotnet test sends as
-TestDiscovery.Completed to the adapter.
-.IP "4." 3
-Once the adapter is done, it sends dotnet test a TestSession.Terminate
-which will cause dotnet test to shutdown.
-.SS Dotnet test parameters
 .PP
-Any parameters not accepted by dotnet test will be forwarded to the
+\f[C]PROJECT\f[]
-runner.
-This is the list of parameters supported by dotnet test from its own
-help print out:
 .PP
-Usage: dotnet test [arguments] [options]
+Specifies a path to the test project.
+If omitted, it defaults to current directory.
+.SH OPTIONS
+.SS .NET Core 2.x
 .PP
-Arguments: The project to test, defaults to the current directory.
+\f[C]\-a|\-\-test\-adapter\-path\ <PATH_TO_ADAPTER>\f[]
-Can be a path to a project.json or a project directory.
 .PP
-Options: \-?|\-h|\-\-help Show help information \-\-parentProcessId Used
+Use the custom test adapters from the specified path in the test run.
-by IDEs to specify their process ID.
+.PP
-Test will exit if the parent process does.
+\f[C]\-c|\-\-configuration\ {Debug|Release}\f[]
-\-\-port Used by IDEs to specify a port number to listen for a
+.PP
-connection.
+Defines the build configuration.
-\-c|\-\-configuration Configuration under which to build \-o|\-\-output
+The default value is \f[C]Debug\f[], but your project's configuration could override this default SDK setting.
-Directory in which to find the binaries to be run
+.PP
-\-b|\-\-build\-base\-path Directory in which to find temporary outputs
+\f[C]\-\-collect\ <DATA_COLLECTOR_FRIENDLY_NAME>\f[]
-\-f|\-\-framework Looks for test binaries for a specific framework
+.PP
-\-r|\-\-runtime Look for test binaries for a for the specified runtime
+Enables data collector for the test run.
-\-\-no\-build Do not build project before testing
+For more information, see Monitor and analyze test run.
-.SS Minimum parameters that the runner needs to support
+.PP
-.IP \[bu] 2
+\f[C]\-d|\-\-diag\ <PATH_TO_DIAGNOSTICS_FILE>\f[]
-AssemblyUnderTest: Path to the dll that contains the tests to be run.
+.PP
-.IP \[bu] 2
+Enables diagnostic mode for the test platform and write diagnostic messages to the specified file.
-\-\-port: Used by dotnet test to specify a port number that the runner
+.PP
-should connect to.
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
-.IP \[bu] 2
+.PP
-\-\-list: Indicates that the tests should only be listed and not
+Looks for test binaries for a specific framework.
-executed.
+.PP
-.IP \[bu] 2
+\f[C]\-\-filter\ <EXPRESSION>\f[]
-\-\-designtime: Indicates that the runner is running in design time, for
+.PP
-instance, inside an adapter.
+Filters out tests in the current project using the given expression.
-.IP \[bu] 2
+For more information, see the Filter option details section.
-\-\-wait\-command: Indicates that the runner should wait to receive
+For additional information and examples on how to use selective unit test filtering, see Running selective unit tests.
-commands through the TCP channel instead of running tests right away.
+.PP
-We use this to get around the command line size limit.
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-l|\-\-logger\ <LoggerUri/FriendlyName>\f[]
+.PP
+Specifies a logger for test results.
+.PP
+\f[C]\-\-no\-build\f[]
+.PP
+Does not build the test project prior to running it.
+.PP
+\f[C]\-\-no\-restore\f[]
+.PP
+Doesn't perform an implicit restore when running the command.
+.PP
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Directory in which to find the binaries to run.
+.PP
+\f[C]\-r|\-\-results\-directory\ <PATH>\f[]
+.PP
+The directory where the test results are going to be placed.
+The specified directory will be created if it doesn't exist.
+.PP
+\f[C]\-s|\-\-settings\ <SETTINGS_FILE>\f[]
+.PP
+Settings to use when running tests.
+.PP
+\f[C]\-t|\-\-list\-tests\f[]
+.PP
+List all of the discovered tests in the current project.
+.PP
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
+.SS .NET Core 1.x
+.PP
+\f[C]\-a|\-\-test\-adapter\-path\ <PATH_TO_ADAPTER>\f[]
+.PP
+Use the custom test adapters from the specified path in the test run.
+.PP
+\f[C]\-c|\-\-configuration\ {Debug|Release}\f[]
+.PP
+Defines the build configuration.
+The default value is \f[C]Debug\f[], but your project's configuration could override this default SDK setting.
+.PP
+\f[C]\-d|\-\-diag\ <PATH_TO_DIAGNOSTICS_FILE>\f[]
+.PP
+Enables diagnostic mode for the test platform and write diagnostic messages to the specified file.
+.PP
+\f[C]\-f|\-\-framework\ <FRAMEWORK>\f[]
+.PP
+Looks for test binaries for a specific framework.
+.PP
+\f[C]\-\-filter\ <EXPRESSION>\f[]
+.PP
+Filters out tests in the current project using the given expression.
+For more information, see the Filter option details section.
+For additional information and examples on how to use selective unit test filtering, see Running selective unit tests.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-l|\-\-logger\ <LoggerUri/FriendlyName>\f[]
+.PP
+Specifies a logger for test results.
+.PP
+\f[C]\-\-no\-build\f[]
+.PP
+Does not build the test project prior to running it.
+.PP
+\f[C]\-o|\-\-output\ <OUTPUT_DIRECTORY>\f[]
+.PP
+Directory in which to find the binaries to run.
+.PP
+\f[C]\-s|\-\-settings\ <SETTINGS_FILE>\f[]
+.PP
+Settings to use when running tests.
+.PP
+\f[C]\-t|\-\-list\-tests\f[]
+.PP
+List all of the discovered tests in the current project.
+.PP
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
+.PP
+   *   *   *   *   *
+.SH EXAMPLES
+.PP
+Run the tests in the project in the current directory:
+.PP
+\f[C]dotnet\ test\f[]
+.PP
+Run the tests in the \f[C]test1\f[] project:
+.PP
+\f[C]dotnet\ test\ ~/projects/test1/test1.csproj\f[]
+.SS Filter option details
+.PP
+\f[C]\-\-filter\ <EXPRESSION>\f[]
+.PP
+\f[C]<Expression>\f[] has the format \f[C]<property><operator><value>[|&<Expression>]\f[].
+.PP
+\f[C]<property>\f[] is an attribute of the \f[C]Test\ Case\f[].
+The following are the properties supported by popular unit test frameworks:
+.PP
+.TS
+tab(@);
+c l.
+T{
+Test Framework
+T}@T{
+Supported properties
+T}
+_
+.TE
+| MSTest |
+FullyQualifiedName
+Name
+ClassName
+Priority
+TestCategory
+| | Xunit |
+FullyQualifiedName
+DisplayName
+Traits
+.IP
+.nf
+\f[C]
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ |
+\f[]
+.fi
+.PP
+The \f[C]<operator>\f[] describes the relationship between the property and the value:
+.PP
+.TS
+tab(@);
+c l.
+T{
+Operator
+T}@T{
+Function
+T}
+_
+T{
+\f[C]=\f[]
+T}@T{
+Exact match
+T}
+T{
+\f[C]!=\f[]
+T}@T{
+Not exact match
+T}
+T{
+\f[C]~\f[]
+T}@T{
+Contains
+T}
+.TE
+.PP
+\f[C]<value>\f[] is a string.
+All the lookups are case insensitive.
+.PP
+An expression without an \f[C]<operator>\f[] is automatically considered as a \f[C]contains\f[] on \f[C]FullyQualifiedName\f[] property (for example, \f[C]dotnet\ test\ \-\-filter\ xyz\f[] is same as \f[C]dotnet\ test\ \-\-filter\ FullyQualifiedName~xyz\f[]).
+.PP
+Expressions can be joined with conditional operators:
+.PP
+.TS
+tab(@);
+c c.
+T{
+Operator
+T}@T{
+Function
+T}
+_
+T{
+| \  \ 
+T}@T{
+OR \  \  \ 
+T}
+T{
+\f[C]&\f[]
+T}@T{
+AND
+T}
+.TE
+.PP
+You can enclose expressions in parenthesis when using conditional operators (for example, \f[C](Name~TestMethod1)\ |\ (Name~TestMethod2)\f[]).
+.PP
+For additional information and examples on how to use selective unit test filtering, see Running selective unit tests.
+.SS See also
+.PP
+Frameworks and Targets
+.PD 0
+.P
+.PD
+\&.NET Core Runtime IDentifier (RID) catalog
 .SH AUTHORS
-Microsoft Corporation dotnetclifeedback\@microsoft.com.
+mairaw.

Documentation/manpages/sdk/dotnet-vstest.1

@@ -0,0 +1,141 @@
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet vstest command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet vstest
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\-vstest\f[] \- Runs tests from the specified files.
+.SH SYNOPSIS
+.PP
+\f[C]dotnet\ vstest\ [<TEST_FILE_NAMES>]\ [\-\-Settings|/Settings]\ [\-\-Tests|/Tests]\ [\-\-TestAdapterPath|/TestAdapterPath]\ [\-\-Platform|/Platform]\ [\-\-Framework|/Framework]\ [\-\-Parallel|/Parallel]\ [\-\-TestCaseFilter|/TestCaseFilter]\ [\-\-logger|/logger]\ [\-lt|\-\-ListTests|/lt|/ListTests]\ [\-\-ParentProcessId|/ParentProcessId]\ [\-\-Port|/Port]\ [\-\-Diag|/Diag]\ [[\-\-]\ <args>...]]\ [\-?|\-\-Help|/?|/Help]\f[]
+.SH DESCRIPTION
+.PP
+The \f[C]dotnet\-vstest\f[] command runs the \f[C]VSTest.Console\f[] command\-line application to run automated unit and coded UI application tests.
+.SS Arguments
+.PP
+\f[C]TEST_FILE_NAMES\f[]
+.PP
+Run tests from the specified assemblies.
+Separate multiple test assembly names with spaces.
+.SH OPTIONS
+.PP
+\f[C]\-\-Settings|/Settings:<Settings\ File>\f[]
+.PP
+Settings to use when running tests.
+.PP
+\f[C]\-\-Tests|/Tests:<Test\ Names>\f[]
+.PP
+Run tests with names that match the provided values.
+Separate multiple values with commas.
+.PP
+\f[C]\-\-TestAdapterPath|/TestAdapterPath\f[]
+.PP
+Use custom test adapters from a given path (if any) in the test run.
+.PP
+\f[C]\-\-Platform|/Platform:<Platform\ type>\f[]
+.PP
+Target platform architecture used for test execution.
+Valid values are \f[C]x86\f[], \f[C]x64\f[], and \f[C]ARM\f[].
+.PP
+\f[C]\-\-Framework|/Framework:<Framework\ Version>\f[]
+.PP
+Target .NET Framework version used for test execution.
+Examples of valid values are \f[C]\&.NETFramework,Version=v4.6\f[], \f[C]\&.NETCoreApp,Version=v1.0\f[], etc.
+Other supported values are \f[C]Framework35\f[], \f[C]Framework40\f[], \f[C]Framework45\f[], and \f[C]FrameworkCore10\f[].
+.PP
+\f[C]\-\-Parallel|/Parallel\f[]
+.PP
+Execute tests in parallel.
+By default, all available cores on the machine are available for use.
+Set an explicit number of cores with a settings file.
+.PP
+\f[C]\-\-TestCaseFilter|/TestCaseFilter:<Expression>\f[]
+.PP
+Run tests that match the given expression.
+\f[C]<Expression>\f[] is of the format \f[C]<property>Operator<value>[|&<Expression>]\f[], where Operator is one of \f[C]=\f[], \f[C]!=\f[], or \f[C]~\f[].
+Operator \f[C]~\f[] has `contains' semantics and is applicable for string properties like \f[C]DisplayName\f[].
+Parenthesis \f[C]()\f[] are used to group sub\-expressions.
+.PP
+\f[C]\-?|\-\-Help|/?|/Help\f[]
+.PP
+Prints out a short help for the command.
+.PP
+\f[C]\-\-logger|/logger:<Logger\ Uri/FriendlyName>\f[]
+.PP
+Specify a logger for test results.
+.IP \[bu] 2
+To publish test results to Team Foundation Server, use the \f[C]TfsPublisher\f[] logger provider:
+.RS 2
+.IP
+.nf
+\f[C]
+/logger:TfsPublisher;
+\ \ \ \ Collection=<team\ project\ collection\ url>;
+\ \ \ \ BuildName=<build\ name>;
+\ \ \ \ TeamProject=<team\ project\ name>
+\ \ \ \ [;Platform=<Defaults\ to\ "Any\ CPU">]
+\ \ \ \ [;Flavor=<Defaults\ to\ "Debug">]
+\ \ \ \ [;RunTitle=<title>]
+\f[]
+.fi
+.RE
+.IP \[bu] 2
+To log results to a Visual Studio Test Results File (TRX), use the \f[C]trx\f[] logger provider.
+This switch creates a file in the test results directory with given log file name.
+If \f[C]LogFileName\f[] isn't provided, a unique file name is created to hold the test results.
+.RS 2
+.IP
+.nf
+\f[C]
+/logger:trx\ [;LogFileName=<Defaults\ to\ unique\ file\ name>]
+\f[]
+.fi
+.RE
+.PP
+\f[C]\-lt|\-\-ListTests|/lt|/ListTests:<File\ Name>\f[]
+.PP
+Lists discovered tests from the given test container.
+.PP
+\f[C]\-\-ParentProcessId|/ParentProcessId:<ParentProcessId>\f[]
+.PP
+Process Id of the parent process responsible for launching the current process.
+.PP
+\f[C]\-\-Port|/Port:<Port>\f[]
+.PP
+Specifies the port for the socket connection and receiving the event messages.
+.PP
+\f[C]\-\-Diag|/Diag:<Path\ to\ log\ file>\f[]
+.PP
+Enables verbose logs for the test platform.
+Logs are written to the provided file.
+.PP
+\f[C]args\f[]
+.PP
+Specifies extra arguments to pass to the adapter.
+Arguments are specified as name\-value pairs of the form \f[C]<n>=<v>\f[], where \f[C]<n>\f[] is the argument name and \f[C]<v>\f[] is the argument value.
+Use a space to separate multiple arguments.
+.SH EXAMPLES
+.PP
+Run tests in \f[C]mytestproject.dll\f[]:
+.PP
+\f[C]dotnet\ vstest\ mytestproject.dll\f[]
+.PP
+Run tests in \f[C]mytestproject.dll\f[], exporting to custom folder with custom name:
+.PP
+\f[C]dotnet\ vstest\ mytestproject.dll\ \-\-logger:"trx;LogFileName=custom_file_name.trx"\ \-\-ResultsDirectory:custom/file/path\f[]
+.PP
+Run tests in \f[C]mytestproject.dll\f[] and \f[C]myothertestproject.exe\f[]:
+.PP
+\f[C]dotnet\ vstest\ mytestproject.dll\ myothertestproject.exe\f[]
+.PP
+Run \f[C]TestMethod1\f[] tests:
+.PP
+\f[C]dotnet\ vstest\ /Tests:TestMethod1\f[]
+.PP
+Run \f[C]TestMethod1\f[] and \f[C]TestMethod2\f[] tests:
+.PP
+\f[C]dotnet\ vstest\ /Tests:TestMethod1,TestMethod2\f[]
+.SH AUTHORS
+guardrex.

Documentation/manpages/sdk/dotnet.1

@@ -0,0 +1,401 @@
+.\"t
+.\" Automatically generated by Pandoc 2.1.3
+.\"
+.TH "dotnet command \- .NET Core CLI" "1" "" "" ".NET Core"
+.hy
+.SH dotnet command
+.PP
+.SH NAME
+.PP
+\f[C]dotnet\f[] \- General driver for running the command\-line commands.
+.SH SYNOPSIS
+.SS .NET Core 2.x
+.IP
+.nf
+\f[C]
+dotnet\ [command]\ [arguments]\ [\-\-additional\-deps]\ [\-\-additionalprobingpath]\ [\-d|\-\-diagnostics]
+\ \ \ \ [\-\-fx\-version]\ [\-h|\-\-help]\ [\-\-info]\ [\-\-roll\-forward\-on\-no\-candidate\-fx]\ [\-v|\-\-verbosity]\ [\-\-version]
+\f[]
+.fi
+.SS .NET Core 1.x
+.IP
+.nf
+\f[C]
+dotnet\ [command]\ [arguments]\ [\-\-additionalprobingpath]\ [\-d|\-\-diagnostics]\ [\-\-fx\-version]
+\ \ \ \ [\-h|\-\-help]\ [\-\-info]\ [\-v|\-\-verbosity]\ [\-\-version]
+\f[]
+.fi
+.PP
+   *   *   *   *   *
+.SH DESCRIPTION
+.PP
+\f[C]dotnet\f[] is a generic driver for the Command Line Interface (CLI) toolchain.
+Invoked on its own, it provides brief usage instructions.
+.PP
+Each specific feature is implemented as a command.
+In order to use the feature, the command is specified after \f[C]dotnet\f[], such as \f[C]dotnet\ build\f[].
+All of the arguments following the command are its own arguments.
+.PP
+The only time \f[C]dotnet\f[] is used as a command on its own is to run framework\-dependent apps.
+Specify an application DLL after the \f[C]dotnet\f[] verb to execute the application (for example, \f[C]dotnet\ myapp.dll\f[]).
+.SH OPTIONS
+.SS .NET Core 2.x
+.PP
+\f[C]\-\-additional\-deps\ <PATH>\f[]
+.PP
+Path to additional \f[I]deps.json\f[] file.
+.PP
+\f[C]\-\-additionalprobingpath\ <PATH>\f[]
+.PP
+Path containing probing policy and assemblies to probe.
+.PP
+\f[C]\-d|\-\-diagnostics\f[]
+.PP
+Enables diagnostic output.
+.PP
+\f[C]\-\-fx\-version\ <VERSION>\f[]
+.PP
+Version of the installed .NET Core runtime to use to run the application.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+If using with \f[C]dotnet\f[], it also prints a list of the available commands.
+.PP
+\f[C]\-\-info\f[]
+.PP
+Prints out detailed information about the CLI tooling and the environment, such as the current operating system, commit SHA for the version, and other information.
+.PP
+\f[C]\-\-roll\-forward\-on\-no\-candidate\-fx\f[]
+.PP
+Rolls forward on no candidate shared framework.
+.PP
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
+Not supported in every command; see specific command page to determine if this option is available.
+.PP
+\f[C]\-\-version\f[]
+.PP
+Prints out the version of the .NET Core SDK in use.
+.SS .NET Core 1.x
+.PP
+\f[C]\-\-additionalprobingpath\ <PATH>\f[]
+.PP
+Path containing probing policy and assemblies to probe.
+.PP
+\f[C]\-d|\-\-diagnostics\f[]
+.PP
+Enables diagnostic output.
+.PP
+\f[C]\-\-fx\-version\ <VERSION>\f[]
+.PP
+Version of the installed .NET Core runtime to use to run the application.
+.PP
+\f[C]\-h|\-\-help\f[]
+.PP
+Prints out a short help for the command.
+If using with \f[C]dotnet\f[], it also prints a list of the available commands.
+.PP
+\f[C]\-\-info\f[]
+.PP
+Prints out detailed information about the CLI tooling and the environment, such as the current operating system, commit SHA for the version, and other information.
+.PP
+\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
+.PP
+Sets the verbosity level of the command.
+Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
+Not supported in every command; see specific command page to determine if this option is available.
+.PP
+\f[C]\-\-version\f[]
+.PP
+Prints out the version of the .NET Core SDK in use.
+.PP
+   *   *   *   *   *
+.SS dotnet commands
+.SS General
+.SS .NET Core 2.x
+.PP
+.TS
+tab(@);
+l l.
+T{
+Command
+T}@T{
+Function
+T}
+_
+T{
+dotnet build
+T}@T{
+Builds a .NET Core application.
+T}
+T{
+dotnet clean
+T}@T{
+Clean build outputs.
+T}
+T{
+dotnet help
+T}@T{
+Shows more detailed documentation online for the command.
+T}
+T{
+dotnet migrate
+T}@T{
+Migrates a valid Preview 2 project to a .NET Core SDK 1.0 project.
+T}
+T{
+dotnet msbuild
+T}@T{
+Provides access to the MSBuild command line.
+T}
+T{
+dotnet new
+T}@T{
+Initializes a C# or F# project for a given template.
+T}
+T{
+dotnet pack
+T}@T{
+Creates a NuGet package of your code.
+T}
+T{
+dotnet publish
+T}@T{
+Publishes a .NET framework\-dependent or self\-contained application.
+T}
+T{
+dotnet restore
+T}@T{
+Restores the dependencies for a given application.
+T}
+T{
+dotnet run
+T}@T{
+Runs the application from source.
+T}
+T{
+dotnet sln
+T}@T{
+Options to add, remove, and list projects in a solution file.
+T}
+T{
+dotnet store
+T}@T{
+Stores assemblies in the runtime package store.
+T}
+T{
+dotnet test
+T}@T{
+Runs tests using a test runner.
+T}
+.TE
+.SS .NET Core 1.x
+.PP
+.TS
+tab(@);
+l l.
+T{
+Command
+T}@T{
+Function
+T}
+_
+T{
+dotnet build
+T}@T{
+Builds a .NET Core application.
+T}
+T{
+dotnet clean
+T}@T{
+Clean build outputs.
+T}
+T{
+dotnet migrate
+T}@T{
+Migrates a valid Preview 2 project to a .NET Core SDK 1.0 project.
+T}
+T{
+dotnet msbuild
+T}@T{
+Provides access to the MSBuild command line.
+T}
+T{
+dotnet new
+T}@T{
+Initializes a C# or F# project for a given template.
+T}
+T{
+dotnet pack
+T}@T{
+Creates a NuGet package of your code.
+T}
+T{
+dotnet publish
+T}@T{
+Publishes a .NET framework\-dependent or self\-contained application.
+T}
+T{
+dotnet restore
+T}@T{
+Restores the dependencies for a given application.
+T}
+T{
+dotnet run
+T}@T{
+Runs the application from source.
+T}
+T{
+dotnet sln
+T}@T{
+Options to add, remove, and list projects in a solution file.
+T}
+T{
+dotnet test
+T}@T{
+Runs tests using a test runner.
+T}
+.TE
+.PP
+   *   *   *   *   *
+.SS Project references
+.PP
+.TS
+tab(@);
+l l.
+T{
+Command
+T}@T{
+Function
+T}
+_
+T{
+dotnet add reference
+T}@T{
+Add a project reference.
+T}
+T{
+dotnet list reference
+T}@T{
+List project references.
+T}
+T{
+dotnet remove reference
+T}@T{
+Remove a project reference.
+T}
+.TE
+.SS NuGet packages
+.PP
+.TS
+tab(@);
+l l.
+T{
+Command
+T}@T{
+Function
+T}
+_
+T{
+dotnet add package
+T}@T{
+Add a NuGet package.
+T}
+T{
+dotnet remove package
+T}@T{
+Remove a NuGet package.
+T}
+.TE
+.SS NuGet commands
+.PP
+.TS
+tab(@);
+l l.
+T{
+Command
+T}@T{
+Function
+T}
+_
+T{
+dotnet nuget delete
+T}@T{
+Deletes or unlists a package from the server.
+T}
+T{
+dotnet nuget locals
+T}@T{
+Clears or lists local NuGet resources such as http\-request cache, temporary cache, or machine\-wide global packages folder.
+T}
+T{
+dotnet nuget push
+T}@T{
+Pushes a package to the server and publishes it.
+T}
+.TE
+.SH EXAMPLES
+.PP
+Initialize a sample .NET Core console application that can be compiled and run:
+.PP
+\f[C]dotnet\ new\ console\f[]
+.PP
+Restore dependencies for a given application:
+.PP
+\f[C]dotnet\ restore\f[]
+.PP
+.PP
+Build a project and its dependencies in a given directory:
+.PP
+\f[C]dotnet\ build\f[]
+.PP
+Run a framework\-dependent app named \f[C]myapp.dll\f[]:
+.PP
+\f[C]dotnet\ myapp.dll\f[]
+.SH ENVIRONMENT VARIABLES
+.SS .NET Core 2.x
+.PP
+\f[C]DOTNET_PACKAGES\f[]
+.PP
+The primary package cache.
+If not set, it defaults to \f[C]$HOME/.nuget/packages\f[] on Unix or \f[C]%HOME%\\NuGet\\Packages\f[] on Windows.
+.PP
+\f[C]DOTNET_SERVICING\f[]
+.PP
+Specifies the location of the servicing index to use by the shared host when loading the runtime.
+.PP
+\f[C]DOTNET_CLI_TELEMETRY_OPTOUT\f[]
+.PP
+Specifies whether data about the .NET Core tools usage is collected and sent to Microsoft.
+Set to \f[C]true\f[] to opt\-out of the telemetry feature (values \f[C]true\f[], \f[C]1\f[], or \f[C]yes\f[] accepted); otherwise, set to \f[C]false\f[] to opt\-in to the telemetry features (values \f[C]false\f[], \f[C]0\f[], or \f[C]no\f[] accepted).
+If not set, the defaults is \f[C]false\f[], and the telemetry feature is active.
+.PP
+\f[C]DOTNET_MULTILEVEL_LOOKUP\f[]
+.PP
+Specifies whether .NET Core runtime, shared framework or SDK are resolved from the global location.
+If not set, it defaults to \f[C]true\f[].
+Set to \f[C]false\f[] to not resolve from the global location and have isolated .NET Core installations (values \f[C]0\f[] or \f[C]false\f[] are accepted).
+For more information about multi\-level lookup, see Multi\-level SharedFX Lookup.
+.SS .NET Core 1.x
+.PP
+\f[C]DOTNET_PACKAGES\f[]
+.PP
+The primary package cache.
+If not set, it defaults to \f[C]$HOME/.nuget/packages\f[] on Unix or \f[C]%HOME%\\NuGet\\Packages\f[] on Windows.
+.PP
+\f[C]DOTNET_SERVICING\f[]
+.PP
+Specifies the location of the servicing index to use by the shared host when loading the runtime.
+.PP
+\f[C]DOTNET_CLI_TELEMETRY_OPTOUT\f[]
+.PP
+Specifies whether data about the .NET Core tools usage is collected and sent to Microsoft.
+Set to \f[C]true\f[] to opt\-out of the telemetry feature (values \f[C]true\f[], \f[C]1\f[], or \f[C]yes\f[] accepted); otherwise, set to \f[C]false\f[] to opt\-in to the telemetry features (values \f[C]false\f[], \f[C]0\f[], or \f[C]no\f[] accepted).
+If not set, the defaults is \f[C]false\f[], and the telemetry feature is active.
+.PP
+   *   *   *   *   *
+.SH AUTHORS
+mairaw.

Documentation/manpages/tool/README.md

@@ -0,0 +1,35 @@
+# Manpage update tool
+
+Utility to update dotnet-cli documentation from https://github.com/dotnet/docs.
+
+## Prerequisites
+
+* Unix OS
+* `python` in PATH
+* `pandoc` installed
+* `pandocfilters` package installed
+* `unzip`
+* `wget` or `curl`
+
+## Usage
+
+```sh
+./update-man-pages.sh
+```
+
+## Ubuntu example (from scratch)
+
+```sh
+apt update
+apt install -y jq curl python python-pip wget unzip git < /dev/null
+pip install pandocfilters
+
+pandocVersion=$(curl -s https://api.github.com/repos/jgm/pandoc/releases/latest | jq -r ".tag_name")
+pandocVersionedName="pandoc-$pandocVersion-1-amd64.deb"
+curl -sLO https://github.com/jgm/pandoc/releases/download/$pandocVersion/$pandocVersionedName > /dev/null
+dpkg -i $pandocVersionedName
+rm $pandocVersionedName*
+
+git clone https://github.com/dotnet/cli
+./cli/Documentation/manpages/tool/update-man-pages.sh
+```

Documentation/manpages/tool/man-pandoc-filter.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python
+#
+# Copyright (c) .NET Foundation and contributors. All rights reserved.
+# Licensed under the MIT license. See LICENSE file in the project root for full license information.
+#
+
+import copy
+from pandocfilters import toJSONFilters, Para, Str, Header, Space, Link
+
+def remove_includes(key, value, format, meta):
+    if key == 'Para' and value[0]['c'] == '[!INCLUDE':
+        return Para([Str("")])
+    return None
+
+def promote_and_capitalize_sections(key, value, format, meta):
+    if key == 'Header':
+        header_contents = value[2]
+        header_text = ' '.join([ x['c'] for x in header_contents if x['t'] == 'Str']).lower()
+        if header_text in ['name', 'synopsis', 'description', 'options', 'examples', 'environment variables']:
+            # capitalize
+            for element in header_contents:
+                if element['t'] == 'Str':
+                    element['c'] = element['c'].upper()
+            # promote
+            value = Header(1, value[1], header_contents)
+            return value
+    return None
+
+def demote_net_core_1_2(key, value, format, meta):
+    if key == 'Header':
+        header_id = value[1][0]
+        if header_id.startswith('net-core-'):
+            value = Header(2, value[1], value[2][0]['c'][1])
+            return value
+    return None
+
+def remove_references(key, value, format, meta):
+    if key == 'Link':
+        pass
+        if value[1][0]['t'] == 'Code':
+            return value[1][0]
+        return Str(' '.join([e['c'] for e in value[1] if 'c' in e.keys()]))
+    return None
+
+def main():
+    toJSONFilters([
+        remove_includes,
+        promote_and_capitalize_sections,
+        demote_net_core_1_2,
+        remove_references,
+    ])
+
+if __name__ == '__main__':
+    main()

Documentation/manpages/tool/update-man-pages.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env sh
+#
+# Copyright (c) .NET Foundation and contributors. All rights reserved.
+# Licensed under the MIT license. See LICENSE file in the project root for full license information.
+#
+
+MANPAGE_TOOL_DIR=$(cd $(dirname $0); pwd)
+
+cd $MANPAGE_TOOL_DIR/../sdk
+
+echo "Downloading dotnet/docs master"
+
+if [ -x "$(command -v curl)" ]; then
+  curl -sSLO https://github.com/dotnet/docs/archive/master.zip > /dev/null
+elif [ -x "$(command -v wget)" ]; then
+  wget -q https://github.com/dotnet/docs/archive/master.zip > /dev/null
+else
+  echo "Please install curl or wget to proceed"
+  exit 1
+fi
+
+echo "Extracting master.zip"
+unzip -o master.zip > /dev/null
+
+echo "Removing master.zip"
+rm master.zip*
+
+ls docs-master/docs/core/tools/dotnet*.md | while read -r line;
+  do
+    echo "Working on $line"
+    pandoc -s -t man -V section=1 -V header=".NET Core" --column=500 --filter $MANPAGE_TOOL_DIR/man-pandoc-filter.py "$line" -o "$(basename ${line%.md}.1)"
+done
+
+rm -rf docs-master

Documentation/project-docs/developer-guide.md

@@ -3,7 +3,7 @@ Developer Guide
 
 ## Prerequisites
 
-In order to build .NET Command Line Interface, you need the following installed on you machine.
+In order to build .NET Command-line Interface (CLI), you need the following installed on you machine:
 
 ### For Windows
 
@@ -27,8 +27,9 @@ In order to build .NET Command Line Interface, you need the following installed
 ## Building/Running
 
 1. Run `build.cmd` or `build.sh` from the root depending on your OS. If you don't want to execute tests, run `build.cmd /t:Compile` or `./build.sh /t:Compile`. 
-  - To build the CLI in macOS Sierra, you need to set the DOTNET_RUNTIME_ID environment variable by running `export DOTNET_RUNTIME_ID=osx.10.11-x64`.
+2. The CLI that is built (we call it stage 2) is laid out in the `bin\2\{RID}\dotnet` folder. You can run `dotnet.exe` or `dotnet` from that folder to try out the `dotnet` command.
-2. Use `artifacts/{RID}/stage2/dotnet` to try out the `dotnet` command. You can also add `artifacts/{os}-{arch}/stage2` to the PATH if you want to use the build output when invoking `dotnet` from the current console.
+
+> If you need to update localizable strings in resource (*.resx*) files, run `build.cmd /p:UpdateXlfOnBuild=true` or `./build.sh /p:UpdateXlfOnBuild=true` to update the XLIFF (*.xlf*) files as well.
 
 ## A simple test
 Using the `dotnet` built in the previous step:
@@ -40,8 +41,12 @@ Using the `dotnet` built in the previous step:
 
 ## Running tests
 
-1. To run all tests invoke `build.cmd` or `build.sh` which will build the product and run the tests.
+1. To run all tests, invoke `build.cmd` or `build.sh` which will build the product and run the tests.
-2. To run a specific test, cd into that test's directory and execute `dotnet test`. If using this approach, make sure to add `artifacts/{RID}/stage2` to your `PATH` and set the `NUGET_PACKAGES` environment variable to point to the repo's `.nuget/packages` directory.
+2. To run a specific test project:
+    - Run `scripts\cli-test-env.bat` on Windows, or [source](https://en.wikipedia.org/wiki/Source_(command)) `scripts/cli-test-env.sh` on Linux or OS X.  This will add the stage 2 `dotnet` folder to your path and set up other environment variables which are used for running tests.
+    - `cd` into the test's directory
+    - Run `dotnet test`
+    - Refer to the command-line help for `dotnet test` if you want to run a specific test in the test project
 
 ## Adding a Command
 
@@ -53,12 +58,15 @@ The dotnet CLI supports several models for adding new commands:
 4. Via the user's `PATH`
 
 ### Commands in dotnet.dll
+
 Developers are generally encouraged to avoid adding commands to `dotnet.dll` or the CLI installer directly. This is appropriate for very general commands such as restore, build, publish, test, and clean, but is generally too broad of a distribution mechanism for new commands. Please create an issue and engage the team if you feel there is a missing core command that you would like to add.
 
 ### Tools NuGet packages
+
 Many existing extensions, including those for ASP.NET Web applications, extend the CLI using Tools NuGet packages. For an example of a working packaged command look at `TestAssets/TestPackages/dotnet-hello/v1/`.
 
 ### MSBuild tasks & targets
+
 NuGet allows adding tasks and targets to a project through a NuGet package. This mechanism, in fact, is how all .NET Core projects pull in the .NET SDK. Extending the CLI through this model has several advantages:
 
 1. Targets have access to the MSBuild Project Context, allowing them to reason about the files and properties being used to build a particular project.
@@ -68,7 +76,9 @@ Commands added as targets can be invoked once the target project adds a referenc
 Targets are invoked by calling `dotnet msbuild /t:{TargetName}`
 
 ### Commands on the PATH
+
 The dotnet CLI considers any executable on the path named `dotnet-{commandName}` to be a command it can call out to. 
 
 ## Things to Know
+
 - Any added commands are usually invoked through `dotnet {command}`. As a result of this, stdout and stderr are redirected through the driver (`dotnet`) and buffered by line. As a result of this, child commands should use Console.WriteLine in any cases where they expect output to be written immediately. Any uses of Console.Write should be followed by Console.WriteLine to ensure the output is written.

Documentation/specs/cli-installation-scenarios.md

@@ -17,6 +17,8 @@ Obtaining .NET CLI
 * [Acquisition modes](#acquisition-modes)
   * [Native installers](#native-installers)
   * [Installation script](#installation-script)
+    * [Windows one-liner](#windows-command)
+    * [OSX/Linux one-liner](#osxlinux-shell-command)
   * [Complete manual installation](#complete-manual-installation)
   * [Docker](#docker)
   * [NuGet Packages](#nuget-packages)
@@ -256,6 +258,18 @@ OSX/Linux:
 ./dotnet-install.sh --channel 2.0
 ```
 
+#### Windows obtain one-liner example
+
+```
+@powershell -NoProfile -ExecutionPolicy unrestricted -Command "&([scriptblock]::Create((Invoke-WebRequest -useb 'https://dot.net/v1/dotnet-install.ps1'))) <additional installation-script args>"
+```
+
+#### OSX/Linux obtain one-liner
+
+```
+curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin <additional installation-script args>
+```
+
 ### Docker 
 [Docker](https://docs.docker.com/) has become a pretty good way to use developer tools, from trying them out in an interactive image use to using it for deployment. We have Docker images on DockerHub already. 
 

Documentation/specs/runtime-configuration-file.md

@@ -9,8 +9,8 @@ The runtime configuration files store the dependencies of an application (former
 There are two runtime configuration files for a particular application. Given a project named `MyApp`, the compilation process produces the following files (on Windows, other platforms are similar):
 
 * `MyApp.dll` - The managed assembly for `MyApp`, including an ECMA-compliant entry point token.
-* `MyApp.exe` - A copy of the `corehost.exe` executable.
+* `MyApp.exe` - A copy of the `corehost.exe` executable. Only present when the application is a self-contained application.
-* `MyApp.runtimeconfig.json` - An **optional** configuration file containing runtime configuration settings.
+* `MyApp.runtimeconfig.json` - An **optional** configuration file containing runtime configuration settings. This file is required for portable applications, but not for self-contained apps.
 * `MyApp.deps.json` - A list of dependencies, as well as compilation context data and compilation dependencies. Not technically required, but required to use the servicing or package cache/shared package install features.
 
 The `MyApp.runtimeconfig.json` is designed to be user-editable (in the case of an app consumer wanting to change various CLR runtime options for an app, much like the `MyApp.exe.config` XML file works in .NET 4.x today). However, the `MyApp.deps.json` file is designed to be processed by automated tools and should not be user-edited. Having the files as separate makes this clearer. We could use a different format for the deps file, but if we're already integrating a JSON parser into the host, it seems most appropriate to re-use that here. Also, there are diagnostic benefits to being able to read the `.deps.json` file in a simple text editor.

Microsoft.DotNet.Cli.sln

@@ -1,6 +1,7 @@
+
 Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio 15
-VisualStudioVersion = 15.0.26510.0
+VisualStudioVersion = 15.0.27130.2020
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{ED2FE3E2-F7E7-4389-8231-B65123F2076F}"
 EndProject
@@ -13,8 +14,6 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "test", "test", "{17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}"
 EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tools", "tools", "{0722D325-24C8-4E83-B5AF-0A083E7F0749}"
-EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "build_projects", "build_projects", "{88278B81-7649-45DC-8A6A-D3A645C5AFC3}"
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "TestAssets", "TestAssets", "{ADA7052B-884B-4776-8B8D-D04191D0AA70}"
@@ -23,21 +22,24 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "TestPackages", "TestPackage
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "build", "build", "{89905EC4-BC0F-443B-8ADF-691321F10108}"
 	ProjectSection(SolutionItems) = preProject
+		build\AppHostTemplate.proj = build\AppHostTemplate.proj
 		build\AzureInfo.props = build\AzureInfo.props
 		build\BackwardsCompatibilityRuntimes.props = build\BackwardsCompatibilityRuntimes.props
 		build\BranchInfo.props = build\BranchInfo.props
 		build\Branding.props = build\Branding.props
 		build\BuildDefaults.props = build\BuildDefaults.props
 		build\BuildInfo.targets = build\BuildInfo.targets
+		build\BundledDotnetTools.proj = build\BundledDotnetTools.proj
+		build\BundledDotnetTools.props = build\BundledDotnetTools.props
 		build\BundledRuntimes.props = build\BundledRuntimes.props
 		build\BundledSdks.props = build\BundledSdks.props
 		build\BundledTemplates.proj = build\BundledTemplates.proj
 		build\BundledTemplates.props = build\BundledTemplates.props
 		build\BundledTools.props = build\BundledTools.props
-		build\BundledVersions.targets = build\BundledVersions.targets
 		build\Compile.targets = build\Compile.targets
 		build\CrossGen.props = build\CrossGen.props
 		build\DependencyVersions.props = build\DependencyVersions.props
+		build\DerivedHostMachineInfo.props = build\DerivedHostMachineInfo.props
 		build\FileExtensions.props = build\FileExtensions.props
 		build\GitCommitInfo.targets = build\GitCommitInfo.targets
 		build\HostInfo.targets = build\HostInfo.targets
@@ -54,12 +56,10 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "build", "build", "{89905EC4
 		build\Publish.targets = build\Publish.targets
 		build\RestoreDependency.proj = build\RestoreDependency.proj
 		build\sdks\sdks.csproj = build\sdks\sdks.csproj
+		build\SetupPreviousStage.props = build\SetupPreviousStage.props
 		build\Signing.proj = build\Signing.proj
-		build\Stage0.props = build\Stage0.props
 		build\Test.targets = build\Test.targets
 		build\Version.props = build\Version.props
-		build\VersionBadge.props = build\VersionBadge.props
-		build\DerivedHostMachineInfo.props = build\DerivedHostMachineInfo.props
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "package", "package", "{FD7D515A-D10F-4F49-B8AE-21CF7ED071AE}"
@@ -131,8 +131,6 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "PackageWithFakeNativeDep",
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ToolWithOutputName", "TestAssets\TestPackages\ToolWithOutputName\ToolWithOutputName.csproj", "{8FB83810-5A4C-4097-9A79-8E687E4981CB}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "dotnet-archive", "src\dotnet-archive\dotnet-archive.csproj", "{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}"
-EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "dotnet", "src\dotnet\dotnet.csproj", "{203F0362-DAFC-4679-A01E-7FBC331D8647}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.DotNet.Archive", "src\Microsoft.DotNet.Archive\Microsoft.DotNet.Archive.csproj", "{F8C66E8A-FC59-40B3-AC0F-58CA22526F76}"
@@ -143,16 +141,12 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.DotNet.Configurer
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.DotNet.InternalAbstractions", "src\Microsoft.DotNet.InternalAbstractions\Microsoft.DotNet.InternalAbstractions.csproj", "{570950AD-A080-4F32-980C-F50E312910DF}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.DotNet.TestFramework", "src\Microsoft.DotNet.TestFramework\Microsoft.DotNet.TestFramework.csproj", "{6592A22C-2386-4E83-A4D3-FC08075C723A}"
-EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "redist", "src\redist\redist.csproj", "{098D9321-1201-4974-A75E-F58EBCD98ACF}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "tool_msbuild", "src\tool_msbuild\tool_msbuild.csproj", "{D82A3246-9831-4024-A9B2-1932EEF3D56F}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "tool_nuget", "src\tool_nuget\tool_nuget.csproj", "{BE4C655A-DC54-4408-B739-743456D34111}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Archiver", "tools\Archiver\Archiver.csproj", "{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}"
-EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ArgumentForwardingTests", "test\ArgumentForwardingTests\ArgumentForwardingTests.csproj", "{3E28672F-F4E4-44D5-AEFB-1F425DECC57E}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ArgumentsReflector", "test\ArgumentsReflector\ArgumentsReflector.csproj", "{A5CA696F-585E-40AB-912C-6316BC330C5E}"
@@ -197,8 +191,6 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.DotNet.Tools.Test
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "msbuild.IntegrationTests", "test\msbuild.IntegrationTests\msbuild.IntegrationTests.csproj", "{23EE9BBB-3B33-4CF2-8D1A-29A8DB12E878}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Performance", "test\Performance\Performance.csproj", "{F5E27BA5-063B-4770-A6E8-87252E9AB22C}"
-EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.DotNet.Cli.Build.Framework", "build_projects\Microsoft.DotNet.Cli.Build.Framework\Microsoft.DotNet.Cli.Build.Framework.csproj", "{AA744891-5209-4335-8457-37EC347DF833}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "shared-build-targets-utils", "build_projects\shared-build-targets-utils\shared-build-targets-utils.csproj", "{DA3595A8-35DE-42B9-97A4-4A2461BAD554}"
@@ -231,6 +223,26 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "dotnet-add-package.Tests",
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "tool_fsc", "src\tool_fsharp\tool_fsc.csproj", "{602976C5-2477-4B4C-AD9A-1EAFB250529A}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.DotNet.MSBuildSdkResolver", "src\Microsoft.DotNet.MSBuildSdkResolver\Microsoft.DotNet.MSBuildSdkResolver.csproj", "{FCDFAF40-CC16-4D49-96C0-E49F195E7142}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "dotnet-restore.Tests", "test\dotnet-restore.Tests\dotnet-restore.Tests.csproj", "{B4EE3671-C103-4A37-8DEB-C74E0134104E}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.DotNet.TestFramework", "test\Microsoft.DotNet.TestFramework\Microsoft.DotNet.TestFramework.csproj", "{44759218-B558-4AF0-8991-515F1100DCF5}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Msbuild.Tests.Utilities", "test\Msbuild.Tests.Utilities\Msbuild.Tests.Utilities.csproj", "{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.DotNet.ShellShim.Tests", "test\Microsoft.DotNet.ShellShim.Tests\Microsoft.DotNet.ShellShim.Tests.csproj", "{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.DotNet.ToolPackage.Tests", "test\Microsoft.DotNet.ToolPackage.Tests\Microsoft.DotNet.ToolPackage.Tests.csproj", "{91BFE800-1624-4A58-A1CE-339705A8FFD0}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.DotNet.Tools.Tests.ComponentMocks", "test\Microsoft.DotNet.Tools.Tests.ComponentMocks\Microsoft.DotNet.Tools.Tests.ComponentMocks.csproj", "{E442F4C1-08DB-470F-B9A6-197444CD0295}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "tool_launcher", "src\tool_launcher\tool_launcher.csproj", "{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "dotnet-install-tool.Tests", "test\dotnet-install-tool.Tests\dotnet-install-tool.Tests.csproj", "{8FE9D802-57F3-493B-9E14-72DF905E3838}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.DotNet.MSBuildSdkResolver.Tests", "test\Microsoft.DotNet.MSBuildSdkResolver.Tests\Microsoft.DotNet.MSBuildSdkResolver.Tests.csproj", "{B7C82980-F01D-4B8A-A746-BFA0032CB152}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -511,30 +523,6 @@ Global
 		{8FB83810-5A4C-4097-9A79-8E687E4981CB}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
 		{8FB83810-5A4C-4097-9A79-8E687E4981CB}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
 		{8FB83810-5A4C-4097-9A79-8E687E4981CB}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.Debug|x64.ActiveCfg = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.Debug|x64.Build.0 = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.Debug|x86.ActiveCfg = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.Debug|x86.Build.0 = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.MinSizeRel|Any CPU.ActiveCfg = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.MinSizeRel|Any CPU.Build.0 = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.MinSizeRel|x64.ActiveCfg = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.MinSizeRel|x64.Build.0 = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.MinSizeRel|x86.ActiveCfg = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.MinSizeRel|x86.Build.0 = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.Release|Any CPU.Build.0 = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.Release|x64.ActiveCfg = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.Release|x64.Build.0 = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.Release|x86.ActiveCfg = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.Release|x86.Build.0 = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
 		{203F0362-DAFC-4679-A01E-7FBC331D8647}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{203F0362-DAFC-4679-A01E-7FBC331D8647}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{203F0362-DAFC-4679-A01E-7FBC331D8647}.Debug|x64.ActiveCfg = Release|Any CPU
@@ -655,30 +643,6 @@ Global
 		{570950AD-A080-4F32-980C-F50E312910DF}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
 		{570950AD-A080-4F32-980C-F50E312910DF}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
 		{570950AD-A080-4F32-980C-F50E312910DF}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.Debug|x64.ActiveCfg = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.Debug|x64.Build.0 = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.Debug|x86.ActiveCfg = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.Debug|x86.Build.0 = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.MinSizeRel|Any CPU.ActiveCfg = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.MinSizeRel|Any CPU.Build.0 = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.MinSizeRel|x64.ActiveCfg = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.MinSizeRel|x64.Build.0 = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.MinSizeRel|x86.ActiveCfg = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.MinSizeRel|x86.Build.0 = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.Release|Any CPU.Build.0 = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.Release|x64.ActiveCfg = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.Release|x64.Build.0 = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.Release|x86.ActiveCfg = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.Release|x86.Build.0 = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
-		{6592A22C-2386-4E83-A4D3-FC08075C723A}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
 		{098D9321-1201-4974-A75E-F58EBCD98ACF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{098D9321-1201-4974-A75E-F58EBCD98ACF}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{098D9321-1201-4974-A75E-F58EBCD98ACF}.Debug|x64.ActiveCfg = Release|Any CPU
@@ -751,30 +715,6 @@ Global
 		{BE4C655A-DC54-4408-B739-743456D34111}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
 		{BE4C655A-DC54-4408-B739-743456D34111}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
 		{BE4C655A-DC54-4408-B739-743456D34111}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.Debug|x64.ActiveCfg = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.Debug|x64.Build.0 = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.Debug|x86.ActiveCfg = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.Debug|x86.Build.0 = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.MinSizeRel|Any CPU.ActiveCfg = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.MinSizeRel|Any CPU.Build.0 = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.MinSizeRel|x64.ActiveCfg = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.MinSizeRel|x64.Build.0 = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.MinSizeRel|x86.ActiveCfg = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.MinSizeRel|x86.Build.0 = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.Release|Any CPU.Build.0 = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.Release|x64.ActiveCfg = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.Release|x64.Build.0 = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.Release|x86.ActiveCfg = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.Release|x86.Build.0 = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
 		{3E28672F-F4E4-44D5-AEFB-1F425DECC57E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{3E28672F-F4E4-44D5-AEFB-1F425DECC57E}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{3E28672F-F4E4-44D5-AEFB-1F425DECC57E}.Debug|x64.ActiveCfg = Release|Any CPU
@@ -1303,30 +1243,6 @@ Global
 		{23EE9BBB-3B33-4CF2-8D1A-29A8DB12E878}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
 		{23EE9BBB-3B33-4CF2-8D1A-29A8DB12E878}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
 		{23EE9BBB-3B33-4CF2-8D1A-29A8DB12E878}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.Debug|x64.ActiveCfg = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.Debug|x64.Build.0 = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.Debug|x86.ActiveCfg = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.Debug|x86.Build.0 = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.MinSizeRel|Any CPU.ActiveCfg = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.MinSizeRel|Any CPU.Build.0 = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.MinSizeRel|x64.ActiveCfg = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.MinSizeRel|x64.Build.0 = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.MinSizeRel|x86.ActiveCfg = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.MinSizeRel|x86.Build.0 = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.Release|Any CPU.Build.0 = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.Release|x64.ActiveCfg = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.Release|x64.Build.0 = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.Release|x86.ActiveCfg = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.Release|x86.Build.0 = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
 		{AA744891-5209-4335-8457-37EC347DF833}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{AA744891-5209-4335-8457-37EC347DF833}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{AA744891-5209-4335-8457-37EC347DF833}.Debug|x64.ActiveCfg = Release|Any CPU
@@ -1567,6 +1483,270 @@ Global
 		{08A40B6A-F695-4EA9-AC8D-CF88FADEA796}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
 		{08A40B6A-F695-4EA9-AC8D-CF88FADEA796}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
 		{08A40B6A-F695-4EA9-AC8D-CF88FADEA796}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.Debug|x64.Build.0 = Debug|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.Debug|x86.Build.0 = Debug|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.MinSizeRel|x86.ActiveCfg = Debug|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.MinSizeRel|x86.Build.0 = Debug|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.Release|Any CPU.Build.0 = Release|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.Release|x64.ActiveCfg = Release|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.Release|x64.Build.0 = Release|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.Release|x86.ActiveCfg = Release|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.Release|x86.Build.0 = Release|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.Debug|x64.Build.0 = Debug|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.Debug|x86.Build.0 = Debug|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.MinSizeRel|Any CPU.ActiveCfg = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.MinSizeRel|Any CPU.Build.0 = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.MinSizeRel|x64.ActiveCfg = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.MinSizeRel|x64.Build.0 = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.MinSizeRel|x86.ActiveCfg = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.MinSizeRel|x86.Build.0 = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.Release|Any CPU.Build.0 = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.Release|x64.ActiveCfg = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.Release|x64.Build.0 = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.Release|x86.ActiveCfg = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.Release|x86.Build.0 = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.Debug|x64.Build.0 = Debug|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.Debug|x86.Build.0 = Debug|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.MinSizeRel|x86.ActiveCfg = Debug|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.MinSizeRel|x86.Build.0 = Debug|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.Release|Any CPU.Build.0 = Release|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.Release|x64.ActiveCfg = Release|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.Release|x64.Build.0 = Release|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.Release|x86.ActiveCfg = Release|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.Release|x86.Build.0 = Release|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.Debug|x64.Build.0 = Debug|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.Debug|x86.Build.0 = Debug|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.MinSizeRel|x86.ActiveCfg = Debug|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.MinSizeRel|x86.Build.0 = Debug|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.Release|Any CPU.Build.0 = Release|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.Release|x64.ActiveCfg = Release|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.Release|x64.Build.0 = Release|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.Release|x86.ActiveCfg = Release|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.Release|x86.Build.0 = Release|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
+		{44759218-B558-4AF0-8991-515F1100DCF5}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.Debug|x64.Build.0 = Debug|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.Debug|x86.Build.0 = Debug|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.MinSizeRel|x86.ActiveCfg = Debug|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.MinSizeRel|x86.Build.0 = Debug|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.Release|x64.ActiveCfg = Release|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.Release|x64.Build.0 = Release|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.Release|x86.ActiveCfg = Release|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.Release|x86.Build.0 = Release|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.Debug|x64.Build.0 = Debug|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.Debug|x86.Build.0 = Debug|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.MinSizeRel|x86.ActiveCfg = Debug|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.MinSizeRel|x86.Build.0 = Debug|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.Release|x64.ActiveCfg = Release|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.Release|x64.Build.0 = Release|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.Release|x86.ActiveCfg = Release|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.Release|x86.Build.0 = Release|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.Debug|x64.Build.0 = Debug|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.Debug|x86.Build.0 = Debug|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.MinSizeRel|x86.ActiveCfg = Debug|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.MinSizeRel|x86.Build.0 = Debug|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.Release|Any CPU.Build.0 = Release|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.Release|x64.ActiveCfg = Release|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.Release|x64.Build.0 = Release|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.Release|x86.ActiveCfg = Release|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.Release|x86.Build.0 = Release|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.Debug|x64.Build.0 = Debug|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.Debug|x86.Build.0 = Debug|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.MinSizeRel|x86.ActiveCfg = Debug|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.MinSizeRel|x86.Build.0 = Debug|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.Release|x64.ActiveCfg = Release|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.Release|x64.Build.0 = Release|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.Release|x86.ActiveCfg = Release|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.Release|x86.Build.0 = Release|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
+		{E442F4C1-08DB-470F-B9A6-197444CD0295}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.Debug|x64.Build.0 = Debug|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.Debug|x86.Build.0 = Debug|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.MinSizeRel|Any CPU.ActiveCfg = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.MinSizeRel|Any CPU.Build.0 = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.MinSizeRel|x64.ActiveCfg = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.MinSizeRel|x64.Build.0 = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.MinSizeRel|x86.ActiveCfg = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.MinSizeRel|x86.Build.0 = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.Release|Any CPU.Build.0 = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.Release|x64.ActiveCfg = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.Release|x64.Build.0 = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.Release|x86.ActiveCfg = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.Release|x86.Build.0 = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.Debug|x64.Build.0 = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.Debug|x86.Build.0 = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.MinSizeRel|x86.ActiveCfg = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.MinSizeRel|x86.Build.0 = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.Release|Any CPU.Build.0 = Release|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.Release|x64.ActiveCfg = Release|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.Release|x64.Build.0 = Release|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.Release|x86.ActiveCfg = Release|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.Release|x86.Build.0 = Release|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.RelWithDebInfo|Any CPU.ActiveCfg = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.RelWithDebInfo|Any CPU.Build.0 = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.RelWithDebInfo|x64.ActiveCfg = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.RelWithDebInfo|x64.Build.0 = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.RelWithDebInfo|x86.ActiveCfg = Debug|Any CPU
+		{8FE9D802-57F3-493B-9E14-72DF905E3838}.RelWithDebInfo|x86.Build.0 = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.Debug|x64.Build.0 = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.Debug|x86.Build.0 = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.MinSizeRel|Any CPU.ActiveCfg = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.MinSizeRel|Any CPU.Build.0 = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.MinSizeRel|x64.ActiveCfg = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.MinSizeRel|x64.Build.0 = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.MinSizeRel|x86.ActiveCfg = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.MinSizeRel|x86.Build.0 = Debug|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.Release|Any CPU.Build.0 = Release|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.Release|x64.ActiveCfg = Release|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.Release|x64.Build.0 = Release|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.Release|x86.ActiveCfg = Release|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.Release|x86.Build.0 = Release|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.RelWithDebInfo|Any CPU.ActiveCfg = Release|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.RelWithDebInfo|Any CPU.Build.0 = Release|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.RelWithDebInfo|x64.ActiveCfg = Release|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.RelWithDebInfo|x64.Build.0 = Release|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.RelWithDebInfo|x86.ActiveCfg = Release|Any CPU
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152}.RelWithDebInfo|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -1591,23 +1771,21 @@ Global
 		{736BF068-7389-41B9-BF63-D4E49B9BC833} = {1AB5B24B-B317-4142-A5D1-A6E84F15BA34}
 		{48408A19-CCC5-4C85-990B-0A9F827BF29A} = {1AB5B24B-B317-4142-A5D1-A6E84F15BA34}
 		{8FB83810-5A4C-4097-9A79-8E687E4981CB} = {1AB5B24B-B317-4142-A5D1-A6E84F15BA34}
-		{F0CB08B6-2809-4D37-B1DD-A9B7F1B0D95D} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
 		{203F0362-DAFC-4679-A01E-7FBC331D8647} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
 		{F8C66E8A-FC59-40B3-AC0F-58CA22526F76} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
 		{73ACEB34-D22C-43EA-87BE-EFC0E83D0126} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
 		{ABB81DAE-0D26-483C-BE3B-0F9ACD812A62} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
 		{570950AD-A080-4F32-980C-F50E312910DF} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
-		{6592A22C-2386-4E83-A4D3-FC08075C723A} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
 		{098D9321-1201-4974-A75E-F58EBCD98ACF} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
 		{D82A3246-9831-4024-A9B2-1932EEF3D56F} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
 		{BE4C655A-DC54-4408-B739-743456D34111} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
-		{2DFCC95F-75F7-46E1-8F56-256DB4CA98B2} = {0722D325-24C8-4E83-B5AF-0A083E7F0749}
 		{3E28672F-F4E4-44D5-AEFB-1F425DECC57E} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
 		{A5CA696F-585E-40AB-912C-6316BC330C5E} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
 		{4EF497BF-D717-4E03-90B1-932C7F51B918} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
 		{18B43540-346F-4AFF-8868-A82CF098FAFD} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
 		{C3845C85-1F59-4552-BE52-32F513CE795F} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
 		{BBB5A4C8-CD2D-4A6A-9159-0FEAF84B745E} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
+		{8AA88E83-6A98-4AD6-86EB-2ED4F6EDA17F} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
 		{726D2CB9-80E5-4496-9C86-910AC452C45E} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
 		{EF745C56-0350-4C42-AA22-86D592E1D8D5} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
 		{87063BA1-454D-4433-ADF9-89C667275D62} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
@@ -1623,7 +1801,6 @@ Global
 		{F228580D-9373-4A60-AB88-76DF58D11580} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
 		{48E260F4-6F3F-4387-B61F-D15BABD06D9A} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
 		{23EE9BBB-3B33-4CF2-8D1A-29A8DB12E878} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
-		{F5E27BA5-063B-4770-A6E8-87252E9AB22C} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
 		{AA744891-5209-4335-8457-37EC347DF833} = {88278B81-7649-45DC-8A6A-D3A645C5AFC3}
 		{DA3595A8-35DE-42B9-97A4-4A2461BAD554} = {88278B81-7649-45DC-8A6A-D3A645C5AFC3}
 		{F2D1A7DA-B3EB-4CA7-BAA9-A18CEC398853} = {88278B81-7649-45DC-8A6A-D3A645C5AFC3}
@@ -1636,5 +1813,19 @@ Global
 		{3F7D56A3-A280-467E-8916-C18659C243BA} = {1AB5B24B-B317-4142-A5D1-A6E84F15BA34}
 		{B1AEC227-5115-44BC-92D2-B1B3545E1DDE} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
 		{08A40B6A-F695-4EA9-AC8D-CF88FADEA796} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
+		{602976C5-2477-4B4C-AD9A-1EAFB250529A} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
+		{FCDFAF40-CC16-4D49-96C0-E49F195E7142} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
+		{B4EE3671-C103-4A37-8DEB-C74E0134104E} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
+		{44759218-B558-4AF0-8991-515F1100DCF5} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
+		{E7C72EF2-8480-48B4-AAE8-A596F1A6048E} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
+		{E84C08C9-70D7-48B0-9507-ADB8B9A2694C} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
+		{91BFE800-1624-4A58-A1CE-339705A8FFD0} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
+		{E442F4C1-08DB-470F-B9A6-197444CD0295} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
+		{EDF19BE6-F20F-4AD0-8E3B-E837030726A5} = {ED2FE3E2-F7E7-4389-8231-B65123F2076F}
+		{8FE9D802-57F3-493B-9E14-72DF905E3838} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
+		{B7C82980-F01D-4B8A-A746-BFA0032CB152} = {17735A9D-BFD9-4585-A7CB-3208CA6EA8A7}
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {B526D2CE-EE2D-4AD4-93EF-1867D90FF1F5}
 	EndGlobalSection
 EndGlobal

README.md

@@ -7,14 +7,14 @@ This repo contains the source code for cross-platform [.NET Core](http://github.
 Looking for V1 of the .NET Core tooling?
 ----------------------------------------
 
-If you are looking for the v1.0.1 release of the .NET Core tools (CLI, MSBuild and the new csproj), see https://dot.net/core.
+If you are looking for the v2.0 release of the .NET Core tools (CLI, MSBuild and the new csproj), head over to https://dot.net/core and download!
 
-> **Note:** the release/2.1.2xx branch of the CLI repo is based on an upcoming update of the SDK and is considered pre-release. For production-level usage, please use the
+> **Note:** the release/2.1.3xx branch of the CLI repo is based on an upcoming update of the SDK and is considered pre-release. For production-level usage, please use the
 > released version of the tools available at https://dot.net/core
 
 Found an issue?
 ---------------
-You can consult the [Documents Index](Documentation/README.md) to find out the current issues and to see the workarounds.  
+You can consult the [Documents Index](Documentation/README.md) to find out the current issues and to see the workarounds.
 
 If you don't find your issue, please file one! However, given that this is a very high-frequency repo, we've setup some [basic guidelines](Documentation/project-docs/issue-filing-guide.md) to help you. Please consult those first.
 
@@ -23,36 +23,36 @@ This project has adopted the code of conduct defined by the [Contributor Covenan
 Build Status
 ------------
 
-|Windows x64 |Windows x86 |Mac OS X |Linux x64 |Ubuntu 14.04 / Linux Mint 17 |Ubuntu 16.04 |Ubuntu 16.10 |Debian 8 |RHEL 7.2 |
+|Windows x64|Windows x86|macOS|Linux x64 Archive|Linux arm Archive|Linux arm64 Archive|Linux Native Installers|RHEL 6 Archive|Linux-musl Archive|
 |:------:|:------:|:------:|:------:|:------:|:------:|:------:|:------:|:------:|
-|[![][win-x64-build-badge]][win-x64-build]|[![][win-x86-build-badge]][win-x86-build]|[![][osx-build-badge]][osx-build]|[![][linux-build-badge]][linux-build]|[![][ubuntu-14.04-build-badge]][ubuntu-14.04-build]|[![][ubuntu-16.04-build-badge]][ubuntu-16.04-build]|[![][ubuntu-16.10-build-badge]][ubuntu-16.10-build]|[![][debian-8-build-badge]][debian-8-build]|[![][rhel-build-badge]][rhel-build]|
+|[![][win-x64-build-badge]][win-x64-build]|[![][win-x86-build-badge]][win-x86-build]|[![][osx-build-badge]][osx-build]|[![][linux-build-badge]][linux-build]|[![][linux-arm-build-badge]][linux-arm-build]|[![][linux-arm64-build-badge]][linux-arm64-build]|[![][linuxnative-build-badge]][linuxnative-build]|[![][rhel6-build-badge]][rhel6-build]|[![][linux-musl-build-badge]][linux-musl-build]|
 
-[win-x64-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6786/badge
+[win-x64-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6902/badge
-[win-x64-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6786
+[win-x64-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6902
 
-[win-x86-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6787/badge
+[win-x86-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6901/badge
-[win-x86-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6787
+[win-x86-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6901
 
-[osx-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6781/badge
+[osx-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6900/badge
-[osx-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6781
+[osx-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6900
 
-[linux-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6780/badge
+[linux-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6899/badge
-[linux-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6780
+[linux-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6899
 
-[ubuntu-14.04-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6783/badge
+[linux-arm-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/8721/badge
-[ubuntu-14.04-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6783
+[linux-arm-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=8721
 
-[ubuntu-16.04-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6784/badge
+[linux-arm64-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/8817/badge
-[ubuntu-16.04-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6784
+[linux-arm64-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=8817
 
-[ubuntu-16.10-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6785/badge
+[linuxnative-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/7254/badge
-[ubuntu-16.10-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6785
+[linuxnative-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=7254
 
-[debian-8-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6778/badge
+[rhel6-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/7392/badge
-[debian-8-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6778
+[rhel6-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=7392
 
-[rhel-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/6782/badge
+[linux-musl-build-badge]: https://devdiv.visualstudio.com/_apis/public/build/definitions/0bdbc590-a062-4c3f-b0f6-9383f67865ee/9036/badge
-[rhel-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=6782
+[linux-musl-build]: https://devdiv.visualstudio.com/DevDiv/_build?_a=completed&definitionId=9036
 
 Installers and Binaries
 -----------------------
@@ -63,24 +63,20 @@ To download the .NET Core runtime **without** the SDK, visit https://github.com/
 
 > **Note:** Be aware that the following installers are the **latest bits**. If you
 > want to install the latest released versions, check out the [preceding section](#looking-for-v1-of-the-net-core-tooling).
+> In order to be able to restore these pre-release packages, you may need to add a NuGet feed pointing to https://dotnet.myget.org/F/dotnet-core/api/v3/index.json. Other feeds may also be necessary depending on what kind of project you are working with.
 
-| Platform | Latest Daily Build<br>*release/2.1.2xx*<br>[![][version-badge]][version] |
+| Platform | Latest Daily Build<br>*release/2.1.3xx*<br>[![][version-badge]][version] |
 | -------- | :-------------------------------------: |
 | **Windows x64** | [Installer][win-x64-installer] - [Checksum][win-x64-installer-checksum]<br>[zip][win-x64-zip] - [Checksum][win-x64-zip-checksum] |
 | **Windows x86** | [Installer][win-x86-installer] - [Checksum][win-x86-installer-checksum]<br>[zip][win-x86-zip] - [Checksum][win-x86-zip-checksum] |
-| **Mac OS X** | [Installer][osx-installer] - [Checksum][osx-installer-checksum]<br>[tar.gz][osx-targz] - [Checksum][osx-targz-checksum] |
+| **macOS** | [Installer][osx-installer] - [Checksum][osx-installer-checksum]<br>[tar.gz][osx-targz] - [Checksum][osx-targz-checksum] |
-| **Linux x64** | [tar.gz][linux-targz] - [Checksum][linux-targz-checksum] |
+| **Linux x64** | [DEB Installer][linux-DEB-installer] - [Checksum][linux-DEB-installer-checksum]<br>[RPM Installer][linux-RPM-installer] - [Checksum][linux-RPM-installer-checksum]<br>_see installer note below_<sup>1</sup><br>[tar.gz][linux-targz] - [Checksum][linux-targz-checksum] |
-| **Ubuntu 14.04 / Linux Mint 17** | [Installer][ubuntu-14.04-installer] - [Checksum][ubuntu-14.04-installer-checksum]<br>_see installer note below_<sup>1</sup><br>tar.gz - See **Linux x64** |
+| **Linux arm** | [tar.gz][linux-arm-targz] - [Checksum][linux-arm-targz-checksum] |
-| **Ubuntu 16.04** | [Installer][ubuntu-16.04-installer] - [Checksum][ubuntu-16.04-installer-checksum]<br>_see installer note below_<sup>1</sup><br>tar.gz - See **Linux x64** |
+| **Linux arm64** | [tar.gz][linux-arm64-targz] - [Checksum][linux-arm64-targz-checksum] |
-| **Ubuntu 16.10** | [Installer][ubuntu-16.10-installer] - [Checksum][ubuntu-16.10-installer-checksum]<br>_see installer note below_<sup>1</sup><br>tar.gz - See **Linux x64** |
+| **RHEL 6** | [tar.gz][rhel-6-targz] - [Checksum][rhel-6-targz-checksum] |
-| **Debian 8**  | [Installer][debian-8-installer] - [Checksum][debian-8-installer-checksum]<br>_see installer note below_<sup>1</sup><br>tar.gz - See **Linux x64** |
+| **Linux-musl** | [tar.gz][linux-musl-targz] - [Checksum][linux-musl-targz-checksum] |
-| **RHEL 7.2** | [Installer][rhel-7-installer] - [Checksum][rhel-7-installer-checksum]<br>_see installer note below_<sup>1</sup><br>tar.gz - See **Linux x64** |
-| **CentOS 7.1 / Oracle Linux 7** | tar.gz - See **Linux x64** |
-| **Fedora 24** | tar.gz - See **Linux x64** |
-| **OpenSUSE 42.1** | tar.gz - See **Linux x64** |
 
-
+| Latest Coherent Build<sup>2</sup><br>*release/2.1.3xx* |
-| Latest Coherent Build<sup>2</sup><br>*release/2.1.2xx* |
 |:------:|
 | [![][coherent-version-badge]][coherent-version] |
 
@@ -88,44 +84,47 @@ Reference notes:
 > **1**: *Our Debian packages are put together slightly differently than the other OS specific installers. Instead of combining everything, we have separate component packages that depend on each other. If you're installing these directly from the .deb files (via dpkg or similar), then you'll need to install the [corresponding Host, Host FX Resolver, and Shared Framework packages](https://github.com/dotnet/core-setup#daily-builds) before installing the Sdk package.*
 > <br><br>**2**: *A 'coherent' build is defined as a build where the Runtime version matches between the CLI and Asp.NET.*
 
+[version]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/latest.version
+[coherent-version]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/latest.coherent.version
 [comment]: # (The latest versions are always the same across all platforms. Just need one to show, so picking win-x64's svg.)
-[version]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/latest.version
+[version-badge]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/win_x64_Release_version_badge.svg
-[version-badge]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/win_x64_Release_version_badge.svg
+[coherent-version-badge]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/win_x64_Release_coherent_badge.svg
-[coherent-version]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/latest.coherent.version
-[coherent-version-badge]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/win_x86_Release_coherent_badge.svg
 
-[win-x64-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-win-x64.exe
+[win-x64-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-win-x64.exe
-[win-x64-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-win-x64.exe.sha
+[win-x64-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-win-x64.exe.sha
-[win-x64-zip]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-win-x64.zip
+[win-x64-zip]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-win-x64.zip
-[win-x64-zip-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-win-x64.zip.sha
+[win-x64-zip-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-win-x64.zip.sha
 
-[win-x86-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-win-x86.exe
+[win-x86-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-win-x86.exe
-[win-x86-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-win-x86.exe.sha
+[win-x86-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-win-x86.exe.sha
-[win-x86-zip]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-win-x86.zip
+[win-x86-zip]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-win-x86.zip
-[win-x86-zip-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-win-x86.zip.sha
+[win-x86-zip-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-win-x86.zip.sha
 
-[osx-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-osx-x64.pkg
+[osx-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-osx-x64.pkg
-[osx-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-osx-x64.pkg.sha
+[osx-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-osx-x64.pkg.sha
-[osx-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-osx-x64.tar.gz
+[osx-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-osx-x64.tar.gz
-[osx-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-osx-x64.tar.gz.sha
+[osx-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-osx-x64.tar.gz.sha
 
-[linux-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-linux-x64.tar.gz
+[linux-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-linux-x64.tar.gz
-[linux-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-linux-x64.tar.gz.sha
+[linux-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-linux-x64.tar.gz.sha
 
-[ubuntu-14.04-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-ubuntu-x64.deb
+[linux-arm-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-linux-arm.tar.gz
-[ubuntu-14.04-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-ubuntu-x64.deb.sha
+[linux-arm-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-linux-arm.tar.gz.sha
 
-[ubuntu-16.04-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-ubuntu.16.04-x64.deb
+[linux-arm64-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-linux-arm64.tar.gz
-[ubuntu-16.04-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-ubuntu.16.04-x64.deb.sha
+[linux-arm64-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-linux-arm64.tar.gz.sha
 
-[ubuntu-16.10-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-ubuntu.16.10-x64.deb
+[linux-DEB-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-x64.deb
-[ubuntu-16.10-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-ubuntu.16.10-x64.deb.sha
+[linux-DEB-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-x64.deb.sha
 
-[debian-8-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-debian-x64.deb
+[linux-RPM-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-x64.rpm
-[debian-8-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-debian-x64.deb.sha
+[linux-RPM-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-x64.rpm.sha
 
-[rhel-7-installer]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-rhel-x64.rpm
+[rhel-6-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-rhel.6-x64.tar.gz
-[rhel-7-installer-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.2xx/dotnet-sdk-latest-rhel-x64.rpm.sha
+[rhel-6-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-rhel.6-x64.tar.gz.sha
+
+[linux-musl-targz]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-linux-musl-x64.tar.gz
+[linux-musl-targz-checksum]: https://dotnetclichecksums.blob.core.windows.net/dotnet/Sdk/release/2.1.3xx/dotnet-sdk-latest-linux-musl-x64.tar.gz.sha
 
 # Debian daily feed
 
@@ -152,15 +151,6 @@ sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
 sudo apt-get update
 ```
 
-Ubuntu 16.10
-```
-sudo sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ yakkety main" > /etc/apt/sources.list.d/dotnetdev.list'
-
-sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
-
-sudo apt-get update
-```
-
 Debian 8
 ```
 sudo sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ jessie main" > /etc/apt/sources.list.d/dotnetdev.list'
@@ -183,7 +173,7 @@ apt-cache search dotnet-sdk | grep 2.0.0
 Docker
 ------
 
-You can also use our Docker base images found on https://hub.docker.com/r/microsoft/dotnet to set up your dev or testing environment for usage.  
+You can also use our Docker base images found on https://hub.docker.com/r/microsoft/dotnet to set up your dev or testing environment for usage.
 
 Basic usage
 -----------

TestAssets/DesktopTestProjects/AppWithProjTool2Fx/App.csproj

@@ -2,10 +2,11 @@
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), testAsset.props))\testAsset.props" />
 
   <PropertyGroup>
-    <TargetFrameworks>netcoreapp2.0;net451</TargetFrameworks>
+    <TargetFrameworks>netcoreapp2.1;net451</TargetFrameworks>
     <OutputType>Exe</OutputType>
-    <AssetTargetFallback Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">$(AssetTargetFallback);portable-net45+win8;dnxcore50</AssetTargetFallback>
+    <AssetTargetFallback Condition=" '$(TargetFramework)' == 'netcoreapp2.1' ">$(AssetTargetFallback);portable-net45+win8;dnxcore50</AssetTargetFallback>
     <RuntimeIdentifiers>win7-x64;win7-x86;osx.10.10-x64;osx.10.11-x64;ubuntu.14.04-x64;ubuntu.16.04-x64;ubuntu.16.10-x64;centos.7-x64;rhel.7.2-x64;debian.8-x64;fedora.24-x64;opensuse.42.1-x64</RuntimeIdentifiers>
+    <RestoreAdditionalProjectSources Condition="'$(TEST_PACKAGES)' != ''">$(TEST_PACKAGES)</RestoreAdditionalProjectSources>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/DesktopTestProjects/AppWithProjTool2Fx/NuGet.Config

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="test-packages" value="../../../artifacts/testpackages" />
-  </packageSources>
-</configuration>

TestAssets/DesktopTestProjects/BindingRedirectSample/AppWithRedirectsAndConfig/AppWithRedirectsAndConfig.csproj

@@ -4,6 +4,7 @@
     <AssemblyName>AppWithRedirectsAndConfig</AssemblyName>
     <OutputType>Exe</OutputType>
     <RuntimeIdentifiers>win7-x64;win7-x86</RuntimeIdentifiers>
+    <RestoreAdditionalProjectSources Condition="'$(TEST_PACKAGES)' != ''">$(TEST_PACKAGES)</RestoreAdditionalProjectSources>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/DesktopTestProjects/BindingRedirectSample/AppWithRedirectsNoConfig/AppWithRedirectsNoConfig.csproj

@@ -4,6 +4,7 @@
     <AssemblyName>AppWithRedirectsNoConfig</AssemblyName>
     <OutputType>Exe</OutputType>
     <RuntimeIdentifiers>win7-x64;win7-x86</RuntimeIdentifiers>
+    <RestoreAdditionalProjectSources Condition="'$(TEST_PACKAGES)' != ''">$(TEST_PACKAGES)</RestoreAdditionalProjectSources>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/DesktopTestProjects/BindingRedirectSample/NuGet.Config

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="test-packages" value="../../../artifacts/testpackages" />
-  </packageSources>
-</configuration>

TestAssets/DesktopTestProjects/LibWithProjTool2Fx/Lib.csproj

@@ -2,7 +2,8 @@
   <PropertyGroup>
     <TargetFrameworks>netstandard1.6;net451</TargetFrameworks>
     <OutputType>Library</OutputType>
-    <AssetTargetFallback Condition=" '$(TargetFramework)' == 'netstandard1.6' ">$(AssetTargetFallback);portable-net45+win8;dnxcore50;netcoreapp2.0</AssetTargetFallback>
+    <AssetTargetFallback Condition=" '$(TargetFramework)' == 'netstandard1.6' ">$(AssetTargetFallback);portable-net45+win8;dnxcore50;netcoreapp2.1</AssetTargetFallback>
+    <RestoreAdditionalProjectSources Condition="'$(TEST_PACKAGES)' != ''">$(TEST_PACKAGES)</RestoreAdditionalProjectSources>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/DesktopTestProjects/LibWithProjTool2Fx/NuGet.Config

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="test-packages" value="../../../artifacts/testpackages" />
-  </packageSources>
-</configuration>

TestAssets/DesktopTestProjects/MultiTFMXunitProject/XUnitProject/XUnitProject.csproj

@@ -2,7 +2,7 @@
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), testAsset.props))\testAsset.props" />
 
   <PropertyGroup>
-    <TargetFrameworks>net461;netcoreapp2.0</TargetFrameworks>
+    <TargetFrameworks>net461;netcoreapp2.1</TargetFrameworks>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/DesktopTestProjects/NETFrameworkReferenceNETStandard20/MultiTFMTestApp/MultiTFMTestApp.csproj

@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFrameworks>netcoreapp2.0;net461</TargetFrameworks>
+    <TargetFrameworks>netcoreapp2.1;net461</TargetFrameworks>
   </PropertyGroup>
 
     <ItemGroup>

TestAssets/Directory.Build.props

@@ -0,0 +1,3 @@
+<Project>
+  <!-- Empty Directory.Build.props file to prevent test asset projects from picking up the repo's Directory.Build.props' -->
+</Project>

TestAssets/NonRestoredTestProjects/AppThrowingException/AppDependingOnOtherAsTool/AppDependingOnOtherAsTool.csproj

@@ -3,7 +3,7 @@
   
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/NonRestoredTestProjects/AppWithNonExistingToolDependency/AppWithNonExistingToolDependency.csproj

@@ -3,7 +3,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/NonRestoredTestProjects/DotnetAddP2PProjects/Broken/Broken.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk" ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
     <OutputType>Library</OutputType>
-    <TargetFrameworks>net451;netcoreapp2.0</TargetFrameworks>
+    <TargetFrameworks>net451;netcoreapp2.1</TargetFrameworks>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/NonRestoredTestProjects/DotnetAddP2PProjects/Empty/README

@@ -0,0 +1,2 @@
+This directory is intentionally empty.
+

TestAssets/NonRestoredTestProjects/DotnetAddP2PProjects/EmptyItemGroup/EmptyItemGroup.csproj

@@ -3,10 +3,10 @@
 
   <PropertyGroup>
     <OutputType>Library</OutputType>
-    <TargetFrameworks>net451;netcoreapp2.0</TargetFrameworks>
+    <TargetFrameworks>net451;netcoreapp2.1</TargetFrameworks>
   </PropertyGroup>
 
-  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">
+  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.1' ">
     <PackageReference Include="Microsoft.NETCore.App" Version="$(MicrosoftNETCoreAppPackageVersion)" />
   </ItemGroup>
 

TestAssets/NonRestoredTestProjects/DotnetAddP2PProjects/Lib/Lib.csproj

@@ -3,10 +3,10 @@
 
   <PropertyGroup>
     <OutputType>Library</OutputType>
-    <TargetFrameworks>net451;netcoreapp2.0;netstandard1.4</TargetFrameworks>
+    <TargetFrameworks>net451;netcoreapp2.1;netstandard1.4</TargetFrameworks>
   </PropertyGroup>
 
-  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">
+  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.1' ">
     <PackageReference Include="Microsoft.NETCore.App" Version="$(MicrosoftNETCoreAppPackageVersion)" />
   </ItemGroup>
 </Project>

TestAssets/NonRestoredTestProjects/DotnetAddP2PProjects/MoreThanOne/a.csproj

@@ -3,7 +3,7 @@
 
   <PropertyGroup>
     <OutputType>Library</OutputType>
-    <TargetFrameworks>netcoreapp2.0</TargetFrameworks>
+    <TargetFrameworks>netcoreapp2.1</TargetFrameworks>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/NonRestoredTestProjects/DotnetAddP2PProjects/MoreThanOne/b.csproj

@@ -3,7 +3,7 @@
 
   <PropertyGroup>
     <OutputType>Library</OutputType>
-    <TargetFrameworks>netcoreapp2.0</TargetFrameworks>
+    <TargetFrameworks>netcoreapp2.1</TargetFrameworks>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/NonRestoredTestProjects/DotnetAddP2PProjects/Net452AndNetCoreApp10Lib/Net452AndNetCoreApp10Lib.csproj

@@ -3,9 +3,10 @@
 
   <PropertyGroup>
     <OutputType>Library</OutputType>
-    <TargetFrameworks>net452;netcoreapp2.0</TargetFrameworks>
+    <TargetFrameworks>net452;netcoreapp2.1</TargetFrameworks>
   </PropertyGroup>
-  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">
+  
+  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.1' ">
     <PackageReference Include="Microsoft.NETCore.App" Version="$(MicrosoftNETCoreAppPackageVersion)" />
   </ItemGroup>
 </Project>

TestAssets/NonRestoredTestProjects/DotnetAddP2PProjects/ValidRef/ValidRef.csproj

@@ -5,7 +5,8 @@
     <OutputType>Library</OutputType>
     <TargetFrameworks>net451;netcoreapp1.0;netstandard1.4</TargetFrameworks>
   </PropertyGroup>
-  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">
+  
+  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.1' ">
     <PackageReference Include="Microsoft.NETCore.App" Version="$(MicrosoftNETCoreAppPackageVersion)" />
   </ItemGroup>
 </Project>

TestAssets/NonRestoredTestProjects/DotnetAddP2PProjects/WithDoubledRef/WithDoubledRef.csproj

@@ -5,7 +5,8 @@
     <OutputType>Library</OutputType>
     <TargetFrameworks>net451;netcoreapp1.0</TargetFrameworks>
   </PropertyGroup>
-  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">
+  
+  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.1' ">
     <PackageReference Include="Microsoft.NETCore.App" Version="$(MicrosoftNETCoreAppPackageVersion)" />
   </ItemGroup>
 

TestAssets/NonRestoredTestProjects/DotnetAddP2PProjects/WithExistingRefCondOnItem/WithExistingRefCondOnItem.csproj

@@ -5,7 +5,8 @@
     <OutputType>Library</OutputType>
     <TargetFrameworks>net451;netcoreapp1.0</TargetFrameworks>
   </PropertyGroup>
-  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">
+  
+  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.1' ">
     <PackageReference Include="Microsoft.NETCore.App" Version="$(MicrosoftNETCoreAppPackageVersion)" />
   </ItemGroup>
 

TestAssets/NonRestoredTestProjects/DotnetAddP2PProjects/WithExistingRefCondWhitespaces/WithExistingRefCondWhitespaces.csproj

@@ -5,9 +5,11 @@
     <OutputType>Library</OutputType>
     <TargetFrameworks>net451;netcoreapp1.0</TargetFrameworks>
   </PropertyGroup>
-  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">
+
+  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.1' ">
     <PackageReference Include="Microsoft.NETCore.App" Version="$(MicrosoftNETCoreAppPackageVersion)" />
   </ItemGroup>
+  
   <ItemGroup Condition="       '$(TargetFramework)' == 'net451'" >
     <ProjectReference Include="..\Lib\Lib.csproj" />
   </ItemGroup>

TestAssets/NonRestoredTestProjects/DotnetAddP2PProjects/WithRefNoCondNonUniform/WithRefNoCondNonUniform.csproj

@@ -5,7 +5,8 @@
     <OutputType>Library</OutputType>
     <TargetFrameworks>net451;netcoreapp1.0</TargetFrameworks>
   </PropertyGroup>
-  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">
+
+  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.1' ">
     <PackageReference Include="Microsoft.NETCore.App" Version="$(MicrosoftNETCoreAppPackageVersion)" />
   </ItemGroup>
 

TestAssets/NonRestoredTestProjects/PJHalfMigrated/src/ProjectA/ProjectA.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <DebugType>portable</DebugType>
     <AssemblyName>ProjectA</AssemblyName>
     <OutputType>Exe</OutputType>

TestAssets/NonRestoredTestProjects/TestProjectWithUnresolvedPlatformDependency/TestProjectWithUnresolvedPlatformDependency.csproj

@@ -1,8 +1,8 @@
 <Project Sdk="Microsoft.NET.Sdk" ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <OutputType>Exe</OutputType>
-    <AssetTargetFallback Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">$(AssetTargetFallback);dnxcore50</AssetTargetFallback>
+    <AssetTargetFallback Condition=" '$(TargetFramework)' == 'netcoreapp2.1' ">$(AssetTargetFallback);dnxcore50</AssetTargetFallback>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/NonRestoredTestProjects/ToolWithRandomPackageName/AppWithDepOnTool/AppWithDepOnTool.csproj

@@ -3,7 +3,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <GeneratedPackageId>random-name</GeneratedPackageId>
   </PropertyGroup>
 

TestAssets/NonRestoredTestProjects/ToolWithRandomPackageName/ToolWithRandomPackageName/ToolWithRandomPackageName.csproj

@@ -3,7 +3,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <GeneratedPackageId>random-name</GeneratedPackageId>
     <PackageId>$(GeneratedPackageId)</PackageId>
     <AssemblyName>dotnet-randompackage</AssemblyName>

TestAssets/TestPackages/NuGet.Config

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="testpackages" value="../../artifacts/testpackages/packages" />
-  </packageSources>
-</configuration>

TestAssets/TestPackages/ToolWithOutputName/ToolWithOutputName.csproj

@@ -2,7 +2,7 @@
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), testAsset.props))\testAsset.props" />
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <AssemblyName>dotnet-tool-with-output-name</AssemblyName>
     <PackageId>ToolWithOutputName</PackageId>
     <OutputType>Exe</OutputType>

TestAssets/TestPackages/dotnet-dependency-context-test/dotnet-dependency-context-test.csproj

@@ -3,7 +3,7 @@
 
   <PropertyGroup>
     <VersionPrefix>1.0.0-rc</VersionPrefix>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <OutputType>Exe</OutputType>
   </PropertyGroup>
 

TestAssets/TestPackages/dotnet-dependency-tool-invoker/dotnet-dependency-tool-invoker.csproj

@@ -6,7 +6,7 @@
 
   <PropertyGroup>
     <VersionPrefix>1.0.0-rc</VersionPrefix>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <OutputType>Exe</OutputType>
     <VersionSuffix></VersionSuffix>
     <DisableImplicitFrameworkReferences>false</DisableImplicitFrameworkReferences>

TestAssets/TestPackages/dotnet-desktop-binding-redirects/dotnet-desktop-binding-redirects.csproj

@@ -9,7 +9,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Newtonsoft.Json" Version="5.0.0" />
+    <PackageReference Include="Newtonsoft.Json" Version="5.0.1" />
   </ItemGroup>
 
   <ItemGroup Condition=" '$(TargetFramework)' == 'net451' ">

TestAssets/TestPackages/dotnet-fallbackfoldertool/dotnet-fallbackfoldertool.csproj

@@ -2,7 +2,7 @@
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), testAsset.props))\testAsset.props" />
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <AssemblyName>dotnet-fallbackfoldertool</AssemblyName>
     <OutputType>Exe</OutputType>
     <VersionSuffix></VersionSuffix>

TestAssets/TestPackages/dotnet-hello/v1/dotnet-hello/dotnet-hello.csproj

@@ -5,7 +5,7 @@
     <Version>1.0.0</Version>
     <!--Workaround for https://github.com/NuGet/Home/issues/4583-->
     <VersionSuffix></VersionSuffix>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <AssemblyName>dotnet-hello</AssemblyName>
     <OutputType>Exe</OutputType>
     <RuntimeIdentifiers>win7-x64;win7-x86;osx.10.10-x64;osx.10.11-x64;ubuntu.14.04-x64;ubuntu.16.04-x64;ubuntu.16.10-x64;centos.7-x64;rhel.7.2-x64;debian.8-x64;fedora.24-x64;opensuse.42.1-x64</RuntimeIdentifiers>

TestAssets/TestPackages/dotnet-hello/v2/dotnet-hello/dotnet-hello.csproj

@@ -5,7 +5,7 @@
     <Version>2.0.0</Version>
     <!--Workaround for https://github.com/NuGet/Home/issues/4583-->
     <VersionSuffix></VersionSuffix>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <AssemblyName>dotnet-hello</AssemblyName>
     <OutputType>Exe</OutputType>
     <RuntimeIdentifiers>win7-x64;win7-x86;osx.10.10-x64;osx.10.11-x64;ubuntu.14.04-x64;ubuntu.16.04-x64;ubuntu.16.10-x64;centos.7-x64;rhel.7.2-x64;debian.8-x64;fedora.24-x64;opensuse.42.1-x64</RuntimeIdentifiers>

TestAssets/TestPackages/dotnet-portable/dotnet-portable.csproj

@@ -2,7 +2,7 @@
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), testAsset.props))\testAsset.props" />
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <OutputType>Exe</OutputType>
   </PropertyGroup>
 

TestAssets/TestPackages/dotnet-prefercliruntime/dotnet-prefercliruntime.csproj

@@ -2,7 +2,7 @@
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), testAsset.props))\testAsset.props" />
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <OutputType>Exe</OutputType>
     <VersionSuffix></VersionSuffix>
   </PropertyGroup>

TestAssets/TestProjects/11TestAppWith10CLIToolReferences/11TestAppWith10CLIToolReferences.csproj

@@ -4,6 +4,7 @@
   <PropertyGroup>
     <OutputType>Exe</OutputType>
     <TargetFramework>netcoreapp1.1</TargetFramework>
+    <RestoreAdditionalProjectSources Condition="'$(TEST_PACKAGES)' != ''">$(TEST_PACKAGES)</RestoreAdditionalProjectSources>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/TestProjects/11TestAppWith10CLIToolReferences/NuGet.Config

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="test-packages" value="../../../artifacts/testpackages" />
-  </packageSources>
-</configuration>

TestAssets/TestProjects/AppWithApplicationUrlInLaunchSettings/AppWithApplicationUrlInLaunchSettings.csproj

@@ -0,0 +1,8 @@
+<Project Sdk="Microsoft.NET.Sdk" ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), testAsset.props))\testAsset.props" />
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
+  </PropertyGroup>
+</Project>

TestAssets/TestProjects/AppWithApplicationUrlInLaunchSettings/Program.cs

@@ -0,0 +1,16 @@
+// Copyright (c) .NET Foundation and contributors. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using System;
+
+namespace MSBuildTestApp
+{
+    public class Program
+    {
+        public static void Main(string[] args)
+        {
+            var message = Environment.GetEnvironmentVariable("ASPNETCORE_URLS");
+            Console.WriteLine(message);
+        }
+    }
+}

TestAssets/TestProjects/AppWithApplicationUrlInLaunchSettings/Properties/launchSettings.json

@@ -0,0 +1,27 @@
+{
+  "iisSettings": {
+    "windowsAuthentication": false,
+    "anonymousAuthentication": true,
+    "iisExpress": {
+      "applicationUrl": "http://localhost:49850/",
+      "sslPort": 0
+    }
+  },
+  "profiles": {
+    "First": {
+      "commandName": "Project",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development",
+        "ASPNETCORE_URLS": "http://localhost:12345/"
+      },
+      "applicationUrl": "http://localhost:67890/"
+    },
+    "Second": {
+      "commandName": "Project",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      },
+      "applicationUrl": "http://localhost:54321/"
+    }
+  }
+}

TestAssets/TestProjects/AppWithCorruptedLaunchSettings/AppWithCorruptedLaunchSettings.csproj

@@ -3,7 +3,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
-    <RuntimeIdentifiers>win7-x64;win7-x86;osx.10.12-x64;ubuntu.14.04-x64;ubuntu.16.04-x64;ubuntu.16.10-x64;centos.7-x64;rhel.7-x64;debian.8-x64;fedora.24-x64;opensuse.42.1-x64</RuntimeIdentifiers>
+    <RuntimeIdentifiers>win7-x64;win7-x86;osx.10.12-x64;ubuntu.14.04-x64;ubuntu.16.04-x64;ubuntu.16.10-x64;rhel.6-x64;centos.7-x64;rhel.7-x64;debian.8-x64;fedora.24-x64;opensuse.42.1-x64;linux-musl-x64</RuntimeIdentifiers>
   </PropertyGroup>
 </Project>

TestAssets/TestProjects/AppWithDepOnToolWithOutputName/AppWithDepOnToolWithOutputName.csproj

@@ -2,8 +2,9 @@
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), testAsset.props))\testAsset.props" />
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <OutputType>Exe</OutputType>
+    <RestoreAdditionalProjectSources Condition="'$(TEST_PACKAGES)' != ''">$(TEST_PACKAGES)</RestoreAdditionalProjectSources>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/TestProjects/AppWithDepOnToolWithOutputName/NuGet.Config

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="test-packages" value="../../../artifacts/testpackages" />
-  </packageSources>
-</configuration>

TestAssets/TestProjects/AppWithDirectAndToolDep/AppWithDirectAndToolDep.csproj

@@ -2,8 +2,9 @@
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), testAsset.props))\testAsset.props" />
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <OutputType>Exe</OutputType>
+    <RestoreAdditionalProjectSources Condition="'$(TEST_PACKAGES)' != ''">$(TEST_PACKAGES)</RestoreAdditionalProjectSources>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/TestProjects/AppWithDirectAndToolDep/NuGet.Config

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="test-packages" value="../../../artifacts/testpackages/packages" />
-  </packageSources>
-</configuration>

TestAssets/TestProjects/AppWithDirectDep/AppWithDirectDep.csproj

@@ -3,10 +3,11 @@
 
   <PropertyGroup>
     <VersionPrefix>1.0.0</VersionPrefix>
-    <TargetFrameworks>netcoreapp2.0</TargetFrameworks>
+    <TargetFrameworks>netcoreapp2.1</TargetFrameworks>
     <AssemblyName>AppWithDirectDep</AssemblyName>
     <OutputType>Exe</OutputType>
     <PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance>
+    <RestoreAdditionalProjectSources Condition="'$(TEST_PACKAGES)' != ''">$(TEST_PACKAGES)</RestoreAdditionalProjectSources>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/TestProjects/AppWithDirectDep/NuGet.Config

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="test-packages" value="../../../artifacts/testpackages/packages" />
-  </packageSources>
-</configuration>

TestAssets/TestProjects/AppWithDirectDepWithOutputName/AppWithDirectDepWithOutputName.csproj

@@ -2,8 +2,9 @@
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), testAsset.props))\testAsset.props" />
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <OutputType>Exe</OutputType>
+    <RestoreAdditionalProjectSources Condition="'$(TEST_PACKAGES)' != ''">$(TEST_PACKAGES)</RestoreAdditionalProjectSources>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/TestProjects/AppWithDirectDepWithOutputName/NuGet.Config

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <!--To inherit the global NuGet package sources remove the <clear/> line below -->
-    <clear />
-    <add key="test-packages" value="../../../artifacts/testpackages" />
-  </packageSources>
-</configuration>

TestAssets/TestProjects/AppWithFallbackFolderToolDependency/AppWithFallbackFolderToolDependency.csproj

@@ -2,8 +2,9 @@
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), testAsset.props))\testAsset.props" />
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <OutputType>Exe</OutputType>
+    <RestoreAdditionalProjectSources Condition="'$(TEST_PACKAGES)' != ''">$(TEST_PACKAGES)</RestoreAdditionalProjectSources>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/TestProjects/AppWithFallbackFolderToolDependency/NuGet.Config

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="test-packages" value="../../../artifacts/testpackages" />
-  </packageSources>
-</configuration>

TestAssets/TestProjects/AppWithLaunchSettings/AppWithLaunchSettings.csproj

@@ -3,7 +3,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
-    <RuntimeIdentifiers>win7-x64;win7-x86;osx.10.12-x64;ubuntu.14.04-x64;ubuntu.16.04-x64;ubuntu.16.10-x64;centos.7-x64;rhel.7-x64;debian.8-x64;fedora.24-x64;opensuse.42.1-x64</RuntimeIdentifiers>
+    <RuntimeIdentifiers>win7-x64;win7-x86;osx.10.12-x64;ubuntu.14.04-x64;ubuntu.16.04-x64;ubuntu.16.10-x64;rhel.6-x64;centos.7-x64;rhel.7-x64;debian.8-x64;fedora.24-x64;opensuse.42.1-x64;linux-musl-x64</RuntimeIdentifiers>
   </PropertyGroup>
 </Project>

TestAssets/TestProjects/AppWithLaunchSettingsNoDefault/AppWithLaunchSettingsNoDefault.csproj

@@ -3,7 +3,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
-    <RuntimeIdentifiers>win7-x64;win7-x86;osx.10.12-x64;ubuntu.14.04-x64;ubuntu.16.04-x64;ubuntu.16.10-x64;centos.7-x64;rhel.7-x64;debian.8-x64;fedora.24-x64;opensuse.42.1-x64</RuntimeIdentifiers>
+    <RuntimeIdentifiers>win7-x64;win7-x86;osx.10.12-x64;ubuntu.14.04-x64;ubuntu.16.04-x64;ubuntu.16.10-x64;rhel.6-x64;centos.7-x64;rhel.7-x64;debian.8-x64;fedora.24-x64;opensuse.42.1-x64;linux-musl-x64</RuntimeIdentifiers>
   </PropertyGroup>
 </Project>

TestAssets/TestProjects/AppWithMultipleFxAndTools/MSBuildAppWithMultipleFrameworksAndTools.csproj

@@ -3,13 +3,15 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFrameworks>net451;netcoreapp2.0</TargetFrameworks>
+    <TargetFrameworks>net451;netcoreapp2.1</TargetFrameworks>
+    <RestoreAdditionalProjectSources Condition="'$(TEST_PACKAGES)' != ''">$(TEST_PACKAGES)</RestoreAdditionalProjectSources>
   </PropertyGroup>
 
   <ItemGroup>
     <PackageReference Include="dotnet-desktop-and-portable" Version="1.0.0-*" />
   </ItemGroup>
-  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">
+
+  <ItemGroup Condition=" '$(TargetFramework)' == 'netcoreapp2.1' ">
     <PackageReference Include="Microsoft.NETCore.App" Version="$(MicrosoftNETCoreAppPackageVersion)" />
   </ItemGroup>
 

TestAssets/TestProjects/AppWithMultipleFxAndTools/NuGet.Config

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="test-packages" value="../../../artifacts/testpackages" />
-  </packageSources>
-</configuration>

TestAssets/TestProjects/AppWithToolDependency/AppWithToolDependency.csproj

@@ -2,8 +2,9 @@
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), testAsset.props))\testAsset.props" />
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
     <OutputType>Exe</OutputType>
+    <RestoreAdditionalProjectSources Condition="'$(TEST_PACKAGES)' != ''">$(TEST_PACKAGES)</RestoreAdditionalProjectSources>
   </PropertyGroup>
 
   <ItemGroup>

TestAssets/TestProjects/AppWithToolDependency/NuGet.Config

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="test-packages" value="../../../artifacts/testpackages" />
-  </packageSources>
-</configuration>