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:
parent
ef9935e3d0
commit
311599e8f2
4 changed files with 11 additions and 20 deletions
|
|
@ -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,
|
||||
}
|
||||
|
|
|
|||
Loading…
Reference in a new issue