Global tools - Part 1

docs/core/tools/dotnet-tool-install.md

@@ -0,0 +1,95 @@
+---
+title: dotnet tool install command - .NET Core CLI
+description: The dotnet tool install command installs the specified .NET Core Global Tool on your machine.
+author: mairaw
+ms.author: mairaw
+ms.date: 05/29/2018
+---
+# dotnet tool install
+
+[!INCLUDE [topic-appliesto-net-core-21plus.md](../../../includes/topic-appliesto-net-core-21plus.md)]
+
+## Name
+
+`dotnet tool install` - Installs the specified [.NET Core Global Tool](global-tools.md) on your machine.
+
+## Synopsis
+
+```
+dotnet tool install <PACKAGE_NAME> <-g|--global> [--add-source] [--configfile] [--framework] [-v|--verbosity] [--version]
+dotnet tool install <PACKAGE_NAME> <--tool-path> [--add-source] [--configfile] [--framework] [-v|--verbosity] [--version]
+dotnet tool install <-h|--help>
+```
+
+## Description
+
+The `dotnet tool install` command provides a way for you to install .NET Core Global Tools on your machine. To use the command, you either have to specify that you want a user-wide installation using the `--global` option or you specify a path to install it using the `--tool-path` option.
+
+Global Tools are installed in the following directories by default when you specify the `-g` (or `--global`) option:
+
+| OS          | Path                          |
+|-------------|-------------------------------|
+| Linux/macOS | `$HOME/.dotnet/tools`         |
+| Windows     | `%USERPROFILE%\.dotnet\tools` |
+
+## Arguments
+
+`PACKAGE_NAME`
+
+Name/ID of the NuGet package that contains the .NET Core Global Tool to install.
+
+## Options
+
+`--add-source <SOURCE>`
+
+Adds an additional NuGet package source to use during installation.
+
+`--configfile <FILE>`
+
+The NuGet configuration (*nuget.config*) file to use.
+
+`--framework <FRAMEWORK>`
+
+Specifies the [target framework](../../standard/frameworks.md) to install the tool for. By default, the .NET Core SDK tries to choose the most appropriate target framework.
+
+`-g|--global`
+
+Specifies that the installation is user wide. Can't be combined with the `--tool-path` option. If you don't specify this option, you must specify the `--tool-path` option.
+
+`-h|--help`
+
+Prints out a short help for the command.
+
+`--tool-path <PATH>`
+
+Specifies the location where to install the Global Tool. PATH can be absolute or relative. If PATH doesn't exist, the command tries to create it. Can't be combined with the `--global` option. If you don't specify this option, you must specify the `--global` option.
+
+`-v|--verbosity <LEVEL>`
+
+Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`.
+
+`--version <VERSION_NUMBER>`
+
+The version of the tool to install. By default, the latest stable package version is installed. Use this option to install preview or older versions of the tool.
+
+## Examples
+
+Installs the [dotnetsay](https://www.nuget.org/packages/dotnetsay/) Global Tool in the default location:
+
+`dotnet tool install -g dotnetsay`
+
+Installs the [dotnetsay](https://www.nuget.org/packages/dotnetsay/) Global Tool on a specific Windows folder:
+
+`dotnet tool install dotnetsay --tool-path c:\global-tools`
+
+Installs the [dotnetsay](https://www.nuget.org/packages/dotnetsay/) Global Tool on a specific Linux/macOS folder:
+
+`dotnet tool install dotnetsay --tool-path ~/bin`
+
+Installs version 2.0.0 of the [dotnetsay](https://www.nuget.org/packages/dotnetsay/) Global Tool:
+
+`dotnet tool install -g dotnetsay --version 2.0.0`
+
+## See also
+
+[.NET Core Global Tools](global-tools.md)

docs/core/tools/dotnet-tool-list.md

@@ -0,0 +1,58 @@
+---
+title: dotnet tool list command - .NET Core CLI
+description: The dotnet tool list command lists the specified .NET Core Global Tool from your machine.
+author: mairaw
+ms.author: mairaw
+ms.date: 05/29/2018
+---
+# dotnet tool list
+
+[!INCLUDE [topic-appliesto-net-core-21plus.md](../../../includes/topic-appliesto-net-core-21plus.md)]
+
+## Name
+
+`dotnet tool list` - Lists all [.NET Core Global Tools](global-tools.md) currently installed in the default directory on your machine or in the specified path.
+
+## Synopsis
+
+```
+dotnet tool list <-g|--global>
+dotnet tool list <--tool-path>
+dotnet tool list <-h|--help>
+```
+
+## Description
+
+The `dotnet tool list` command provides a way for you to list all .NET Core Global Tools installed user-wide on your machine (current user profile) or in the specified path. The command lists the package name, version installed, and the Global Tool command. To use the list command, you either have to specify that you want to see all user-wide tools using the `--global` option or specify a custom path using the `--tool-path` option.
+
+## Options
+
+`-g|--global`
+
+Lists user-wide Global Tools. Can't be combined with the `--tool-path` option. If you don't specify this option, you must specify the `--tool-path` option.
+
+`-h|--help`
+
+Prints out a short help for the command.
+
+`--tool-path <PATH>`
+
+Specifies a custom location where to find Global Tools. PATH can be absolute or relative. Can't be combined with the `--global` option. If you don't specify this option, you must specify the `--global` option.
+
+## Examples
+
+Lists all Global Tools installed user-wide on your machine (current user profile):
+
+`dotnet tool list -g`
+
+Lists the Global Tools from a specific Windows folder:
+
+`dotnet tool list --tool-path c:\global-tools`
+
+Lists the Global Tools from a specific Linux/macOS folder:
+
+`dotnet tool list --tool-path ~/bin`
+
+## See also
+
+[.NET Core Global Tools](global-tools.md)

docs/core/tools/dotnet-tool-uninstall.md

@@ -0,0 +1,64 @@
+---
+title: dotnet tool uninstall command - .NET Core CLI
+description: The dotnet tool uninstall command uninstalls the specified .NET Core Global Tool from your machine.
+author: mairaw
+ms.author: mairaw
+ms.date: 05/29/2018
+---
+# dotnet tool uninstall
+
+[!INCLUDE [topic-appliesto-net-core-21plus.md](../../../includes/topic-appliesto-net-core-21plus.md)]
+
+## Name
+
+`dotnet tool uninstall` - Uninstalls the specified [.NET Core Global Tool](global-tools.md) from your machine.
+
+## Synopsis
+
+```
+dotnet tool uninstall <PACKAGE_NAME> <-g|--global>
+dotnet tool uninstall <PACKAGE_NAME> <--tool-path>
+dotnet tool uninstall <-h|--help>
+```
+
+## Description
+
+The `dotnet tool uninstall` command provides a way for you to uninstall .NET Core Global Tools from your machine. To use the command, you either have to specify that you want to remove a user-wide tool using the `--global` option or specify a path to where the tool is installed using the `--tool-path` option.
+
+## Arguments
+
+`PACKAGE_NAME`
+
+Name/ID of the NuGet package that contains the .NET Core Global Tool to uninstall. You can find the package name using the [dotnet tool list](dotnet-tool-list.md) command.
+
+## Options
+
+`-g|--global`
+
+Specifies that the tool to be removed is from a user-wide installation. Can't be combined with the `--tool-path` option. If you don't specify this option, you must specify the `--tool-path` option.
+
+`-h|--help`
+
+Prints out a short help for the command.
+
+`--tool-path <PATH>`
+
+Specifies the location where to uninstall the Global Tool. PATH can be absolute or relative. Can't be combined with the `--global` option. If you don't specify this option, you must specify the `--global` option.
+
+## Examples
+
+Uninstalls the [dotnetsay](https://www.nuget.org/packages/dotnetsay/) Global Tool:
+
+`dotnet tool uninstall -g dotnetsay`
+
+Uninstalls the [dotnetsay](https://www.nuget.org/packages/dotnetsay/) Global Tool from a specific Windows folder:
+
+`dotnet tool uninstall dotnetsay --tool-path c:\global-tools`
+
+Uninstalls the [dotnetsay](https://www.nuget.org/packages/dotnetsay/) Global Tool from a specific Linux/macOS folder:
+
+`dotnet tool uninstall dotnetsay --tool-path ~/bin`
+
+## See also
+
+[.NET Core Global Tools](global-tools.md)

docs/core/tools/dotnet-tool-update.md

@@ -0,0 +1,80 @@
+---
+title: dotnet tool update command - .NET Core CLI
+description: The dotnet tool update command updates the specified .NET Core Global Tool on your machine.
+author: mairaw
+ms.author: mairaw
+ms.date: 05/29/2018
+---
+# dotnet tool update
+
+[!INCLUDE [topic-appliesto-net-core-21plus.md](../../../includes/topic-appliesto-net-core-21plus.md)]
+
+## Name
+
+`dotnet tool update` - Updates the specified [.NET Core Global Tool](global-tools.md) on your machine.
+
+## Synopsis
+
+```
+dotnet tool update <PACKAGE_NAME> <-g|--global> [--configfile] [--framework] [-v|--verbosity]
+dotnet tool update <PACKAGE_NAME> <--tool-path> [--configfile] [--framework] [-v|--verbosity]
+dotnet tool update <-h|--help>
+```
+
+## Description
+
+The `dotnet tool update` command provides a way for you to update .NET Core Global Tools on your machine to the latest stable version of the package. The command uninstalls and reinstalls a tool, effectively updating it. To use the command, you either have to specify that you want to update a tool from a user-wide installation using the `--global` option or specify a path to where the tool is installed using the `--tool-path` option.
+
+## Arguments
+
+`PACKAGE_NAME`
+
+Name/ID of the NuGet package that contains the .NET Core Global Tool to update. You can find the package name using the [dotnet tool list](dotnet-tool-list.md) command.
+
+## Options
+
+`--add-source <SOURCE>`
+
+Adds an additional NuGet package source to use during installation.
+
+`--configfile <FILE>`
+
+The NuGet configuration (*nuget.config*) file to use.
+
+`--framework <FRAMEWORK>`
+
+Specifies the [target framework](../../standard/frameworks.md) to update the tool for.
+
+`-g|--global`
+
+Specifies that the update is for a user-wide tool. Can't be combined with the `--tool-path` option. If you don't specify this option, you must specify the `--tool-path` option.
+
+`-h|--help`
+
+Prints out a short help for the command.
+
+`--tool-path <PATH>`
+
+Specifies the location where the Global Tool is installed. PATH can be absolute or relative. Can't be combined with the `--global` option. If you don't specify this option, you must specify the `--global` option.
+
+`-v|--verbosity <LEVEL>`
+
+Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`.
+
+## Examples
+
+Updates the [dotnetsay](https://www.nuget.org/packages/dotnetsay/) Global Tool:
+
+`dotnet tool update -g dotnetsay`
+
+Updates the [dotnetsay](https://www.nuget.org/packages/dotnetsay/) Global Tool located on a specific Windows folder:
+
+`dotnet tool update dotnetsay --tool-path c:\global-tools`
+
+Updates the [dotnetsay](https://www.nuget.org/packages/dotnetsay/) Global Tool located on a specific Linux/macOS folder:
+
+`dotnet tool update dotnetsay --tool-path ~/bin`
+
+## See also
+
+[.NET Core Global Tools](global-tools.md)