.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "W2DO 1"
.TH W2DO 1 "2018-12-28" "Version 2.3.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
w2do \- a simple text\-based todo manager
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBw2do\fR [\fB\-l\fR] [\fB\-t\fR \fItask\fR] [\fB\-g\fR \fIgroup\fR] [\fB\-d\fR \fIdate\fR] [\fB\-p\fR
\&\fIpriority\fR] [\fB\-f\fR|\fB\-u\fR]
.PP
\&\fBw2do\fR \fB\-a\fR \fItask\fR [\fB\-g\fR \fIgroup\fR] [\fB\-d\fR \fIdate\fR] [\fB\-p\fR \fIpriority\fR]
[\fB\-f\fR|\fB\-u\fR]
.PP
\&\fBw2do\fR \fB\-c\fR \fIid\fR [\fB\-t\fR \fItask\fR] [\fB\-g\fR \fIgroup\fR] [\fB\-d\fR \fIdate\fR] [\fB\-p\fR
\&\fIpriority\fR] [\fB\-f\fR|\fB\-u\fR]
.PP
\&\fBw2do\fR \fB\-r\fR \fIid\fR
.PP
\&\fBw2do\fR [\fIoptions\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBw2do\fR is a simple to use yet efficient command-line todo manager written
in Perl.
.SH "OPTIONS"
.IX Header "OPTIONS"
.SS "General Options"
.IX Subsection "General Options"
.IP "\fB\-l\fR, \fB\-\-list\fR" 4
.IX Item "-l, --list"
Display items in the task list. All tasks are listed by default, but
desired subset can be easily selected via specifying options as well. Since
listing is the default action, this option can be safely omitted.
.IP "\fB\-a\fR \fItask\fR, \fB\-\-add\fR \fItask\fR" 4
.IX Item "-a task, --add task"
Add new item with selected \fItask\fR name to the task list. When no
additional specifying options are given, the group \fBgeneral\fR, the due date
\&\fBanytime\fR and the priority \fB3\fR is used by default and the task is marked
as unfinished.
.IP "\fB\-c\fR \fIid\fR, \fB\-\-change\fR \fIid\fR" 4
.IX Item "-c id, --change id"
Change item with selected \fIid\fR in the task list. Further specifying
options are required in order to take any effect.
.IP "\fB\-r\fR \fIid\fR, \fB\-\-remove\fR \fIid\fR" 4
.IX Item "-r id, --remove id"
Remove item with selected \fIid\fR from the task list.
.IP "\fB\-\-change\-group\fR \fIgroup\fR" 4
.IX Item "--change-group group"
Change all items in the selected \fIgroup\fR. Further specifying options are
required in order to take any effect.
.IP "\fB\-\-remove\-group\fR \fIgroup\fR" 4
.IX Item "--remove-group group"
Remove all items from the selected \fIgroup\fR.
.IP "\fB\-\-purge\-group\fR \fIgroup\fR" 4
.IX Item "--purge-group group"
Remove all finished items from the selected \fIgroup\fR.
.IP "\fB\-\-change\-date\fR \fIdate\fR" 4
.IX Item "--change-date date"
Change all items with selected due \fIdate\fR. Further specifying options are
required in order to take any effect.
.IP "\fB\-\-remove\-date\fR \fIdate\fR" 4
.IX Item "--remove-date date"
Remove all items with selected due \fIdate\fR.
.IP "\fB\-\-purge\-date\fR \fIdate\fR" 4
.IX Item "--purge-date date"
Remove all finished items with selected due \fIdate\fR.
.IP "\fB\-\-change\-pri\fR \fIpriority\fR" 4
.IX Item "--change-pri priority"
Change all items with selected \fIpriority\fR. Further specifying options are
required in order to take any effect.
.IP "\fB\-\-remove\-pri\fR \fIpriority\fR" 4
.IX Item "--remove-pri priority"
Remove all items with selected \fIpriority\fR.
.IP "\fB\-\-purge\-pri\fR \fIpriority\fR" 4
.IX Item "--purge-pri priority"
Remove all finished items with selected \fIpriority\fR.
.IP "\fB\-\-change\-old\fR" 4
.IX Item "--change-old"
Change all items with passed due date. Further specifying options are
required in order to take any effect.
.IP "\fB\-\-remove\-old\fR" 4
.IX Item "--remove-old"
Remove all items with passed due date.
.IP "\fB\-\-purge\-old\fR" 4
.IX Item "--purge-old"
Remove all finished items with passed due date.
.IP "\fB\-\-change\-all\fR" 4
.IX Item "--change-all"
Change all items in the task list. Further specifying options are required
in order to take any effect.
.IP "\fB\-\-remove\-all\fR" 4
.IX Item "--remove-all"
Remove all items from the task list.
.IP "\fB\-\-purge\-all\fR" 4
.IX Item "--purge-all"
Remove all finished items from the task list.
.IP "\fB\-\-undo\fR" 4
.IX Item "--undo"
Revert last action. When invoked, the data are restored from the backup
file (i.e. \f(CW\*(C`~/.w2do.bak\*(C'\fR by default), which is deleted at the same time.
.IP "\fB\-\-groups\fR" 4
.IX Item "--groups"
Display comma-delimited list of all groups in the task list.
.IP "\fB\-\-stats\fR" 4
.IX Item "--stats"
Display detailed task list statistics.
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
Display help message and exit.
.IP "\fB\-v\fR, \fB\-\-version\fR" 4
.IX Item "-v, --version"
Display version information and exit.
.SS "Specifying Options"
.IX Subsection "Specifying Options"
.IP "\fB\-t\fR \fItask\fR, \fB\-\-task\fR \fItask\fR" 4
.IX Item "-t task, --task task"
Specify the \fItask\fR name.
.IP "\fB\-g\fR \fIgroup\fR, \fB\-\-group\fR \fIgroup\fR" 4
.IX Item "-g group, --group group"
Specify the \fIgroup\fR name. The group name should be a single word with
maximum of 10 characters, but longer names are shortened automatically.
.IP "\fB\-d\fR \fIdate\fR, \fB\-\-date\fR \fIdate\fR" 4
.IX Item "-d date, --date date"
Specify the due \fIdate\fR. Available options are \fBanytime\fR, \fBtoday\fR,
\&\fByesterday\fR, \fBtomorrow\fR, \fBmonth\fR, \fByear\fR, or an exact date in the
YYYY-MM-DD format, e.g. 2008\-06\-17 for 17 June 2008.
.IP "\fB\-p\fR \fIpriority\fR, \fB\-\-priority\fR \fIpriority\fR" 4
.IX Item "-p priority, --priority priority"
Specify the \fIpriority\fR. Available options are integers between \fB1\fR and
\&\fB5\fR, where 1 represents the highest priority.
.IP "\fB\-f\fR, \fB\-\-finished\fR" 4
.IX Item "-f, --finished"
Specify the finished task.
.IP "\fB\-u\fR, \fB\-\-unfinished\fR" 4
.IX Item "-u, --unfinished"
Specify the unfinished task.
.SS "Additional Options"
.IX Subsection "Additional Options"
.IP "\fB\-s\fR \fIfile\fR, \fB\-\-savefile\fR \fIfile\fR" 4
.IX Item "-s file, --savefile file"
Use selected \fIfile\fR instead of the default \f(CW\*(C`~/.w2do\*(C'\fR as a save file.
.IP "\fB\-w\fR \fIwidth\fR, \fB\-\-width\fR \fIwidth\fR" 4
.IX Item "-w width, --width width"
Use selected line \fIwidth\fR; the minimal value is \fB75\fR.
.IP "\fB\-q\fR, \fB\-\-quiet\fR" 4
.IX Item "-q, --quiet"
Avoid displaying messages that are not necessary.
.IP "\fB\-V\fR, \fB\-\-verbose\fR" 4
.IX Item "-V, --verbose"
Display all messages; this is the default option.
.IP "\fB\-C\fR, \fB\-\-colour\fR, \fB\-\-color\fR" 4
.IX Item "-C, --colour, --color"
Use coloured output instead of the default plain text version.
.IP "\fB\-X\fR, \fB\-\-no\-colour\fR, \fB\-\-no\-color\fR" 4
.IX Item "-X, --no-colour, --no-color"
Use plain text output (no colours); this is the default option.
.IP "\fB\-b\fR, \fB\-\-bare\fR" 4
.IX Item "-b, --bare"
Do not display table header and group separators.
.IP "\fB\-B\fR, \fB\-\-no\-bare\fR" 4
.IX Item "-B, --no-bare"
Display table header and group separators; the default option.
.IP "\fB\-I\fR, \fB\-\-no\-id\fR" 4
.IX Item "-I, --no-id"
Do not display \s-1ID\s0 column in the listing.
.IP "\fB\-\-with\-id\fR" 4
.IX Item "--with-id"
Display \s-1ID\s0 column in the listing; the default option.
.IP "\fB\-G\fR, \fB\-\-no\-group\fR" 4
.IX Item "-G, --no-group"
Do not display group column in the listing.
.IP "\fB\-\-with\-group\fR" 4
.IX Item "--with-group"
Display group column in the listing; the default option.
.IP "\fB\-D\fR, \fB\-\-no\-date\fR" 4
.IX Item "-D, --no-date"
Do not display due date column in the listing.
.IP "\fB\-\-with\-date\fR" 4
.IX Item "--with-date"
Display due date column in the listing; the default option.
.IP "\fB\-P\fR, \fB\-\-no\-priority\fR" 4
.IX Item "-P, --no-priority"
Do not display priority column in the listing.
.IP "\fB\-\-with\-priority\fR" 4
.IX Item "--with-priority"
Display priority column in the listing; the default option.
.IP "\fB\-S\fR, \fB\-\-no\-state\fR" 4
.IX Item "-S, --no-state"
Do not display state column in the listing.
.IP "\fB\-\-with\-state\fR" 4
.IX Item "--with-state"
Display state column in the listing; the default option.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
.IP "\fBW2DO_SAVEFILE\fR" 4
.IX Item "W2DO_SAVEFILE"
Use selected file instead of the default \f(CW\*(C`~/.w2do\*(C'\fR as a save file.
.IP "\fBW2DO_WIDTH\fR" 4
.IX Item "W2DO_WIDTH"
Use selected line width; the minimal value is \fB75\fR.
.SH "FILES"
.IX Header "FILES"
.IP "\fI~/.w2do\fR" 4
.IX Item "~/.w2do"
Default save file.
.IP "\fI~/.w2do.bak\fR" 4
.IX Item "~/.w2do.bak"
Default backup file.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBw2html\fR(1), \fBw2text\fR(1), \fBperl\fR(1).
.SH "BUGS"
.IX Header "BUGS"
To report bugs or even send patches, you can either add new issue to the
project bugtracker at <http://code.google.com/p/w2do/issues/>, visit the
discussion group at <http://groups.google.com/group/w2do/>, or you can
contact the author directly via e\-mail.
.SH "AUTHOR"
.IX Header "AUTHOR"
Written by Jaromir Hradilek <jhradilek@gmail.com>.
.PP
Permission is granted to copy, distribute and/or modify this document under
the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3 or any later
version published by the Free Software Foundation; with no Invariant
Sections, no Front-Cover Texts, and no Back-Cover Texts.
.PP
A copy of the license is included as a file called \s-1FDL\s0 in the main
directory of the w2do source package.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2008, 2009, 2010 Jaromir Hradilek
.PP
This program is free software; see the source for copying conditions. It is
distributed in the hope that it will be useful, but \s-1WITHOUT ANY WARRANTY\s0;
without even the implied warranty of \s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A
PARTICULAR PURPOSE.\s0