do not use underscores in time stamp
authorOlaf Dabrunz <od@suse.de>
Thu, 22 Jan 2009 11:50:57 +0000 (12:50 +0100)
committerOlaf Dabrunz <od@suse.de>
Thu, 22 Jan 2009 11:50:57 +0000 (12:50 +0100)
commit20ef546cd2b7bdd00021167ca0d5bd0df648634e
tree5509f9999d6a3bee6edd8b3aaf1607d91318657d
parentb36809a97deac24680c802d50e2b280d7e24257d
do not use underscores in time stamp

It turns out that there are no parsers for the sam log yet. So there is no need
to protect them from breaking, and we do not need to link the date and time
with an underscore to keep the whole string one item on the line. The date and
time are now separated by a space.

To make the time representation ISO-8601 compliant, the time zone is directly
attached to the time again.

According to ISO-8601 (and also RFC3339), a space is not allowed in compliant
representations. So the date and the time are now two separate representations.
Each of them is ISO-8601 (or RFC3339) compliant in itself (attaching the time
zone to the time representation suffices to make it compliant, and the leading
'T' can be dropped). But the reader is supposed to understand that they should
be used together to represent a single instant in time.

The separation with a space is done for readability. This is based on feedback
from testers of sam. This format is also used in other applications, see e.g.
http://en.wikipedia.org/wiki/Talk:ISO_8601.

The time stamp is used in the log file and log file entries are also displayed
on stderr for the user to read. The latter makes it necessary to have a
readable representation. Otherwise it would be too cumbersome for a reader to
interpret the log line.

Parsers of the log file should assume that either whitespace is used to
separate the date and the time, or that a single 'T' (or 't') is used. This
makes them robust against changes of the timestamp that are allowed by the
mentioned standards, and against the readability "space" that is used here.

If at all possible, the current format of the time stamp will not be changed in
future versions of sam.
sam