]> git.ipfire.org Git - thirdparty/git.git/commit - t/t0006-date.sh
date: document and test "raw-local" mode
authorJeff King <peff@peff.net>
Wed, 27 Jul 2016 13:44:41 +0000 (09:44 -0400)
committerJunio C Hamano <gitster@pobox.com>
Wed, 27 Jul 2016 21:15:50 +0000 (14:15 -0700)
commit1a2a1e8eb93de2b89a32a52980ec7614fe9d154c
tree3856c85a1a0436d2416fcbd0d2c54aa0bbd85e87
parentd38c7b2c2ce0116215eb05e11d442e9d03b887f4
date: document and test "raw-local" mode

The "raw" format shows a Unix epoch timestamp, but with a
timezone tacked on. The timestamp is not _in_ that zone, but
it is extra information about the time (by default, the zone
the author was in).

The documentation claims that "raw-local" does not work. It
does, but the end result is rather subtle. Let's describe it
in better detail, and test to make sure it works (namely,
the epoch time doesn't change, but the zone does).

While we are rewording the documentation in this area, let's
not use the phrase "does not work" for the remaining option,
"--date=relative". It's vague; do we accept it or not? We do
accept it, but it has no effect (which is a reasonable
outcome). We should also refer to the option not as
"--relative" (which is the historical synonym, and does not
take "-local" at all), but as "--date=relative".

Helped-by: Jakub Narębski <jnareb@gmail.com>
Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/rev-list-options.txt
t/t0006-date.sh