Idea: recommend using --target-arch in README.md, with option to use --target for different platforms + environments

Author: xtremekforever

README.md

@@ -120,12 +120,15 @@ to the `--experimental-swift-sdk` option.
 
 By default, on macOS hosts running on Apple Silicon, the Swift SDK Generator will create Swift SDKs
 for Ubuntu Jammy on aarch64, which matches the arch of the host. However, it is possible to change
-the default target architecture by passing the `--target` flag:
+the default target architecture by passing the `--target-arch` flag:
 
 ```bash
-swift run swift-sdk-generator make-linux-sdk --target x86_64-unknown-linux-gnu
+swift run swift-sdk-generator make-linux-sdk --target-arch x86_64
 ```
 
+This will default to building the Swift SDK for `x86_64-unknown-linux-gnu`. To build for other
+platforms and environments, supply the `--target` flag with the full target triple instead.
+
 The Linux distribution name and version can also be passed to change from the default of Ubuntu Jammy:
 
 ```bash
@@ -141,13 +144,13 @@ and are likely not using the Swift OSS toolchain to build and run Swift projects
 is included by *default*. This default behavior can be changed by passing  `--no-host-toolchain`:
 
 ```bash
-swift run swift-sdk-generator make-linux-sdk --no-host-toolchain --target x86_64-unknown-linux-gnu
+swift run swift-sdk-generator make-linux-sdk --no-host-toolchain --target x86_64
 ```
 
 Or, if on Linux, and desiring to generate the Swift SDK with the host toolchain included, add `--host-toolchain`:
 
 ```bash
-swift run swift-sdk-generator make-linux-sdk --host-toolchain --target aarch64-unknown-linux-gnu
+swift run swift-sdk-generator make-linux-sdk --host-toolchain --target aarch64
 ```
 
 ## Building an SDK from a container image

Sources/GeneratorCLI/GeneratorCLI.swift

@@ -148,15 +148,19 @@ extension GeneratorCLI {
     var host: Triple? = nil
 
     @Option(
-      help: """
-        The target triple of the bundle. The default depends on a recipe used for SDK generation. Pass `--help` to a specific recipe subcommand for more details.
-        """
-    )
+      help:
+        "The target triple of the bundle. The default depends on a recipe used for SDK generation.")
     var target: Triple? = nil
 
     @Option(help: "Deprecated. Use `--host` instead")
     var hostArch: Triple.Arch? = nil
-    @Option(help: "Deprecated. Use `--target` instead")
+    @Option(
+      help: """
+        The target arch of the bundle. The default depends on a recipe used for SDK generation.
+        If this is passed, the target triple will default to `<target-arch>-unknown-linux-gnu`.
+        Use the `--target` param to pass the full target triple if needed.
+        """
+    )
     var targetArch: Triple.Arch? = nil
 
     /// Default to adding host toolchain when building on macOS
@@ -228,7 +232,8 @@ extension GeneratorCLI {
       if let arch = generatorOptions.targetArch {
         let target = Triple(arch: arch, vendor: nil, os: .linux, environment: .gnu)
         appLogger.warning(
-          "deprecated: Please use `--target \(target.triple)` instead of `--target-arch \(arch)`")
+          "Using `--target-arch \(arch)` defaults to `\(target.triple)`. Use `--target` if you want to pass the full target triple."
+        )
         return target
       }
       return Triple(arch: hostTriple.arch!, vendor: nil, os: .linux, environment: .gnu)