Re: [PATCH v6 1/4] last-modified: new subcommand to show when files were last modified

From: Jean-Noël AVILA <jn.avila@free.fr>
Date: Aug 1, 2025, 20:34 UTC
Message-ID: <5029495.31r3eYUQgx@cayenne>
In-Reply-To: <87ms8jui3p.fsf@iotcl.com>

Hello,

On Friday, 1 August 2025 18:22:50 CEST Toon Claes wrote:

Show 31 quoted lines

> Patrick Steinhardt <ps@pks.im> writes:
> > On Wed, Jul 30, 2025 at 07:55:07PM +0200, Toon Claes wrote:
> >> diff --git a/Documentation/git-last-modified.adoc
> >> b/Documentation/git-last-modified.adoc new file mode 100644
> >> index 0000000000..89138ebeb7
> >> --- /dev/null
> >> +++ b/Documentation/git-last-modified.adoc
> >> @@ -0,0 +1,49 @@
> >> +git-last-modified(1)
> >> +====================
> >> +
> >> +NAME
> >> +----
> >> +git-last-modified - EXPERIMENTAL: Show when files were last modified
> >> +
> >> +
> >> +SYNOPSIS
> >> +--------
> >> +[synopsis]
> >> +git last-modified [-r] [-t] [<revision-range>] [[--] <path>...]
> > 
> > I think we typically list long options here, not the short single-letter
> > ones.
> 
> Okay, makes sense.
> 
> >> +
> >> +DESCRIPTION
> >> +-----------
> >> +
> >> +Shows which commit last modified each of the relevant files and

subdirectories.

Show 9 quoted lines

> >> +
> >> +THIS COMMAND IS EXPERIMENTAL. THE BEHAVIOR MAY CHANGE.
> >> +
> >> +OPTIONS
> >> +-------
> >> +
> > 
> >> +-r::
> > -r, --recursive::

As a newly introduced man page, please switch to full synopsis style and cite only one form per line:

`-r`:: `--recurse`::

Show 7 quoted lines

> >> +	Recurse into subtrees.
> >> +
> > 
> >> +-t::
> > -t, --tree-in-recursive::
> Sure!
>

Idem here.