Skip to content

Commit 9deef08

Browse files
committed
rev-list: clarify git-log default date format
The documentation mistakenly said that the default format was similar to RFC 2822 format and tried to specify it by enumerating differences, which had two problems: * There are some more differences from the 2822 format that are not mentioned; worse yet * The default format is not modeled after RFC 2822 format at all. As can be seen in f80cd78 (date.c: add "show_date()" function., 2005-05-06), it is a derivative of ctime(3) format. Stop saying that it is similar to RFC 2822, and rewrite the description to explain the format without requiring the reader to know any other format. Signed-off-by: Junio C Hamano <[email protected]>
1 parent 844ede3 commit 9deef08

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

Documentation/rev-list-options.txt

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1100,12 +1100,12 @@ preferred format. See the `strftime` manual for a complete list of
11001100
format placeholders. When using `-local`, the correct syntax is
11011101
`--date=format-local:...`.
11021102

1103-
`--date=default` is the default format, and is similar to
1104-
`--date=rfc2822`, with a few exceptions:
1103+
`--date=default` is the default format, and is based on ctime(3)
1104+
output. It shows a single line with three-letter day of the week,
1105+
three-letter month, day-of-month, hour-minute-seconds in "HH:MM:SS"
1106+
format, followed by 4-digit year, plus timezone information, unless
1107+
the local time zone is used, e.g. `Thu Jan 1 00:00:00 1970 +0000`.
11051108
--
1106-
- there is no comma after the day-of-week
1107-
1108-
- the time zone is omitted when the local time zone is used
11091109

11101110
ifdef::git-rev-list[]
11111111
--header::

0 commit comments

Comments
 (0)