> do any tools actually generate log file entries with parentheses?
No, but I answer pings and put things in parens often. The convention
is that parens are for comments by the user and brackets are for
machine-generated comments, namely, a human-readable version of the
timestamp.
> what is the "comment" thing that apparently you can answer tagtime with?
Oh, that's the parens/brackets thing.
> what is the .tsk file format? all of the formats to do with task things, if
> there are more.
That's safe to ignore but I have a built-in to-do list manager that
integrates with TagTime. It's basically a bunch of vim macros. The
idea is to enter tasks with time estimates, and, optionally, tags.
Then you can answer tagtime pings with the number of the task and it
will fill in the tags for that task and also accumulate data on how
good your time estimates are. Like if you're well-calibrated then, for
example, for all your 15-minute tasks you'll get pinged a third of the
time that you're doing one of those. If you get pinged for more like
two thirds of your nominally 15-minute tasks then those tasks are
actually taking 30 minutes, on average. I have a ton of data on myself
to that effect that I have yet to analyze.
It would be pretty great to have realtime stats on that on my personal
dashboard. I'd see what I needed to multiply my estimates by to make
them realistic and could gradually learn to actually do that as part
of making the estimates.
PS: Joel Spolsky calls the ratio of estimated to actual time your
velocity:
http://www.joelonsoftware.com/items/2007/10/26.html