docs(#2671): trim per-verb arg help (diff, list, lint, pr-merge)

Continue trimming clap arg help to user-relevant info: drop the
token-bounded-paging rationale (list --page), the why-it's-required
note (lint no-reviewer), the `Forgejo Do:`/`force_merge` API internals
(pr-merge), and tighten diff --full. pr-status was already clean.
This commit is contained in:
atlas 2026-07-23 22:50:55 +02:00
commit 311599e8f2
4 changed files with 11 additions and 20 deletions

View file

@ -24,9 +24,9 @@ use crate::client::{Client, index, split_repo};
/// per-commit history, so a squash option isn't exposed).
#[derive(Clone, Copy, ValueEnum)]
pub enum Method {
/// Create a merge commit (Forgejo `Do: merge`).
/// Create a merge commit.
Merge,
/// Rebase the head branch onto the base then fast-forward (Forgejo `Do: rebase`).
/// Rebase the head branch onto the base, then fast-forward.
Rebase,
}
@ -56,13 +56,11 @@ pub struct Args {
/// Merge strategy (default: a merge commit). Squash is not offered.
#[arg(long, value_enum, default_value = "merge")]
method: Method,
/// Keep the head branch after merging. By default the head branch is
/// deleted once the merge succeeds.
/// Keep the head branch after merging (deleted by default).
#[arg(long = "keep-branch")]
keep_branch: bool,
/// Merge even if the PR is not mergeable, CI is not green, or a review
/// requests changes. Also sets Forgejo's `force_merge` so the server does
/// not refuse on its own status checks.
/// requests changes.
#[arg(long)]
force: bool,
}