Add tool-specific package identity descriptions to replace generic examples

Co-authored-by: baronfel <[email protected]>

Author: 2 people

src/Cli/dotnet/CliStrings.resx

@@ -819,6 +819,9 @@ The default is 'false.' However, when targeting .NET 7 or lower, the default is
   <data name="PackageIdentityArgumentDescription" xml:space="preserve">
     <value>Package reference in the form of a package identifier like 'Newtonsoft.Json' or package identifier and version separated by '@' like '[email protected]'.</value>
   </data>
+  <data name="ToolPackageIdentityArgumentDescription" xml:space="preserve">
+    <value>Package reference in the form of a package identifier like 'dotnetsay' or package identifier and version separated by '@' like '[email protected]'.</value>
+  </data>
   <data name="PackageIdentityArgumentIdOrVersionIsNull" xml:space="preserve">
     <value>Package reference id and version must not be null.</value>
   </data>

src/Cli/dotnet/Commands/Tool/Install/ToolInstallCommandParser.cs

@@ -10,7 +10,7 @@ namespace Microsoft.DotNet.Cli.Commands.Tool.Install;
 
 internal static class ToolInstallCommandParser
 {
-    public static readonly Argument<PackageIdentityWithRange> PackageIdentityArgument = CommonArguments.RequiredPackageIdentityArgument();
+    public static readonly Argument<PackageIdentityWithRange> PackageIdentityArgument = CommonArguments.RequiredToolPackageIdentityArgument();
 
     public static readonly Option<string> VersionOption = new("--version")
     {

src/Cli/dotnet/CommonArguments.cs

@@ -27,6 +27,14 @@ public static DynamicArgument<PackageIdentityWithRange> RequiredPackageIdentityA
                 Arity = ArgumentArity.ExactlyOne,
             };
 
+        public static DynamicArgument<PackageIdentityWithRange> RequiredToolPackageIdentityArgument() =>
+            new("packageId")
+            {
+                Description = CliStrings.ToolPackageIdentityArgumentDescription,
+                CustomParser = (ArgumentResult argumentResult) => ParsePackageIdentityWithVersionSeparator(argumentResult.Tokens[0]?.Value)!.Value,
+                Arity = ArgumentArity.ExactlyOne,
+            };
+
         private static PackageIdentityWithRange? ParsePackageIdentityWithVersionSeparator(string? packageIdentity, char versionSeparator = '@')
         {
             if (string.IsNullOrEmpty(packageIdentity))