NAME

       w2do - a simple text-based todo manager

SYNOPSIS

       w2do [-l] [-t task] [-g group] [-d date] [-p priority] [-f|-u]

       w2do -a task [-g group] [-d date] [-p priority] [-f|-u]

       w2do -c id [-t task] [-g group] [-d date] [-p priority] [-f|-u]

       w2do -r id

       w2do [options]

DESCRIPTION

       w2do is a simple to use yet efficient command-line todo manager written in Perl.

OPTIONS

   General Options
       -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.

       -a task, --add task
           Add new item with selected task name to the task list. When no additional specifying
           options are given, the group general, the due date anytime and the priority 3 is used
           by default and the task is marked as unfinished.

       -c id, --change id
           Change item with selected id in the task list. Further specifying options are required
           in order to take any effect.

       -r id, --remove id
           Remove item with selected id from the task list.

       --change-group group
           Change all items in the selected group. Further specifying options are required in
           order to take any effect.

       --remove-group group
           Remove all items from the selected group.

       --purge-group group
           Remove all finished items from the selected group.

       --change-date date
           Change all items with selected due date. Further specifying options are required in
           order to take any effect.

       --remove-date date
           Remove all items with selected due date.

       --purge-date date
           Remove all finished items with selected due date.

       --change-pri priority
           Change all items with selected priority. Further specifying options are required in
           order to take any effect.

       --remove-pri priority
           Remove all items with selected priority.

       --purge-pri priority
           Remove all finished items with selected priority.

       --change-old
           Change all items with passed due date. Further specifying options are required in
           order to take any effect.

       --remove-old
           Remove all items with passed due date.

       --purge-old
           Remove all finished items with passed due date.

       --change-all
           Change all items in the task list. Further specifying options are required in order to
           take any effect.

       --remove-all
           Remove all items from the task list.

       --purge-all
           Remove all finished items from the task list.

       --undo
           Revert last action. When invoked, the data are restored from the backup file (i.e.
           "~/.w2do.bak" by default), which is deleted at the same time.

       --groups
           Display comma-delimited list of all groups in the task list.

       --stats
           Display detailed task list statistics.

       -h, --help
           Display help message and exit.

       -v, --version
           Display version information and exit.

   Specifying Options
       -t task, --task task
           Specify the task name.

       -g group, --group group
           Specify the group name. The group name should be a single word with maximum of 10
           characters, but longer names are shortened automatically.

       -d date, --date date
           Specify the due date. Available options are anytime, today, yesterday, tomorrow,
           month, year, or an exact date in the YYYY-MM-DD format, e.g. 2008-06-17 for 17 June
           2008.

       -p priority, --priority priority
           Specify the priority. Available options are integers between 1 and 5, where 1
           represents the highest priority.

       -f, --finished
           Specify the finished task.

       -u, --unfinished
           Specify the unfinished task.

   Additional Options
       -s file, --savefile file
           Use selected file instead of the default "~/.w2do" as a save file.

       -w width, --width width
           Use selected line width; the minimal value is 75.

       -q, --quiet
           Avoid displaying messages that are not necessary.

       -V, --verbose
           Display all messages; this is the default option.

       -C, --colour, --color
           Use coloured output instead of the default plain text version.

       -X, --no-colour, --no-color
           Use plain text output (no colours); this is the default option.

       -b, --bare
           Do not display table header and group separators.

       -B, --no-bare
           Display table header and group separators; the default option.

       -I, --no-id
           Do not display ID column in the listing.

       --with-id
           Display ID column in the listing; the default option.

       -G, --no-group
           Do not display group column in the listing.

       --with-group
           Display group column in the listing; the default option.

       -D, --no-date
           Do not display due date column in the listing.

       --with-date
           Display due date column in the listing; the default option.

       -P, --no-priority
           Do not display priority column in the listing.

       --with-priority
           Display priority column in the listing; the default option.

       -S, --no-state
           Do not display state column in the listing.

       --with-state
           Display state column in the listing; the default option.

ENVIRONMENT

       W2DO_SAVEFILE
           Use selected file instead of the default "~/.w2do" as a save file.

       W2DO_WIDTH
           Use selected line width; the minimal value is 75.

FILES

       ~/.w2do
           Default save file.

       ~/.w2do.bak
           Default backup file.

SEE ALSO

       w2html(1), w2text(1), perl(1).

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.

AUTHOR

       Written by Jaromir Hradilek <jhradilek@gmail.com>.

       Permission is granted to copy, distribute and/or modify this document under the terms of
       the GNU 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.

       A copy of the license is included as a file called FDL in the main directory of the w2do
       source package.

COPYRIGHT

       Copyright (C) 2008, 2009, 2010 Jaromir Hradilek

       This program is free software; see the source for copying conditions. It is distributed in
       the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
       warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.