Tool list package id feature doc update (#31805)

* modify dotnet-tool-list.md

* modify global-tools.md

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

Co-authored-by: Tom Dykstra <tdykstra@microsoft.com>

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

Co-authored-by: Tom Dykstra <tdykstra@microsoft.com>

Co-authored-by: Tom Dykstra <tdykstra@microsoft.com>
Co-authored-by: David Pine <david.pine@microsoft.com>

Author: 3 people

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

@@ -20,18 +20,27 @@ dotnet tool list --tool-path <PATH>
 
 dotnet tool list --local
 
+dotnet tool list [<PACKAGE_ID>]
+
 dotnet tool list
 
 dotnet tool list -h|--help
 ```
 
 ## Description
 
-The `dotnet tool list` command provides a way for you to list all .NET global, tool-path, or local tools installed on your machine. The command lists the package name, version installed, and the tool command.  To use the command, you specify one of the following:
+The `dotnet tool list` command provides a way for you to list .NET global, tool-path, or local tools installed on your machine. The command lists the package name, version installed, and the tool command.  To use the command, you specify one of the following:
 
 * To list global tools installed in the default location, use the `--global` option
 * To list global tools installed in a custom location, use the `--tool-path` option.
 * To list local tools, use the `--local` option or omit the `--global`, `--tool-path`, and `--local` options.
+* To list a specific tool, use the optional `PACKAGE_ID` argument.
+
+## Arguments
+
+- **`PACKAGE_ID`**
+
+  Lists the tool that has the supplied package ID if the tool is installed. Can be used in conjunction with options. Provides a way to check if a specific tool was installed. The command returns 1 if no tool with the specified package ID is found; returns 0 otherwise.
 
 ## Options
 
@@ -67,6 +76,14 @@ The `dotnet tool list` command provides a way for you to list all .NET global, t
 
   Lists all local tools available in the current directory.
 
+- **`dotnet tool list -g dotnetsay`**
+
+  Lists the global tool with the package id [dotnetsay](https://www.nuget.org/packages/dotnetsay/)
+
+- **`dotnet tool list dotnetsay`**
+
+  Lists the local tool with the package id [dotnetsay](https://www.nuget.org/packages/dotnetsay/)
+
 ## See also
 
 - [.NET tools](global-tools.md)

docs/core/tools/global-tools.md

@@ -189,6 +189,20 @@ dotnetsay       2.1.3        dotnetsay      /home/name/repository/.config/dotnet
 
 As shown in the preceding example, the list shows local tools. To see global tools, use the `--global` option. To see tool-path tools, use the `--tool-path` option.
 
+To list a specific tool, use the [dotnet tool list <PACKAGE_ID>](dotnet-tool-list.md) command:
+
+```dotnetcli
+dotnet tool list dotnetsay
+```
+
+The output will be only contain information of that tool if it is installed, similar to the following example:
+
+```console
+Package Id      Version      Commands       Manifest
+-------------------------------------------------------------------------------------------
+dotnetsay       2.1.3        dotnetsay      /home/name/repository/.config/dotnet-tools.json
+```
+
 ### Invoke a global tool
 
 For global tools, use the tool command by itself. For example, if the command is `dotnetsay` or `dotnet-doc`, that's what you use to invoke the global tool: