Auto merge of #10576 - epage:feature, r=weihanglo

feat: Support '-F' as an alias for '--features'

### What does this PR try to resolve?

Adds a short flag `-F` for `--features to all cargo commands to be consistent with the `-F` short flag being added in #10472.

### How should we test and review this PR?

The decision for this is a part of #10472 which is in FCP.

-  It looks like all commands except `cargo-add` are using the prelude to
  define `--features`, so this should hit them all.
- Man pages were updated
- I've updated completions to the best of my knowledge and am unsure of good testing strategies for them
- I'm assuming we don't add tests for every sort flag but rely on clap
  to have coverage to ensure it works.

Review the commits separately.  For the documentation change, the only manual change is in  `src/doc/man/includes/section-features.md`, the rest are code-generated.

Author: bors

src/cargo/util/command_prelude.rs

@@ -132,11 +132,14 @@ pub trait AppExt: Sized {
     }
 
     fn arg_features(self) -> Self {
-        self._arg(multi_opt(
-            "features",
-            "FEATURES",
-            "Space or comma separated list of features to activate",
-        ))
+        self._arg(
+            multi_opt(
+                "features",
+                "FEATURES",
+                "Space or comma separated list of features to activate",
+            )
+            .short('F'),
+        )
         ._arg(opt("all-features", "Activate all available features"))
         ._arg(opt(
             "no-default-features",

src/doc/man/generated_txt/cargo-bench.txt

@@ -181,7 +181,7 @@ OPTIONS
        <https://doc.rust-lang.org/cargo/reference/features.html#command-line-feature-options>
        for more details.
 
-       --features features
+       -F features, --features features
            Space or comma separated list of features to activate. Features of
            workspace members may be enabled with package-name/feature-name
            syntax. This flag may be specified multiple times, which enables all

src/doc/man/generated_txt/cargo-build.txt

@@ -114,7 +114,7 @@ OPTIONS
        <https://doc.rust-lang.org/cargo/reference/features.html#command-line-feature-options>
        for more details.
 
-       --features features
+       -F features, --features features
            Space or comma separated list of features to activate. Features of
            workspace members may be enabled with package-name/feature-name
            syntax. This flag may be specified multiple times, which enables all

src/doc/man/generated_txt/cargo-check.txt

@@ -120,7 +120,7 @@ OPTIONS
        <https://doc.rust-lang.org/cargo/reference/features.html#command-line-feature-options>
        for more details.
 
-       --features features
+       -F features, --features features
            Space or comma separated list of features to activate. Features of
            workspace members may be enabled with package-name/feature-name
            syntax. This flag may be specified multiple times, which enables all

src/doc/man/generated_txt/cargo-doc.txt

@@ -98,7 +98,7 @@ OPTIONS
        <https://doc.rust-lang.org/cargo/reference/features.html#command-line-feature-options>
        for more details.
 
-       --features features
+       -F features, --features features
            Space or comma separated list of features to activate. Features of
            workspace members may be enabled with package-name/feature-name
            syntax. This flag may be specified multiple times, which enables all

src/doc/man/generated_txt/cargo-fix.txt

@@ -193,7 +193,7 @@ OPTIONS
        <https://doc.rust-lang.org/cargo/reference/features.html#command-line-feature-options>
        for more details.
 
-       --features features
+       -F features, --features features
            Space or comma separated list of features to activate. Features of
            workspace members may be enabled with package-name/feature-name
            syntax. This flag may be specified multiple times, which enables all

src/doc/man/generated_txt/cargo-install.txt

@@ -157,7 +157,7 @@ OPTIONS
        <https://doc.rust-lang.org/cargo/reference/features.html#command-line-feature-options>
        for more details.
 
-       --features features
+       -F features, --features features
            Space or comma separated list of features to activate. Features of
            workspace members may be enabled with package-name/feature-name
            syntax. This flag may be specified multiple times, which enables all

src/doc/man/generated_txt/cargo-metadata.txt

@@ -315,7 +315,7 @@ OPTIONS
        <https://doc.rust-lang.org/cargo/reference/features.html#command-line-feature-options>
        for more details.
 
-       --features features
+       -F features, --features features
            Space or comma separated list of features to activate. Features of
            workspace members may be enabled with package-name/feature-name
            syntax. This flag may be specified multiple times, which enables all

src/doc/man/generated_txt/cargo-package.txt

@@ -139,7 +139,7 @@ OPTIONS
        <https://doc.rust-lang.org/cargo/reference/features.html#command-line-feature-options>
        for more details.
 
-       --features features
+       -F features, --features features
            Space or comma separated list of features to activate. Features of
            workspace members may be enabled with package-name/feature-name
            syntax. This flag may be specified multiple times, which enables all

src/doc/man/generated_txt/cargo-publish.txt

@@ -106,7 +106,7 @@ OPTIONS
        <https://doc.rust-lang.org/cargo/reference/features.html#command-line-feature-options>
        for more details.
 
-       --features features
+       -F features, --features features
            Space or comma separated list of features to activate. Features of
            workspace members may be enabled with package-name/feature-name
            syntax. This flag may be specified multiple times, which enables all