{"thread":{"id":"59176","subject":"[PATCH] rev-list: clarify git-log default date format","startedAt":"2023-02-01T15:57:55Z","lastAt":"2023-02-16T17:25:02Z","messageCount":13,"participants":["Rafael Dulfer","Junio C Hamano","Jeff King","Ævar Arnfjörð Bjarmason"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"471248","messageId":"20230201155712.86577-1-rafael@dulfer.be","threadId":"59176","inReplyTo":null,"subject":"[PATCH] rev-list: clarify git-log default date format","fromName":"Rafael Dulfer","fromEmail":"rafael@dulfer.be","sentAt":"2023-02-01T15:57:12Z","receivedAt":"2023-02-01T15:57:55Z","isPatch":true,"sender":{"key":"rafael@dulfer.be","avatar":null},"body":"From: Rafael Dulfer \n\nCurrently, the documentation is slightly incomplete, not explaining all the differences the default format has with rfc2822. Leading to confusion for people trying to parse the date format outputted by git log\n\nThis patch adds 2 more exceptions when compared to rfc2822. Also adds an example of what the format looks like (I originally wanted to specify this in strftime notation, but because of the way day-of-month is formatted this is impossible)\n\nSigned-off-by: Rafael Dulfer \n---\n Documentation/rev-list-options.txt | 10 ++++++++--\n 1 file changed, 8 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt\nindex ff68e48406..8bc8475f3e 100644\n--- a/Documentation/rev-list-options.txt\n+++ b/Documentation/rev-list-options.txt\n@@ -1103,9 +1103,15 @@ format placeholders. When using `-local`, the correct syntax is\n `--date=default` is the default format, and is similar to\n `--date=rfc2822`, with a few exceptions:\n --\n-\t- there is no comma after the day-of-week\n+\t- There is no comma after the day-of-week\n \n-\t- the time zone is omitted when the local time zone is used\n+\t- The time zone is omitted when the local time zone is used\n+\n+\t- Day-of-month and month are switched around\n+\n+\t- Time-of-day and the year are switched around\n+\n+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.\n \n ifdef::git-rev-list[]\n --header::\n-- \n2.39.1\n\n"},{"id":"471257","messageId":"xmqq5ycl1c6h.fsf@gitster.g","threadId":"59176","inReplyTo":"20230201155712.86577-1-rafael@dulfer.be","subject":"Re: [PATCH] rev-list: clarify git-log default date format","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2023-02-01T18:19:02Z","receivedAt":"2023-02-01T18:19:24Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Rafael Dulfer writes:\n\n> From: Rafael Dulfer \n>\n> Currently, the documentation is slightly incomplete, not explaining all the differences the default format has with rfc2822. Leading to confusion for people trying to parse the date format outputted by git log\n>\n> This patch adds 2 more exceptions when compared to rfc2822. Also adds an example of what the format looks like (I originally wanted to specify this in strftime notation, but because of the way day-of-month is formatted this is impossible)\n\nOverly long lines.\n\n>\n> Signed-off-by: Rafael Dulfer \n> ---\n> Documentation/rev-list-options.txt | 10 ++++++++--\n> 1 file changed, 8 insertions(+), 2 deletions(-)\n>\n> diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt\n> index ff68e48406..8bc8475f3e 100644\n> --- a/Documentation/rev-list-options.txt\n> +++ b/Documentation/rev-list-options.txt\n> @@ -1103,9 +1103,15 @@ format placeholders. When using `-local`, the correct syntax is\n> `--date=default` is the default format, and is similar to\n> `--date=rfc2822`, with a few exceptions:\n> --\n> -\t- there is no comma after the day-of-week\n> +\t- There is no comma after the day-of-week\n> \n> -\t- the time zone is omitted when the local time zone is used\n> +\t- The time zone is omitted when the local time zone is used\n> +\n> +\t- Day-of-month and month are switched around\n> +\n> +\t- Time-of-day and the year are switched around\n> +\n> +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.\n\nAll of the above may technically be correct, but I wonder if it\nmakes it easier to follow to simply stop saying \"is similar to\".\nThat is\n\n The default format `--date=default` shows a single line with\n three-letter day of the week, three-letter month, day-of-month,\n hour-minute-second in the \"HH:MM:SS\" format, followed by 4-digit\n year, plus timezone information unless the local time zone is\n used (e.g. \"Thu Jan 1 00:00:00 1970 +0000\").\n\nor something like that.\n"},{"id":"471274","messageId":"Y9rr/hfnrV2zmyWf@coredump.intra.peff.net","threadId":"59176","inReplyTo":"xmqq5ycl1c6h.fsf@gitster.g","subject":"Re: [PATCH] rev-list: clarify git-log default date format","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2023-02-01T22:47:26Z","receivedAt":"2023-02-01T22:47:41Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Wed, Feb 01, 2023 at 10:19:02AM -0800, Junio C Hamano wrote:\n\n> > -\t- there is no comma after the day-of-week\n> > +\t- There is no comma after the day-of-week\n> > \n> > -\t- the time zone is omitted when the local time zone is used\n> > +\t- The time zone is omitted when the local time zone is used\n> > +\n> > +\t- Day-of-month and month are switched around\n> > +\n> > +\t- Time-of-day and the year are switched around\n> > +\n> > +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.\n> \n> All of the above may technically be correct, but I wonder if it\n> makes it easier to follow to simply stop saying \"is similar to\".\n> That is\n> \n> The default format `--date=default` shows a single line with\n> three-letter day of the week, three-letter month, day-of-month,\n> hour-minute-second in the \"HH:MM:SS\" format, followed by 4-digit\n> year, plus timezone information unless the local time zone is\n> used (e.g. \"Thu Jan 1 00:00:00 1970 +0000\").\n> \n> or something like that.\n\nYes, I agree with your suggestion. When you can explain something as\n\"like X, but Y\" it is helpful when Y is short. When it becomes much\nlonger, than simply spelling out what X is becomes more helpful.\n\n-Peff\n"},{"id":"471275","messageId":"230201.864js5q9sv.gmgdl@evledraar.gmail.com","threadId":"59176","inReplyTo":"xmqq5ycl1c6h.fsf@gitster.g","subject":"Re: [PATCH] rev-list: clarify git-log default date format","fromName":"Ævar Arnfjörð Bjarmason","fromEmail":"avarab@gmail.com","sentAt":"2023-02-01T22:28:05Z","receivedAt":"2023-02-01T22:51:22Z","isPatch":true,"sender":{"key":"avarab@gmail.com","avatar":"https://avatars.githubusercontent.com/u/45301?v=4"},"body":"\nOn Wed, Feb 01 2023, Junio C Hamano wrote:\n\n> Rafael Dulfer writes:\n>\n>> From: Rafael Dulfer \n>>\n>> Currently, the documentation is slightly incomplete, not explaining\n>> all the differences the default format has with rfc2822. Leading to\n>> confusion for people trying to parse the date format outputted by\n>> git log\n>>\n>> This patch adds 2 more exceptions when compared to rfc2822. Also\n>> adds an example of what the format looks like (I originally wanted\n>> to specify this in strftime notation, but because of the way\n>> day-of-month is formatted this is impossible)\n>\n> Overly long lines.\n>\n>>\n>> Signed-off-by: Rafael Dulfer \n>> ---\n>> Documentation/rev-list-options.txt | 10 ++++++++--\n>> 1 file changed, 8 insertions(+), 2 deletions(-)\n>>\n>> diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt\n>> index ff68e48406..8bc8475f3e 100644\n>> --- a/Documentation/rev-list-options.txt\n>> +++ b/Documentation/rev-list-options.txt\n>> @@ -1103,9 +1103,15 @@ format placeholders. When using `-local`, the correct syntax is\n>> `--date=default` is the default format, and is similar to\n>> `--date=rfc2822`, with a few exceptions:\n>> --\n>> -\t- there is no comma after the day-of-week\n>> +\t- There is no comma after the day-of-week\n>> \n>> -\t- the time zone is omitted when the local time zone is used\n>> +\t- The time zone is omitted when the local time zone is used\n>> +\n>> +\t- Day-of-month and month are switched around\n>> +\n>> +\t- Time-of-day and the year are switched around\n>> +\n>> +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.\n>\n> All of the above may technically be correct, but I wonder if it\n> makes it easier to follow to simply stop saying \"is similar to\".\n> That is\n>\n> The default format `--date=default` shows a single line with\n> three-letter day of the week, three-letter month, day-of-month,\n> hour-minute-second in the \"HH:MM:SS\" format, followed by 4-digit\n> year, plus timezone information unless the local time zone is\n> used (e.g. \"Thu Jan 1 00:00:00 1970 +0000\").\n>\n> or something like that.\n\nI think that following such a description in prose is still more\nconfusing than just showing an example. E.g. we could say:\n\t\n\tAssuming a user in timezone +0200 (Central Europe) values of\n\tthese `--date` argument would produce:\n\t\n\t|---------------+--------------------------------|\n\t| rfc2822 | Thu, 7 Apr 2005 15:13:13 -0700 |\n\t| rfc2822-local | Fri, 8 Apr 2005 00:13:13 +0200 |\n\t| default | Thu Apr 7 15:13:13 2005 -0700 |\n\t| default-local | Fri Apr 8 00:13:13 2005 |\n\t|---------------+--------------------------------|\n\t\nIn particular your example says \"unless the local time zone is used\",\nbut then shows an example that's 'default', not 'default-local'.\n"},{"id":"471277","messageId":"xmqqy1phxabi.fsf@gitster.g","threadId":"59176","inReplyTo":"230201.864js5q9sv.gmgdl@evledraar.gmail.com","subject":"Re: [PATCH] rev-list: clarify git-log default date format","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2023-02-01T22:58:09Z","receivedAt":"2023-02-01T22:58:15Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Ævar Arnfjörð Bjarmason writes:\n\n>> That is\n>>\n>> The default format `--date=default` shows a single line with\n>> three-letter day of the week, three-letter month, day-of-month,\n>> hour-minute-second in the \"HH:MM:SS\" format, followed by 4-digit\n>> year, plus timezone information unless the local time zone is\n>> used (e.g. \"Thu Jan 1 00:00:00 1970 +0000\").\n>>\n>> or something like that.\n>\n> I think that following such a description in prose is still more\n> confusing than just showing an example. E.g. we could say:\n> \t\n> \tAssuming a user in timezone +0200 (Central Europe) values of\n\nAdd \"on day X at time Y\" here, and I'd buy that ;-)\n\n> \tthese `--date` argument would produce:\n> \t\n> \t|---------------+--------------------------------|\n> \t| rfc2822 | Thu, 7 Apr 2005 15:13:13 -0700 |\n> \t| rfc2822-local | Fri, 8 Apr 2005 00:13:13 +0200 |\n> \t| default | Thu Apr 7 15:13:13 2005 -0700 |\n> \t| default-local | Fri Apr 8 00:13:13 2005 |\n> \t|---------------+--------------------------------|\n\n"},{"id":"471350","messageId":"d9fc8688-bbf1-96c2-07bf-a12fe38625a9@dulfer.be","threadId":"59176","inReplyTo":"xmqqy1phxabi.fsf@gitster.g","subject":"Re: [PATCH] rev-list: clarify git-log default date format","fromName":"Rafael Dulfer","fromEmail":"rafael@dulfer.be","sentAt":"2023-02-02T11:37:37Z","receivedAt":"2023-02-02T11:37:46Z","isPatch":true,"sender":{"key":"rafael@dulfer.be","avatar":null},"body":"> Add \"on day X at time Y\" here, and I'd buy that 😉\n\nFeels to me that adding \"on day X at time Y\" is a bit superfluous, since \nit's quite obvious from the examples, but I guess it can't hurt to be exact.\n\nI think it would be a good idea to still have _some_ text for \n`--date=default`, just so the structure of the sections stays the same \nover all the date options. Maybe just something simple like. \n\"`--date=default` is the default format. It is a custom format based on \nrfc2822\". And then below that we have the table (which is more a \nconclusion to the section, as it provides examples for a few, more \nunclear, formats)\n\nOn 01/02/2023 23:58, Junio C Hamano wrote:\n> Ævar Arnfjörð Bjarmason writes:\n>\n>>> That is\n>>>\n>>> The default format `--date=default` shows a single line with\n>>> three-letter day of the week, three-letter month, day-of-month,\n>>> hour-minute-second in the \"HH:MM:SS\" format, followed by 4-digit\n>>> year, plus timezone information unless the local time zone is\n>>> used (e.g. \"Thu Jan 1 00:00:00 1970 +0000\").\n>>>\n>>> or something like that.\n>> I think that following such a description in prose is still more\n>> confusing than just showing an example. E.g. we could say:\n>> \t\n>> \tAssuming a user in timezone +0200 (Central Europe) values of\n> Add \"on day X at time Y\" here, and I'd buy that ;-)\n>\n>> \tthese `--date` argument would produce:\n>> \t\n>> \t|---------------+--------------------------------|\n>> \t| rfc2822 | Thu, 7 Apr 2005 15:13:13 -0700 |\n>> \t| rfc2822-local | Fri, 8 Apr 2005 00:13:13 +0200 |\n>> \t| default | Thu Apr 7 15:13:13 2005 -0700 |\n>> \t| default-local | Fri Apr 8 00:13:13 2005 |\n>> \t|---------------+--------------------------------|\n"},{"id":"471366","messageId":"xmqqfsbovy7u.fsf@gitster.g","threadId":"59176","inReplyTo":"d9fc8688-bbf1-96c2-07bf-a12fe38625a9@dulfer.be","subject":"Re: [PATCH] rev-list: clarify git-log default date format","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2023-02-02T16:17:09Z","receivedAt":"2023-02-02T16:17:13Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Rafael Dulfer writes:\n\n> like. \"`--date=default` is the default format. It is a custom format\n> based on rfc2822\".\n\nBut the thing is it is *not* custom based on rfc2822. The default\nformat came first, 2822 much later. If I have to guess (and I\nshouldn't because I was around back when we invented that format,\nbut I am lazy and my recollecion hazy), it came straight from the\nresult of ctime() but with timezone info appended at the end.\n\n"},{"id":"471373","messageId":"xmqqsffouhys.fsf@gitster.g","threadId":"59176","inReplyTo":"xmqqfsbovy7u.fsf@gitster.g","subject":"Re: [PATCH] rev-list: clarify git-log default date format","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2023-02-02T16:53:31Z","receivedAt":"2023-02-02T16:53:38Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Junio C Hamano writes:\n\n> Rafael Dulfer writes:\n>\n>> like. \"`--date=default` is the default format. It is a custom format\n>> based on rfc2822\".\n>\n> But the thing is it is *not* custom based on rfc2822. The default\n> format came first, 2822 much later. If I have to guess (and I\n> shouldn't because I was around back when we invented that format,\n> but I am lazy and my recollecion hazy), it came straight from the\n> result of ctime() but with timezone info appended at the end.\n\nIt indeed was modeled after ctime() in f80cd783 (date.c: add\n\"show_date()\" function., 2005-05-06).\n\n date.c: add \"show_date()\" function.\n \n Kind of like ctime(), but not as broken.\n"},{"id":"472175","messageId":"xmqqcz6av3ta.fsf_-_@gitster.g","threadId":"59176","inReplyTo":"xmqqsffouhys.fsf@gitster.g","subject":"[PATCH v2] rev-list: clarify git-log default date format","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2023-02-16T00:42:25Z","receivedAt":"2023-02-16T00:43:01Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"The documentation mistakenly said that the default format was\nsimilar to RFC 2822 format and tried to specify it by enumerating\ndifferences, which had two problems:\n\n * There are some more differences from the 2822 format that are not\n mentioned; worse yet\n\n * The default format is not modeled after RFC 2822 format at all.\n As can be seen in f80cd783 (date.c: add \"show_date()\" function.,\n 2005-05-06), it is a derivative of ctime(3) format.\n\nStop saying that it is similar to RFC 2822, and rewrite the\ndescription to explain the format without requiring the reader to\nknow any other format.\n\nSigned-off-by: Junio C Hamano \n---\n * The discussion stalled and the topic was left in limbo for a few\n weeks. Let's attempt to reboot it instead of silently waiting\n for a rerolled version from the original author.\n\n Documentation/rev-list-options.txt | 11 +++++------\n 1 file changed, 5 insertions(+), 6 deletions(-)\n\ndiff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt\nindex ff68e48406..9ae7ccdaa9 100644\n--- a/Documentation/rev-list-options.txt\n+++ b/Documentation/rev-list-options.txt\n@@ -1100,12 +1100,11 @@ preferred format. See the `strftime` manual for a complete list of\n format placeholders. When using `-local`, the correct syntax is\n `--date=format-local:...`.\n \n-`--date=default` is the default format, and is similar to\n-`--date=rfc2822`, with a few exceptions:\n---\n-\t- there is no comma after the day-of-week\n-\n-\t- the time zone is omitted when the local time zone is used\n+`--date=default` is the default format, and is based on ctime(3)\n+output. It shows a single line with three-letter day of the week,\n+three-letter month, day-of-month, hour-minute-seconds in \"HH:MM:SS\"\n+format, followed by 4-digit year, plus timezone information, unless\n+the local time zone is used, e.g. `Thu Jan 1 00:00:00 1970 +0000`.\n \n ifdef::git-rev-list[]\n --header::\n-- \n2.39.2-456-gb1485644f9\n\n"},{"id":"472180","messageId":"Y+2R2qIVQG9hJpEA@coredump.intra.peff.net","threadId":"59176","inReplyTo":"xmqqcz6av3ta.fsf_-_@gitster.g","subject":"Re: [PATCH v2] rev-list: clarify git-log default date format","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2023-02-16T02:15:54Z","receivedAt":"2023-02-16T02:15:57Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Wed, Feb 15, 2023 at 04:42:25PM -0800, Junio C Hamano wrote:\n\n> The documentation mistakenly said that the default format was\n> similar to RFC 2822 format and tried to specify it by enumerating\n> differences, which had two problems:\n> \n> * There are some more differences from the 2822 format that are not\n> mentioned; worse yet\n> \n> * The default format is not modeled after RFC 2822 format at all.\n> As can be seen in f80cd783 (date.c: add \"show_date()\" function.,\n> 2005-05-06), it is a derivative of ctime(3) format.\n> \n> Stop saying that it is similar to RFC 2822, and rewrite the\n> description to explain the format without requiring the reader to\n> know any other format.\n> \n> Signed-off-by: Junio C Hamano \n> ---\n> * The discussion stalled and the topic was left in limbo for a few\n> weeks. Let's attempt to reboot it instead of silently waiting\n> for a rerolled version from the original author.\n\nThanks for keeping this moving. The proposed text looks great to me.\n\n-Peff\n"},{"id":"472183","messageId":"xmqqfsb6tixy.fsf@gitster.g","threadId":"59176","inReplyTo":"Y+2R2qIVQG9hJpEA@coredump.intra.peff.net","subject":"Re: [PATCH v2] rev-list: clarify git-log default date format","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2023-02-16T02:58:33Z","receivedAt":"2023-02-16T02:58:39Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Jeff King writes:\n\n> On Wed, Feb 15, 2023 at 04:42:25PM -0800, Junio C Hamano wrote:\n>\n>> The documentation mistakenly said that the default format was\n>> similar to RFC 2822 format and tried to specify it by enumerating\n>> differences, which had two problems:\n>> \n>> * There are some more differences from the 2822 format that are not\n>> mentioned; worse yet\n>> \n>> * The default format is not modeled after RFC 2822 format at all.\n>> As can be seen in f80cd783 (date.c: add \"show_date()\" function.,\n>> 2005-05-06), it is a derivative of ctime(3) format.\n>> \n>> Stop saying that it is similar to RFC 2822, and rewrite the\n>> description to explain the format without requiring the reader to\n>> know any other format.\n>> \n>> Signed-off-by: Junio C Hamano \n>> ---\n>> * The discussion stalled and the topic was left in limbo for a few\n>> weeks. Let's attempt to reboot it instead of silently waiting\n>> for a rerolled version from the original author.\n>\n> Thanks for keeping this moving. The proposed text looks great to me.\n\nThanks, but the formatting is broken, and needs a line with \"--\" on\nit at the end. What I will queue on 'seen' already has the\ncorrection.\n"},{"id":"472204","messageId":"xmqqzg9dshei.fsf_-_@gitster.g","threadId":"59176","inReplyTo":"xmqqcz6av3ta.fsf_-_@gitster.g","subject":"[PATCH v3] rev-list: clarify git-log default date format","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2023-02-16T16:29:25Z","receivedAt":"2023-02-16T16:29:42Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"The documentation mistakenly said that the default format was\nsimilar to RFC 2822 format and tried to specify it by enumerating\ndifferences, which had two problems:\n\n * There are some more differences from the 2822 format that are not\n mentioned; worse yet\n\n * The default format is not modeled after RFC 2822 format at all.\n As can be seen in f80cd783 (date.c: add \"show_date()\" function.,\n 2005-05-06), it is a derivative of ctime(3) format.\n\nStop saying that it is similar to RFC 2822, and rewrite the\ndescription to explain the format without requiring the reader to\nknow any other format.\n\nSigned-off-by: Junio C Hamano \n---\n * The same text as the previous one; only to correct the lack of\n \"--\" at the end in v2 that broke the formatting toolchain.\n\n Documentation/rev-list-options.txt | 10 +++++-----\n 1 file changed, 5 insertions(+), 5 deletions(-)\n\ndiff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt\nindex ff68e48406..0d90d5b154 100644\n--- a/Documentation/rev-list-options.txt\n+++ b/Documentation/rev-list-options.txt\n@@ -1100,12 +1100,12 @@ preferred format. See the `strftime` manual for a complete list of\n format placeholders. When using `-local`, the correct syntax is\n `--date=format-local:...`.\n \n-`--date=default` is the default format, and is similar to\n-`--date=rfc2822`, with a few exceptions:\n+`--date=default` is the default format, and is based on ctime(3)\n+output. It shows a single line with three-letter day of the week,\n+three-letter month, day-of-month, hour-minute-seconds in \"HH:MM:SS\"\n+format, followed by 4-digit year, plus timezone information, unless\n+the local time zone is used, e.g. `Thu Jan 1 00:00:00 1970 +0000`.\n --\n-\t- there is no comma after the day-of-week\n-\n-\t- the time zone is omitted when the local time zone is used\n \n ifdef::git-rev-list[]\n --header::\n-- \n2.39.2-501-gd9d677b2d8\n\n\n"},{"id":"472208","messageId":"Y+5m6qIx1xsy2Scw@coredump.intra.peff.net","threadId":"59176","inReplyTo":"xmqqzg9dshei.fsf_-_@gitster.g","subject":"Re: [PATCH v3] rev-list: clarify git-log default date format","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2023-02-16T17:24:58Z","receivedAt":"2023-02-16T17:25:02Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Thu, Feb 16, 2023 at 08:29:25AM -0800, Junio C Hamano wrote:\n\n> * The same text as the previous one; only to correct the lack of\n> \"--\" at the end in v2 that broke the formatting toolchain.\n\nThanks. I looked at this version under doc-diff as well as the HTML\nversion and confirmed that it looks good (which I'm sure you also did at\nthis point ;) ).\n\n-Peff\n"}]}