<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<refentry>
<refmeta>
<refentrytitle>conics</refentrytitle>
<manvolnum>1</manvolnum>
</refmeta>
<refnamediv>
    <refname>conics</refname>
    <refpurpose>console tool to deal with iCalendar (ics) files</refpurpose>
</refnamediv>
<refsynopsisdiv>
<literallayout><emphasis>conics</emphasis> [options] [subcommand] [subcommand-options]</literallayout>
<simpara>Defaults subcommand is <emphasis>show</emphasis> so invocation of <emphasis>conics</emphasis> without any
arguments is equal to <emphasis>conics show</emphasis></simpara>

</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
<simpara>TBA</simpara>

</refsect1>
<refsect1>
<title>OPTIONS</title>
<variablelist>
<varlistentry>
<term>
-c CALENDAR, --calendar=CALENDAR
</term>
<listitem>
<simpara>
    Use CALENDAR instead of default one
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-l, --local
</term>
<listitem>
<simpara>
    Follow only local links
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-f, --force
</term>
<listitem>
<simpara>
    Force refresh of cache files
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-v, --version
</term>
<listitem>
<simpara>
    Print version and exit
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>SUBCOMMANDS</title>
<refsect2>
<title>add</title>
<simpara>Add new item</simpara>

<variablelist>
<varlistentry>
<term>
-p PRIO, --prio=PRIO
</term>
<listitem>
<simpara>
    Set priority to PRIO (one of veryhigh, high, medium, low, verylow)
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-u UNDER, --under=UNDER
</term>
<listitem>
<simpara>
    Create new item under parent. Format is id.id.id
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2>
<title>edit</title>
<simpara>Edit item</simpara>

<variablelist>
<varlistentry>
<term>
-p PRIO, --prio=PRIO
</term>
<listitem>
<simpara>
    Set priority to PRIO (one of veryhigh, high, medium, low, verylow)
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-D, --done
</term>
<listitem>
<simpara>
    Mark item as done
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-P DONE, --percent=DONE
</term>
<listitem>
<simpara>
    Set percents complete to PERCENT (number between 0 and 100)
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2>
<title>export</title>
<simpara>Export todo in iCalendar format</simpara>

<variablelist>
<varlistentry>
<term>
-d DEPTH, --depth=DEPTH
</term>
<listitem>
<simpara>
    Follow DEPTH levels of links (-1 for infinite)
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2>
<title>help</title>
<simpara>List commands with short description</simpara>

</refsect2>
<refsect2>
<title>import</title>
<simpara>Import todo from iCalendar
Reads ics data from stdin and creates new node with it</simpara>

<variablelist>
<varlistentry>
<term>
-r, --replace
</term>
<listitem>
<simpara>
    Overwrite old entries on import
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-u UNDER, --under=UNDER
</term>
<listitem>
<simpara>
    Create new item under parent. Format is id.id.id
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2>
<title>init</title>
<simpara>Create empty ics file</simpara>

<variablelist>
<varlistentry>
<term>
--stdout
</term>
<listitem>
<simpara>
    Write to stdout instead of file
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
--touch
</term>
<listitem>
<simpara>
    Don't complain when file exists
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2>
<title>link</title>
<simpara>Add another ics under item</simpara>

<variablelist>
<varlistentry>
<term>
-t TITLE, --title=TITLE
</term>
<listitem>
<simpara>
    Set title to TITLE
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-p PRIO, --prio=PRIO
</term>
<listitem>
<simpara>
    Set priority to PRIO (one of veryhigh, high, medium, low, verylow)
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-u UNDER, --under=UNDER
</term>
<listitem>
<simpara>
    Create new item under parent. Format is id.id.id
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2>
<title>show</title>
<simpara>Show calendar (default action)</simpara>

<variablelist>
<varlistentry>
<term>
-a, --all
</term>
<listitem>
<simpara>
    Show done tasks too
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-f FORMAT, --format=FORMAT
</term>
<listitem>
<simpara>
    Use FORMAT function for printing
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-d DEPTH, --depth=DEPTH
</term>
<listitem>
<simpara>
    Follow DEPTH levels of links (-1 for infinite)
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsect1>
<refsect1>
<title>EXAMPLES</title>
<simpara>Print conics todo list direct from git repository</simpara>

<screen>$ conics show 'http://grid.pp.ru/git/?p=psha/conics/.git;a=blob_plain;f=.todo.ics;hb=master'</screen>
</refsect1>
<refsect1>
<title>ENVIRONMENT VARIABLES</title>
<simpara>Does not rely on any.</simpara>

</refsect1>
<refsect1>
<title>SEE ALSO</title>
<simpara><ulink url="http://grid.pp.ru/wiki/conics">http://grid.pp.ru/wiki/conics</ulink></simpara>

</refsect1>
<refsect1>
<title>Author</title>
<simpara>Pavel Shramov &lt;shramov@mexmat.net&gt;</simpara>

</refsect1>
</refentry>
