I have been reading through the specification, and I believe there are a few things which needs further clarifications.
I. Records
Summary
It MUST be separated from the entry one “space”
Incorrect wording, I believe.
Range
There MUST be a - between the two values, which MAY be surrounded by one “space” on each side.
Ambigious. Can there be ...
- ... multiple spaces?
- ... spaces on just one side?
klog currently actually accepts ranges in the format of 00:00 -01:11
The ? MAY be written in repeatedly, e.g. ???.
Incorrect wording. Maybe use "in a recurring succession"?
Duration
I would very much like to see a clarification that the minute part cannot be greater than 59, if it is in combination with an hour part. I assume this is the intended behaviour, since klog throws an error if the minutes are greater than 60. However, surprisingly it actually accepts 1h60m
and interprets that as 2h
. I believe this is a bug with the program, but I might be wrong.
II. Organizing records in files
Subsequent records MUST be separated by one “blank line”; there MAY be additional blank lines.
Contradictory. I interpret the first sentence as "must be separated by one and only one blank line". I wish for this to be clarified.