Re: [PATCH] rev-list: clarify git-log default date format
- From
Jeff King <peff@peff.net>
- Date
- Feb 1, 2023, 22:47 UTC
- Message-ID
- <Y9rr/hfnrV2zmyWf@coredump.intra.peff.net>
- In-Reply-To
- <xmqq5ycl1c6h.fsf@gitster.g>
On Wed, Feb 01, 2023 at 10:19:02AM -0800, Junio C Hamano wrote:
Show 23 quoted lines
> > - - there is no comma after the day-of-week > > + - There is no comma after the day-of-week > > > > - - the time zone is omitted when the local time zone is used > > + - The time zone is omitted when the local time zone is used > > + > > + - Day-of-month and month are switched around > > + > > + - Time-of-day and the year are switched around > > + > > +As a result, the format looks as follows: `Thu Jan 1 00:00:00 1970 +0000` with `+0000` being omitted when the local time zone is used. > > All of the above may technically be correct, but I wonder if it > makes it easier to follow to simply stop saying "is similar to". > That is > > The default format `--date=default` shows a single line with > three-letter day of the week, three-letter month, day-of-month, > hour-minute-second in the "HH:MM:SS" format, followed by 4-digit > year, plus timezone information unless the local time zone is > used (e.g. "Thu Jan 1 00:00:00 1970 +0000"). > > or something like that.
Yes, I agree with your suggestion. When you can explain something as "like X, but Y" it is helpful when Y is short. When it becomes much longer, than simply spelling out what X is becomes more helpful.
-Peff