arbtt 0.8.1.2 → 0.8.1.3
raw patch · 3 files changed
+45/−29 lines, 3 filesdep ~tasty
Dependency ranges changed: tasty
Files
- arbtt.cabal +2/−2
- categorize.cfg +2/−1
- doc/arbtt.xml +41/−26
arbtt.cabal view
@@ -1,5 +1,5 @@ name: arbtt-version: 0.8.1.2+version: 0.8.1.3 license: GPL license-file: LICENSE category: Desktop@@ -191,7 +191,7 @@ test.hs Build-depends: base == 4.5.* || == 4.6.* || == 4.7.*- , tasty == 0.7.* || == 0.8.*+ , tasty == 0.7.* || == 0.8.* || == 0.9.* , tasty-golden >= 2.2.0.2 && <= 2.3 , tasty-hunit == 0.2.* || == 0.4.* || == 0.8.* || == 0.9.* , HUnit == 1.2.*
categorize.cfg view
@@ -1,3 +1,4 @@+-- -*- 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.@@ -106,7 +107,7 @@ -- 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
doc/arbtt.xml view
@@ -39,6 +39,12 @@ <contrib>Documentation writer</contrib> <email>waldir@email.com</email> </author>+ <author id="gwern">+ <firstname>Gwern</firstname>+ <surname>Branwen</surname>+ <contrib>Documentation writer</contrib>+ <email>gwern@gwern.net</email>+ </author> </authorgroup> </articleinfo> <abstract>@@ -47,9 +53,18 @@ 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.+ </para>+ <para>+ It is comparable to the window trackers <ulink+ url="https://www.rescuetime.com/">RescueTime</ulink>, <ulink+ url="https://github.com/gurgeh/selfspy">selfspy</ulink>, <ulink+ url="http://www.timesnapper.com/">TimeSnapper</ulink>, and+ <ulink url="https://etopian.com/software/automatic-screenshots-windows-mac-linux/">+ Productive Peach</ulink>; but it differs from the manual timetrackers like <ulink+ url="http://projecthamster.wordpress.com/about/">Project Hamster</ulink> which require+ the user to type a description of their activities. <warning><para>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.</para></warning> </para>@@ -107,7 +122,7 @@ <para> Obviously, you can already read the documentation. If you still want to build it yourself, enter the directory <filename>doc/</filename> and run- <command>make</command> for the documentation in HTML and PDF format. + <command>make</command> for the documentation in HTML and PDF format. </para> </sect2> @@ -147,7 +162,7 @@ <example id="catex"> <title><filename>categorize.cfg</filename></title>- <programlisting><xi:include href="../categorize.cfg" parse="text" + <programlisting><xi:include href="../categorize.cfg" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> </example> </sect2>@@ -228,7 +243,7 @@ For <literal>current window</literal>, the currently active window is in scope. If there is no such window, the condition is false. </para>- + <para> For <literal>any window</literal>, the condition is applied to each window, in turn, and if any of the windows matches, the result is true. If@@ -244,7 +259,7 @@ 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>--filter</option> option of- <command>arbtt-stats</command>. They can be compared with expressions + <command>arbtt-stats</command>. They can be compared with expressions like "hh:mm", for example <programlisting>$time >= 8:00 && $time < 12:00 ==> tag time-of-day:morning</programlisting> </para>@@ -344,7 +359,7 @@ <quote>}</quote> </rhs> <rhs>- <nonterminal def="#g-cond"/> <quote>==></quote> + <nonterminal def="#g-cond"/> <quote>==></quote> <nonterminal def="#g-rule"/> | <quote>if</quote> <nonterminal def="#g-cond"/> <quote>then</quote> <nonterminal def="#g-rule"/> <quote>else</quote>@@ -370,13 +385,13 @@ <rhs> <nonterminal def="#g-string"/> <nonterminal def="#g-cmpop"/> <nonterminal def="#g-string"/> </rhs> <rhs> <nonterminal def="#g-string"/> <nonterminal def="#g-cmpop"/>- <quote>[</quote> <nonterminal def="#g-listofstring"/> + <quote>[</quote> <nonterminal def="#g-listofstring"/> <quote>]</quote>- </rhs> + </rhs> <rhs> <nonterminal def="#g-string"/> <quote>=~</quote> <nonterminal def="#g-regex"/></rhs> <rhs> <nonterminal def="#g-string"/> <quote>=~</quote>- <quote>[</quote> <nonterminal def="#g-listofregex"/> + <quote>[</quote> <nonterminal def="#g-listofregex"/> <quote>]</quote> </rhs> <rhs> <nonterminal def="#g-number"/> <nonterminal def="#g-cmpop"/>@@ -492,7 +507,7 @@ expressions. </para> </sect2>- + </sect1> <sect1 id="references">@@ -501,7 +516,7 @@ <command>arbtt-stats</command>. This overview is followed by their manual pages. </para>- + <!-- <sect2> <title>Generating statistics</title> --> <para>To generate statistics about the data that@@ -550,7 +565,7 @@ <refname>arbtt-stats</refname> <refpurpose>generate statistics from the arbtt data samples</refpurpose> </refnamediv>- + <refsynopsisdiv> <cmdsynopsis> <command>arbtt-stats</command>@@ -716,26 +731,26 @@ intervals where the given tag has been applied to, or where the given category has the same value. </para>- + <para>To distinguish tags and categories, the latter have to be entered followed by a colon.</para>- + <para>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. Inactive times while <command>arbtt-capture</command> is running will separate the results as expected.</para>- + </listitem> </varlistentry> <varlistentry> <term><option>--for-each</option> <replaceable>PERIOD</replaceable></term> <listitem><para>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.</para>- + <para>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@@ -751,7 +766,7 @@ <refsect1><title>Examples</title> <para>Some useful examples of what you can do with <command>arbtt-stats</command> are provided here:</para>- <screen># Only consider the time when I was programming in Haskell + <screen># 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@@ -782,7 +797,7 @@ newer versions of arbtt.</para> </refsect1> </refentry>- + <refentry id="arbtt-capture"> <refmeta> <refentrytitle>arbtt-capture</refentrytitle>@@ -794,7 +809,7 @@ <refname>arbtt-capture</refname> <refpurpose>collect data samples for arbtt</refpurpose> </refnamediv>- + <refsynopsisdiv> <cmdsynopsis> <command>arbtt-capture</command>@@ -806,7 +821,7 @@ <para> <command>arbtt-capture</command> runs continuously and saves at the given sample rate, usually once per minute, the collected data to- <filename>~/.arbtt/capture.log</filename>. + <filename>~/.arbtt/capture.log</filename>. </para> </refsect1> @@ -869,7 +884,7 @@ <refname>arbtt-dump</refname> <refpurpose>dumps arbtt data samples</refpurpose> </refnamediv>- + <refsynopsisdiv> <cmdsynopsis> <command>arbtt-dump</command>@@ -995,7 +1010,7 @@ <refname>arbtt-import</refname> <refpurpose>imports dumped arbtt data samples</refpurpose> </refnamediv>- + <refsynopsisdiv> <cmdsynopsis> <command>arbtt-import</command>@@ -1065,7 +1080,7 @@ <refname>arbtt-recover</refname> <refpurpose>tries to recover a broken arbtt data log</refpurpose> </refnamediv>- + <refsynopsisdiv> <cmdsynopsis> <command>arbtt-recover</command>@@ -1179,7 +1194,7 @@ The version history with changes relevant for the user is documented here. </para> - <sect2 id="release-notes-0.8">+ <sect2 id="release-notes-0.8.1"> <title>Version 0.8.1</title> <itemizedlist> <listitem>@@ -1237,7 +1252,7 @@ </listitem> </itemizedlist> </sect2>- + <sect2> <title>Version 0.7</title> <itemizedlist>