Skip to content

Commit 442f6fd

Browse files
committed
date: clarify --date=raw description
"... in the internal raw Git format `%s %z` format." was clunky in repeating "format" twice, and would not have helped those who do not immediately get that these are strftime(3) conversion specifiers. Explain them with words, and demote the mention of `%s %z` to a hint to help those who know them. Helped-by: Jeff King <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 642833d commit 442f6fd

File tree

1 file changed

+5
-1
lines changed

1 file changed

+5
-1
lines changed

Documentation/rev-list-options.txt

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -746,7 +746,11 @@ format, often found in email messages.
746746
+
747747
`--date=short` shows only the date, but not the time, in `YYYY-MM-DD` format.
748748
+
749-
`--date=raw` shows the date in the internal raw Git format `%s %z` format.
749+
`--date=raw` shows the date as seconds since the epoch (1970-01-01
750+
00:00:00 UTC), followed by a space, and then the timezone as an offset
751+
from UTC (a `+` or `-` with four digits; the first two are hours, and
752+
the second two are minutes). I.e., as if the timestamp were formatted
753+
with `strftime("%s %z")`).
750754
Note that the `-local` option does not affect the seconds-since-epoch
751755
value (which is always measured in UTC), but does switch the accompanying
752756
timezone value.

0 commit comments

Comments
 (0)