Show --no-X variants in CLI help

crates/ruff_cli/src/args.rs

@@ -77,17 +77,21 @@ pub struct CheckCommand {
     /// List of files or directories to check.
     pub files: Vec<PathBuf>,
     /// Attempt to automatically fix lint violations.
+    /// Use `--no-fix` to disable.
     #[arg(long, overrides_with("no_fix"))]
     fix: bool,
     #[clap(long, overrides_with("fix"), hide = true)]
     no_fix: bool,
     /// Show violations with source code.
+    /// Use `--no-show-source` to disable.
     #[arg(long, overrides_with("no_show_source"))]
     show_source: bool,
     #[clap(long, overrides_with("show_source"), hide = true)]
     no_show_source: bool,
     /// Show an enumeration of all autofixed lint violations.
-    #[arg(long, overrides_with("no_show_fixes"))]
+    /// Use `--no-show-fixes` to disable.
+    // Show a custom `--show-fixes / --no-show-fixes` flag.
+    #[arg(long, overrides_with("no_show_fixes"), help_heading = "Miscellaneous")]
     show_fixes: bool,
     #[clap(long, overrides_with("show_fixes"), hide = true)]
     no_show_fixes: bool,
@@ -98,6 +102,7 @@ pub struct CheckCommand {
     #[arg(short, long)]
     pub watch: bool,
     /// Fix any fixable lint violations, but don't report on leftover violations. Implies `--fix`.
+    /// Use `--no-fix-only` to disable.
     #[arg(long, overrides_with("no_fix_only"))]
     fix_only: bool,
     #[clap(long, overrides_with("fix_only"), hide = true)]
@@ -115,6 +120,7 @@ pub struct CheckCommand {
     #[arg(long, value_enum)]
     pub target_version: Option<PythonVersion>,
     /// Enable preview mode; checks will include unstable rules and fixes.
+    /// Use `--no-preview` to disable.
     #[arg(long, overrides_with("no_preview"))]
     preview: bool,
     #[clap(long, overrides_with("preview"), hide = true)]
@@ -226,6 +232,7 @@ pub struct CheckCommand {
     )]
     pub extend_unfixable: Option<Vec<RuleSelector>>,
     /// Respect file exclusions via `.gitignore` and other standard ignore files.
+    /// Use `--no-respect-gitignore` to disable.
     #[arg(
         long,
         overrides_with("no_respect_gitignore"),
@@ -235,6 +242,7 @@ pub struct CheckCommand {
     #[clap(long, overrides_with("respect_gitignore"), hide = true)]
     no_respect_gitignore: bool,
     /// Enforce exclusions, even for paths passed to Ruff directly on the command-line.
+    /// Use `--no-force-exclude` to disable.
     #[arg(
         long,
         overrides_with("no_force_exclude"),
@@ -341,6 +349,7 @@ pub struct FormatCommand {
     #[arg(long, conflicts_with = "isolated")]
     pub config: Option<PathBuf>,
     /// Respect file exclusions via `.gitignore` and other standard ignore files.
+    /// Use `--no-respect-gitignore` to disable.
     #[arg(
         long,
         overrides_with("no_respect_gitignore"),
@@ -350,6 +359,7 @@ pub struct FormatCommand {
     #[clap(long, overrides_with("respect_gitignore"), hide = true)]
     no_respect_gitignore: bool,
     /// Enforce exclusions, even for paths passed to Ruff directly on the command-line.
+    /// Use `--no-force-exclude` to disable.
     #[arg(
         long,
         overrides_with("no_force_exclude"),
@@ -369,6 +379,7 @@ pub struct FormatCommand {
     pub stdin_filename: Option<PathBuf>,
 
     /// Enable preview mode; checks will include unstable rules and fixes.
+    /// Use `--no-preview` to disable.
     #[arg(long, overrides_with("no_preview"), hide = true)]
     preview: bool,
     #[clap(long, overrides_with("preview"), hide = true)]