Re: [PATCH v2] doc: `--date` in `git-commit` accepts approxidates

From: Jeff King <peff@peff.net>
Date: Feb 23, 2021, 19:06 UTC
Message-ID: <YDVSICgBwPLtDNu4@coredump.intra.peff.net>
In-Reply-To: <pull.969.v2.git.git.1614106322760.gitgitgadget@gmail.com>

On Tue, Feb 23, 2021 at 06:52:02PM +0000, Utku Gultopu via GitGitGadget wrote:

Show 7 quoted lines

> +ifdef::git-commit[]
> +In addition to recognizing all date formats above, the `--date` option
> +will also try to make sense of other, more human-centric date formats,
> +such as relative dates like "yesterday" or "last Friday at noon". For
> +further details on what kind of formats are accepted, please refer to
> +the `approxidate_careful` function in `date.c` file in Git source code.
> +endif::git-commit[]

OK. This is still referring to `approxidate_careful`, which may not be meaningful to most users. But at least it makes a best effort at a hand-waving definition before then. :)

I'd probably omit the final sentence entirely (as it may simply confuse people who don't know how to find Git's source), but I'm OK with it either way.

-Peff