[arbtt.xml: cpedit based on reading live version http://arbtt.nomeata.de/doc/users_guide/effective-use.html
gwern@gwern.net**20140926025547
 Ignore-this: 2e51c35bad9cca4cd735a151b02e179b
] hunk ./doc/arbtt.xml 333
 
     <figure id="grammar">
         <title>The formal grammar of <filename>categorize.cfg</filename></title>
- -	<productionset>
- -	  <production id="g-rules">
- -	    <lhs>Rules</lhs>
- -	    <rhs>
- -	      [ <nonterminal def="#g-aliasspec"/> ]
- -	      <nonterminal def="#g-rule"/> ( (<quote>,</quote>
- -	      <nonterminal def="#g-rule"/>)* | ( <quote>;</quote>
- -	      <nonterminal def="#g-rule"/>)* )
- -	    </rhs>
- -	  </production>
+    <productionset>
+      <production id="g-rules">
+        <lhs>Rules</lhs>
+        <rhs>
+          [ <nonterminal def="#g-aliasspec"/> ]
+          <nonterminal def="#g-rule"/> ( (<quote>,</quote>
+          <nonterminal def="#g-rule"/>)* | ( <quote>;</quote>
+          <nonterminal def="#g-rule"/>)* )
+        </rhs>
+      </production>
 
           <production id="g-aliasspec">
             <lhs>AliasSpec</lhs>
hunk ./doc/arbtt.xml 356
             <rhs>Literal <quote>-&gt;</quote> Literal</rhs>
           </production>
 
- -	  <production id="g-rule">
- -	    <lhs>Rule</lhs>
- -	    <rhs><quote>{</quote> <nonterminal def="#g-rules"/>
+      <production id="g-rule">
+        <lhs>Rule</lhs>
+        <rhs><quote>{</quote> <nonterminal def="#g-rules"/>
                  <quote>}</quote>
             </rhs>
             <rhs>
hunk ./doc/arbtt.xml 371
             <rhs>
               <quote>tag</quote> <nonterminal def="#g-tag"/>
             </rhs>
- -	  </production>
+      </production>
 
hunk ./doc/arbtt.xml 373
- -	  <production id="g-cond">
- -	    <lhs>Cond</lhs>
- -	    <rhs><quote>(</quote> <nonterminal def="#g-cond"/>
+      <production id="g-cond">
+        <lhs>Cond</lhs>
+        <rhs><quote>(</quote> <nonterminal def="#g-cond"/>
                  <quote>)</quote>
             </rhs>
             <rhs><quote>!</quote> <nonterminal def="#g-cond"/> |
hunk ./doc/arbtt.xml 384
                  <nonterminal def="#g-cond"/> <quote>||</quote> <nonterminal
                  def="#g-cond"/>
             </rhs>
- -	    <rhs> <quote>$active</quote> </rhs>
+        <rhs> <quote>$active</quote> </rhs>
             <rhs> <nonterminal def="#g-string"/> <nonterminal def="#g-cmpop"/>
hunk ./doc/arbtt.xml 386
- -	   	 <nonterminal def="#g-string"/> </rhs>
+         <nonterminal def="#g-string"/> </rhs>
             <rhs> <nonterminal def="#g-string"/> <nonterminal def="#g-cmpop"/>
hunk ./doc/arbtt.xml 388
- -	   	 <quote>[</quote> <nonterminal def="#g-listofstring"/>
+         <quote>[</quote> <nonterminal def="#g-listofstring"/>
                  <quote>]</quote>
                  </rhs>
             <rhs> <nonterminal def="#g-string"/> <quote>=~</quote>
hunk ./doc/arbtt.xml 392
- -	    	 <nonterminal def="#g-regex"/></rhs>
+             <nonterminal def="#g-regex"/></rhs>
             <rhs> <nonterminal def="#g-string"/> <quote>=~</quote>
hunk ./doc/arbtt.xml 394
- -	   	 <quote>[</quote> <nonterminal def="#g-listofregex"/>
+         <quote>[</quote> <nonterminal def="#g-listofregex"/>
                  <quote>]</quote>
                  </rhs>
             <rhs> <nonterminal def="#g-number"/> <nonterminal def="#g-cmpop"/>
hunk ./doc/arbtt.xml 398
- -	   	 <nonterminal def="#g-number"/> </rhs>
+         <nonterminal def="#g-number"/> </rhs>
             <rhs> <nonterminal def="#g-timediff"/> <nonterminal def="#g-cmpop"/>
hunk ./doc/arbtt.xml 400
- -	   	 <nonterminal def="#g-timediff"/> </rhs>
+         <nonterminal def="#g-timediff"/> </rhs>
             <rhs> <nonterminal def="#g-date"/> <nonterminal def="#g-cmpop"/>
hunk ./doc/arbtt.xml 402
- -	   	 <nonterminal def="#g-date"/> </rhs>
+         <nonterminal def="#g-date"/> </rhs>
             <rhs> <quote>current window</quote> <nonterminal def="#g-cond"/> </rhs>
             <rhs> <quote>any window</quote> <nonterminal def="#g-cond"/> </rhs>
hunk ./doc/arbtt.xml 405
- -	  </production>
+      </production>
 
hunk ./doc/arbtt.xml 407
- -	  <production id="g-string">
- -	    <lhs>String</lhs>
- -	    <rhs> <quote>$title</quote> </rhs>
- -	    <rhs> <quote>$program</quote> </rhs>
- -	    <rhs> <quote>$desktop</quote> </rhs>
- -	    <rhs> <quote>format</quote> <nonterminal def="#g-date" /> </rhs>
- -	    <rhs> <quote>"</quote> string literal <quote>"</quote> </rhs>
- -	  </production>
+      <production id="g-string">
+        <lhs>String</lhs>
+        <rhs> <quote>$title</quote> </rhs>
+        <rhs> <quote>$program</quote> </rhs>
+        <rhs> <quote>$desktop</quote> </rhs>
+        <rhs> <quote>format</quote> <nonterminal def="#g-date" /> </rhs>
+        <rhs> <quote>"</quote> string literal <quote>"</quote> </rhs>
+      </production>
 
hunk ./doc/arbtt.xml 416
- -	  <production id="g-listofstring">
- -	    <lhs>ListOfString</lhs>
- -	    <rhs> <quote>"</quote> string literal <quote>"</quote> </rhs>
- -	    <rhs> <quote>"</quote> string literal <quote>"</quote> , <nonterminal def="#g-listofstring"/> </rhs>
- -	  </production>
+      <production id="g-listofstring">
+        <lhs>ListOfString</lhs>
+        <rhs> <quote>"</quote> string literal <quote>"</quote> </rhs>
+        <rhs> <quote>"</quote> string literal <quote>"</quote> , <nonterminal def="#g-listofstring"/> </rhs>
+      </production>
 
hunk ./doc/arbtt.xml 422
- -	  <production id="g-number">
- -	    <lhs>Number</lhs>
- -	    <rhs> <quote>$idle</quote> </rhs>
- -	    <rhs> <quote>day of week</quote> <nonterminal def="#g-date" /> </rhs>
- -	    <rhs> <quote>day of month</quote> <nonterminal def="#g-date" /> </rhs>
- -	    <rhs> <quote>month</quote> <nonterminal def="#g-date" /> </rhs>
- -	    <rhs> <quote>year</quote> <nonterminal def="#g-date" /> </rhs>
- -	    <rhs> number literal </rhs>
- -	  </production>
+      <production id="g-number">
+        <lhs>Number</lhs>
+        <rhs> <quote>$idle</quote> </rhs>
+        <rhs> <quote>day of week</quote> <nonterminal def="#g-date" /> </rhs>
+        <rhs> <quote>day of month</quote> <nonterminal def="#g-date" /> </rhs>
+        <rhs> <quote>month</quote> <nonterminal def="#g-date" /> </rhs>
+        <rhs> <quote>year</quote> <nonterminal def="#g-date" /> </rhs>
+        <rhs> number literal </rhs>
+      </production>
 
hunk ./doc/arbtt.xml 432
- -	  <production id="g-date">
- -	    <lhs>Date</lhs>
- -	    <rhs> <quote>$date</quote> </rhs>
- -	    <!-- <rhs> <quote>$now</quote> </rhs> -->
- -	  </production>
+      <production id="g-date">
+        <lhs>Date</lhs>
+        <rhs> <quote>$date</quote> </rhs>
+        <!-- <rhs> <quote>$now</quote> </rhs> -->
+      </production>
 
hunk ./doc/arbtt.xml 438
- -	  <production id="g-timediff">
- -	    <lhs>TimeDiff</lhs>
- -	    <rhs> <quote>$time</quote> </rhs>
- -	    <rhs> <quote>$sampleage</quote> </rhs>
- -	    <!-- <rhs> <nonterminal def="#g-date"/> <quote>-</quote> <nonterminal def="#g-date"/></rhs> -->
+      <production id="g-timediff">
+        <lhs>TimeDiff</lhs>
+        <rhs> <quote>$time</quote> </rhs>
+        <rhs> <quote>$sampleage</quote> </rhs>
+        <!-- <rhs> <nonterminal def="#g-date"/> <quote>-</quote> <nonterminal def="#g-date"/></rhs> -->
             <rhs>( Digit )* Digit <quote>:</quote> Digit Digit</rhs>
hunk ./doc/arbtt.xml 444
- -	  </production>
+      </production>
 
           <production id="g-tag">
             <lhs>Tag</lhs>
hunk ./doc/arbtt.xml 460
               character.</lineannotation> </rhs>
           </production>
 
- -	  <production id="g-listofregex">
- -	    <lhs>ListOfRegex</lhs>
- -	    <rhs> <quote>"</quote> <nonterminal def="#g-regex"/> <quote>"</quote> </rhs>
- -	    <rhs> <quote>"</quote> <nonterminal def="#g-regex"/> <quote>"</quote> , <nonterminal def="#g-listofregex"/> </rhs>
- -	  </production>
+      <production id="g-listofregex">
+        <lhs>ListOfRegex</lhs>
+        <rhs> <quote>"</quote> <nonterminal def="#g-regex"/> <quote>"</quote> </rhs>
+        <rhs> <quote>"</quote> <nonterminal def="#g-regex"/> <quote>"</quote> , <nonterminal def="#g-listofregex"/> </rhs>
+      </production>
 
           <production id="g-cmpop">
             <lhs>CmpOp</lhs>
hunk ./doc/arbtt.xml 472
             | <quote>&gt;</quote> | <quote>&gt;=</quote></rhs>
           </production>
 
- -	</productionset>
+    </productionset>
       </figure>
       <para>
         A <literal>String</literal> refers to a double-quoted string of
hunk ./doc/arbtt.xml 515
 <sect1 id="effective-use">
   <title>Effective Use of Arbtt</title>
   <para>
- -    Now that the syntax has been describedand the toolbox laid out,
+    Now that the syntax has been described and the toolbox laid out,
     how do you practically go about using and configuring arbtt?
   </para>
   <sect2>
hunk ./doc/arbtt.xml 531
       <filename>~/.xinitrc</filename> or similar.
     </para>
     <para>
- -      Another trick is ad dit as a <ulink
+      Another trick is add it as a <ulink
       url="https://en.wikipedia.org/wiki/Cron"><literal>cron</literal></ulink>
       job. To do so, edit your crontab file (<literal>crontab -e</literal>) and
       add a line like this:
hunk ./doc/arbtt.xml 544
       At boot, <literal>arbtt-capture</literal> will be run in the
       background and will capture a snapshot of the X metadata for
       active windows every 60 seconds (the default). If you want more
- -      fine-grained time data at the expense of doubling storage use
- -      you could increase the sampling rate with a command like
+      fine-grained time data at the expense of doubling storage use,
+      you could increase the sampling rate with an option like
       <literal>--sample-rate=30</literal>. To be resilient to any errors
       or segfaults, you could also wrap it in an infinite loop to restart
       the daemon should it ever crash, with a command like
hunk ./doc/arbtt.xml 558
   <sect2>
     <title>Checking data availability</title>
     <para>
- -      arbtt tracks X properties like window title, class, and running
- -      program, and you write rules to classify the strings as
+      arbtt tracks <ulink url="https://en.wikipedia.org/wiki/X_Window_System_protocols_and_architecture#Attributes_and_properties"
+      >X</ulink> properties like window title, class, and running
+      program, and you write rules to classify those strings as
       you wish; but this assumes that the necessary data is present in
       those properties.
     </para>
hunk ./doc/arbtt.xml 567
     <para>
       For some programs, this is the case. For example, web browsers
       like Firefox typically set the X title to the
- -      <literal>&lt;title&gt;</literal> of the web page in the
+      HTML <literal>&lt;title&gt;</literal> element of the web page in the
       currently-focused tab, which is enough for classification.
     </para>
     <para>
hunk ./doc/arbtt.xml 572
       Some programs do not set titles or class, and all arbtt sees is
- -      empty strings like &quot;&quot;; or they may set the title/class
- -      to a constant like &quot;Liferea&quot;, which may be acceptable if
+      empty strings like <literal>&quot;&quot;</literal>; or they may set the title/class
+      to a constant like <literal>&quot;Liferea&quot;</literal>, which may be acceptable if
       that program is used for only one purpose, but if it is used for
       many purposes, then you cannot write a rule matching it without
       producing highly-misleading time analyses. (For example, a web
hunk ./doc/arbtt.xml 579
       browser may be used for countless purposes, ranging from work to
       research to music to writing to programming; but if the web
- -      browser's title/class were always just &quot;Web browser&quot;,
+      browser's title/class were always just <literal>&quot;Web browser&quot;</literal>,
       how would you classify 5 hours spent using the web browser? If the
       5 hours are classified as any or all of those purposes, then the
       results will be misleading garbage - you probably did not spend 5
hunk ./doc/arbtt.xml 590
       You should check for such problematic programs upon starting using
       arbtt. It would be unfortunate if you were to log for a few
       months, go back for a detailed report for some reason, and
- -      discover that the necessary data was never actually available for
+      discover that the necessary data was never available for
       arbtt to log!
     </para>
     <para>
hunk ./doc/arbtt.xml 650
 </programlisting>
       <para>
         With this, we can usefully classify all such time samples as
- -        being “writing”.
+        being “writing”:
       </para>
hunk ./doc/arbtt.xml 652
+<programlisting>
+current window $title == &quot;/home/gwern/arbtt.page&quot; ==> tag Writing,
+</programlisting>
       <para>
         Another common gap is terminals/shells: they often do not
         include information in the title like the current working
hunk ./doc/arbtt.xml 685
 _NET_WM_NAME(UTF8_STRING) = &quot;/home/gwern/wiki; 2014-09-03 13:39:32 arbtt-stats --help&quot;
 </programlisting>
       <para>
- -	Some distributions (e.g. Debian) already provide the relevant
- -	configuration for this to happen. If it does not work for you, you can try to add
- -	<programlisting>. /etc/profile.d/vte.sh</programlisting>
- -	to your <filename>~/.bashrc</filename>.
+    Some distributions (e.g. Debian) already provide the relevant
+    configuration for this to happen. If it does not work for you, you can try to add
+    <programlisting>. /etc/profile.d/vte.sh</programlisting>
+    to your <filename>~/.bashrc</filename>.
       </para>
       <para>
         A rule could classify based on the directory you are working in,
hunk ./doc/arbtt.xml 943
         </para>
     </sect3>
     <sect3>
- -	<title>
- -	  Avoid large and microscopic tags
- -	</title>
- -	<para>
- -	  If a tag takes up more than a third or so of your time, it is
- -	  probably too large, masks variation, and can be broken down into more
- -	  meaningful tags. Conversely, a tag too narrow to show up regularly in
- -	  reports (because it is below the default 1% filter) may not be
- -	  helpful because it is usually tiny, and can be combined with the most
- -	  similar tag to yield more compact and easily interpreted reports.
- -	</para>
+    <title>
+      Avoid large and microscopic tags
+    </title>
+    <para>
+      If a tag takes up more than a third or so of your time, it is
+      probably too large, masks variation, and can be broken down into more
+      meaningful tags. Conversely, a tag too narrow to show up regularly in
+      reports (because it is below the default 1% filter) may not be
+      helpful because it is usually tiny, and can be combined with the most
+      similar tag to yield more compact and easily interpreted reports.
+    </para>
     </sect3>
   </sect2>
   <sect2>
hunk ./doc/arbtt.xml 1411
         <term><option>-V</option></term>
         <term><option>--version</option></term>
         <listitem><simpara>shows the version number, and exists.</simpara></listitem>
- -	</varlistentry>
+    </varlistentry>
         <varlistentry>
         <term><option>-f</option> <replaceable>FILE</replaceable></term>
         <term><option>--logfile</option> <replaceable>FILE</replaceable></term>
hunk ./doc/arbtt.xml 1421
         <term><option>-t</option> <replaceable>FORMAT</replaceable></term>
         <term><option>--format</option> <replaceable>FORMAT</replaceable></term>
         <listitem><simpara>dumping format to use, where <replaceable>FORMAT</replaceable> is one of <literal>human</literal> (the default), <literal>show</literal> or <literal>JSON</literal>. Case in-sensitive.</simpara></listitem>
- -	</varlistentry>
+    </varlistentry>
         <varlistentry>
         <term><option>-l</option> <replaceable>NUMBER</replaceable></term>
         <term><option>--last</option> <replaceable>NUMBER</replaceable></term>
hunk ./doc/arbtt.xml 1543
         <term><option>-V</option></term>
         <term><option>--version</option></term>
         <listitem><simpara>shows the version number, and exists.</simpara></listitem>
- -	</varlistentry>
+    </varlistentry>
         <varlistentry>
         <term><option>-f</option> <replaceable>FILE</replaceable></term>
         <term><option>--logfile</option> <replaceable>FILE</replaceable></term>
hunk ./doc/arbtt.xml 1609
         <term><option>-V</option></term>
         <term><option>--version</option></term>
         <listitem><simpara>shows the version number, and exists.</simpara></listitem>
- -	</varlistentry>
+    </varlistentry>
         <varlistentry>
         <term><option>-i</option></term>
         <term><option>--infile</option></term>
hunk ./doc/arbtt.xml 1696
     <title>Version 0.9 (unreleased)</title>
     <itemizedlist>
       <listitem>
- -	<para>
+    <para>
           The <option>--for-each</option> option of
           <command>arbtt-stats</command> now supports grouping results by
           minute or hour.
hunk ./doc/arbtt.xml 1700
- -	</para>
+    </para>
       </listitem>
       <listitem>
hunk ./doc/arbtt.xml 1703
- -	<para>
- -	  Gwern Branwen contributed the <xref linkend="effective-use"/>.
- -	</para>
+    <para>
+      Gwern Branwen contributed the <xref linkend="effective-use"/>.
+    </para>
       </listitem>
     </itemizedlist>
   </sect2>
hunk ./doc/arbtt.xml 1714
     <title>Version 0.8.1</title>
     <itemizedlist>
       <listitem>
- -	<para>
- -	  The syntax now allows for time differences larger than 99:99.
+    <para>
+      The syntax now allows for time differences larger than 99:99.
           (<ulink url="https://bitbucket.org/nomeata/arbtt/issue/14/improve-time-categorization-directives">issue #14</ulink>)
hunk ./doc/arbtt.xml 1717
- -	</para>
+    </para>
       </listitem>
     </itemizedlist>
   </sect2>
hunk ./doc/arbtt.xml 1726
     <title>Version 0.8</title>
     <itemizedlist>
       <listitem>
- -	<para>
- -	  <command>arbtt-dump</command> can now show the data in other formats
- -	  as well, as suggested by Waldir Pimenta (option
- -	  <option>--format</option>). This includes a human-readale output and
- -	  JSON.
- -	</para>
+    <para>
+      <command>arbtt-dump</command> can now show the data in other formats
+      as well, as suggested by Waldir Pimenta (option
+      <option>--format</option>). This includes a human-readale output and
+      JSON.
+    </para>
       </listitem>
       <listitem>
         <para>New option <option>--last</option> of <command>arbtt-dump</command>.</para>
hunk ./doc/arbtt.xml 1788
     <title>Version 0.6.4.1</title>
     <itemizedlist>
       <listitem>
- -      	<para>
- -      	Added missing module to the packages.
- -      	</para>
+        <para>
+        Added missing module to the packages.
+        </para>
       </listitem>
     </itemizedlist>
   </sect2>
hunk ./doc/arbtt.xml 1873
     <title>Version 0.5 (The ZuriHac-Release)</title>
     <itemizedlist>
       <listitem>
- -	<para>New command <command>arbtt-import</command>, which imports the output from <command>arbtt-dump</command>.
+    <para>New command <command>arbtt-import</command>, which imports the output from <command>arbtt-dump</command>.
         </para>
       </listitem>
       <listitem>
hunk ./doc/arbtt.xml 1892
       </listitem>
       <listitem>
         <para>
- -	  Unicode is handled correctly in regular expressions.
- -	</para>
+      Unicode is handled correctly in regular expressions.
+    </para>
       </listitem>
       <listitem>
         <para>
hunk ./doc/arbtt.xml 1897
- -	  Improved date-handling functions for <filename>categorize.cfg</filename>.
+      Improved date-handling functions for <filename>categorize.cfg</filename>.
           (<xref linkend="sergey"/>)
hunk ./doc/arbtt.xml 1899
- -	</para>
+    </para>
       </listitem>
     </itemizedlist>
   </sect2>
hunk ./doc/arbtt.xml 1909
     <itemizedlist>
       <listitem>
         <para>Bugfix: Added missing modules to the cabal file.
- -	</para>
+    </para>
       </listitem>
     </itemizedlist>
   </sect2>
hunk ./doc/arbtt.xml 1919
     <itemizedlist>
       <listitem>
         <para>Implement a custom compression method greatly reduce the file size of the log file. Run <command>arbtt-capture</command> to compress the previous samples as well.
- -	</para>
+    </para>
       </listitem>
     </itemizedlist>
   </sect2>
hunk ./doc/arbtt.xml 1954
         <command>arbtt-dump</command>.</para>
       </listitem>
       <listitem>
- -	<para>New command <command>arbtt-recover</command> to rescue data from
- -	a proken data log file.</para>
+    <para>New command <command>arbtt-recover</command> to rescue data from
+    a proken data log file.</para>
       </listitem>
       <listitem>
hunk ./doc/arbtt.xml 1958
- -	<para>Actually include this documentation in the released tarball.</para>
+    <para>Actually include this documentation in the released tarball.</para>
       </listitem>
     </itemizedlist>
   </sect2>