<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<article lang="en">
<articleinfo>
    <title>conics &#8212; console iCalendar tool</title>
    <date>Sat, 08 Nov 2008 14:03:54 +0300</date>
    <author>
        <firstname>Pavel</firstname>
        <surname>Shramov</surname>
        <affiliation><address><email>shramov_at_mexmat.net</email></address></affiliation>
    </author>
    <authorinitials>PS</authorinitials>

<revhistory><revision><revnumber>0.0.13</revnumber><date>Sat, 08 Nov 2008 14:03:54 +0300</date><authorinitials>PS</authorinitials></revision></revhistory>

</articleinfo>
<section>
<title>What is it?</title>
<simpara><literal>conics</literal> is a simple console todo manager inspired by <xref linkend="devtodo"/>. Main
feautures are</simpara>

<itemizedlist>
<listitem>
<simpara>
iCalendar files as backend storage <xref linkend="rfc2445"/>
</simpara>
</listitem>
<listitem>
<simpara>
linking different todo files (remote over http[s] are also supported)
</simpara>
</listitem>
<listitem>
<simpara>
hierarchical todo list
</simpara>
</listitem>
</itemizedlist>
<simpara>Up-to-date version of this manual is located at
<ulink url="http://grid.pp.ru/wiki/conics">http://grid.pp.ru/wiki/conics</ulink>.</simpara>

<simpara>Feel free to contact me (Pavel Shramov &lt;shramov_at_mexmat.net&gt;) if You have suggestions.</simpara>

</section>
<section>
<title>Why one more?</title>
<simpara>Reason is very simple &#8212; I've not found any console tool compatible with GUI
tools like Mozilla or korganizer. One of the best tools <xref linkend="devtodo"/> lacks many
features like compatibility and remote lists. Also it's very hard to improve it
since it's written in C++ . So goal was to reimplement devtodo's functionality
(at least part of it) in python with iCalendar backend.</simpara>

</section>
<section>
<title>Links</title>
<simpara>Links are implemented as extension of <literal>VTODO</literal> nodes of calendar. <literal>X-REMOTE-URI</literal>
property if found is treated as link to another file. This scheme was
chosen so other iCal tools show this as simple todo task. <literal>link</literal> command also
sets description equal to <literal>X-REMOTE-URI</literal> field. Since link is a todo item all
operations with it are possible &#8212; changing priority, description, etc.</simpara>

</section>
<section>
<title>Quickstart</title>
<simpara>Install <literal>conics</literal></simpara>

<literallayout class="monospaced">apt-get install conics</literallayout>
<simpara>or pickup last version from <ulink url="http://grid.pp.ru/egg/conics/">http://grid.pp.ru/egg/conics/</ulink></simpara>

<simpara>Add task</simpara>

<literallayout class="monospaced">conics add --prio veryhigh 'Sample task'
Long description (end with ^D): some description</literallayout>
<simpara>Add conics todo list from git</simpara>

<literallayout class="monospaced">conics link --title 'conics todo' \
'http://grid.pp.ru/git/?p=psha/conics/.git;a=blob_plain;f=.todo.ics;hb=master'</literallayout>
<simpara>or watch it directly</simpara>

<literallayout class="monospaced">conics show \
'http://grid.pp.ru/git/?p=psha/conics/.git;a=blob_plain;f=.todo.ics;hb=master'</literallayout>
<simpara>Watch what you've got</simpara>

<literallayout class="monospaced">conics</literallayout>
<simpara><literal>show</literal> is default action when nothing else is specified or when first arg is
option. Other commands may be found with <literal>conics help</literal>. Options for each command
are available with <literal>-h</literal> flag e.g. <literal>conics link -h</literal>.</simpara>

</section>
<section>
<title>Roadmap</title>
<simpara>Current todo list is available from git repo at
<ulink url="http://grid.pp.ru/git/?p=psha/conics/.git;a=blob_plain;f=.todo.ics;hb=master">http://grid.pp.ru/git/?p=psha/conics/.git;a=blob_plain;f=.todo.ics;hb=master</ulink></simpara>

<simpara>or in text form at
<ulink url="http://grid.pp.ru/git/?p=psha/conics/.git;a=blob_plain;f=TODO;hb=HEAD">http://grid.pp.ru/git/?p=psha/conics/.git;a=blob_plain;f=TODO;hb=HEAD</ulink></simpara>

</section>
<section>
<title>Source</title>
<simpara>Available from</simpara>

<itemizedlist>
<listitem>
<simpara>
git: <ulink url="git://grid.pp.ru/psha/conics">git://grid.pp.ru/psha/conics</ulink>
</simpara>
</listitem>
<listitem>
<simpara>
gitweb: <ulink url="http://grid.pp.ru/git/?p=psha/conics/.git">http://grid.pp.ru/git/?p=psha/conics/.git</ulink>
</simpara>
</listitem>
<listitem>
<simpara>
debian package: <ulink url="http://grid.pp.ru/debian/">http://grid.pp.ru/debian/</ulink>
</simpara>
</listitem>
</itemizedlist>
</section>
<section>
<title>Reference</title>
<bibliomixed>
<bibliomisc>
<anchor id="devtodo" xreflabel="[devtodo]"/>[devtodo] <ulink url="http://swapoff.org/DevTodo/">http://swapoff.org/DevTodo/</ulink>
</bibliomisc>
</bibliomixed>
<bibliomixed>
<bibliomisc>
<anchor id="icalendar" xreflabel="[icalendar]"/>[icalendar] <ulink url="http://codespeak.net/icalendar/">http://codespeak.net/icalendar/</ulink>
</bibliomisc>
</bibliomixed>
<bibliomixed>
<bibliomisc>
<anchor id="rfc2445" xreflabel="[rfc2445]"/>[rfc2445] <ulink url="http://www.ietf.org/rfc/rfc2445.txt">http://www.ietf.org/rfc/rfc2445.txt</ulink>
</bibliomisc>
</bibliomixed>
</section>
</article>
