swift-package-migrate: Improve command-line option descriptions

AnthonyLatsis · AnthonyLatsis · commit a4ff351c377b · 2025-07-24T02:59:12.000+01:00
Be clear that both options accept a comma-separated list, which is not at all obvious, and also state the default for `--target`. (cherry picked from commit acbc716)
diff --git a/Sources/Commands/PackageCommands/Migrate.swift b/Sources/Commands/PackageCommands/Migrate.swift
@@ -32,7 +32,7 @@ import var TSCBasic.stdoutStream
 struct MigrateOptions: ParsableArguments {
     @Option(
         name: .customLong("target"),
-        help: "The targets to migrate to specified set of features."
+        help: "A comma-separated list of targets to migrate. (default: all Swift targets)"
     )
     var _targets: String?
 
@@ -42,7 +42,7 @@ struct MigrateOptions: ParsableArguments {
 
     @Option(
         name: .customLong("to-feature"),
-        help: "The Swift language upcoming/experimental feature to migrate to."
+        help: "A comma-separated list of Swift language features to migrate to."
     )
     var _features: String
 

Original file line number	Diff line number	Diff line change
`@@ -32,7 +32,7 @@ import var TSCBasic.stdoutStream`
`32`	`32`	`struct MigrateOptions: ParsableArguments {`
`33`	`33`	`@Option(`
`34`	`34`	`name: .customLong("target"),`
`35`		`- help: "The targets to migrate to specified set of features."`
	`35`	`+ help: "A comma-separated list of targets to migrate. (default: all Swift targets)"`
`36`	`36`	`)`
`37`	`37`	`var _targets: String?`
`38`	`38`
`@@ -42,7 +42,7 @@ struct MigrateOptions: ParsableArguments {`
`42`	`42`
`43`	`43`	`@Option(`
`44`	`44`	`name: .customLong("to-feature"),`
`45`		`- help: "The Swift language upcoming/experimental feature to migrate to."`
	`45`	`+ help: "A comma-separated list of Swift language features to migrate to."`
`46`	`46`	`)`
`47`	`47`	`var _features: String`
`48`	`48`