<<<<<<< HEAD
<!-- Creator     : groff version 1.22.2 -->
<!-- CreationDate: Fri Feb 14 14:42:34 2014 -->
=======
<!-- Creator     : groff version 1.22.3 -->
<!-- CreationDate: Fri Jun 24 15:17:56 2016 -->
>>>>>>> devel
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
       p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
       pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
       table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
       h1      { text-align: center }
</style>
<title>taskopenrc</title>

</head>
<body>

<h1 align="center">taskopenrc</h1>

<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#CONFIGURATION VARIABLES">CONFIGURATION VARIABLES</a><br>
<a href="#EXAMPLES">EXAMPLES</a><br>
<a href="#CREDITS &amp; COPYRIGHTS">CREDITS &amp; COPYRIGHTS</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<a href="#REPORTING BUGS">REPORTING BUGS</a><br>

<hr>


<h2>NAME
<a name="NAME"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em">taskopenrc
&minus; Configuration file for the <b>taskopen</b>(1)
command</p>

<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em"><b>~/.taskopenrc
<br>
taskopen -c /path/to/taskopenrc</b></p>

<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em"><b>taskopen</b>
obtains its configuration data from a file called
<i>~/.taskopenrc</i> in the user&rsquo;s home directory.</p>

<p style="margin-left:11%; margin-top: 1em">Each line in
the taskopenrc file is either an assignment, a comment or
empty.</p>

<p style="margin-left:11%; margin-top: 1em">An assignment
consists of a variable name and a value separated by the
equal sign (&quot;=&quot;):</p>

<p style="margin-left:22%; margin-top: 1em">&lt;variable
name&gt;=&lt;value&gt;</p>

<p style="margin-left:11%; margin-top: 1em">where the
variable name is one of the names below.</p>

<p style="margin-left:11%; margin-top: 1em">A hash mark
(&quot;#&quot;) can be used to mark the beginning of a
comment line.</p>

<h2>CONFIGURATION VARIABLES
<a name="CONFIGURATION VARIABLES"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em">Valid variable
names and their default values are:</p>

<p style="margin-left:11%; margin-top: 1em"><b>General
configuration <br>
BROWSER=xdg-open</b>$FILE<b>&amp;&gt;/dev/null</b></p>

<p style="margin-left:22%;">The executable which will be
used to open URIs.</p>

<p style="margin-left:11%;"><b>EDITOR=vim</b></p>

<p style="margin-left:22%;">Your preferred editor.</p>

<p style="margin-left:11%;"><b>FILE_CMD=xdg-open</b></p>

<p style="margin-left:22%;">Command to be used for opening
non-text files.</p>

<p style="margin-left:11%;"><b>TASKBIN=task</b></p>

<p style="margin-left:22%;">The path to your taskwarrior
binary.</p>


<p style="margin-left:11%;"><b>PATH_EXT=/usr/share/taskopen/scripts</b></p>

<p style="margin-left:22%;">The given path(s) will be
prepended to taskopen&rsquo;s PATH variable. The default
value depends on the installation path.</p>

<p style="margin-left:11%;"><b>DEBUG=0</b></p>

<p style="margin-left:22%;">Set this to &rsquo;1&rsquo; if
you want to enable additional debugging output.</p>

<p style="margin-left:11%; margin-top: 1em"><b>Notes files
<br>
NOTES_FOLDER=$HOME/tasknotes/</b></p>

<p style="margin-left:22%;">The directory in which the
Notes files will be stored.</p>

<p style="margin-left:11%;"><b>NOTES_EXT=.txt</b></p>

<p style="margin-left:22%;">The file extension used for
Notes files.</p>

<p style="margin-left:11%;"><b>NOTES_FILE</b></p>

<p style="margin-left:22%;">This sets the actual path of
the Notes files. The string &quot;UUID&quot; will be
replaced with the task&rsquo;s UUID. If not set, the value
will be assembled by taking NOTES_FOLDER and NOTES_EXT:
${NOTES_FOLDER}UUID${NOTES_EXT}</p>

<p style="margin-left:11%;"><b>NOTES_CMD</b></p>

<p style="margin-left:22%;">Sets the command that will be
executed to open a Notes file. If not set, the value will be
assembled by taking EDITOR and NOTES_FILE: ${EDITOR}
&quot;${NOTES_FILE}&quot;.</p>

<p style="margin-left:11%;"><b>NOTES_REGEX=Notes</b></p>

<p style="margin-left:22%;">The regular expression which
identifies an annotation as a link to the Notes file.</p>

<p style="margin-left:11%; margin-top: 1em"><b>Default
arguments <br>
DEFAULT_FILTER=status.is:pending</b></p>

<p style="margin-left:22%;">The default taskwarrior filter
that will be applied to all queries. Can be deactivted by
using the -a or -A switches.</p>

<p style="margin-left:11%;"><b>DEFAULT_SORT</b></p>

<p style="margin-left:22%;">Specify the default sorting
which may be overridden by the -s option.</p>

<p style="margin-left:11%;"><b>DEFAULT-i=ls -la</b></p>

<p style="margin-left:22%;">Default command for the -i
parameter which allows using -i without an argument.</p>

<p style="margin-left:11%;"><b>DEFAULT-x</b></p>

<p style="margin-left:22%;">Default command for the -x
parameter which allows using -x without an argument.</p>


<p style="margin-left:11%; margin-top: 1em"><b>Classification
<br>
BROWSER_REGEX=www|http</b></p>

<p style="margin-left:22%;">The regular expression which
identifies annotations openable by BROWSER.</p>


<p style="margin-left:11%;"><b>FILE_REGEX=&quot;\.|\/|~&quot;</b></p>

<p style="margin-left:22%;">The regular expression that
identifies file paths in annotations which will be opened by
EDITOR or xdg-open.</p>

<p style="margin-left:11%;"><b>TEXT_REGEX</b></p>

<p style="margin-left:22%;">This regular expression
identifies annotations that can be edited in raw mode (see
&rsquo;-r&rsquo;). If set and no other regular expression
matches the annotation, the EDITOR will be invoked to edit
the annotation.</p>

<p style="margin-left:11%;"><b>CUSTOM1_REGEX</b></p>

<p style="margin-left:22%;">The regular expression that
identifies annotations openable by CUSTOM1_CMD.</p>

<p style="margin-left:11%;"><b>CUSTOM1_CMD</b></p>

<p style="margin-left:22%;">The command with which
annotations matching CUSTOM1_REGEX will be opened. You may
use the following environment variables: $FILE, $UUID, $ID,
$LABEL and $ANNOTATION. By Default, the value of $FILE will
be appended to the command. See <b>taskopen</b>(1) for
further details.</p>

<p style="margin-left:11%;"><b>CUSTOM[0-9]+_REGEX</b></p>

<p style="margin-left:22%;">see CUSTOM1_REGEX</p>

<p style="margin-left:11%;"><b>CUSTOM[0-9]+_CMD</b></p>

<p style="margin-left:22%;">see CUSTOM1_CMD</p>

<p style="margin-left:11%;"><b>NO_ANNOTATION_HOOK</b></p>

<p style="margin-left:22%;">Execute an arbitrary script if
there is no annotation found. The corresponding taskwarrior
IDs will be passed as arguments, e.g. &quot;attach.sh 21
42&quot;</p>

<p style="margin-left:11%;"><b>TASK_ATTRIBUTES</b></p>

<p style="margin-left:22%;">Add arbitrary taskwarrior
attributes (comma separated) as sort keys and environment
variables for use within user commands. In order to prevent
name conflicts, the corresponding sort keys are preceded by
&quot;task_&quot; (e.g. &quot;task_project&quot;).
Environment variables are additionally in upper case (e.g.
TASK_PROJECT).</p>

<h2>EXAMPLES
<a name="EXAMPLES"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em"><b>Using the
notes.vim plugin for Notes files <br>
NOTES_FOLDER=$HOME/Notes/vimnotes <br>
NOTES_EXT=&quot;&quot; <br>
NOTES_CMD=&quot;vim -c &quot;:Note $UUID&quot;&quot;</b></p>

<p style="margin-left:22%; margin-top: 1em">The notes.vim
plugin can be found at
<i>&lt;http://peterodding.com/code/vim/notes/&gt;</i></p>

<p style="margin-left:11%; margin-top: 1em"><b>Link to mutt
emails <br>
CUSTOM1_REGEX=Message-[iI][dD]:|message: <br>
CUSTOM1_CMD=&quot;echo &quot;$FILE&quot; |
muttjump&quot;</b></p>

<p style="margin-left:22%; margin-top: 1em">Thanks to
Jostein Berntsen, the old bash version of taskopen had
support for linking to your emails by using mutt. This
feature can still be enabled by setting the CUSTOM1_REGEX
and CUSTOM1_CMD appropriately, given that taskopen&rsquo;s
PATH contains the path to the corresponding helper scripts
(see PATH_EXT).</p>

<p style="margin-left:22%; margin-top: 1em">Taskopen then
uses muttjump to open the mutt mailboxes natively or in a
screen window (very quick and effective). The muttjump can
be found at
<i>&lt;https://github.com/weisslj/muttjump&gt;</i></p>

<p style="margin-left:11%; margin-top: 1em"><b>Integrating
user-defined attributes (UDAs) <br>
TASK_ATTRIBUTES=url,costs <br>
CUSTOM1_REGEX=URL <br>
CUSTOM1_CMD=&quot;xdg-open $TASK_URL&quot; <br>
DEFAULT_SORT=&quot;task_costs-,id+&quot;</b></p>

<p style="margin-left:22%; margin-top: 1em">You can make
taskopen agnostic to any taskwarrior attributes by adding
them to TASK_ATTRIBUTES. This enables the use of these
attributes within user commands (see taskopen (1)) or as
sort keys.</p>

<h2>CREDITS &amp; COPYRIGHTS
<a name="CREDITS &amp; COPYRIGHTS"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em">Copyright (C)
<<<<<<< HEAD
2010 &minus; 2014, J. Schlatow</p>
=======
2010 &minus; 2016, J. Schlatow</p>
>>>>>>> devel

<p style="margin-left:11%; margin-top: 1em">Taskopen is
distributed under the GNU General Public License. See
<i>http://www.opensource.org/licenses/gpl-2.0.php</i> for
more information.</p>

<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em"><b>taskopen</b>(1)</p>

<p style="margin-left:11%; margin-top: 1em">For more
information regarding taskopen, see the following: <br>
The official site at</p>


<p style="margin-left:22%;"><i>&lt;https://github.com/ValiValpas/taskopen/&gt;</i></p>

<p style="margin-left:11%;">The official code repository
at</p>


<p style="margin-left:22%;"><i>&lt;git://github.com/ValiValpas/taskopen.git&gt;</i></p>

<h2>REPORTING BUGS
<a name="REPORTING BUGS"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em">Bugs in
taskopen may be reported to the issue-tracker at</p>


<p style="margin-left:22%;"><i>&lt;https://github.com/ValiValpas/taskopen/issues&gt;</i></p>
<hr>
</body>
</html>
