[PATCH v3 1/4] last-modified: clarify in the docs the command takes a pathspec
- From
Toon Claes <toon@iotcl.com>
- Date
- Jan 20, 2026, 21:47 UTC
- Message-ID
- <20260120-toon-last-modified-zzzz-v3-1-9bffd4968b0e@iotcl.com>
- In-Reply-To
- <20260120-toon-last-modified-zzzz-v3-0-9bffd4968b0e@iotcl.com>
The documentation mentions git-last-modified(1) takes `<path>...`, but that argument actually accepts a pathspec. Reword the documentation to reflect that.
Signed-off-by: Toon Claes <toon@iotcl.com> --- Documentation/git-last-modified.adoc | 11 ++++++----- builtin/last-modified.c | 4 ++-- 2 files changed, 8 insertions(+), 7 deletions(-)
diff --git a/Documentation/git-last-modified.adoc b/Documentation/git-last-modified.adoc index 602843e095..7c3fd844b8 100644 --- a/Documentation/git-last-modified.adoc +++ b/Documentation/git-last-modified.adoc @@ -9,7 +9,8 @@ git-last-modified - EXPERIMENTAL: Show when files were last modified SYNOPSIS -------- [synopsis] -git last-modified [--recursive] [--show-trees] [<revision-range>] [[--] <path>...] +git last-modified [--recursive] [--show-trees] + [<revision-range>] [[--] <pathspec>...] DESCRIPTION ----------- @@ -39,10 +40,10 @@ OPTIONS spell `<revision-range>`, see the 'Specifying Ranges' section of linkgit:gitrevisions[7]. -`[--] <path>...`:: - For each _<path>_ given, the commit which last modified it is returned. - Without an optional path parameter, all files and subdirectories - in path traversal the are included in the output. +`[--] <pathspec>...`:: + Show the commit that last modified each path matching _<pathspec>_. + If no _<pathspec>_ is given, all files and subdirectories are included. + See linkgit:gitglossary[7] for details on pathspec syntax. SEE ALSO -------- diff --git a/builtin/last-modified.c b/builtin/last-modified.c index c80f0535f6..e38e0bc4ca 100644 --- a/builtin/last-modified.c +++ b/builtin/last-modified.c @@ -510,8 +510,8 @@ int cmd_last_modified(int argc, const char **argv, const char *prefix, struct last_modified lm = { 0 }; const char * const last_modified_usage[] = { - N_("git last-modified [--recursive] [--show-trees] " - "[<revision-range>] [[--] <path>...]"), + N_("git last-modified [--recursive] [--show-trees]\n" + " [<revision-range>] [[--] <pathspec>...]"), NULL };
-- 2.52.0