[arbtt.xml: fix duplicate ID in release notes gwern@gwern.net**20140903191504 Ignore-this: b2f1dda7c6be44959591c5d790983150 ] hunk ./doc/arbtt.xml 1182 The version history with changes relevant for the user is documented here. - - + Version 0.8.1 [arbtt.xml: delete trailing whitespace gwern@gwern.net**20140903191535 Ignore-this: bd5d1d7b41f5604fd8c1cc588d6411fc ] hunk ./doc/arbtt.xml 52 expressive rules you specify, derive what you were doing, and what for. The log file might contain very sensitive private data. Make sure - - you understand the consequences of a full-time logger and be careful with this data. hunk ./doc/arbtt.xml 109 Obviously, you can already read the documentation. If you still want to build it yourself, enter the directory doc/ and run - - make for the documentation in HTML and PDF format. + make for the documentation in HTML and PDF format. hunk ./doc/arbtt.xml 149 <filename>categorize.cfg</filename> - - hunk ./doc/arbtt.xml 230 For current window, the currently active window is in scope. If there is no such window, the condition is false. - - + For any window, the condition is applied to each window, in turn, and if any of the windows matches, the result is true. If hunk ./doc/arbtt.xml 246 time span from when the sample was recored until now, the time of evaluating the statistics. The latter variable is especially useful when passed to the option of - - arbtt-stats. They can be compared with expressions + arbtt-stats. They can be compared with expressions like "hh:mm", for example $time >= 8:00 && $time < 12:00 ==> tag time-of-day:morning hunk ./doc/arbtt.xml 346 } - - ==> + ==> | if then else hunk ./doc/arbtt.xml 372 - - [ + [ ] hunk ./doc/arbtt.xml 374 - - + =~ =~ hunk ./doc/arbtt.xml 378 - - [ + [ ] hunk ./doc/arbtt.xml 494 expressions. - - + hunk ./doc/arbtt.xml 503 arbtt-stats. This overview is followed by their manual pages. - - + To generate statistics about the data that hunk ./doc/arbtt.xml 552 arbtt-stats generate statistics from the arbtt data samples - - + arbtt-stats hunk ./doc/arbtt.xml 718 intervals where the given tag has been applied to, or where the given category has the same value. - - + To distinguish tags and categories, the latter have to be entered followed by a colon. hunk ./doc/arbtt.xml 721 - - + This report will give wrong results if an activity has been carried out at the end of a session and right at the beginning, as the intermediate time is thought to be part of the interval. hunk ./doc/arbtt.xml 727 Inactive times while arbtt-capture is running will separate the results as expected. - - + hunk ./doc/arbtt.xml 734 PERIOD This is not a report of its own, but causes the selected report to be executed for each of the given PERIOD (which can be - - day, month or year) where there exist selected samples. All the reports + day, month or year) where there exist selected samples. All the reports will then be printed one after another or, in the case of CSV output, with an additional column. hunk ./doc/arbtt.xml 737 - - + Note that if this option is enabled, samples that are filtered out are completely ignored (to avoid empty reports for periods with only filtered samples). Therefore, the hunk ./doc/arbtt.xml 753 Examples Some useful examples of what you can do with arbtt-stats are provided here: - - # Only consider the time when I was programming in Haskell + # Only consider the time when I was programming in Haskell arbtt-stats -o Editing-Haskell # Tell me what evolution folders I spend my time in when I actually do hunk ./doc/arbtt.xml 784 newer versions of arbtt. - - + arbtt-capture hunk ./doc/arbtt.xml 796 arbtt-capture collect data samples for arbtt - - + arbtt-capture hunk ./doc/arbtt.xml 808 arbtt-capture runs continuously and saves at the given sample rate, usually once per minute, the collected data to - - ~/.arbtt/capture.log. + ~/.arbtt/capture.log. hunk ./doc/arbtt.xml 871 arbtt-dump dumps arbtt data samples - - + arbtt-dump hunk ./doc/arbtt.xml 997 arbtt-import imports dumped arbtt data samples - - + arbtt-import hunk ./doc/arbtt.xml 1067 arbtt-recover tries to recover a broken arbtt data log - - + arbtt-recover hunk ./doc/arbtt.xml 1239 - - + Version 0.7 [arbtt.xml: add self to doc authors, add a list of similar projects to intro to describe arbtt better gwern@gwern.net**20140903191546 Ignore-this: 2e182232bbe9f9d441deb32d7c818f5e ] hunk ./doc/arbtt.xml 42 Documentation writer waldir@email.com + + Gwern + Branwen + Documentation writer + gwern@gwern.net + hunk ./doc/arbtt.xml 56 has the focus and how long since your last action (and possibly more sources later), and stores this. It is also a program that will, based on expressive rules you specify, derive what you were doing, and what for. + It is comparable to the window trackers RescueTime, selfspy, TimeSnapper, and + + Productive Peach; but it differs from the manual timetrackers like Project Hamster which require + the user to type a description of their activities. The log file might contain very sensitive private data. Make sure you understand the consequences of a full-time logger and be careful with this [example categorize.cfg: add local variable to set emacs to haskell-mode gwern@gwern.net**20140903191640 Ignore-this: 983cec6417a9aa25232ea9efaa2bd0f6 by adding the metadata, emacs users copying the example config get appropriate syntax highlighting without additional work, and other users are reminded that their favorite editor's haskell mode would work well in displaying arbtt configs ] hunk ./categorize.cfg 1 +-- -*- mode: haskell; -*- -- Comments in this file use the Haskell syntax: -- A "--" comments the rest of the line. -- A set of {- ... -} comments out a group of lines. hunk ./categorize.cfg 110 -- You can compare dates: $date >= 2001-01-01 ==> tag this_century, - --- You have to write them in YYYY-MM-DD format, else they will not be recognized. +-- You have to write them in YYYY-MM-DD format, else they will not be recognized. -- “format $date” produces a string with the date in ISO 8601 format -- (YYYY-MM-DD), it may be compared with strings. For example, to match