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
|
|
@ -89,12 +89,8 @@ pub struct Args {
|
|||
/// ~50, applies). Must be >= 1.
|
||||
#[arg(long, default_value_t = 30, value_parser = clap::value_parser!(u64).range(1..))]
|
||||
limit: u64,
|
||||
/// Page number to fetch (1-based; default 1). Combine with `--limit`
|
||||
/// to walk a large result set incrementally — fetch page 1, process,
|
||||
/// fetch page 2, … until a short/empty page. This keeps each call
|
||||
/// token-bounded (one page at a time) instead of pulling a whole
|
||||
/// repo's population into a single response. Must be >= 1 (the forge
|
||||
/// pages are 1-based; page 0 is rejected).
|
||||
/// Page number to fetch (1-based, default 1). Combine with `--limit`
|
||||
/// to page through large result sets incrementally.
|
||||
#[arg(long, default_value_t = 1, value_parser = clap::value_parser!(u64).range(1..))]
|
||||
page: u64,
|
||||
}
|
||||
|
|
|
|||
Loading…
Reference in a new issue