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

@ -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,
}