Release date for 1.9.1

- Fixed incorrect regex in hook format unit tests.  Note that this
  doesn't show up in the tinderbox, because that version of task is
  not built with Lua support.

.gitignore

@@ -5,10 +5,15 @@ config.h.in
 config.status
 src/.deps
 src/Makefile
-*/task
+*/*task
 stamp-h1
 Makefile
+Makefile.in
 configure
 config.log
 www.xls
+src/tests/all.log
+src/tests/*.data
 *~
+.*.swp
+package-config/osx/binary/task

AUTHORS

@@ -1,7 +1,11 @@
-Principal Author:
-  Paul Beckingham, paul@beckingham.net
+The development of task was made possible by the significant contributions of the following people:
+  Paul Beckingham    (Principal Author)
+  Federico Hernandez (Package Maintainer & Contributing Author)
+  David J Patrick    (Designer)
+  John Florian       (Contributing Author)
+  Cory Donnelly      (Contributing Author)
 
-Contributing Authors:
+The following submitted code, packages or analysis, and deserve special thanks:
   Damian Glenny
   Andy Lester
   H. İbrahim Güngör
@@ -10,9 +14,16 @@ Contributing Authors:
   Benjamin Tegarden
   Chris Pride
   Richard Querin
-  Federico Hernandez
+  T. Charles Yun
+  P.C. Shyamshankar
+  Johan Friis
+  Steven de Brouwer
+  Pietro Cerutti
+  Alexander Neumann
+  Emil Sköldberg
+  Johannes Schlatow
 
-With thanks to:
+Thanks to the following, who submitted detailed bug reports and excellent suggestions:
   Eugene Kramer
   Srijith K
   Bruce Israel
@@ -21,7 +32,6 @@ With thanks to:
   galvanizd
   Stas Antons
   Vincent Fleuranceau
-  T. Charles Yun
   ArchiMark
   Carlos Yoder
   Russell Friesenhahn
@@ -29,4 +39,13 @@ With thanks to:
   Eric Farris
   Bruce Dillahunty
   Askme Too
+  Mike Adonay
+  Thomas@BIC
+  Ian Mortimer
+  Zach Frazier
+  Ivo Jimenez
+  Joe Pulliam
+  Juergen Daubert
+  Rich Mintz
+  Seneca Cunningham
 

ChangeLog

@@ -1,7 +1,339 @@
 
 ------ current release ---------------------------
 
-1.6.0 (4/12/2009)
+1.9.1 (5/22/2010)
+ + Summary report bar colors can now be specified with color.summary.bar
+   and color.summary.background configuration variables.
+ + The 'edit' command now conveniently fills in the current date for new
+   annotations.
+ + Deleting a task no longer clobbers any recorded end date (thanks to
+   Seneca Cunningham).
+ + The following holidays are now computed automatically and can be used
+   in the definitions for the calendar holidays:
+   Good Friday (goodfriday), Easter (easter), Easter monday
+   (eastermonday), Ascension (ascension), Pentecost (pentecost)
+   The date is configured with the given keyword.
+ + The configure script is more portable (thanks to Emil Sköldberg).
+ + Updated task-faq.5 man page.
+ + Fixed bug #382 in which the annotate command didn't return an error
+   message when called without an ID.
+ + Fixed bug #402 which failed compilation on Arch Linux (thanks to
+   Johannes Schlatow).
+ + Fixed bug #401 that ignored the search.case.sensitive configuration
+   setting when filtering on project names (thanks to John Florian).
+ + Fixed bug #395 that prevented the upgrade of a pending task to a
+   recurring task (thanks to T. Charles Yun).
+
+------ old releases ------------------------------
+
+1.9.0 (2/22/2010) dd758f8b33de110a633e2ff3ebdac73232b8ff44
+ + Added feature #283 that makes it possible to control the verbosity
+   of the output of annotations.
+ + Added feature #254 (#295) which gives task a second date format to be
+   used in the reports with more conversion sequences like weekday name
+   or weeknumber. The date format is set with variable "dateformat.report".
+ + Added feature #292 that permits alternate line coloration in reports
+   (thanks to Richard Querin).
+ + Added feature #307 that provides vim with syntax highlighting for .taskrc.
+ + Added feature #336 which gives task a 'prepend' command for symmetry
+   with the 'append' command.
+ + Added feature #341 that makes explicit references to the task and taskrc
+   man pages, both in the auto-generated .taskrc file and the version command
+   output (thanks to Cory Donnelly).
+ + The 'delete' command is now aliased to 'rm' (thanks to Ivo Jimenez).
+ + Added new attribute modifiers 'word' and 'noword' which find the existence
+   of whole words, or prove the non-existence of whole words.  If a task has
+   the description "Pay the bill", then "description.word:the" will match, but
+   "description.word:th" will not.  For partial word matches, there is still
+   "description.contains:th".
+ + Added new 'config' command to display the configuration settings of task.
+   As a consequence 'version' now only shows the version number and legal
+   information.
+ + The 'config' command now complains about use of deprecated color names in
+   your .taskrc file.
+ + Added feature #296, that allows the 'config' command to modify your .taskrc
+   settings directly, with the command 'task config <name> <value>', or
+   'task config <name>' to remove the setting.
+ + Task now supports nested .taskrc files using the "include /path" directive.
+ + The 'entry', 'start' and 'end' columns now have equivalents that include the
+   time, and are called 'entry_time', 'start_time', and 'end_time', for use in
+   custom reports.
+ + 2 new columns have been added to the reports: countdown and
+   countdown_compact.  They show the days left until a task is due or how many
+   days a task has been overdue.
+ + The new 'priority_long' field can be shown in custom reports, and will
+   display 'High' rather than the abbreviated 'H'.
+ + Task now supports .taskrc command line overrides using rc.name:value and
+   the new rc.name=value to accommodate a frequent mistake.
+ + The color rules for projects (color.project.foo) now matches on partial
+   project names, the same way as filters.
+ + The color command now takes a color as an argument, and displays that color
+   with sample text.
+ + Added 2 new configuration variables to display the details of tasks with due
+   dates when doing a 'task cal' for the corresponding months:
+   'calendar.details' and 'calendar.details.report'
+ + Added 5 new color configuration variables to colorize today, days with due
+   tasks, days with overdue tasks, weekend days and week numbers in the
+   calendar:
+   'calendar.color.today', 'color.calendar.due', 'calendar.calendar.overdue',
+   'color.calendar.weekend'and 'color.calendar.weeknumber'.
+ + Added support for holidays in the calendar by using calendar.holidays
+   and the corresponding holiday.X.name and holiday.X.date variables.
+   The default dateformat being YMD (20101224) set by dateformat.holiday.
+ + The coloring of due tasks in reports can now be enabled for all tasks, and
+   not only the imminent ones, by setting the configuration variable due=0.
+ + Tasks due on the current day ("today") can now have their own color setting
+   color.due.today and color.calendar.due.today.
+ + Added a new 'task-faq' man page for common questions and answers.
+ + Added a new 'task-color' man page detailing how to set up and use color in
+   task.
+ + Added feature #176, which allows for configurable case-sensitivity for
+   keyword searches and substitutions (thanks to John Florian).
+ + Task can now use an alternate tag indicator by setting the tag.indicator
+   configuration variable to something other than the default of +.
+ + Task can now use an alternate active indicator by setting the
+   active.indicator configuration variable to something other than the default
+   of *.
+ + Task can now use an alternate recurrence indicator by setting the
+   recurrence.indicator configuration variable to something other than the
+   default of R.
+ + Added a new file, README.build, which provides assistance troubleshooting
+   build-related problems on different operating systems and environments.
+ + Fixed bug #316 which caused the timesheet report to display an oddly sorted
+   list.
+ + Fixed bug #317 which colored tasks in the 'completed' report according to
+   due dates, which are no longer relevant to a completed task (thanks to
+   Cory Donnelly).
+ + Fixed bug #347 which used only a lowercase "all" to confirm multiple changes
+   instead of an uppercase "All" like the "Yes" answer.
+ + Fixed bug that was causing the 'completed' report to sort incorrectly.
+ + Fixed bug that showed a calendar for the year 2037 when 'task calendar due'
+   was run, and there are no tasks with due dates.
+ + Fixed bug #360 which prevented certain modifications to recurring tasks
+   (thanks to John Florian).
+ + Fixed bug #299 which prevented excluding multiple projects from a report,
+   by using "task list project.isnt:foo project.isnt:bar" (thanks to John
+   Florian).
+ + Fixed bug #368 which caused recurring tasks 'until' dates to be rendered as
+   epoch numbers instead of dates (thanks to Cory Donnelly).
+ + Fixed bug #369 which prevented the config command from setting quoted or
+   unquoted multi-word values (thanks to Richard Querin).
+ + Fixed bug #370 which prevented the removal of a due date from a task,
+   mis-identifying the task as recurring just because it had a due date
+   (thanks to John Florian).
+ + Fixed bug #371 which caused task to mis-apply certain color rules, like
+   color.alternate, which was (a) not applied first, and (b) not blended
+   with the other color rules (thanks to Richard Querin).
+ + Fixed bug #372 which incorrectly mapped 16-color backgrounds into the
+   256-color space.
+
+1.8.5 (12/05/2009) a6c7236ff34e5eee3ef1693b97cb1367e6e3c607
+ + Added feature to allow the user to quit when asked to confirm multiple
+   changes.  Now task asks "Proceed with change? (Yes/no/all/quit)".
+ + Added feature #341 that makes explicit references to the task and taskrc
+   man pages, both in the auto-generated .taskrc file and the version command
+   output (thanks to Cory Donnelly).
+ + Added feature - #310 that simplified and make clearer an error message
+   that complained about things that were beyond user control (thanks to
+   John Florian).
+ + Fixed bug that was causing the 'completed' report to sort incorrectly.
+ + Fixed bug #321 where all shell input was converted to lower case (thanks
+   to Juergen Daubert).
+ + Fixed bug #327 that allowed the removal of a due date from a recurring
+   task.
+ + Fixed bug #317 which colored tasks in the 'completed' report according
+   to due dates, which are no longer relevant to a completed task (thanks
+   to Cory Donnelly).
+ + Fixed bug that was causing the 'completed' report to sort incorrectly.
+ + Fixed bug #322 which failed to propagate rc overrides to shell commands.
+ + Fixed redundant messages when exiting shell mode.
+ + Fixed bug #333 which failed to display the ID of a duplicated task (thanks
+   to Cory Donnelly).
+ + Fixed bug #332 where task complained that the 'recur_ind' custom report
+   column was invalid.  It was misnamed in the documentation, which should
+   have read 'recurrence_indicator'.  Also, the 'tag_indicator' column was
+   not mentioned anywhere (thanks to T. Charles Yun).
+ + Fixed bug #319 that caused task to not properly detect the removal of a
+   tag when obtaining confirmation from the user fora bulk modification
+   (thanks to Cory Donnelly).
+
+1.8.4 (11/17/2009) 12c4983936d27317df100f05da8244139dd06a3f
+ + Fixed bug that caused wait: dates to not be properly rendered in a
+   readable and preferred format with the "edit" command.
+ + Fixed bug that caused a hang on cygwin, when a task with multiple
+   annotations was edited (thanks to Joe Pulliam).
+ + Fixed bug #314 where the edit command fails when data.location includes
+   directories containing spaces (thanks to Cory Donnelly).
+ + Added a warning (issue #312) when modifying recurring tasks, that all
+   instances of that task may be modified.  When task confirms a bulk edit
+   the recurrence is again indicated (thanks to Cory Donnelly).
+
+1.8.3 (10/21/2009) bcdcbeeea0d92f21c3565aebfaf6332b959f4025
+ + Added support for Haiku R1/alpha1
+
+1.8.2 (9/7/2009) f243f0ed443ecd7dde779de8a6525222591024db
+ + Added feature #282 that returns useful exit codes to the shell.  Now a
+   script can detect whether no tasks were returned by a report (thanks to
+   Pietro Cerutti).
+ + Fixed bug #287 that causes color control codes to be written to shadow
+   files (thanks to Richard Querin).
+ + Fixed bug #289 which imported task from todo.sh without valid uuids
+   (thanks to Ben Jackson).
+ + Fixed bug #291 which generated a false warning about an unrecognized
+   variable when enabling default.projects in .taskrc (thanks to Thomas@BIC).
+ + Fixed bug #288 which failed to propagate rc file overrides on the command
+   line to the default command (thanks to Zach Frazier).
+
+1.8.1 (8/20/2009) 35792e7874d2bb664abb1a0a67960b7fe7e0fccf
+ + Fixed bug #231 that broke the build on OpenBSD 32-bit due to a time_t
+   and int collision (thanks to Pietro Cerutti).
+ + Fixed bug #241 that prevented bash's tab-completion of projects in Fedora 
+   11 and likely anything using bash-4 (thanks to John Florian).
+ + Fixed bug #242 that sometimes causes the ID echoed after a task is added
+   to be incorrect (thanks to John Florian).
+ + Fixed bug #245 that quoted date fields on export, that were subsequently
+   improperly parsed on import (thanks to John Florian).
+ + Fixed bug #248 where single and double quotes are both stored as
+   ampersand-quot-semi (thanks to John Florian).
+ + Fixed bug #249 that caused annotations with the same date to be lost after
+   a "task edit" command (thanks to Federico Hernandez).
+ + Fixed bug #250 whereby rc.dateformat was not observed when parsing the
+   creation date of an annotation (thanks to Federico Hernandez).
+ + Fixed bug #251 whereby the presence of annotations cause the .hasnt attribute
+   modifier to not work (thanks to John Florian).
+ + Fixed bug #252 that prevented use of attribute modifiers on dates to effect
+   a range, such as "task ls due.after:eom due.before:eoy" (thanks to John
+   Florian).
+ + Fixed bug #256 that allowed a recurring task with no due date.
+ + Fixed bug #257 where an extant ~/.taskrc file prevented the override and
+   automatic creation of an alternate rc file (thanks to Zach Frazier).
+ + Fixed bug #259 that cause a build failure on Snow Leopard 10a432.
+ + Fixed bug #260 whereby the start, stop and delete commands did not complain
+   when filter arguments were specified, even though they were ignored
+   (thanks to T. Charles Yun).
+ + Fixed bug that allowed a recurring task to be added without a due date.
+ + Fixed bug that displays the wrong .taskrc file name on override (thanks to
+   Federico Hernandez).
+ + Fixed bug that failed to suppress color control code in the header and
+   footnote when redirecting output to a file (thanks to John Florian).
+
+1.8.0 (7/21/2009) 14977ef317bd004dae2f2c313e806af9f2a2140c
+ + Added zsh tab completion script (thanks to P.C. Shyamshankar).
+ + Fixed bug that cause the _forcecolor configuration variable to be
+   considered obsolete (thank to Bruce Dillahunty).
+ + Fixed documentation errors (thanks to Thomas@BIC).
+ + The 'weekstart' configuration variable now controls the 'calendar'
+   report (thanks to Federico Hernandez).
+ + The 'displayweeknumber' configuration variable now controls the display
+   of week number in the 'calendar' report (thanks to Federico Hernandez).
+ + Supports '--' argument to indicate that all subsequence arguments are
+   part of the description, despite what they otherwise might mean.
+ + Removed support for the obsolete task file format 1 (never released).
+ + Fixed bug that allowed blank annotations to be added (thanks to Bruce
+   Dillahunty).
+ + Supports negative tag filters, so that (task list +foo -bar) now filters
+   tasks that have the "foo" tag, but do not have the "bar" tag (thanks to
+   Chris Pride).
+ + Custom reports now support a more compact form of the "age" column,
+   called "age_compact" (thanks to T. Charles Yun).
+ + Supports 'rc.name:value' for a command line override to .taskrc data
+   (thanks to Federico Hernandez).
+ + Removed obsolete DEVELOPERS file.  The online support forums at
+   http://taskwarrior.org will provide better information.
+ + Fixed bug that kept some deleted tasks showing up on the calendar report
+   (thanks to Federico Hernandez).
+ + Now asks the user to confirm large changes if configuration variable
+   'confirmation' is set to 'yes'.  A large change is one that completely
+   replaces a task description, or operates on a large number of tasks,
+   which defaults to 4 but is configurable via the 'bulk' configuration
+   variable  (thanks to John Florian).
+ + Now echoes back the new task ID on 'add' (thanks to Bruce Dillahunty).
+ + The new "shell" command provides an interactive shell for task.  All
+   commands are supported (thanks to Bruce Dillahunty, Federico Hernandez,
+   and John Florian).
+ + New "recurring" report to list all recurring tasks.
+ + New, more flexible, more consistent, grep-able file format.
+ + If task is renamed to "cal", or there is a symlink to task called "cal",
+   then task can act as a replacement for the Unix "cal" command.
+ + Supports arguments to the cal command like "month year", "year", etc.
+ + The "tags" report now shows the tag usage count.
+ + The "projects" report now shows totals by project and priority.
+ + Now supports attribute modifiers that allow much finer control over report
+   filtering, for example "task list due.before:friday", or "task list
+   pri.not:H" and many more.
+ + Now supports new "age_compact" and "wait" custom report columns.
+ + Now supports colorization of the header and footnote messages that are
+   printed before and after report output, with the 'color.header' and
+   'color.footnote' configuration variables.
+ + Now supports the 'limit' attribute, to control the number of tasks that
+   are shown, for example: "task list limit:10".
+ + Now supports a debug mode that can be used to generate helpful information
+   when reporting a problem.  Just run the command with "task rc.debug:on ..."
+   and diagnostics will be generated that will help pinpoint a problem.
+ + The new "undo" command replaces the old "undo" and "undelete" command
+   with a complete undo stack that can rollback all changes.
+ + While waiting for a file lock, task states the reason for the delay.
+ + Now supports a 'waiting' state that causes tasks to not appear until
+   a certain date, for example "task <ID> wait:<date>".  The task
+   will then not show up on any report (except 'all') until that date.
+ + The "active", "completed", "overdue" and "next" reports are now custom
+   reports, and therefore modifiable.
+ + Now supports a 'waiting' custom report to list all waiting tasks.
+ + Now supports a 'recurring' custom report to list all recurring tasks.
+ + Now supports an 'all' report to list all tasks, including deleted
+ + Supports command aliases - create an alias for any command by creating
+   a .taskrc entry like "alias.new_name=old_name".
+   and completed tasks.
+ + Now over 1,600 unit tests, helping to maintain code quality.
+
+1.7.1 (6/8/2009) 1422a15cbc470cff590bf06daad20d01fe1b05ef
+ + Fixed build failure on OpenBSD (thanks to Mike Adonay).
+ + Took the opportunity of a patch release to update the various email
+   addresses and URLs in the various documents.
+
+1.7.0 (5/14/2009) f6b8b39d8b4a85c30a457e9e78b582b74531bfe4
+ + Improved the errors when parsing a corrupt or unrecognized pending.data
+   or completed.data file (thanks to T. Charles Yun).
+ + Added details to the "info" report about recurring tasks (thanks to T.
+   Charles Yun).
+ + Now writes a sample "defaultwidth" configuration variable to the default
+   .taskrc file (thanks to T. Charles Yun).
+ + Task allows commands that require an ID to now be given a sequence, which
+   is a set of IDs.  This allows commands like "task delete 1 2 5-10,12".
+ + Fixed bug in the ghistory report, which caused it to only show a new
+   month if a task was added during that month.
+ + New command "duplicate" which allow existing task(s) to be duplicated,
+   and also have modifications applied (thanks to David J Patrick).
+ + The "append", and "done" commands now allow modifications to be applied
+   to the task(s) (thanks to David J Patrick).
+ + Improved word wrapping in various output.
+ + Fixed bug that added an extra line between header and graph in the
+   ghistory report.
+ + Added simple 'taskprogram' mailing list subscribe form to the web site.
+ + For custom reports that define a "limit" to the number of rows of output
+   such as "oldest" and "newest", task allows an override value.  For
+   example "task oldest 5" will display the 5 oldest tasks.
+ + Modified the "stats" report so that it has the same aesthetics as the
+   other reports.
+ + New "timesheet" command displays tasks completed and started, per week,
+   and can display multiple weeks.
+ + New tab completion script, task_completion.sh, for bash users, is installed
+   to /usr/local/share/task (thanks to Federico Hernandez).
+ + Applied patch to allow task to build on Arch Linux (thanks to Johan Friis).
+ + Applied patch to fix a UUID bug on Solaris 8 (thanks to Steven de Brouwer).
+ + The task and taskrc man pages are here.  Try "man task", "man taskrc"
+   (thanks to Federico Hernandez and P.C. Shyamshankar).
+ + Fixed bug that causes task to create a default .task directory, even if
+   data.location specified otherwise (thanks to Federico Hernandez).
+ + New "edit" command that fires up a text editor (uses 'editor' configuration
+   variable, $VISUAL or $EDITOR environment variable) and allows direct
+   editing of all editable task details.
+
+1.6.1 (4/24/2009) 1b6faf57c998617024d0348a87b941a5d2ab2249
+  + Fixed bug that caused new, first-time .taskrc files to be written without
+    including the custom report labels (thanks to P.C. Shyamshankar).
+
+1.6.0 (4/12/2009) 06062a96eb57d10dcd7fbe1edf968bb638a0b3a9
   + Added support for new "append" command that adds more description text to
     an existing task.
   + Added support for the "weekdays" recurrence, which means a task can recur
@@ -43,9 +375,7 @@
   + Substitutions can now be made global with /from/to/g and all occurrences
     of "from" will be replaced with "to".
 
------- old releases ------------------------------
-
-1.5.0 (3/15/2009)
+1.5.0 (3/15/2009) 87be68e2e83d7bb628be1e5679b16a49a26d3549
   + Removed deprecated TUTORIAL file.
   + Removed "showage" configuration variable.
   + "task stop" can now remove the start time from a started task.
@@ -202,7 +532,8 @@
   + Bug: configure.ac does not properly determine ncurses availability.
   + Bug: Cannot seem to use the percent character in a task description.
   + Bug: New installation "task stats" reports newest task 12/31/1969.
-  + Bug: New installation task projects displays header but no data - should short-circuit.
+  + Bug: New installation task projects displays header but no data - should
+         short-circuit.
   + Bug: incorrect color specification in sample .taskrc file.
   + Bug: when run without arguments, task dumps core on Solaris 10.
   + "task calendar" now reports all months with due pending tasks.
@@ -240,7 +571,7 @@
   + Made unit tests compile and run again.
   + Removed tests from distibution.
 
-0.9.6 (5/13/208)
+0.9.6 (5/13/2008)
   + Corrected wrong include file in Table.cpp.
   + Replaced color management code.
   + Improved color rules code.
@@ -287,7 +618,7 @@
   + Rules-based colorization.
 
 0.8.1 (1/28/2008) - 0.8.16 (3/13/2008)
-  + autoconf conversion (many builds).
+  + autoconf conversion
 
 0.8.0 Polish (1/25/2008)
   + Code cleanup, reorganization.

DEVELOPERS

@@ -1,22 +0,0 @@
-Developers may wish to change task, and here is a high-level guide to the files
-included.
-
-  task.{cpp,h}    Implements main, high level processing.
-  command.cpp     Implements all non-report task commands.
-  report.cpp      Implements all task reports.
-  parse.cpp       Parses the command line.
-  TDB.{cpp,h}     The task database, performs all file I/O.
-  T.{cpp,h}       Represents a single task - parses a record from TDB, and also
-                  composes record for TDB.  Provides accessors for tasks.
-  Grid.{cpp,h}    Implements a sparse 2D array, provides data storage for the
-                  Table object.
-  Table.{cpp,h}   Implements tabular data rendering, wrapping etc.
-  Config.{cpp,h}  Implements a reader for the .taskrc file.
-  Date.{cpp,h}    General date class for the time_t type.
-  text.cpp        Text manipulation functions.
-  util.cpp        General utility functions.
-  color.cpp       Color support functions.
-  rules.cpp       Auto-colorization rules.
-
-Don't forget, please send bugs, patches to task@beckingham.net
-

Makefile.am

@@ -1,3 +1,24 @@
 SUBDIRS = src
-EXTRA_DIST = DEVELOPERS
+
+dist_man_MANS = doc/man/task.1 doc/man/taskrc.5 doc/man/task-tutorial.5 doc/man/task-faq.5 doc/man/task-color.5
+
+#docdir = $(datadir)/doc/${PACKAGE}-${VERSION}
+doc_DATA = AUTHORS ChangeLog COPYING NEWS README
+
+EXTRA_DIST = INSTALL README.build
+
+bashscriptsdir = $(docdir)
+nobase_dist_bashscripts_DATA = scripts/bash/task_completion.sh
+
+zshscriptsdir = $(docdir)
+nobase_dist_zshscripts_DATA = scripts/zsh/_task
+
+vimscriptsdir = $(docdir)
+nobase_dist_vimscripts_DATA = scripts/vim/README scripts/vim/ftdetect/task.vim scripts/vim/syntax/taskdata.vim scripts/vim/syntax/taskedit.vim scripts/vim/syntax/taskrc.vim
+
+i18ndir = $(docdir)
+nobase_dist_i18n_DATA = i18n/strings.de-DE i18n/strings.en-US i18n/strings.es-ES i18n/strings.fr-FR i18n/strings.nl-NL i18n/strings.sv-SE i18n/tips.de-DE i18n/tips.en-US i18n/tips.sv-SE
+
+rcfiledir = $(docdir)/rc
+dist_rcfile_DATA = doc/rc/holidays-US.rc doc/rc/holidays-SE.rc doc/rc/dark-16.theme doc/rc/dark-256.theme doc/rc/light-16.theme doc/rc/light-256.theme
 

Makefile.in

@@ -1,595 +0,0 @@
-# Makefile.in generated by automake 1.10 from Makefile.am.
-# @configure_input@
-
-# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
-# 2003, 2004, 2005, 2006  Free Software Foundation, Inc.
-# This Makefile.in is free software; the Free Software Foundation
-# gives unlimited permission to copy and/or distribute it,
-# with or without modifications, as long as this notice is preserved.
-
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
-# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
-# PARTICULAR PURPOSE.
-
-@SET_MAKE@
-VPATH = @srcdir@
-pkgdatadir = $(datadir)/@PACKAGE@
-pkglibdir = $(libdir)/@PACKAGE@
-pkgincludedir = $(includedir)/@PACKAGE@
-am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
-install_sh_DATA = $(install_sh) -c -m 644
-install_sh_PROGRAM = $(install_sh) -c
-install_sh_SCRIPT = $(install_sh) -c
-INSTALL_HEADER = $(INSTALL_DATA)
-transform = $(program_transform_name)
-NORMAL_INSTALL = :
-PRE_INSTALL = :
-POST_INSTALL = :
-NORMAL_UNINSTALL = :
-PRE_UNINSTALL = :
-POST_UNINSTALL = :
-subdir = .
-DIST_COMMON = README $(am__configure_deps) $(srcdir)/Makefile.am \
-	$(srcdir)/Makefile.in $(srcdir)/auto.h.in \
-	$(top_srcdir)/configure AUTHORS COPYING ChangeLog INSTALL NEWS \
-	depcomp install-sh missing
-ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
-am__aclocal_m4_deps = $(top_srcdir)/configure.ac
-am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
-	$(ACLOCAL_M4)
-am__CONFIG_DISTCLEAN_FILES = config.status config.cache config.log \
- configure.lineno config.status.lineno
-mkinstalldirs = $(install_sh) -d
-CONFIG_HEADER = auto.h
-CONFIG_CLEAN_FILES =
-SOURCES =
-DIST_SOURCES =
-RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \
-	html-recursive info-recursive install-data-recursive \
-	install-dvi-recursive install-exec-recursive \
-	install-html-recursive install-info-recursive \
-	install-pdf-recursive install-ps-recursive install-recursive \
-	installcheck-recursive installdirs-recursive pdf-recursive \
-	ps-recursive uninstall-recursive
-RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive	\
-  distclean-recursive maintainer-clean-recursive
-ETAGS = etags
-CTAGS = ctags
-DIST_SUBDIRS = $(SUBDIRS)
-DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
-distdir = $(PACKAGE)-$(VERSION)
-top_distdir = $(distdir)
-am__remove_distdir = \
-  { test ! -d $(distdir) \
-    || { find $(distdir) -type d ! -perm -200 -exec chmod u+w {} ';' \
-         && rm -fr $(distdir); }; }
-DIST_ARCHIVES = $(distdir).tar.gz
-GZIP_ENV = --best
-distuninstallcheck_listfiles = find . -type f -print
-distcleancheck_listfiles = find . -type f -print
-ACLOCAL = @ACLOCAL@
-AMTAR = @AMTAR@
-AUTOCONF = @AUTOCONF@
-AUTOHEADER = @AUTOHEADER@
-AUTOMAKE = @AUTOMAKE@
-AWK = @AWK@
-CC = @CC@
-CCDEPMODE = @CCDEPMODE@
-CFLAGS = @CFLAGS@
-CPPFLAGS = @CPPFLAGS@
-CXX = @CXX@
-CXXCPP = @CXXCPP@
-CXXDEPMODE = @CXXDEPMODE@
-CXXFLAGS = @CXXFLAGS@
-CYGPATH_W = @CYGPATH_W@
-DEFS = @DEFS@
-DEPDIR = @DEPDIR@
-ECHO_C = @ECHO_C@
-ECHO_N = @ECHO_N@
-ECHO_T = @ECHO_T@
-EGREP = @EGREP@
-EXEEXT = @EXEEXT@
-GREP = @GREP@
-INSTALL = @INSTALL@
-INSTALL_DATA = @INSTALL_DATA@
-INSTALL_PROGRAM = @INSTALL_PROGRAM@
-INSTALL_SCRIPT = @INSTALL_SCRIPT@
-INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
-LDFLAGS = @LDFLAGS@
-LIBOBJS = @LIBOBJS@
-LIBS = @LIBS@
-LTLIBOBJS = @LTLIBOBJS@
-MAKEINFO = @MAKEINFO@
-MKDIR_P = @MKDIR_P@
-OBJEXT = @OBJEXT@
-PACKAGE = @PACKAGE@
-PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
-PACKAGE_NAME = @PACKAGE_NAME@
-PACKAGE_STRING = @PACKAGE_STRING@
-PACKAGE_TARNAME = @PACKAGE_TARNAME@
-PACKAGE_VERSION = @PACKAGE_VERSION@
-PATH_SEPARATOR = @PATH_SEPARATOR@
-SET_MAKE = @SET_MAKE@
-SHELL = @SHELL@
-STRIP = @STRIP@
-VERSION = @VERSION@
-abs_builddir = @abs_builddir@
-abs_srcdir = @abs_srcdir@
-abs_top_builddir = @abs_top_builddir@
-abs_top_srcdir = @abs_top_srcdir@
-ac_ct_CC = @ac_ct_CC@
-ac_ct_CXX = @ac_ct_CXX@
-am__include = @am__include@
-am__leading_dot = @am__leading_dot@
-am__quote = @am__quote@
-am__tar = @am__tar@
-am__untar = @am__untar@
-bindir = @bindir@
-build_alias = @build_alias@
-builddir = @builddir@
-datadir = @datadir@
-datarootdir = @datarootdir@
-docdir = @docdir@
-dvidir = @dvidir@
-exec_prefix = @exec_prefix@
-host_alias = @host_alias@
-htmldir = @htmldir@
-includedir = @includedir@
-infodir = @infodir@
-install_sh = @install_sh@
-libdir = @libdir@
-libexecdir = @libexecdir@
-localedir = @localedir@
-localstatedir = @localstatedir@
-mandir = @mandir@
-mkdir_p = @mkdir_p@
-oldincludedir = @oldincludedir@
-pdfdir = @pdfdir@
-prefix = @prefix@
-program_transform_name = @program_transform_name@
-psdir = @psdir@
-sbindir = @sbindir@
-sharedstatedir = @sharedstatedir@
-srcdir = @srcdir@
-sysconfdir = @sysconfdir@
-target_alias = @target_alias@
-top_builddir = @top_builddir@
-top_srcdir = @top_srcdir@
-SUBDIRS = src
-EXTRA_DIST = DEVELOPERS
-all: auto.h
-	$(MAKE) $(AM_MAKEFLAGS) all-recursive
-
-.SUFFIXES:
-am--refresh:
-	@:
-$(srcdir)/Makefile.in:  $(srcdir)/Makefile.am  $(am__configure_deps)
-	@for dep in $?; do \
-	  case '$(am__configure_deps)' in \
-	    *$$dep*) \
-	      echo ' cd $(srcdir) && $(AUTOMAKE) --gnu '; \
-	      cd $(srcdir) && $(AUTOMAKE) --gnu  \
-		&& exit 0; \
-	      exit 1;; \
-	  esac; \
-	done; \
-	echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu  Makefile'; \
-	cd $(top_srcdir) && \
-	  $(AUTOMAKE) --gnu  Makefile
-.PRECIOUS: Makefile
-Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
-	@case '$?' in \
-	  *config.status*) \
-	    echo ' $(SHELL) ./config.status'; \
-	    $(SHELL) ./config.status;; \
-	  *) \
-	    echo ' cd $(top_builddir) && $(SHELL) ./config.status $@ $(am__depfiles_maybe)'; \
-	    cd $(top_builddir) && $(SHELL) ./config.status $@ $(am__depfiles_maybe);; \
-	esac;
-
-$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
-	$(SHELL) ./config.status --recheck
-
-$(top_srcdir)/configure:  $(am__configure_deps)
-	cd $(srcdir) && $(AUTOCONF)
-$(ACLOCAL_M4):  $(am__aclocal_m4_deps)
-	cd $(srcdir) && $(ACLOCAL) $(ACLOCAL_AMFLAGS)
-
-auto.h: stamp-h1
-	@if test ! -f $@; then \
-	  rm -f stamp-h1; \
-	  $(MAKE) $(AM_MAKEFLAGS) stamp-h1; \
-	else :; fi
-
-stamp-h1: $(srcdir)/auto.h.in $(top_builddir)/config.status
-	@rm -f stamp-h1
-	cd $(top_builddir) && $(SHELL) ./config.status auto.h
-$(srcdir)/auto.h.in:  $(am__configure_deps) 
-	cd $(top_srcdir) && $(AUTOHEADER)
-	rm -f stamp-h1
-	touch $@
-
-distclean-hdr:
-	-rm -f auto.h stamp-h1
-
-# This directory's subdirectories are mostly independent; you can cd
-# into them and run `make' without going through this Makefile.
-# To change the values of `make' variables: instead of editing Makefiles,
-# (1) if the variable is set in `config.status', edit `config.status'
-#     (which will cause the Makefiles to be regenerated when you run `make');
-# (2) otherwise, pass the desired values on the `make' command line.
-$(RECURSIVE_TARGETS):
-	@failcom='exit 1'; \
-	for f in x $$MAKEFLAGS; do \
-	  case $$f in \
-	    *=* | --[!k]*);; \
-	    *k*) failcom='fail=yes';; \
-	  esac; \
-	done; \
-	dot_seen=no; \
-	target=`echo $@ | sed s/-recursive//`; \
-	list='$(SUBDIRS)'; for subdir in $$list; do \
-	  echo "Making $$target in $$subdir"; \
-	  if test "$$subdir" = "."; then \
-	    dot_seen=yes; \
-	    local_target="$$target-am"; \
-	  else \
-	    local_target="$$target"; \
-	  fi; \
-	  (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \
-	  || eval $$failcom; \
-	done; \
-	if test "$$dot_seen" = "no"; then \
-	  $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \
-	fi; test -z "$$fail"
-
-$(RECURSIVE_CLEAN_TARGETS):
-	@failcom='exit 1'; \
-	for f in x $$MAKEFLAGS; do \
-	  case $$f in \
-	    *=* | --[!k]*);; \
-	    *k*) failcom='fail=yes';; \
-	  esac; \
-	done; \
-	dot_seen=no; \
-	case "$@" in \
-	  distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \
-	  *) list='$(SUBDIRS)' ;; \
-	esac; \
-	rev=''; for subdir in $$list; do \
-	  if test "$$subdir" = "."; then :; else \
-	    rev="$$subdir $$rev"; \
-	  fi; \
-	done; \
-	rev="$$rev ."; \
-	target=`echo $@ | sed s/-recursive//`; \
-	for subdir in $$rev; do \
-	  echo "Making $$target in $$subdir"; \
-	  if test "$$subdir" = "."; then \
-	    local_target="$$target-am"; \
-	  else \
-	    local_target="$$target"; \
-	  fi; \
-	  (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \
-	  || eval $$failcom; \
-	done && test -z "$$fail"
-tags-recursive:
-	list='$(SUBDIRS)'; for subdir in $$list; do \
-	  test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \
-	done
-ctags-recursive:
-	list='$(SUBDIRS)'; for subdir in $$list; do \
-	  test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \
-	done
-
-ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES)
-	list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \
-	unique=`for i in $$list; do \
-	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
-	  done | \
-	  $(AWK) '    { files[$$0] = 1; } \
-	       END { for (i in files) print i; }'`; \
-	mkid -fID $$unique
-tags: TAGS
-
-TAGS: tags-recursive $(HEADERS) $(SOURCES) auto.h.in $(TAGS_DEPENDENCIES) \
-		$(TAGS_FILES) $(LISP)
-	tags=; \
-	here=`pwd`; \
-	if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \
-	  include_option=--etags-include; \
-	  empty_fix=.; \
-	else \
-	  include_option=--include; \
-	  empty_fix=; \
-	fi; \
-	list='$(SUBDIRS)'; for subdir in $$list; do \
-	  if test "$$subdir" = .; then :; else \
-	    test ! -f $$subdir/TAGS || \
-	      tags="$$tags $$include_option=$$here/$$subdir/TAGS"; \
-	  fi; \
-	done; \
-	list='$(SOURCES) $(HEADERS) auto.h.in $(LISP) $(TAGS_FILES)'; \
-	unique=`for i in $$list; do \
-	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
-	  done | \
-	  $(AWK) '    { files[$$0] = 1; } \
-	       END { for (i in files) print i; }'`; \
-	if test -z "$(ETAGS_ARGS)$$tags$$unique"; then :; else \
-	  test -n "$$unique" || unique=$$empty_fix; \
-	  $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
-	    $$tags $$unique; \
-	fi
-ctags: CTAGS
-CTAGS: ctags-recursive $(HEADERS) $(SOURCES) auto.h.in $(TAGS_DEPENDENCIES) \
-		$(TAGS_FILES) $(LISP)
-	tags=; \
-	here=`pwd`; \
-	list='$(SOURCES) $(HEADERS) auto.h.in $(LISP) $(TAGS_FILES)'; \
-	unique=`for i in $$list; do \
-	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
-	  done | \
-	  $(AWK) '    { files[$$0] = 1; } \
-	       END { for (i in files) print i; }'`; \
-	test -z "$(CTAGS_ARGS)$$tags$$unique" \
-	  || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \
-	     $$tags $$unique
-
-GTAGS:
-	here=`$(am__cd) $(top_builddir) && pwd` \
-	  && cd $(top_srcdir) \
-	  && gtags -i $(GTAGS_ARGS) $$here
-
-distclean-tags:
-	-rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags
-
-distdir: $(DISTFILES)
-	$(am__remove_distdir)
-	test -d $(distdir) || mkdir $(distdir)
-	@srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
-	topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
-	list='$(DISTFILES)'; \
-	  dist_files=`for file in $$list; do echo $$file; done | \
-	  sed -e "s|^$$srcdirstrip/||;t" \
-	      -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \
-	case $$dist_files in \
-	  */*) $(MKDIR_P) `echo "$$dist_files" | \
-			   sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \
-			   sort -u` ;; \
-	esac; \
-	for file in $$dist_files; do \
-	  if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
-	  if test -d $$d/$$file; then \
-	    dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
-	    if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
-	      cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \
-	    fi; \
-	    cp -pR $$d/$$file $(distdir)$$dir || exit 1; \
-	  else \
-	    test -f $(distdir)/$$file \
-	    || cp -p $$d/$$file $(distdir)/$$file \
-	    || exit 1; \
-	  fi; \
-	done
-	list='$(DIST_SUBDIRS)'; for subdir in $$list; do \
-	  if test "$$subdir" = .; then :; else \
-	    test -d "$(distdir)/$$subdir" \
-	    || $(MKDIR_P) "$(distdir)/$$subdir" \
-	    || exit 1; \
-	    distdir=`$(am__cd) $(distdir) && pwd`; \
-	    top_distdir=`$(am__cd) $(top_distdir) && pwd`; \
-	    (cd $$subdir && \
-	      $(MAKE) $(AM_MAKEFLAGS) \
-	        top_distdir="$$top_distdir" \
-	        distdir="$$distdir/$$subdir" \
-		am__remove_distdir=: \
-		am__skip_length_check=: \
-	        distdir) \
-	      || exit 1; \
-	  fi; \
-	done
-	-find $(distdir) -type d ! -perm -777 -exec chmod a+rwx {} \; -o \
-	  ! -type d ! -perm -444 -links 1 -exec chmod a+r {} \; -o \
-	  ! -type d ! -perm -400 -exec chmod a+r {} \; -o \
-	  ! -type d ! -perm -444 -exec $(install_sh) -c -m a+r {} {} \; \
-	|| chmod -R a+r $(distdir)
-dist-gzip: distdir
-	tardir=$(distdir) && $(am__tar) | GZIP=$(GZIP_ENV) gzip -c >$(distdir).tar.gz
-	$(am__remove_distdir)
-
-dist-bzip2: distdir
-	tardir=$(distdir) && $(am__tar) | bzip2 -9 -c >$(distdir).tar.bz2
-	$(am__remove_distdir)
-
-dist-tarZ: distdir
-	tardir=$(distdir) && $(am__tar) | compress -c >$(distdir).tar.Z
-	$(am__remove_distdir)
-
-dist-shar: distdir
-	shar $(distdir) | GZIP=$(GZIP_ENV) gzip -c >$(distdir).shar.gz
-	$(am__remove_distdir)
-
-dist-zip: distdir
-	-rm -f $(distdir).zip
-	zip -rq $(distdir).zip $(distdir)
-	$(am__remove_distdir)
-
-dist dist-all: distdir
-	tardir=$(distdir) && $(am__tar) | GZIP=$(GZIP_ENV) gzip -c >$(distdir).tar.gz
-	$(am__remove_distdir)
-
-# This target untars the dist file and tries a VPATH configuration.  Then
-# it guarantees that the distribution is self-contained by making another
-# tarfile.
-distcheck: dist
-	case '$(DIST_ARCHIVES)' in \
-	*.tar.gz*) \
-	  GZIP=$(GZIP_ENV) gunzip -c $(distdir).tar.gz | $(am__untar) ;;\
-	*.tar.bz2*) \
-	  bunzip2 -c $(distdir).tar.bz2 | $(am__untar) ;;\
-	*.tar.Z*) \
-	  uncompress -c $(distdir).tar.Z | $(am__untar) ;;\
-	*.shar.gz*) \
-	  GZIP=$(GZIP_ENV) gunzip -c $(distdir).shar.gz | unshar ;;\
-	*.zip*) \
-	  unzip $(distdir).zip ;;\
-	esac
-	chmod -R a-w $(distdir); chmod a+w $(distdir)
-	mkdir $(distdir)/_build
-	mkdir $(distdir)/_inst
-	chmod a-w $(distdir)
-	dc_install_base=`$(am__cd) $(distdir)/_inst && pwd | sed -e 's,^[^:\\/]:[\\/],/,'` \
-	  && dc_destdir="$${TMPDIR-/tmp}/am-dc-$$$$/" \
-	  && cd $(distdir)/_build \
-	  && ../configure --srcdir=.. --prefix="$$dc_install_base" \
-	    $(DISTCHECK_CONFIGURE_FLAGS) \
-	  && $(MAKE) $(AM_MAKEFLAGS) \
-	  && $(MAKE) $(AM_MAKEFLAGS) dvi \
-	  && $(MAKE) $(AM_MAKEFLAGS) check \
-	  && $(MAKE) $(AM_MAKEFLAGS) install \
-	  && $(MAKE) $(AM_MAKEFLAGS) installcheck \
-	  && $(MAKE) $(AM_MAKEFLAGS) uninstall \
-	  && $(MAKE) $(AM_MAKEFLAGS) distuninstallcheck_dir="$$dc_install_base" \
-	        distuninstallcheck \
-	  && chmod -R a-w "$$dc_install_base" \
-	  && ({ \
-	       (cd ../.. && umask 077 && mkdir "$$dc_destdir") \
-	       && $(MAKE) $(AM_MAKEFLAGS) DESTDIR="$$dc_destdir" install \
-	       && $(MAKE) $(AM_MAKEFLAGS) DESTDIR="$$dc_destdir" uninstall \
-	       && $(MAKE) $(AM_MAKEFLAGS) DESTDIR="$$dc_destdir" \
-	            distuninstallcheck_dir="$$dc_destdir" distuninstallcheck; \
-	      } || { rm -rf "$$dc_destdir"; exit 1; }) \
-	  && rm -rf "$$dc_destdir" \
-	  && $(MAKE) $(AM_MAKEFLAGS) dist \
-	  && rm -rf $(DIST_ARCHIVES) \
-	  && $(MAKE) $(AM_MAKEFLAGS) distcleancheck
-	$(am__remove_distdir)
-	@(echo "$(distdir) archives ready for distribution: "; \
-	  list='$(DIST_ARCHIVES)'; for i in $$list; do echo $$i; done) | \
-	  sed -e 1h -e 1s/./=/g -e 1p -e 1x -e '$$p' -e '$$x'
-distuninstallcheck:
-	@cd $(distuninstallcheck_dir) \
-	&& test `$(distuninstallcheck_listfiles) | wc -l` -le 1 \
-	   || { echo "ERROR: files left after uninstall:" ; \
-	        if test -n "$(DESTDIR)"; then \
-	          echo "  (check DESTDIR support)"; \
-	        fi ; \
-	        $(distuninstallcheck_listfiles) ; \
-	        exit 1; } >&2
-distcleancheck: distclean
-	@if test '$(srcdir)' = . ; then \
-	  echo "ERROR: distcleancheck can only run from a VPATH build" ; \
-	  exit 1 ; \
-	fi
-	@test `$(distcleancheck_listfiles) | wc -l` -eq 0 \
-	  || { echo "ERROR: files left in build directory after distclean:" ; \
-	       $(distcleancheck_listfiles) ; \
-	       exit 1; } >&2
-check-am: all-am
-check: check-recursive
-all-am: Makefile auto.h
-installdirs: installdirs-recursive
-installdirs-am:
-install: install-recursive
-install-exec: install-exec-recursive
-install-data: install-data-recursive
-uninstall: uninstall-recursive
-
-install-am: all-am
-	@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
-
-installcheck: installcheck-recursive
-install-strip:
-	$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
-	  install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
-	  `test -z '$(STRIP)' || \
-	    echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
-mostlyclean-generic:
-
-clean-generic:
-
-distclean-generic:
-	-test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES)
-
-maintainer-clean-generic:
-	@echo "This command is intended for maintainers to use"
-	@echo "it deletes files that may require special tools to rebuild."
-clean: clean-recursive
-
-clean-am: clean-generic mostlyclean-am
-
-distclean: distclean-recursive
-	-rm -f $(am__CONFIG_DISTCLEAN_FILES)
-	-rm -f Makefile
-distclean-am: clean-am distclean-generic distclean-hdr distclean-tags
-
-dvi: dvi-recursive
-
-dvi-am:
-
-html: html-recursive
-
-info: info-recursive
-
-info-am:
-
-install-data-am:
-
-install-dvi: install-dvi-recursive
-
-install-exec-am:
-
-install-html: install-html-recursive
-
-install-info: install-info-recursive
-
-install-man:
-
-install-pdf: install-pdf-recursive
-
-install-ps: install-ps-recursive
-
-installcheck-am:
-
-maintainer-clean: maintainer-clean-recursive
-	-rm -f $(am__CONFIG_DISTCLEAN_FILES)
-	-rm -rf $(top_srcdir)/autom4te.cache
-	-rm -f Makefile
-maintainer-clean-am: distclean-am maintainer-clean-generic
-
-mostlyclean: mostlyclean-recursive
-
-mostlyclean-am: mostlyclean-generic
-
-pdf: pdf-recursive
-
-pdf-am:
-
-ps: ps-recursive
-
-ps-am:
-
-uninstall-am:
-
-.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) install-am \
-	install-strip
-
-.PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \
-	all all-am am--refresh check check-am clean clean-generic \
-	ctags ctags-recursive dist dist-all dist-bzip2 dist-gzip \
-	dist-shar dist-tarZ dist-zip distcheck distclean \
-	distclean-generic distclean-hdr distclean-tags distcleancheck \
-	distdir distuninstallcheck dvi dvi-am html html-am info \
-	info-am install install-am install-data install-data-am \
-	install-dvi install-dvi-am install-exec install-exec-am \
-	install-html install-html-am install-info install-info-am \
-	install-man install-pdf install-pdf-am install-ps \
-	install-ps-am install-strip installcheck installcheck-am \
-	installdirs installdirs-am maintainer-clean \
-	maintainer-clean-generic mostlyclean mostlyclean-generic pdf \
-	pdf-am ps ps-am tags tags-recursive uninstall uninstall-am
-
-# Tell versions [3.59,3.63) of GNU make to not export all variables.
-# Otherwise a system limit (for SysV at least) may be exceeded.
-.NOEXPORT:

NEWS

@@ -1,35 +1,55 @@
-Welcome to Task 1.6.0.
+
+New Features in task 1.9
+
+  - 256-color support
+  - Support for coloring alternate lines of output.  Remember that old green
+    and white fan-fold printer paper?
+  - Supports nested .taskrc files with the new "include" statement"
+  - New columns that include the time as well as date
+  - New attribute modifiers
+  - New date format for reports
+  - Improved .taskrc validation
+  - Improved calendar report with custom coloring and optional task details output
+  - Holidays are now supported in the calendar report
+  - Ability to use multiple, similar filter terms, like:
+      task list project.not:foo project.not:bar
+  - Ability to do case-sensitive or case-insensitive search for keywords, and
+    substitutions in the description and annotations.
+  - Task is now part of Debian
+
+  Please refer to the ChangeLog file for full details.  There are too many to
+  list here.
 
 Task has been built and tested on the following configurations:
 
-  - OS X 10.4 Tiger
-  - OS X 10.5 Leopard
-  - Fedora Core 8
-  - Fedora Core 9
-  - Fedora Core 10
-  - Ubuntu 7 Feisty Fawn
-  - Ubuntu 8 Hardy Heron
-  - Ubuntu 8.10 Intrepid Ibex
-  - Ubuntu 9.04 Jaunty Jackalope (beta)
-  - Solaris 10
-  - Cygwin 1.5.25-14
+  * OS X 10.6 Snow Leopard and 10.5 Leopard
+  * Fedora 12 Constantine and 11 Leonidas
+  * Ubuntu 9.10 Karmic Koala and 9.04 Jaunty Jackalope
+  * Debian Sid
+  * Slackware 12.2
+  * Arch Linux
+  * Gentoo Linux
+  * SliTaz Linux
+  * CRUX Linux
+  * Solaris 10 and 8
+  * OpenBSD 4.5
+  * FreeBSD
+  * Cygwin 1.7 and 1.5
+  * Haiku R1/alpha1
 
 While Task has undergone testing, bugs are sure to remain.  If you encounter a
-bug, please contact me at task@beckingham.net.  Here is what you could do, in
-order of increasing effort (to you) and usefulness (to me):
+bug, please enter a new issue at:
 
-  - Do nothing.  Bug probably won't get fixed.
+  http://taskwarrior.org/projects/taskwarrior/issues/new
 
-  - Send an email to task@beckingham.net, explaining what you saw.  The bug
-    will be addressed, and a new release will be made.  You will be a hero.
+Or you can also report the issue in the forums at:
 
-  - Send an email, and a reproducible test case in the form of the few commands
-    it takes to recreate the problem.  The bug will be addressed, and a new
-    release will be made.  You will be a hero.
+  http://taskwarrior.org/projects/taskwarrior/boards
 
-  - If you are a developer, send a patch that fixes the problem.  Your patch
-    will be applied and tested, and a new release will be made.  You will be a
-    hero.
+Or just send a message to:
+
+  support@taskwarrior.org
 
 Thank you.
 
+---

README

@@ -1,51 +1,23 @@
-Thank you for taking a look at task.  Task is a GTD utility featuring:
 
-  - Robust C++ implementation
-  - Tags
-  - Colorful, tabular output
-  - Reports, graphs
-  - Lots of commands
-  - Low-level API
-  - Abbreviations for all commands, options
-  - Multi-user file locking
-  - Clean architecture allowing quick addition of new features
-  - Recurring tasks
+Thank you for taking a look at task!
 
-It is intended that features, mainly in the form of reports will be added
-frequently, with best practices and useful reports evolving from usage patterns.
+Task is a GTD, todo list, task management, command line utility with a multitude
+of features.  It is a portable, well supported, very active project, and it is
+Open Source.  Task has binary distributions, online documentation, demonstration
+movies, and you'll find all the details at:
 
-Task is scope-limited to GTD functionality only.
+    http://taskwarrior.org
 
-You may want to watch the old task movie on YouTube:
+At the site you'll find a wiki, discussion forums, downloads, news and more.
 
-  http://www.youtube.com/watch?v=l68LCl6BYvs
+Your contributions are especially welcome.  Whether it comes in the form of
+code patches, ideas, discussion, bug reports, encouragement or criticism, your
+input is needed.
 
-or the new improved one:
+Please send your support questions and code patches to:
 
-  http://www.youtube.com/watch?v=D2Kn4DMOVSw
+    support@taskwarrior.org
 
-Either will give you a fairly good idea of what task is capable of, and
-whether it fits in to your way of working.  As a command line application,
-task is not for everyone and some of you may prefer to not proceed.  The
-movie or online tutorial file are the quickest way for you to make that
-decision.  The online tutorial can be found at:
-
-  http://www.beckingham.net/task.html
-
-Task is based on ideas presented in the todo.sh script, found on:
-
-  http://todotxt.org
-
-Task has many more features than todo.sh, but fundamentally, they are
-both working toward the same goals, which is to help you follow basic
-Getting Things Done (GTD) principles.
-
-All feedback is welcome, in addition to any bug reports or patches to:
-
-  task@beckingham.net
-
-Got an idea for an enhancement?  Send a message!
-
-I have found that task makes me more productive and organized.
-I hope task can do the same for you.  
+Consider joining taskwarrior.org and participating in the future of task.
 
+---

README.build

@@ -0,0 +1,98 @@
+
+Task Build Notes
+----------------
+
+Task 1.9 has dependencies that are detected by the configure program in almost
+all cases, but there are situations and operating systems that mean you will
+need to offer configure a little help.
+
+If task will not build on your system, first take a look at the Operating System
+notes below.  If this doesn't help, then go to the Troubleshooting section,
+which includes instructions on how to contact us for help.
+
+
+
+Operating System Notes
+----------------------
+
+Cygwin 1.7
+  Building task on Cygwin 1.7 requires a configure option:
+
+    ./configure --with-ncurses-inc=/usr/include/ncurses
+
+  This is because the ncurses include files are in a different location to
+  Cygwin 1.5.
+
+
+Haiku Alpha/R1
+  Task must be built with gcc version 4.x, so make sure you run:
+
+    $ setgcc gcc4
+
+  To switch from gcc 2.95 to gcc 4.x.
+
+
+
+Troubleshooting
+---------------
+
+In most cases, it is sufficient to run the configure program like this:
+
+  $ ./configure
+
+Configure will run and locate all the necessary pieces for the build, and create
+a Makefile.  There may be errors and warnings when running configure, or there
+may be compiler errors and warnings when running 'make'.  Sometimes you will run
+configure with no reported problems, and the build will fail later.  This is
+almost always because configure is mistaken about some assumption.
+
+The configure program can accept several options that help with its ability to
+locate and use the ncurses library.  They are:
+
+  --with-ncurses
+
+    This option tells configure that no matter what it thinks, ncurses is
+    definitely on this system and should be enabled.  If needed, this option
+    probable needs to be accompanied by the next two options.
+
+  --with-ncurses-inc=/usr/include
+
+    If configure cannot find ncurses header files, this option will tell it
+    exactly where to look.  The path specified in this example is the default,
+    so that probably won't help you.  The path should be the directory in which
+    the file 'ncurses.h' resides.  Here are some possible values to try:
+
+      /usr/include                    (the default shown above)
+      /usr/include/ncurses
+      /usr/local/include
+      /usr/local/include/ncurses
+
+    This should cover most systems, but new variations keeps cropping up.
+
+  --with-ncurses-lib=/usr/lib
+
+    If configure cannot find the ncurses library, this option will tell it
+    exactly where to look.  The path specified in this example is the default,
+    so that probably won't help you.  The path should be the directory in which
+    the file 'libncurses.a' (or your system's equivalent) resides.  Here are
+    some possible values to try:
+
+      /usr/lib
+      /usr/local/lib
+
+    This should cover most systems, but new variations keeps cropping up.
+
+  --without-ncurses
+
+    This disables ncurses support in task, and should really be used as a last
+    resort.  We know of no systems where this is needed.
+
+If trying these options does not succeed, please send the contents of the
+'config.log' files to support@taskwarrior.org, or post a message in the support
+forums at taskwarrior.org along with the information.
+
+If configure runs, but task does not build, when ideally you would send both the
+contents of config.log, and a transcript from the build, which is not written to
+a file, and must be captured from the terminal.
+
+---

binary/COPYING.txt

@@ -1,281 +0,0 @@
-		    GNU GENERAL PUBLIC LICENSE
-		       Version 2, June 1991
-
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.
-     51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-			    Preamble
-
-  The licenses for most software are designed to take away your
-freedom to share and change it.  By contrast, the GNU General Public
-License is intended to guarantee your freedom to share and change free
-software--to make sure the software is free for all its users.  This
-General Public License applies to most of the Free Software
-Foundation's software and to any other program whose authors commit to
-using it.  (Some other Free Software Foundation software is covered by
-the GNU Library General Public License instead.)  You can apply it to
-your programs, too.
-
-  When we speak of free software, we are referring to freedom, not
-price.  Our General Public Licenses are designed to make sure that you
-have the freedom to distribute copies of free software (and charge for
-this service if you wish), that you receive source code or can get it
-if you want it, that you can change the software or use pieces of it
-in new free programs; and that you know you can do these things.
-
-  To protect your rights, we need to make restrictions that forbid
-anyone to deny you these rights or to ask you to surrender the rights.
-These restrictions translate to certain responsibilities for you if you
-distribute copies of the software, or if you modify it.
-
-  For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must give the recipients all the rights that
-you have.  You must make sure that they, too, receive or can get the
-source code.  And you must show them these terms so they know their
-rights.
-
-  We protect your rights with two steps: (1) copyright the software, and
-(2) offer you this license which gives you legal permission to copy,
-distribute and/or modify the software.
-
-  Also, for each author's protection and ours, we want to make certain
-that everyone understands that there is no warranty for this free
-software.  If the software is modified by someone else and passed on, we
-want its recipients to know that what they have is not the original, so
-that any problems introduced by others will not reflect on the original
-authors' reputations.
-
-  Finally, any free program is threatened constantly by software
-patents.  We wish to avoid the danger that redistributors of a free
-program will individually obtain patent licenses, in effect making the
-program proprietary.  To prevent this, we have made it clear that any
-patent must be licensed for everyone's free use or not licensed at all.
-
-  The precise terms and conditions for copying, distribution and
-modification follow.
-
-		    GNU GENERAL PUBLIC LICENSE
-   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
-  0. This License applies to any program or other work which contains
-a notice placed by the copyright holder saying it may be distributed
-under the terms of this General Public License.  The "Program", below,
-refers to any such program or work, and a "work based on the Program"
-means either the Program or any derivative work under copyright law:
-that is to say, a work containing the Program or a portion of it,
-either verbatim or with modifications and/or translated into another
-language.  (Hereinafter, translation is included without limitation in
-the term "modification".)  Each licensee is addressed as "you".
-
-Activities other than copying, distribution and modification are not
-covered by this License; they are outside its scope.  The act of
-running the Program is not restricted, and the output from the Program
-is covered only if its contents constitute a work based on the
-Program (independent of having been made by running the Program).
-Whether that is true depends on what the Program does.
-
-  1. You may copy and distribute verbatim copies of the Program's
-source code as you receive it, in any medium, provided that you
-conspicuously and appropriately publish on each copy an appropriate
-copyright notice and disclaimer of warranty; keep intact all the
-notices that refer to this License and to the absence of any warranty;
-and give any other recipients of the Program a copy of this License
-along with the Program.
-
-You may charge a fee for the physical act of transferring a copy, and
-you may at your option offer warranty protection in exchange for a fee.
-
-  2. You may modify your copy or copies of the Program or any portion
-of it, thus forming a work based on the Program, and copy and
-distribute such modifications or work under the terms of Section 1
-above, provided that you also meet all of these conditions:
-
-    a) You must cause the modified files to carry prominent notices
-    stating that you changed the files and the date of any change.
-
-    b) You must cause any work that you distribute or publish, that in
-    whole or in part contains or is derived from the Program or any
-    part thereof, to be licensed as a whole at no charge to all third
-    parties under the terms of this License.
-
-    c) If the modified program normally reads commands interactively
-    when run, you must cause it, when started running for such
-    interactive use in the most ordinary way, to print or display an
-    announcement including an appropriate copyright notice and a
-    notice that there is no warranty (or else, saying that you provide
-    a warranty) and that users may redistribute the program under
-    these conditions, and telling the user how to view a copy of this
-    License.  (Exception: if the Program itself is interactive but
-    does not normally print such an announcement, your work based on
-    the Program is not required to print an announcement.)
-
-These requirements apply to the modified work as a whole.  If
-identifiable sections of that work are not derived from the Program,
-and can be reasonably considered independent and separate works in
-themselves, then this License, and its terms, do not apply to those
-sections when you distribute them as separate works.  But when you
-distribute the same sections as part of a whole which is a work based
-on the Program, the distribution of the whole must be on the terms of
-this License, whose permissions for other licensees extend to the
-entire whole, and thus to each and every part regardless of who wrote it.
-
-Thus, it is not the intent of this section to claim rights or contest
-your rights to work written entirely by you; rather, the intent is to
-exercise the right to control the distribution of derivative or
-collective works based on the Program.
-
-In addition, mere aggregation of another work not based on the Program
-with the Program (or with a work based on the Program) on a volume of
-a storage or distribution medium does not bring the other work under
-the scope of this License.
-
-  3. You may copy and distribute the Program (or a work based on it,
-under Section 2) in object code or executable form under the terms of
-Sections 1 and 2 above provided that you also do one of the following:
-
-    a) Accompany it with the complete corresponding machine-readable
-    source code, which must be distributed under the terms of Sections
-    1 and 2 above on a medium customarily used for software interchange; or,
-
-    b) Accompany it with a written offer, valid for at least three
-    years, to give any third party, for a charge no more than your
-    cost of physically performing source distribution, a complete
-    machine-readable copy of the corresponding source code, to be
-    distributed under the terms of Sections 1 and 2 above on a medium
-    customarily used for software interchange; or,
-
-    c) Accompany it with the information you received as to the offer
-    to distribute corresponding source code.  (This alternative is
-    allowed only for noncommercial distribution and only if you
-    received the program in object code or executable form with such
-    an offer, in accord with Subsection b above.)
-
-The source code for a work means the preferred form of the work for
-making modifications to it.  For an executable work, complete source
-code means all the source code for all modules it contains, plus any
-associated interface definition files, plus the scripts used to
-control compilation and installation of the executable.  However, as a
-special exception, the source code distributed need not include
-anything that is normally distributed (in either source or binary
-form) with the major components (compiler, kernel, and so on) of the
-operating system on which the executable runs, unless that component
-itself accompanies the executable.
-
-If distribution of executable or object code is made by offering
-access to copy from a designated place, then offering equivalent
-access to copy the source code from the same place counts as
-distribution of the source code, even though third parties are not
-compelled to copy the source along with the object code.
-
-  4. You may not copy, modify, sublicense, or distribute the Program
-except as expressly provided under this License.  Any attempt
-otherwise to copy, modify, sublicense or distribute the Program is
-void, and will automatically terminate your rights under this License.
-However, parties who have received copies, or rights, from you under
-this License will not have their licenses terminated so long as such
-parties remain in full compliance.
-
-  5. You are not required to accept this License, since you have not
-signed it.  However, nothing else grants you permission to modify or
-distribute the Program or its derivative works.  These actions are
-prohibited by law if you do not accept this License.  Therefore, by
-modifying or distributing the Program (or any work based on the
-Program), you indicate your acceptance of this License to do so, and
-all its terms and conditions for copying, distributing or modifying
-the Program or works based on it.
-
-  6. Each time you redistribute the Program (or any work based on the
-Program), the recipient automatically receives a license from the
-original licensor to copy, distribute or modify the Program subject to
-these terms and conditions.  You may not impose any further
-restrictions on the recipients' exercise of the rights granted herein.
-You are not responsible for enforcing compliance by third parties to
-this License.
-
-  7. If, as a consequence of a court judgment or allegation of patent
-infringement or for any other reason (not limited to patent issues),
-conditions are imposed on you (whether by court order, agreement or
-otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License.  If you cannot
-distribute so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you
-may not distribute the Program at all.  For example, if a patent
-license would not permit royalty-free redistribution of the Program by
-all those who receive copies directly or indirectly through you, then
-the only way you could satisfy both it and this License would be to
-refrain entirely from distribution of the Program.
-
-If any portion of this section is held invalid or unenforceable under
-any particular circumstance, the balance of the section is intended to
-apply and the section as a whole is intended to apply in other
-circumstances.
-
-It is not the purpose of this section to induce you to infringe any
-patents or other property right claims or to contest validity of any
-such claims; this section has the sole purpose of protecting the
-integrity of the free software distribution system, which is
-implemented by public license practices.  Many people have made
-generous contributions to the wide range of software distributed
-through that system in reliance on consistent application of that
-system; it is up to the author/donor to decide if he or she is willing
-to distribute software through any other system and a licensee cannot
-impose that choice.
-
-This section is intended to make thoroughly clear what is believed to
-be a consequence of the rest of this License.
-
-  8. If the distribution and/or use of the Program is restricted in
-certain countries either by patents or by copyrighted interfaces, the
-original copyright holder who places the Program under this License
-may add an explicit geographical distribution limitation excluding
-those countries, so that distribution is permitted only in or among
-countries not thus excluded.  In such case, this License incorporates
-the limitation as if written in the body of this License.
-
-  9. The Free Software Foundation may publish revised and/or new versions
-of the General Public License from time to time.  Such new versions will
-be similar in spirit to the present version, but may differ in detail to
-address new problems or concerns.
-
-Each version is given a distinguishing version number.  If the Program
-specifies a version number of this License which applies to it and "any
-later version", you have the option of following the terms and conditions
-either of that version or of any later version published by the Free
-Software Foundation.  If the Program does not specify a version number of
-this License, you may choose any version ever published by the Free Software
-Foundation.
-
-  10. If you wish to incorporate parts of the Program into other free
-programs whose distribution conditions are different, write to the author
-to ask for permission.  For software which is copyrighted by the Free
-Software Foundation, write to the Free Software Foundation; we sometimes
-make exceptions for this.  Our decision will be guided by the two goals
-of preserving the free status of all derivatives of our free software and
-of promoting the sharing and reuse of software generally.
-
-			    NO WARRANTY
-
-  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
-FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
-OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
-PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
-OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
-TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
-PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
-REPAIR OR CORRECTION.
-
-  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
-REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
-INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
-OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
-TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
-YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
-PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGES.
-
-		     END OF TERMS AND CONDITIONS
-

binary/README.txt

@@ -1,51 +0,0 @@
-Thank you for taking a look at task.  Task is a GTD utility featuring:
-
-  - Robust C++ implementation
-  - Tags
-  - Colorful, tabular output
-  - Reports, graphs
-  - Lots of commands
-  - Low-level API
-  - Abbreviations for all commands, options
-  - Multi-user file locking
-  - Clean architecture allowing quick addition of new features
-  - Recurring tasks
-
-It is intended that features, mainly in the form of reports will be added
-frequently, with best practices and useful reports evolving from usage patterns.
-
-Task is scope-limited to GTD functionality only.
-
-You may want to watch the old task movie on YouTube:
-
-  http://www.youtube.com/watch?v=l68LCl6BYvs
-
-or the new improved one:
-
-  http://www.youtube.com/watch?v=D2Kn4DMOVSw
-
-Either will give you a fairly good idea of what task is capable of, and
-whether it fits in to your way of working.  As a command line application,
-task is not for everyone and some of you may prefer to not proceed.  The
-movie or online tutorial file are the quickest way for you to make that
-decision.  The online tutorial can be found at:
-
-  http://www.beckingham.net/task.html
-
-Task is based on ideas presented in the todo.sh script, found on:
-
-  http://todotxt.org
-
-Task has many more features than todo.sh, but fundamentally, they are
-both working toward the same goals, which is to help you follow basic
-Getting Things Done (GTD) principles.
-
-All feedback is welcome, in addition to any bug reports or patches to:
-
-  task@beckingham.net
-
-Got an idea for an enhancement?  Send a message!
-
-I have found that task makes me more productive and organized.
-I hope task can do the same for you.  
-

configure.ac

@@ -2,55 +2,179 @@
 # Process this file with autoconf to produce a configure script.
 
 AC_PREREQ(2.61)
-AC_INIT(task, 1.6.0, bugs@beckingham.net)
+AC_INIT(task, 1.9.1, support@taskwarrior.org)
 
-CFLAGS="${CFLAGS=}"
-CXXFLAGS="${CXXFLAGS=}"
-# this macro is used to get the arguments supplied
-# to the configure script (./configure --enable-debug)
-# Check if we have enable debug support.
-AC_MSG_CHECKING(whether to enable debugging)
-debug_default="yes"
-AC_ARG_ENABLE(debug, [  --enable-debug=[no/yes] turn on debugging
-                       [default=$debug_default]],, enable_debug=$debug_default)
-# Yes, shell scripts can be used
-if test "$enable_debug" = "yes"; then
-  CXXFLAGS="$CFLAGS -Wall -pedantic -ggdb3 -DDEBUG"
-  AC_MSG_RESULT(yes)
-else
-  CXXFLAGS="$CFLAGS -Wall -pedantic -O3"
-  AC_MSG_RESULT(no)
-fi
 
-# Check for OS.
-OS=`uname|sed -e 'y/ABCDEFGHIJKLMNOPQRSTUVWXYZ/abcdefghijklmnopqrstuvwxyz/'`
-if test "$OS" = "sunos"; then
-  AC_MSG_NOTICE([OS Solaris detected])
-  AC_DEFINE([SOLARIS], [], [Compiling on Solaris])
-else
-  AC_MSG_NOTICE([OS Non-Solaris detected])
-  AC_DEFINE([LINUX], [], [Compiling on Non-Solaris])
-fi
-
-AM_INIT_AUTOMAKE
-AC_CONFIG_SRCDIR([src/task.cpp])
-AC_CONFIG_HEADER([auto.h])
-
-# Checks for programs.
+# Source type.
 AC_PROG_CXX
 AC_PROG_CC
 AC_LANG(C++)
 
-AC_SUBST(CFLAGS)
 
-# Checks for libraries.
-AC_CHECK_LIB(ncurses,initscr)
+# Local copies for modification and later AC_SUBST.
+CFLAGS="${CFLAGS=}"
+CXXFLAGS="${CXXFLAGS=}"
+
+
+# this macro is used to get the arguments supplied
+# to the configure script (./configure --enable-debug)
+# Check if we have enable debug support.
+AC_MSG_CHECKING(whether to enable debugging)
+debug_default="no"
+AC_ARG_ENABLE(debug, [  --enable-debug=[no/yes] turn on debugging
+                       [default=$debug_default]],, enable_debug=$debug_default)
+
+if test "x$enable_debug" = "xyes"; then
+  CFLAGS="$CFLAGS -Wall -pedantic -ggdb3 -DDEBUG"
+  CXXFLAGS="$CXXFLAGS -Wall -pedantic -ggdb3 -DDEBUG"
+  AC_MSG_RESULT(yes)
+else
+  CFLAGS="$CFLAGS -Wall -pedantic -O3"
+  CXXFLAGS="$CXXFLAGS -Wall -pedantic -O3"
+  AC_MSG_RESULT(no)
+fi
+
+
+# Check for OS.
+OS=`uname|sed -e 'y/ABCDEFGHIJKLMNOPQRSTUVWXYZ/abcdefghijklmnopqrstuvwxyz/'|cut -c 1-5`
+if test "$OS" = "sunos"; then
+  AC_MSG_NOTICE([OS Solaris detected])
+  AC_DEFINE([SOLARIS], [], [Compiling on Solaris])
+elif test "$OS" = "darwi"; then
+  AC_MSG_NOTICE([OS Darwin detected])
+  AC_DEFINE([DARWIN], [], [Compiling on Darwin])
+elif test "$OS" = "cygwi"; then
+  AC_MSG_NOTICE([OS Cygwin detected])
+  AC_DEFINE([CYGWIN], [], [Compiling on Cygwin])
+elif test "$OS" = "openb"; then
+  AC_MSG_NOTICE([OS OpenBSD detected])
+  AC_DEFINE([OPENBSD], [], [Compiling on OpenBSD])
+elif test "$OS" = "haiku"; then
+  AC_MSG_NOTICE([OS Haiku detected])
+  AC_DEFINE([HAIKU], [], [Compiling on Haiku])
+elif test "$OS" = "freeb"; then
+  AC_MSG_NOTICE([OS FreeBSD detected])
+  AC_DEFINE([FREEBSD], [], [Compiling on FreeBSD])
+elif test "$OS" = "linux"; then
+  AC_MSG_NOTICE([OS Linux detected])
+  AC_DEFINE([LINUX], [], [Compiling on Linux])
+else
+  AC_MSG_NOTICE([OS not detected])
+  AC_DEFINE([UNKNOWN], [], [Compiling on Unknown])
+fi
+
+
+# ncurses enabled by default.
+AC_ARG_WITH([ncurses],
+            [AS_HELP_STRING([--without-ncurses], [disable support for ncurses])],
+            [with_ncurses=no],
+            [with_ncurses=yes])
+
+AC_ARG_WITH([ncurses-inc],
+            [AS_HELP_STRING ([--with-ncurses-inc=DIR], [ncurses include files are in DIR])],
+            [ncurses_inc=$withval],
+            [ncurses_inc=''])
+
+AC_ARG_WITH([ncurses-lib],
+            [AS_HELP_STRING ([--with-ncurses-lib=DIR], [ncurses lib files are in DIR])],
+            [ncurses_lib=$withval],
+            [ncurses_lib=''])
+
+if test "x$with_ncurses" = "xyes" ; then
+  AC_DEFINE([HAVE_LIBNCURSES], [1], [Defined if you have libncurses])
+  if test -n "$ncurses_inc"; then
+    CFLAGS="$CFLAGS -I$ncurses_inc"
+    CXXFLAGS="$CXXFLAGS -I$ncurses_inc"
+  fi
+
+  if test -n "$ncurses_lib"; then
+    LDFLAGS="$LDFLAGS -L$ncurses_lib"
+  fi
+
+  AC_CHECK_LIB([ncurses],[main])
+fi
+
+
+# Readline enabled by default.
+#AC_ARG_WITH([readline],
+#            [AS_HELP_STRING([--without-readline], [disable support for readline])],
+#            [with_readline=no],
+#            [with_readline=yes])
+#
+#AC_ARG_WITH([readline-inc],
+#            [AS_HELP_STRING ([--with-readline-inc=DIR], [readline include files are in DIR])],
+#            [readline_inc=$withval],
+#            [readline_inc=''])
+#
+#AC_ARG_WITH([readline-lib],
+#            [AS_HELP_STRING ([--with-readline-lib=DIR], [readline lib files are in DIR])],
+#            [readline_lib=$withval],
+#            [readline_lib=''])
+#
+#if test "x$with_readline" = "xyes" ; then
+#  AC_DEFINE([HAVE_LIBREADLINE], [1], [Defined if you have libreadline])
+#  if test -n "$readline_inc"; then
+#    CFLAGS="$CFLAGS -I$readline_inc"
+#    CXXFLAGS="$CXXFLAGS -I$readline_inc"
+#  fi
+#
+#  if test -n "$readline_lib"; then
+#    LDFLAGS="$LDFLAGS -L$readline_lib"
+#  fi
+#
+#  AC_CHECK_LIB([readline],[main])
+#fi
+
+
+# Lua disabled by default.
+AC_ARG_WITH([lua],
+            [AS_HELP_STRING([--with-lua], [enable support for lua])],
+            [with_lua=yes],
+            [with_lua=no])
+
+AC_ARG_WITH([lua-inc],
+            [AS_HELP_STRING ([--with-lua-inc=DIR], [lua include files are in DIR])],
+            [lua_inc=$withval],
+            [lua_inc=''])
+
+AC_ARG_WITH([lua-lib],
+            [AS_HELP_STRING ([--with-lua-lib=DIR], [lua lib files are in DIR])],
+            [lua_lib=$withval],
+            [lua_lib=''])
+
+if test "x$with_lua" = "xyes" ; then
+  AC_DEFINE([HAVE_LIBLUA], [1], [Defined if you have liblua])
+  if test -n "$lua_inc"; then
+    CFLAGS="$CFLAGS -I$lua_inc"
+    CXXFLAGS="$CXXFLAGS -I$lua_inc"
+  fi
+
+  if test -n "$lua_lib"; then
+    LDFLAGS="$LDFLAGS -L$lua_lib"
+  fi
+
+  AC_CHECK_LIB([lua],[main])
+fi
+
+
+# Allow the changes above to take effect.
+AC_SUBST(CFLAGS)
+AC_SUBST(CXXFLAGS)
+AC_SUBST(LDFLAGS)
+
+
+# Now the smaller details.
+AM_INIT_AUTOMAKE
+AC_CONFIG_SRCDIR([src/main.cpp])
+AC_CONFIG_HEADER([auto.h])
+
 
 # Checks for header files.
 AC_HEADER_STDC
 AC_CHECK_HEADERS([stdlib.h sys/file.h sys/stat.h sys/time.h unistd.h])
 AC_CHECK_HEADERS([sstream string vector map])
 
+
 # Checks for typedefs, structures, and compiler characteristics.
 AC_HEADER_STDBOOL
 AC_C_CONST
@@ -59,15 +183,19 @@ AC_TYPE_SIZE_T
 AC_HEADER_TIME
 AC_STRUCT_TM
 
+
 # Checks for library functions.
 AC_FUNC_MKTIME
 AC_FUNC_SELECT_ARGTYPES
 AC_CHECK_FUNCS([select])
-#AC_CHECK_FUNC(flock, [AC_DEFINE([HAVE_FLOCK], [1], [Found flock])])
 AC_CHECK_FUNC(uuid_unparse_lower, [AC_DEFINE([HAVE_UUID], [1], [Found uuid_unparse_lower])])
 AC_CHECK_FUNC(random, [AC_DEFINE([HAVE_RANDOM], [1], [Found random])])
 AC_CHECK_FUNC(srandom, [AC_DEFINE([HAVE_SRANDOM], [1], [Found srandom])])
 
+
+# Generate the Makefiles.
 AC_CONFIG_FILES([Makefile src/Makefile])
 AC_OUTPUT
 
+# End.
+

doc/man/task-color.5

@@ -0,0 +1,274 @@
+.TH task-color 5 2010-05-22 "task 1.9.1" "User Manuals"
+
+.SH NAME
+task-color \- A color tutorial for the task(1) command line todo manager.
+
+.SH SETUP
+The first thing you need is a terminal program that supports color.  All
+terminal programs support color, but only a few support lots of colors.  First
+tell your terminal program to use color by specifying the TERM environment
+variable like this:
+
+    TERM=xterm-color
+
+In this example, xterm-color is used - a common value, and one that doesn't
+require that you use xterm.  This works for most setups.  This setting belongs
+in your shell profile (~/.bash_profile, ~/.bashrc, ~/.cshrc etc, depending on
+which shell you use).  If this is a new setting, you will need to either run
+that profile script, or close and reopen the terminal window (which does the
+same thing).
+
+Now tell task that you want to use color.  This is the default for task, so
+the following step may be unnecessary.
+
+    $ task config color on
+
+This command will make sure there is an entry in your ~/.taskrc file that looks
+like:
+
+    color=on
+
+Now task is ready.
+
+.SH AUTOMATIC MONOCHROME
+It should be mentioned that task is aware of whether it's output is going to a
+terminal, or to a file or through a pipe.  When task output goes to a terminal,
+color is desirable, but consider the following command:
+
+    $ task list > file.txt
+
+Do we really want all those color control codes in the file?  Task assumes that
+you do not, and temporarily sets color to 'off' while generating the output.
+This explains the output from the following command:
+
+    $ task config | grep '^color '
+    color                        off
+
+it always returns 'off', no matter what the setting.
+
+The reason is that the task output gets piped into grep, and the color is
+disabled.  If you wanted those color codes, you can override this behavior by
+setting the _forcecolor variable to on, like this:
+
+    $ task config _forcecolor on
+    $ task config | grep '^color '
+    color                        on
+
+or by temporarily overriding it like this:
+
+    $ task rc._forcecolor=on config | grep '^color '
+    color                        on
+
+.SH AVAILABLE COLORS
+Task has a 'color' command that will show all the colors it is capable of
+displaying.  Try this:
+
+    $ task color
+
+The output cannot be replicated here in a man page, but you should see a set of
+color samples.  How many you see depends on your terminal program's ability to
+render them.
+
+You should at least see the Basic colors and Effects - if you do, then you have
+16-color support.  If your terminal supports 256 colors, you'll know it!
+
+.SH 16-COLOR SUPPORT
+The basic color support is provided through named colors:
+
+    black, red, blue, green, magenta, cyan, yellow, white
+
+Foreground color (for text) is simply specified as one of the above colors, or
+not specified at all to use the default terminal text color.
+
+Background color is specified by using the word 'on', and one of the above
+colors.  Some examples:
+
+    green                 # green text, default background color
+    green on yellow       # green text, yellow background
+    on yellow             # default text color, yellow background
+
+These colors can be modified further, by making the foreground bold, or by
+making the background bright.  Some examples:
+
+    bold green
+    bold white on bright red
+    on bright cyan
+
+The order of the words is not important, so the following are equivalent:
+
+    bold green
+    green bold
+
+But the 'on' is important - colors before the 'on' are foreground, and colors
+after 'on' are background.
+
+There is an additional 'underline' attribute that may be used:
+
+    underline bright red on black
+
+Task has a command that helps you visualize these color combinations.  Try this:
+
+    $ task color underline bright red on black
+
+You can use this command to see how the various color combinations work.  You
+will also see some sample colors displayed, like the ones above, in addition to
+the sample requested.
+
+Some combinations look very nice, some look terrible.  Different terminal
+programs do implement slightly different versions of 'red', for example, so you
+may see some unwanted variation due to the program.  The brightness of your
+display is also a factor.
+
+.SH 256-COLOR SUPPORT
+
+Using 256 colors follows the same form, but the names are different, and some
+colors can be referenced in different ways.  First there is by color ordinal,
+which is like this:
+
+    color0
+    color1
+    color2
+    ...
+    color255
+
+This gives you access to all 256 colors, but doesn't help you much.  This range
+is a combination of 8 basic colors (color0 - color7), then 8 brighter variations
+(color8 - color15).  Then a block of 216 colors (color16 - color231).  Then a
+block of 24 gray colors (color232 - color255).
+
+The large block of 216 colors (6x6x6 = 216) represents a color cube, which can
+be addressed via RGB values from 0 to 5 for each component color.  A value of 0
+means none of this component color, and a value of 5 means the most intense
+component color.  For example, a bright red is specified as:
+
+    rgb500
+
+And a darker red would be:
+
+    rgb300
+
+Note that the three digits represent the three component values, so in this
+example the 5, 0 and 0 represent red=5, green=0, blue=0.  Combining intense red
+with no green and no blue yields red.  Similarly, blue and green are:
+
+    rgb005
+    rgb050
+
+Another example - bright yellow - is a mix of bright red and bright green, but
+no blue component, so bright yellow is addressed as:
+
+    rgb550
+
+A soft pink would be addressed as:
+
+    rgb515
+
+See if you agree, by running:
+
+    $ task color black on rgb515
+
+You may notice that the large color block is represented as 6 squares.  All
+colors in the first square have a red value of 0.  All colors in the 6th square
+have a red value of 5.  Within each square, blue ranges from 0 to 5 left to
+right, and within each square green ranges from 0 to 5, top to bottom.  This
+scheme takes some getting used to.
+
+The block of 24 gray colors can also be accessed as gray0 - gray23, in a
+continuous ramp from black to white.
+
+.SH MIXING 16- AND 256-COLORS
+
+If you specify 16-colors, and view on a 256-color terminal, no problem.  If you
+try the reverse, specifying 256-colors and viewing on a 16-color terminal, you
+will be disappointed, perhaps even appalled.
+
+There is some limited color mapping - for example, if you were to specify this
+combination:
+
+    red on gray3
+
+you are mixing a 16-color and 256-color specification.  Task will map red to
+color1, and proceed.  Note that red and color1 are not quite the same.
+
+Note also that there is no bold or bright attributes when dealing with 256
+colors, but there is still underline available.
+
+.SH RULES
+Task supports colorization rules.  These are configuration values that specify
+a color, and the conditions under which that color is used.  By example, let's
+add a few tasks:
+
+    $ task add project:Home priority:H pay the bills               (1)
+    $ task add project:Home            clean the rug               (2)
+    $ task add project:Garden          clean out the garage        (3)
+
+We can add a color rule that uses a blue background for all tasks in the Home
+project:
+
+    $ task config color.project.Home on blue
+
+We use quotes around "on blue" because there are two words, but they represent
+one value in the .taskrc file.  Now suppose we which to use a bold yellow text
+color for all cleaning work:
+
+    $ task config color.keyword.clean bold yellow
+
+Now what happens to task 2, which belongs to project Home (blue background), and
+is also a cleaning task (bold yellow foreground)?  The colors are combined, and
+the task is shown as "bold yellow on blue".
+
+Color rules can be applied by project and description keyword, as shown, and
+also by priority (or lack of priority), by active status, by being due or
+overdue, by being tagged, or having a specific tag (perhaps the most useful
+rule) or by being a recurring task.
+
+It is possible to create a very colorful mix of rules.  With 256-color support,
+those colors can be made subtle, and complementary, but without care, this can
+be a visual mess.  Beware!
+
+.SH THEMES
+Task supports themes.  What this really means is that with the ability to
+include other files into the .taskrc file, different sets of color rules can
+be included.
+
+To get a good idea of what a color theme looks like, try adding this entry to
+your .taskrc file:
+
+    include /usr/local/share/doc/task/themes/dark-256.theme
+
+Better yet, create your own, and share it.
+
+.SH "CREDITS & COPYRIGHTS"
+task was written by P. Beckingham <paul@beckingham.net>.
+.br
+Copyright (C) 2006 \- 2010 P. Beckingham
+
+This man page was originally written by Paul Beckingham.
+
+task is distributed under the GNU General Public License. See
+http://www.gnu.org/licenses/gpl-2.0.txt for more information.
+
+.SH SEE ALSO
+.BR task(1),
+.BR taskrc(5),
+.BR task-faq(5)
+.BR task-tutorial(5)
+
+For more information regarding task, the following may be referenced:
+
+.TP
+The official site at
+<http://taskwarrior.org>
+
+.TP
+The official code repository at
+<git://tasktools.org/task.git/>
+
+.TP
+You can contact the project by writing an email to
+<support@taskwarrior.org>
+
+.SH REPORTING BUGS
+.TP
+Bugs in task may be reported to the issue-tracker at
+<http://taskwarrior.org>

doc/man/task-faq.5

@@ -0,0 +1,197 @@
+.TH task-faq 5 2010-05-22 "task 1.9.1" "User Manuals"
+
+.SH NAME
+task-faq \- A FAQ for the task(1) command line todo manager.
+
+.SH DESCRIPTION
+Task is a command line TODO list manager. It maintains a list of tasks that you
+want to do, allowing you to add/remove, and otherwise manipulate them.  Task
+has a rich list of commands that allow you to do various things with it.
+
+.SH WELCOME
+Welcome to the task FAQ.  If you have would like to see a question answered
+here, please send us a note at <support@taskwarrior.org>.
+
+.TP
+.B Q: Where does task store the data?
+By default, task creates a .taskrc file in your home directory and populates it
+with defaults.  Task also creates a .task directory in your home directory and
+puts data files there.
+
+.TP
+.B Q: Can I edit that data?
+Of course you can.  It is a simple text file, and looks somewhat like the JSON
+format, and if you are careful not to break the format, there is no reason not
+to edit it.  But task provides a rich command set to do that manipulation for
+you, so it is probably best to leave those files alone.
+
+.TP
+.B Q: How do I restore my .taskrc file to defaults?
+If you delete (or rename) your .taskrc file, task will offer to create a default
+one for you.  Another way to do this is with the command:
+
+    $ task rc:new-file version
+
+Task will create 'new-file' if it doesn't already exist.  Note that this is a
+good way to learn about new configuration settings, if your .taskrc file was
+created by an older version of task.
+
+.TP
+.B Q: Do I need to back up my task data?
+Yes.  You should back up your ~/.task directory, and probably your ~/.taskrc
+file too.
+
+.TP
+.B Q: Can I share my tasks between different machines?
+Yes, you can.  Most people have success with a DropBox - a free and secure file
+synching tool.  Simply configure task to store it's data in a dropbox folder, by
+modifying the:
+
+    data.location=...
+
+configuration variable.  Check out DropBox at http://www.dropbox.com.
+
+.TP
+.B Q: The undo.data file gets very large - do I need it?
+You need it if you want the undo capability.  But if it gets large, you can
+certainly truncate it to save space, just be careful to delete lines from the
+top of the file, up to and including a separator '---'.  The simplest way is to
+simply delete the undo.data file.  Note that it does not slow down task, because
+task never reads it until you want to undo.  Otherwise task only appends to the
+file.
+
+.TP
+.B Q: How do I know whether my terminal support 256 colors?
+You will need to make sure your TERM environment variable is set to xterm-color,
+otherwise the easiest way is to just try it!  With task 1.9 or later, you simply
+run
+
+    $ task color
+
+and a full color palette is displayed.  If you see only 8 or 16 colors, perhaps
+with those colors repeated, then your terminal does not support 256 colors.
+
+See the task-color(5) man page for more details.
+
+.TP
+.B Q: How do I make use of all these colors?
+See the task-color(5) man page for an in-depth explanation of the task color
+rules.
+
+.TP
+.B Q: How can I make task put the command in the terminal window title?
+You cannot.  But you can make the shell do it, and you can make the shell
+call the task program.  Here is a Bash script that does this:
+
+    #! /bin/bash
+
+    printf "\\033]0;task $*\a"
+    /usr/local/bin/task $*
+
+You just need to run the script, and let the script run task.  Here is a Bash
+function that does the same thing:
+
+    t ()
+    {
+      printf "\\033]0;task $*\a"
+      /usr/local/bin/task $*
+    }
+
+.TP
+.B Q: Task searches in a case-sensitive fashion - can I change that?
+You can.  Just set the following value in your .taskrc file:
+
+    search.case.sensitive=no
+
+This will affect searching for keywords:
+
+    $ task list Document
+
+task will perform a caseless search in the description and any annotations for
+the keyword 'Document'.  It also affects description and annotation
+substitutions:
+
+    $ task 1 /teh/the/
+
+The pattern on the left will now be a caseless search term.
+
+.TP
+.B Q: Why do the task ID numbers change?
+Task does this to always show you the smallest numbers it can.  The idea is that
+if your tasks are numbered 1 - 33, for example, those are easy to type in.  If
+instead task kept a rolling sequence number, after a while your tasks might be
+numbered 481 - 513, which makes it more likely to enter one incorrectly, because
+there are more digits.
+
+When you run a report (such as "list"), task assigns the numbers before it
+displays them.  For example, you can do this:
+
+    $ task list
+    $ task do 12
+    $ task add Pay the rent
+    $ task delete 31
+
+Those id numbers are then good until the next report is run.  This is because
+task performs a garbage-collect operation on the pending tasks file when a
+report is run, which moves the deleted and completed tasks from the pending.data
+file to the completed.data file.  This keeps the pending tasks file small, and
+therefore keeps task fast.  The completed data file is the one that grows
+unbounded with use, but that one isn't accessed as much, so it doesn't matter as
+much.  So in all, the ID number resequencing is about efficiency.
+
+.TP
+.B Q: How do I list tasks that are either priority 'H' or 'M', but not 'L'?
+Task's filters are all combined with and implicit logical AND operator, so if
+you were to try this:
+
+    $ task list priority:H priority:M
+
+There would be no results, because the priority could not simultaneously be 'H'
+AND 'M'.  What is required is some way to use OR instead of an AND operator. The
+solution is to invert the filter in this way:
+
+    $ task list priority.not:L priority.any:
+
+This filter states that the priority must not be 'L', AND there must be a
+priority assigned.  This filter then properly lists tasks that are 'H' or 'M',
+because the two logical restrictions are not mutually exclusive as in the
+original filter.
+
+Some of you may be familiar with DeMorgan's laws of formal logic that relate
+the AND and OR operators in terms of each other via negation, which can be used
+to construct task filters.
+
+.SH "CREDITS & COPYRIGHTS"
+task was written by P. Beckingham <paul@beckingham.net>.
+.br
+Copyright (C) 2006 \- 2010 P. Beckingham
+
+This man page was originally written by P. Beckingham.
+
+task is distributed under the GNU General Public License.  See
+http://www.gnu.org/licenses/gpl-2.0.txt for more information.
+
+.SH SEE ALSO
+.BR task(1),
+.BR taskrc(5),
+.BR task-tutorial(5)
+.BR task-color(5)
+
+For more information regarding task, the following may be referenced:
+
+.TP
+The official site at
+<http://taskwarrior.org>
+
+.TP
+The official code repository at
+<git://tasktools.org/task.git/>
+
+.TP
+You can contact the project by writing an email to
+<support@taskwarrior.org>
+
+.SH REPORTING BUGS
+.TP
+Bugs in task may be reported to the issue-tracker at
+<http://taskwarrior.org>

doc/man/task-tutorial.5

@@ -0,0 +1,398 @@
+.TH task-tutorial 5 2010-05-22 "task 1.9.1" "User Manuals"
+
+.SH NAME
+task-tutorial \- A tutorial for the task(1) command line todo manager.
+
+.SH NOTE
+Please note that this tutorial was written for task 1.7.0. Though it is still
+accurate on the general usage of task, it might not longer be 100% correct in
+all details. A new tutorial for task is planned for task 2.0.0.
+
+.SH DESCRIPTION
+Task is a command line TODO list manager. It maintains a list of tasks that you
+want to do, allowing you to add/remove, and otherwise manipulate them.  Task
+has a rich list of commands that allow you to do various things with it.
+
+.SH 30 second tutorial
+
+For the excessively lazy. Add two tasks:
+.br
+.RS
+$ task add Read task documents later
+.br
+$ task add priority:H Pay bills
+.RE
+
+Easy. See that second one has a High priority? Now let's look at those tasks:
+.br
+.RS
+$ task ls
+.br
+ID Project Pri Description
+.br
+ 2         H   Pay bills
+.br
+ 1             Read task documents later
+.RE
+
+They are ordered by priority. Let's mark number 2 as done:
+.br
+.RS
+$ task 2 done
+.br
+$ task ls
+.br
+ID Project Pri Description
+.br
+ 1             Read task documents later
+.RE
+
+Gone. Now let's delete that remaining task, because, well, why bother
+now we are already using task:
+.br
+.RS
+$ task delete 1
+.br
+$ task ls
+.br
+No matches
+.RE
+
+That's how easy managing your task list can be.  But now consider learning what
+task can really do...
+
+.SH Simple usage of task
+Let us begin by adding some tasks:
+.br
+.RS
+$ task add Book plane ticket
+.br
+$ task add Rent a tux
+.br
+$ task add Reserve a rental car
+.br
+$ task add Reserve a hotel room
+.RE
+
+You'll notice immediately that task has a very minimalist interface. Let us take
+a look at those tasks:
+.br
+.RS
+$ task ls
+.br
+ID Project Pri Description
+.br
+ 1             Book plane ticket
+.br
+ 2             Rent a tux
+.br
+ 3             Reserve a rental car
+.br
+ 4             Send John a birthday card
+.RE
+
+The 'ls' command provides the most minimal list of tasks. Each task has
+been given an id number, and you can see that there are no projects or
+priorities assigned. Wait a minute - I own a tux, I don't need to rent
+one. Let us delete task 2:
+.br
+.RS
+$ task 2 delete
+.br
+Permanently delete task? (y/n) y
+.RE
+
+Task wants you to confirm deletions. To suppress the confirmation, edit
+your .taskrc file and change the line:
+.br
+.RS
+confirmation=yes
+.RE
+.br
+to have a value of "no".  If the entry is not there, then add it.
+
+While the use of projects and priorities are not essential, they can be very
+useful when the list of tasks grows large.  Let's assign projects to these
+tasks:
+.br
+.RS
+$ task 1 project:Wedding
+.br
+$ task 3 project:Wedding
+.br
+$ task 4 project:Family
+.br
+$ task ls
+.br
+ID Project Pri Description
+.br
+ 3 Family      Send John a birthday card
+.br
+ 2 Wedding     Reserve a rental car
+.br
+ 1 Wedding     Book plane ticket
+.RE
+
+Notice that the id numbers have changed. When tasks get deleted, or have
+their attributes changed (project, for example), the ids are prone to change.
+But the id numbers will remain valid until the next 'ls' command is run.
+You should only use the ids from the most recent 'ls' command. The ids change,
+because task is always trying to use small numbers so that it is easy for you
+to enter them correctly. Now that projects are assigned, we can look at just
+the Wedding project tasks:
+
+Subprojects are supported. If you have a project "Wedding", you can specify
+that a task is a subproject "Transport" of "Wedding" by assigning the project
+"Wedding.Transport". Let's do this:
+.br
+.RS
+$ task 2 project:Wedding.Transport
+.br
+$ task ls
+.br
+ID Project           Pri Description
+.br
+ 3 Family                Send John a birthday card
+.br
+ 2 Wedding.Transport     Reserve a rental car
+.br
+ 1 Wedding               Book plane ticket
+.RE
+
+Task matches the leftmost part of the project when searching, so projects may be
+abbreviated:
+.br
+.RS
+$ task ls project:Wedding.Tra
+.br
+ID Project           Pri Description
+.br
+ 2 Wedding.Transport     Reserve a rental car
+.RE
+
+This way of matching projects can be used to see all tasks under the "Wedding"
+project and all subprojects:
+.br
+.RS
+$ task ls project:Wedding
+.br
+ID Project           Pri Description
+.br
+ 2 Wedding.Transport     Reserve a rental car
+.br
+ 1 Wedding               Book plane ticket
+.RE
+
+Let's reassign 2 back to the "Wedding" project:
+.br
+.RS
+$ task 2 project:Wedding
+.RE
+
+Now that projects are assigned, we can look at just the Wedding project tasks:
+.br
+.RS
+$ task ls project:Wedding
+.br
+ID Project Pri Description
+.br
+ 1 Wedding     Book plane ticket
+.br
+ 2 Wedding     Reserve a rental car
+.RE
+
+Any command arguments after the 'ls' are used for filtering the output.
+We could also have requested:
+.br
+.RS
+$ task ls ticket plane
+.br
+ID Project Pri Description
+.br
+ 1 Wedding     Book plane ticket
+.RE
+
+Now let's prioritize. Priorities can be H, M or L (High, Medium, Low).
+.br
+.RS
+$ task ls
+.br
+ID Project Pri Description
+.br
+ 3 Family      Send John a birthday card
+.br
+ 2 Wedding     Reserve a rental car
+.br
+ 1 Wedding     Book plane ticket
+.br
+$ task 1 priority:H
+.br
+$ task 2 prior:M
+.br
+$ task 3 pr:H
+.br
+Ambiguous attribute 'pr' - could be either of project, priority
+.br
+$ task 3 pri:H
+.br
+$ task ls
+.br
+ID Project Pri Description
+.br
+ 3 Family  H   Send John a birthday card
+.br
+ 1 Wedding H   Book plane ticket
+.br
+ 2 Wedding M   Reserve a rental car
+.RE
+
+Notice that task supports the abbreviation of words such as priority and
+project. Priority can be abbreviated to pri, but not pr, because it is
+ambiguous. Now that tasks have been prioritized, you can see that the tasks are
+being sorted by priority, with the highest priority tasks at the top.
+
+These attributes can all be provided when the task is added, instead of applying
+them afterwards, as shown. The following command shows how to set all the
+attributes at once:
+.br
+.RS
+$ task add project:Wedding priority:H Book plane ticket
+.RE
+
+The sequence of those arguments is not important, so you could have entered the
+following command instead:
+.br
+.RS
+$ task project:Wedding add Book plane priority:H ticket
+.RE
+
+This is because task knows what attributes look like (name:value), knows what
+commands it supports (add, ...), and just assumes the rest is part of the
+description.  Incidentally, if you wanted 'priority:H' to be part of your task
+description, you need to fool task into ignoring it as an attribute.  That can
+be done in two ways:
+.br
+.RS
+$ task add "quoting makes task consider priority:H part of one big argument"
+$ task add -- the hyphens make task treat everything after it as description
+.RE
+
+The 'ls' command provides the least information for each task. The 'list'
+command provides more:
+.br
+.RS
+$ task list
+.br
+ID Project Pri Due Active Age    Description
+.br
+ 3 Family  H              4 mins Send John a birthday card
+.br
+ 1 Wedding H              5 mins Book plane ticket
+.br
+ 2 Wedding M              5 mins Reserve a rental car
+.RE
+
+Notice that a task can have a due date, and can be active. The task lists are
+sorted by due date, then priority. Let's add due dates:
+.br
+.RS
+$ task 3 due:6/25/2008
+.br
+$ task 1 due:7/31/2008
+.br
+$ task list
+.br
+ID Project Pri Due       Active Age    Description
+.br
+ 3 Family  H   6/25/2008        6 mins Send John a birthday card
+.br
+ 1 Wedding H   7/31/2008        7 mins Book plane ticket
+.br
+ 2 Wedding M                    7 mins Reserve a rental car
+.RE
+
+Note that due tasks may be colored to highlight the importance.  See the
+task-color(5) man page for full details.
+
+Tagging tasks is a good way to group them, aside from specifying a project.
+To add a tag to a task:
+.br
+.RS
+$ task <id> +tag
+.RE
+
+The plus sign indicates that this is a tag. Any number of tags may be applied to a
+task, and then used for searching. Tags are just single words that are labels.
+.br
+.RS
+$ task list
+.br
+ID Project Pri Due       Active Age    Description
+.br
+ 3 Family  H   6/25/2008        8 mins Send John a birthday card
+.br
+ 1 Wedding H   7/31/2008        9 mins Book plane ticket
+.br
+ 2 Wedding M                    9 mins Reserve a rental car
+.br
+$ task 1 +phone
+.br
+$ task 2 +phone
+.br
+$ task 3 +shopping
+.br
+$ task 3 +john
+.br
+$ task list +phone
+.br
+ID Project Pri Due       Active Age    Description
+.br
+ 1 Wedding H   7/31/2008        9 mins Book plane ticket
+.br
+ 2 Wedding M                    9 mins Reserve a rental car
+.RE
+
+To remove a tag from a task, use the minus sign:
+.br
+.RS
+$ task 3 \-john
+.RE
+
+.SH Advanced usage of task
+Advanced examples of the usage of task can be found at the official site at
+<http://taskwarrior.org>
+
+.SH "CREDITS & COPYRIGHTS"
+task was written by P. Beckingham <paul@beckingham.net>.
+.br
+Copyright (C) 2006 \- 2010 P. Beckingham
+
+This man page was originally written by Federico Hernandez.
+
+task is distributed under the GNU General Public License. See
+http://www.gnu.org/licenses/gpl-2.0.txt for more information.
+
+.SH SEE ALSO
+.BR task(1),
+.BR taskrc(5),
+.BR task-faq(5)
+.BR task-color(5)
+
+For more information regarding task, the following may be referenced:
+
+.TP
+The official site at
+<http://taskwarrior.org>
+
+.TP
+The official code repository at
+<git://tasktools.org/task.git/>
+
+.TP
+You can contact the project by writing an email to
+<support@taskwarrior.org>
+
+.SH REPORTING BUGS
+.TP
+Bugs in task may be reported to the issue-tracker at
+<http://taskwarrior.org>

doc/man/task.1

@@ -0,0 +1,499 @@
+.TH task 1 2010-05-22 "task 1.9.1" "User Manuals"
+
+.SH NAME
+task \- A command line todo manager.
+
+.SH SYNOPSIS
+.B task [subcommand] [args]
+
+.SH DESCRIPTION
+Task is a command line todo list manager. It maintains a list of tasks that you
+want to do, allowing you to add/remove, and otherwise manipulate them.  Task
+has a rich list of subcommands that allow you to do various things with it.
+
+.SH SUBCOMMANDS
+
+.TP
+.B add [tags] [attrs] description
+Adds a new task to the task list.
+
+.TP
+.B append [tags] [attrs] description
+Appends information to an existing task.
+
+.TP
+.B prepend [tags] [attrs] description
+Prepends information to an existing task.
+
+.TP
+.B annotate ID description
+Adds an annotation to an existing task.
+
+.TP
+.B ID [tags] [attrs] [description]
+Modifies the existing task with provided information.
+
+.TP
+.B ID /from/to/
+Performs one substitution on task description and annotation for fixing mistakes.
+
+.TP
+.B ID /from/to/g
+Performs all substitutions on task description and annotation for fixing mistakes.
+
+.TP
+.B edit ID
+Launches an editor to let you modify all aspects of a task directly.
+Use carefully.
+
+.TP
+.B undo
+Reverts the most recent action.
+
+.TP
+.B shell
+Launches an interactive shell with all the task commands available.
+
+.TP
+.B duplicate ID [tags] [attrs] [description]
+Duplicates the specified task and allows modifications.
+
+.TP
+.B delete ID
+Deletes the specified task from task list.
+
+.TP
+.B info ID
+Shows all data and metadata for the specified task.
+
+.TP
+.B start ID
+Marks the specified task as started.
+
+.TP
+.B stop ID
+Removes the
+.I start
+time from the specified task.
+
+.TP
+.B done ID [tags] [attrs] [description]
+Marks the specified task as done.
+
+.TP
+.B projects
+Lists all project names used, and the number of tasks for each.
+
+.TP
+.B tags
+Show a list of all tags used.
+
+.TP
+.B summary
+Shows a report of task status by project.
+
+.TP
+.B timesheet [weeks]
+Shows a weekly report of tasks completed and started.
+
+.TP
+.B history
+Shows a report of task history by month.
+
+.TP
+.B ghistory
+Shows a graphical report of task status by month.
+
+.TP
+.B calendar [ y | due [y] | month year [y] | year ]
+Shows a monthly calendar with due tasks marked.
+
+.TP
+.B stats
+Shows task database statistics.
+
+.TP
+.B import \fIfile
+Imports tasks from a variety of formats.
+
+.TP
+.B export \fIfile
+Exports all tasks as a CSV file.
+
+.TP
+.B color [sample]
+Displays all possible colors, or a sample.
+
+.TP
+.B version
+Shows the task version number
+
+.TP
+.B config [name [value | '']]
+Shows the current settings in the task configuration file.  Also supports
+directly modifying the .taskrc file.  This command either modifies
+the 'name' setting with a new value of 'value', or adds a new entry that
+is equivalent to 'name=value':
+
+    task config name value
+
+This command sets a blank value.  This has the effect of suppressing any
+default value:
+
+    task config name ''
+
+Finally, this command removes any 'name=...' entry from the .taskrc file:
+
+    task config name
+
+.TP
+.B help
+Shows the long usage text.
+
+.SH REPORT SUBCOMMANDS
+
+A report is a listing of information from the task database. There are several
+reports currently predefined in task. The output and sort behavior of these
+reports can be configured in the configuration file. See also the man page taskrc(5).
+
+.TP
+.B active [tags] [attrs] [description]
+Shows all tasks matching the specified criteria
+that are started but not completed.
+
+.TP
+.B all [tags] [attrs] [description]
+Shows all tasks matching the specified criteria.
+
+.TP
+.B completed [tags] [attrs] [description]
+Shows all tasks matching the specified criteria
+that are completed.
+
+.TP
+.B minimal [tags] [attrs] [description]
+Provides a minimal listing of tasks with specified criteria.
+
+.TP
+.B ls [tags] [attrs] [description]
+Provides a short listing of tasks with specified criteria.
+
+.TP
+.B list [tags] [attrs] [description]
+Provides a more detailed listing of tasks with specified criteria.
+
+.TP
+.B long [tags] [attrs] [description]
+Provides the most detailed listing of tasks with specified criteria.
+
+.TP
+.B newest [tags] [attrs] [description]
+Shows the newest tasks with specified criteria.
+
+.TP
+.B oldest [tags] [attrs] [description]
+Shows the oldest tasks with specified criteria
+
+.TP
+.B overdue [tags] [attrs] [description]
+Shows all incomplete tasks matching the specified criteria
+that are beyond their due date.
+
+.TP
+.B recurring [tags] [attrs] [description]
+Shows all recurring tasks matching the specified criteria.
+
+.TP
+.B waiting [tags] [attrs] [description]
+Shows all waiting tasks matching the specified criteria.
+
+.TP
+.B next [tags] [attrs] [description]
+Shows all tasks with upcoming due dates matching the specified criteria.
+
+.SH ATTRIBUTES AND METADATA
+
+.TP
+.B ID
+Tasks can be specified uniquely by IDs, which are simply the index of the
+task in a report. Be careful, as the IDs of tasks may change after a
+modification to the database. Always run a report to check you have the right
+ID for a task. IDs can be given to task as a sequences, for example,
+.br
+.B
+task del 1,4-10,19
+
+.TP
+.B +tag|-tag
+Tags are arbitrary words associated with a task. Use + to add a tag and - to
+remove a tag from a task. A task can have any quantity of tags
+
+.TP
+.B project:<project-name>
+Specifies the project to which a task is related to.
+
+.TP
+.B priority:H|M|L|N
+Specifies High, Medium, Low and No priority for a task.
+
+.TP
+.B due:<due-date>
+Specifies the due-date of a task.
+
+.TP
+.B recur:<frequency>
+Specifies the frequency of a recurrence of a task.
+
+.TP
+.B until:<end-date-of-recurrence>
+Specifies the Recurrence end-date of a task.
+
+.TP
+.B fg:<color-spec>
+Specifies foreground color.
+
+.TP
+.B bg:<color-spec>
+Specifies background color.
+
+.TP
+.B limit:<number-of-rows>
+Specifies the desired number of rows a report should have.
+
+.TP
+.B wait:<wait-date>
+Date until task becomes pending.
+
+.SH ATTRIBUTE MODIFIERS
+Attribute modifiers improve filters.  Supported modifiers are:
+
+.RS
+.B before     (synonyms under, below)
+.br
+.B  after      (synonyms over, above)
+.br
+.B  none
+.br
+.B  any
+.br
+.B  is         (synonym equals)
+.br
+.B  isnt       (synonym not)
+.br
+.B  has        (synonym contain)
+.br
+.B  hasnt
+.br
+.B  startswith (synonym left)
+.br
+.B  endswith   (synonym right)
+.br
+.B  word
+.br
+.B  noword
+.RE
+
+For example:
+
+.RS
+task list due.before:eom priority.not:L
+.RE
+
+.SH SPECIFYING DATES AND FREQUENCIES
+
+.SS DATES
+Task reads dates from the command line and displays dates in the
+reports.  The expected and desired date format is determined by the
+configuration variable
+.I dateformat
+in the task configuration file.
+
+.RS
+.TP
+Exact specification
+task ... due:7/14/2008
+
+.TP
+Relative wording
+task ... due:today
+.br
+task ... due:yesterday
+.br
+task ...  due:tomorrow
+
+.TP
+Day number with ordinal
+task ... due:23rd
+
+.TP
+End of week (Friday), month and year
+task ... due:eow
+.br
+task ... due:eom
+.br
+task ... due:eoy
+
+.TP
+Next occurring weekday
+task ... due:fri
+.RE
+
+.SS FREQUENCIES
+Recurrence periods. Task supports several ways of specifying the
+.I frequency
+of recurring tasks.
+
+.RS
+.TP
+daily, day, 1d, 2d, ...
+Every day or a number of days.
+
+.TP
+weekdays
+Mondays, Tuesdays, Wednesdays, Thursdays, Fridays and skipping weekend days.
+
+.TP
+weekly, 1w, 2w, ...
+Every week or a number of weeks.
+
+.TP
+biweekly, fortnight
+Every two weeks.
+
+.TP
+quarterly, 1q, 2q, ...
+Every three months, a quarter, or a number of quarters.
+
+.TP
+semiannual
+Every six months.
+
+.TP
+annual, yearly, 1y, 2y, ...
+Every year or a number of years.
+
+.TP
+biannual, biyearly, 2y
+Every two years.
+.RE
+
+
+.SH COMMAND ABBREVIATION
+All task commands may be abbreviated as long as a unique prefix is used. E.g.
+
+.RS
+$ task li
+.RE
+
+is an unambiguous abbreviation for
+
+.RS
+$ task list
+.RE
+
+but
+
+.RS
+$ task l
+.RE
+
+could be list, ls or long.
+
+.SH SPECIFYING DESCRIPTIONS
+Some task descriptions need to be escaped because of the shell
+and the special meaning of some characters to the shell. This can be
+done either by adding quotes to the description or escaping the special
+character:
+
+.RS
+$ task add "quoted ' quote"
+.br
+$ task add escaped \\' quote
+.RE
+
+The argument \-\- (a double dash) tells task to treat all other args
+as description:
+
+.RS
+$ task add -- project:Home needs scheduling
+.RE
+
+.SH CONFIGURATION FILE AND OVERRIDE OPTIONS
+Task stores its configuration in a file in the user's home directory:
+~/.taskrc . The default configuration file can be overridden with
+
+.TP
+.B task rc:<path-to-alternate-file>
+Specifies an alternate configuration file.
+
+.TP
+.B task rc.<name>:<value> ...
+Specifies individual configuration file overrides.
+
+.SH EXAMPLES
+
+For examples please see the task tutorial man page at
+
+.RS
+man task-tutorial
+.RE
+
+or the online documentation starting at
+
+.RS
+<http://taskwarrior.org/wiki/taskwarrior/Simple>
+.RE
+
+.SH FILES
+
+.TP
+~/.taskrc User configuration file - see also taskrc(5).
+
+.TP
+~/.task The default directory where task stores its data files. The location
+can be configured in the configuration file.
+
+.TP
+~/.task/pending.data The file that contains the tasks that are not yet done.
+
+.TP
+~/.task/completed.data The file that contains the completed "done" tasks.
+
+.TP
+~/.task/undo.data The file that contains the information to the "undo" command.
+
+.SH "CREDITS & COPYRIGHTS"
+task was written by P. Beckingham <paul@beckingham.net>.
+.br
+Copyright (C) 2006 \- 2010 P. Beckingham
+
+This man page was originally written by P.C. Shyamshankar, and has been modified
+and supplemented by Federico Hernandez.
+
+task is distributed under the GNU General Public License.  See
+http://www.gnu.org/licenses/gpl-2.0.txt for more information.
+
+.SH SEE ALSO
+.BR taskrc(5),
+.BR task-tutorial(5),
+.BR task-faq(5)
+.BR task-color(5)
+
+For more information regarding task, the following may be referenced:
+
+.TP
+The official site at
+<http://taskwarrior.org>
+
+.TP
+The official code repository at
+<git://tasktools.org/task.git/>
+
+.TP
+You can contact the project by writing an email to
+<support@taskwarrior.org>
+
+.SH REPORTING BUGS
+.TP
+Bugs in task may be reported to the issue-tracker at
+<http://taskwarrior.org>

doc/man/taskrc.5

@@ -0,0 +1,802 @@
+.TH taskrc 5 2010-05-22 "task 1.9.1" "User Manuals"
+
+.SH NAME
+taskrc \- Configuration file for the task(1) command
+
+.SH SYNOPSIS
+.B $HOME/.taskrc
+.br
+.B task rc:<directory-path>/.taskrc
+
+.SH DESCRIPTION
+.B task
+obtains its configuration data from a file called
+.I .taskrc
+\&. This file is normally located in the user's home directory:
+
+.RS
+$HOME/.taskrc
+.RE
+
+The default location can be overridden using the
+.I rc:
+attribute when running task:
+
+.RS
+$ task rc:<directory-path>/.taskrc
+.RE
+
+Individual option can be overridden by using the
+.I rc.<name>: 
+attribute when running task:
+
+.RS
+$ task rc.<name>:<value> ...
+.RE
+
+If
+.B task
+is run without an existing configuration file it will ask if it should create a
+default, sample
+.I .taskrc
+file in the user's home directory.
+
+The task configuration file consists of a series of "assignments" in each line.
+The "assignments" have the syntax:
+
+.RS
+<name-of-configuration-variable>=<value-to-be-set>
+.RE
+
+where:
+.RS
+.TP
+<name-of-configuration-variable>
+is one of the variables described below
+
+.TP
+<value-to-be-set>
+is the value the variable is to be set to.
+.RE
+
+and set a configuration variable to a certain value. The equal sign ("=") is
+used to separate the variable name from the value to be set.
+
+The hash mark, or pound sign ("#") is used as a "comment" character. It can be
+used to annotate the configuration file. All text after the character to the end
+of the line is ignored.
+
+Note that task is flexible about the values used to represent Boolean items.
+You can use "on", "yes", "y", "1", "true", "t", "+", "enabled".  Anything else
+means "off".
+
+.SH EDITING
+You can edit your .taskrc file by hand if you wish, or you can use the 'config'
+command.  To permanently set a value in your .taskrc file, use this command:
+
+.RS
+$ task config nag "You have higher priority tasks!"
+.RE
+
+To delete an entry, use this command:
+
+.RS
+$ task config nag
+.RE
+
+Task will then use the default value.  To explicitly set a value to blank, and
+therefore avoid using the default value, use this command:
+
+.RS
+$ task config nag ""
+.RE
+
+Task will also display all your settings with this command:
+
+.RS
+$ task config
+.RE
+
+and in addition, will also perform a check of all the values in the file,
+warning you of anything it finds amiss.
+
+.SH NESTING CONFIGURATION FILES
+The .taskrc can include other files containing configuration settings by using the
+.B include
+statement:
+
+.RS
+include <path/to/the/configuration/file/to/be/included>
+.RE
+
+By using include files you can divide your main configuration file into several ones containing just the relevant configuration data like colors, etc.
+
+.SH CONFIGURATION VARIABLES
+Valid variable names and their default values are:
+
+.SS FILES
+
+.TP
+.B data.location=$HOME/.task
+This is a path to the directory containing all the task files. By default, it is
+set up to be ~/.task, for example: /home/paul/.task
+
+Note that you can use the
+.B ~
+shell meta character, which will be properly expanded.
+
+.TP
+.B locking=on
+Determines whether task uses file locking when accessing the pending.data and
+completed.data files.  Defaults to "on". Solaris users who store the task data
+files on an NFS mount may need to set locking to "off". Note that there is
+danger in setting this value to "off" - another program (or another instance of
+task) may write to the task.pending file at the same time.
+
+.SS TERMINAL
+.TP
+.B curses=on
+Determines whether task uses ncurses to establish the size of the window you are
+using, for text wrapping.
+
+.TP
+.B defaultwidth=80
+The width of tables used when ncurses support is not available. Defaults to 80.
+
+.TP
+.B editor=vi
+Specifies which text editor you wish to use for when the
+.B task edit <ID>
+command is used. Task will first look for this configuration variable. If found,
+it is used.  Otherwise task will look for the $VISUAL or $EDITOR environment
+variables, before it defaults to using "vi".
+
+.SS MISCELLANEOUS
+
+.TP
+.B locale=en-US
+The locale is a combination of ISO 639-1 language code and ISO 3166 country
+code.  If not specified, task will assume en-US.  If specified, task will locate
+the correct file of localized strings and proceed.  It is an error to specify a
+locale for which there is no strings file.
+
+.TP
+.B confirmation=yes
+May be "yes" or "no", and determines whether task will ask for confirmation
+before deleting a task or doing bulk changes.  The default value is "yes".
+
+.TP
+.B echo.command=yes
+May be "yes" or "no", and causes task to display the ID and description of any
+task when you run the start, stop, do, undo or delete commands. The default
+value is "yes".
+
+.TP
+.B annotations=full
+.TP
+.B report.X.annotations=full
+Controls the display of annotations in reports. Defaults to full - all
+annotations are displayed. Set to "sparse" only the last (newest) annotation
+is displayed and if there are more than one present for a task a "+" sign is
+added to the description. Set to "none" the output of annotations is disabled
+and a "+" sign will be added if there are any annotations present.  The default
+value is "full".
+
+.TP
+.B next=2
+Is a number, defaulting to 2, which is the number of tasks for each project that
+are shown in the
+.B task next
+command.
+
+.TP
+.B bulk=2
+Is a number, defaulting to 2.  When more than this number of tasks are modified
+in a single command, confirmation will be required, unless the
+.B confirmation
+variable is "no".
+
+This is useful for preventing large-scale unintended changes.
+
+.TP
+.B nag=You have higher priority tasks.
+This may be a string of text, or blank. It is used as a prompt when a task is
+started or completed that is not considered high priority. The "task next"
+command lists important tasks, and completing one of those does not generate
+this nagging. Default value is: You have higher priority tasks.  It is a gentle
+reminder that you are contradicting your own priority settings.
+
+.TP
+.B complete.all.projects=yes
+May be yes or no, and determines whether the tab completion scripts consider all
+the project names you have used, or just the ones used in active tasks.  The
+default value is "no".
+
+.TP
+.B complete.all.tags=yes
+May be yes or no, and determines whether the tab completion scripts consider all
+the tag names you have used, or just the ones used in active tasks.  The default
+value is "no".
+
+.TP
+.B search.case.sensitive=yes
+May be yes or no, and determines whether keyword lookup and substitutions on the
+description and annotations are done in a case sensitive way.  Defaults to yes.
+
+.TP
+.B _forcecolor=no
+Task shuts off color automatically when the output is not sent directly to a
+a TTY.  For example, this command:
+
+.RS
+.RS
+$ task list > file
+.RE
+
+will not use any color.  To override this, use:
+
+.RS
+$ task rc._forcecolor=yes list > file
+.RE
+.RE
+
+.TP
+.B blanklines=yes
+Turning this value off causes task to generate a more vertically compact output.
+
+.TP
+.B shell.prompt=task>
+The task shell command uses this value as a prompt.  You can change it to any
+string you like.
+
+.TP
+.B active.indicator=*
+The character or string to show in the active column.  Defaults to *.
+
+.TP
+.B tag.indicator=+
+The character or string to show in the tag_indicator column.  Defaults to +.
+
+.TP
+.B recurrence.indicator=R
+The character or string to show in the recurrence_indicator column.  Defaults to R.
+
+.TP
+.B debug=off
+Task has a debug mode that causes diagnostic output to be displayed.  Typically
+this is not something anyone would want, but when reporting a bug, debug output
+can be useful.  It can also help explain how the command line is being parsed,
+but the information is displayed in a developer-friendly, not a user-friendly
+way.
+
+.TP
+.B alias.rm=delete
+Task supports command aliases.  This alias provides an alternate name (rm) for
+the delete command.  You can use aliases to provide alternate names for any of
+task's commands.
+
+.SS DATES
+
+.TP
+.B dateformat=m/d/Y
+.TP
+.B dateformat.report=m/d/Y
+.TP
+.B dateformat.holiday=YMD
+.TP
+.B report.X.dateformat=m/d/Y
+This is a string of characters that define how task formats date values. The
+precedence order for the configuration variable is report.X.dateformat then
+reportdateformat then dateformat.  While report.X.dateformat only formats the
+due date in reports, reportdateformat formats the due date both in reports
+and "task info".  If both of these are not set then dateformat will be applied
+to the due date.  Entered dates as well as all other displayed dates in reports
+are formatted according to dateformat.
+
+The default value is: m/d/Y.  The string should contain the characters:
+
+.RS
+.RS
+m  minimal-digit month,   for example 1 or 12
+.br
+d  minimal-digit day,     for example 1 or 30
+.br
+y  two-digit year,        for example 09
+.br
+D  two-digit day,         for example 01 or 30
+.br
+M  two-digit month,       for example 01 or 12
+.br
+Y  four-digit year,       for example 2009
+.br
+a  short name of weekday, for example Mon or Wed
+.br
+A  long name of weekday,  for example Monday or Wednesday
+.br
+b  short name of month,   for example Jan or Aug
+.br
+B  long name of month,    for example January or August
+.br
+V  weeknumber,            for example 03 or 37
+.RE
+.RE
+
+.RS
+The string may also contain other characters to act as spacers, or formatting.
+Examples for other values of dateformat:
+.RE
+
+.RS
+.RS
+.br
+d/m/Y  would use for input and output 24/7/2009
+.br
+yMD    would use for input and output 090724
+.br
+M-D-Y  would use for input and output 07-24-2009
+.RE
+.RE
+
+.RS
+Examples for other values of reportdateformat:
+.RE
+
+.RS
+.RS
+.br
+a D b Y (V)  would do an output as "Fri 24 Jul 2009 (30)"
+.br
+A, B D, Y    would do an output as "Friday, July 24, 2009"
+.br
+vV a Y-M-D   would do an output as "v30 Fri 2009-07.24"
+.RE
+.RE
+
+.TP
+.B weekstart=Sunday
+Determines the day a week starts. Valid values are Sunday or Monday only. The
+default value is "Sunday".
+
+.TP
+.B displayweeknumber=yes
+Determines if week numbers are displayed when using the "task calendar" command.
+The week number is dependent on the day a week starts.  The default value is
+"yes".
+
+.TP
+.B due=7
+This is the number of days into the future that define when a task is
+considered due, and is colored accordingly.  The default value is 7.
+
+.TP
+.B calendar.details=sparse
+If set to full running "task calendar" will display the details of tasks with
+due dates that fall into the calendar period.  The corresponding days will be
+color-coded in the calendar.  If set to sparse only the corresponding days will
+be color coded and no details will be displayed.  The displaying of due dates
+with details is turned off by setting the variable to none.  The default value
+is "sparse".
+
+.TP
+.B calendar.details.report=list
+The report to run when displaying the details of tasks with due date when
+running the "task calendar" command.  The default value is "list".
+
+.TP
+.B calendar.holidays=full
+If set to full running "task calendar" will display holidays in the calendar by
+color-coding the corresponding days.  A detailed list with the dates and names
+of the holidays is also shown.  If set to sparse only the days are color-coded
+and no details on the holidays will be displayed. The displaying of holidays is
+turned off by setting the variable to none.  The default value is "none".
+
+.TP
+.B Holidays
+Holidays are entered either directly in the .taskrc file or via an include file
+that is specified in .taskrc.  For each holiday the name and the date is
+required to be given:
+
+.RS
+.RS
+.br
+holiday.towel.name=Day of the towel
+.br
+holiday.towel.date=20100525
+.br
+holiday.sysadmin.name=System Administrator Appreciation Day
+.br
+holiday.sysadmin.date=20100730
+.RE
+.RE
+
+.RS
+Dates are to be entered according to the setting in the dateformat.holiday
+variable.
+.RE
+
+.RS
+The following holidays are computed automatically: Good Friday (goodfriday), Easter (easter), Easter monday (eastermonday), Ascension (ascension), Pentecost (pentecost). The date for these holidays is the given keyword:
+.RE
+
+.RS
+.RS
+.br
+holiday.eastersunday.name=Easter
+.br
+holiday.eastersunday.date=easter
+.RE
+.RE
+
+.TP
+.B monthsperline=3
+Determines how many months the "task calendar" command renders across the
+screen.  Defaults to however many will fit.  If more months than will fit are
+specified, task will only show as many that will fit.
+
+.SS COLOR CONTROLS
+
+.TP
+.B color=on
+May be "on" or "off". Determines whether task uses color. When "off", task will
+use dashes (-----) to underline column headings.
+
+.TP
+.B fontunderline=on
+Determines if font underlines or ASCII dashes should be used to underline
+headers, even when color is enabled.
+
+Task has a number of coloration rules.  They correspond to a particular
+attribute of a task, such as it being due, or being active, and specifies the
+automatic coloring of that task.  A list of valid colors, depending on your
+terminal, can be obtained by running the command:
+
+.RS
+.B task color
+.RE
+
+.RS
+The coloration rules and their defaults are:
+.RE
+
+.RS
+.RS
+.B color.overdue=bold red
+The color for overdue tasks.
+.br
+.B color.due.today=bold magenta
+The color of tasks due today.
+.br
+.B color.due=bold yellow
+The color of due tasks.
+.br
+.B color.pri.H=bold
+The color of priority:H tasks.
+.br
+.B color.pri.M=on yellow
+The color of priority:M tasks.  No default value.
+.br
+.B color.pri.L=on green
+The color of priority:L tasks.  No default value.
+.br
+.B color.pri.none=white on blue
+The color of priority: tasks.  No default value.
+.br
+.B color.active=bold cyan
+The color of active tasks.
+.br
+.B color.tagged=yellow
+The color of tagged tasks.
+.br
+.B color.recurring=on red
+The color for recurring tasks.
+.RE
+.RE
+
+.RS
+To disable a coloration rule for which there is a default, set the value to
+nothing, for example:
+.RS
+.B color.tagged=
+.RE
+.RE
+
+.RS
+See the task-color(5) man pages for color details.
+.RE
+
+.RS
+Certain attributes like tags, projects and keywords can have their own
+coloration rules.
+.RE
+
+.RS
+.TP
+.B color.tag.X=yellow
+Colors any task that has the tag X.
+
+.TP
+.B color.project.X=on green
+Colors any task assigned to project X.
+
+.TP
+.B color.keyword.X=on blue
+Colors any task where the description or any annotation contains X.
+
+.TP
+.B color.header=green
+Colors any of the messages printed prior to the report output.
+
+.TP
+.B color.footnote=green
+Colors any of the messages printed last.
+
+.TP
+.B color.summary.bar=on green
+Colors the summary progress bar.  Should include both a foreground and a
+background color.
+
+.TP
+.B color.summary.background=on black
+Colors the summary progress bar.  Should include at least a background color.
+
+.TP
+.B color.calendar.today=black on cyan
+Color of today in calendar.
+
+.TP
+.B color.calendar.due=black on green
+Color of days with due tasks in calendar.
+
+.TP
+.B color.calendar.due.today=black on magenta
+Color of today with due tasks in calendar.
+
+.TP
+.B color.calendar.overdue=black on red
+Color of days with overdue tasks in calendar.
+
+.TP
+.B color.calendar.weekend=bright white on black
+Color of weekend days in calendar.
+
+.TP
+.B color.calendar.holiday=black on bright yellow
+Color of holidays in calendar.
+
+.TP
+.B color.calendar.weeknumber=black on white
+Color of weeknumbers in calendar.
+.RE
+
+.RS
+It is possible to apply a specific color to every other task in a report,
+which can make it easier to visually separate tasks.  This is especially
+useful when tasks are displayed over multiple lines due to long descriptions
+or annotations.
+.TP
+.B color.alternate=on rgb253
+Color of alternate tasks.
+.RE
+
+.SS SHADOW FILE
+
+.TP
+.B
+shadow.file=$HOME/.task/shadow.txt
+If specified, designates a file path that will be automatically written to by
+task, whenever the task database changes.  In other words, it is automatically
+kept up to date.  The shadow.command configuration variable is used to determine
+which report is written to the shadow file.  There is no color used in the
+shadow file. This feature can be useful in maintaining a current file for use by
+programs like GeekTool, Conky or Samurize.
+
+.TP
+.B
+shadow.command=list
+This is the command that is run to maintain the shadow file, determined by the
+.I shadow.file
+configuration variable. The format is identical to that of
+.I default.command
+\&. Please see the corresponding documentation for that command.
+
+.TP
+.B
+shadow.notify=on
+When this value is set to "on", task will display a message whenever the shadow
+file is updated by some task command.
+
+.SS DEFAULTS
+
+.TP
+.B
+default.project=foo
+Provides a default project name for the
+.I task add
+command, if you don't specify one.  The default is blank.
+
+.TP
+.B
+default.priority=M
+Provides a default priority for the
+.I task add
+command, if you don't specify one.  The default is blank.
+
+.TP
+.B
+default.command=list
+Provides a default command that is run every time task is invoked with no
+arguments.  For example, if set to:
+
+.RS
+.RS
+default.command=list project:foo
+.RE
+.RE
+
+.RS
+then task will run the "list project:foo" command if no command is specified.
+This means that by merely typing
+.RE
+
+.RS
+.RS
+$ task
+.br
+[task list project:foo]
+.br
+\&
+.br
+ID Project Pri Description
+ 1 foo     H   Design foo
+ 2 foo         Build foo
+.RE
+.RE
+
+.SS REPORTS
+
+The reports can be customized by using the following configuration variables.
+The output columns, their labels and the sort order can be set using the
+corresponding variables for each report. Each report name is used as a
+"command" name. For example
+
+.TP
+.B task overdue
+
+.TP
+.B report.X.description
+The description for report X when running the "task help" command.
+
+.TP
+.B report.X.columns
+The columns that will be used when generating the report X. Valid columns are:
+id, uuid, project, priority, entry, start, due, recur, recur_indicator, age,
+age_compact, active, tags, tag_indicator, description, description_only,
+countdown, countdown_compact.
+The IDs are separated by commas.
+
+.TP
+.B report.X.labels
+The labels for each column that will be used when generating report X. The
+labels are a comma separated list.
+
+.TP
+.B report.X.sort
+The sort order of the tasks in the generated report X. The sort order is
+specified by using the column ids post-fixed by a "+" for ascending sort order
+or a "-" for descending sort order. The sort IDs are separated by commas
+
+.TP
+.B report.X.filter
+This adds a filter to the report X so that only tasks matching the filter
+criteria are displayed in the generated report.
+
+.TP
+.B report.X.dateformat
+This adds a dateformat to the report X that will be used by the "due date"
+column. If it is not set then reportdateformat and dateformat will be used in
+this order. See the
+.B DATES
+section for details on the sequence placeholders.
+
+.TP
+.B report.X.annotations
+This adds the possibility to control the output of annotations for a task in a
+report. See the
+.B annotations
+variable for details on the possible values.
+
+.TP
+.B report.X.limit
+An optional value to a report limiting the number of displayed tasks in the
+generated report.
+
+.TP
+Task comes with a number of predefined reports in its default configuration
+file. These reports are:
+
+.TP
+.B long
+Lists all task, all data, matching the specified criteria.
+
+.TP
+.B list
+Lists all tasks matching the specified criteria.
+
+.TP
+.B ls
+Short listing of all tasks matching the specified criteria.
+
+.TP
+.B minimal
+Minimal listing of all tasks matching the specified criteria.
+
+.TP
+.B newest
+Shows the newest tasks.
+
+.TP
+.B oldest
+Shows the oldest tasks.
+
+.TP
+.B overdue
+Lists overdue tasks matching the specified criteria.
+
+.TP
+.B active
+Lists active tasks matching the specified criteria.
+
+.TP
+.B completed
+Lists completed tasks matching the specified criteria.
+
+.TP
+.B recurring
+Lists recurring tasks matching the specified criteria.
+
+.TP
+.B waiting
+Lists all waiting tasks matching the specified criteria.
+
+.TP
+.B all
+Lists all tasks matching the specified criteria.
+
+.TP
+.B next
+Lists all tasks with upcoming due dates matching the specified criteria.
+
+.SH "CREDITS & COPYRIGHTS"
+task was written by P. Beckingham <paul@beckingham.net>.
+.br
+Copyright (C) 2006 \- 2010 P. Beckingham
+
+This man page was originally written by Federico Hernandez.
+
+task is distributed under the GNU General Public License.  See
+http://www.gnu.org/licenses/gpl-2.0.txt for more information.
+
+.SH SEE ALSO
+.BR task(1),
+.BR task-tutorial(5),
+.BR task-faq(5)
+.BR task-color(5)
+
+For more information regarding task, the following may be referenced:
+
+.TP
+The official site at
+<http://taskwarrior.org>
+
+.TP
+The official code repository at
+<git://tasktools.org/task.git/>
+
+.TP
+You can contact the project by writing an email to
+<support@taskwarrior.org>
+
+.SH REPORTING BUGS
+.TP
+Bugs in task may be reported to the issue-tracker at
+<http://taskwarrior.org>

doc/misc/script-color.txt

@@ -0,0 +1,34 @@
+                                         Hello.  This is a demonstration of the
+                                         task program color capabilities coming
+                                         in version 1.9.
+
+task color                               The color command shows the various
+                                         supported colors.  For this you will
+                                         need an xterm with 256-color support,
+                                         or an equivalent.
+
+                                         This demo uses iTerm running on Snow
+                                         Leopard.
+
+task add Prepare 1.9 for release         Let's create a few tasks, to illustrate
+task add Update the various docs         the features.  Five should be enough.
+task add Run the regression tests
+task add Make the packages
+task add Upload to distributions
+
+--- NOTES
+
+16-color mode
+upgrade
+blending
+alternate lines
+
+--- NOTES
+
+task ls                                  Okay, let's color any tasks that
+                                         mention tests a nice medium blue.
+
+echo 'color.keyword.test=color23' >> ~/.taskrc
+
+
+

doc/misc/script-hooks-2.txt

@@ -0,0 +1,40 @@
+$ # Q: What is a formatting hook?
+$ # A: Lua code that modifies task output at run time.
+$
+$ cat > hooks.lua
+
+-- Make ID not show up
+function id (name, value)
+  return "(shhh - it's a secret)", 0, nil
+end
+
+-- Decorate the UUID
+function uuid (name, value)
+  return '<<<' .. value .. '>>>', 0, nil
+end
+
+^D
+
+$ # Q: What is a command hook?
+$ # A: Lua code that changes the way commands work.
+$
+$ cat >> hooks.lua
+
+-- Disable tags
+function notags ()
+  return 1, 'Tags have been disabled'
+end
+
+^D
+
+$
+$ task config -- hook.format-id ~/demo/hooks.lua:id
+$ task config -- hook.format-uuid ~/demo/hooks.lua:uuid
+$ task config -- hook.pre-tag ~/demo/hooks.lua:notags
+$ task list
+$ task add Demonstrate formatting hooks
+$ task 1 info
+$ task config hooks on
+$ task 1 info
+$ task 1 +try_to_tag
+

doc/misc/script-hooks.txt

@@ -0,0 +1,33 @@
+$
+$ # Task now has Lua 5.1.4 built in.
+$
+$ task version
+$ cat > hooks.lua
+function foo ()
+  print ("Hello from Lua")
+  return 0, nil
+end
+^D
+$
+$ # Task can call into Lua at many points during execution.
+$ # This one is called immediately before task quits.
+$
+$ task rc.hook.pre-exit=~/hooks.lua:foo version
+$
+$ # While task is calling Lua code, the Lua can also call
+$ # back into a task API, for information.
+$
+$ cat > hooks.lua
+function foo ()
+  print "Lua version is " .. task_lua_version ())
+  print "Task version is " .. task_version ())
+  return 0, nil
+end
+^D
+$
+$ cat >> .taskrc
+hook.pre-exit=~/hooks.lua:foo
+^D
+$
+$ task version
+

doc/rc/dark-16.theme

@@ -0,0 +1 @@
+# Sample task 1.9 (or later) color theme

doc/rc/dark-256.theme

@@ -0,0 +1 @@
+# Sample task 1.9 (or later) color theme

doc/rc/holidays-SE.rc

@@ -0,0 +1,34 @@
+holiday.nyårsdagen.name=Nyårsdagen
+holiday.nyårsdagen.date=20100101
+holiday.trettondedagjul.name=Trettondedag jul
+holiday.trettondedagjul.date=20100106
+holiday.långfredagen.name=Långfredagen
+holiday.långfredagen.date=20100402
+holiday.påskdagen.name=Påskdagen
+holiday.påskdagen.date=20100404
+holiday.annandagpåsk.name=Annandag påsk
+holiday.annandagpåsk.date=20100405
+holiday.valborgmässoafton.name=Valborgmässoafton
+holiday.valborgmässoafton.date=20100430
+holiday.förstamaj.name=Första maj
+holiday.förstamaj.date=20100501
+holiday.kristihimmelfärdsdag.name=Kristi Himmelsfärdsdag
+holiday.kristihimmelfärdsdag.date=20100513
+holiday.pingstdagen.name=Pingstdagen
+holiday.pingstdagen.date=20100523
+holiday.nationaldagen.name=Nationaldagen
+holiday.nationaldagen.date=20100606
+holiday.midsommarafton.name=Midsommarafton
+holiday.midsommarafton.date=20100625
+holiday.midsommardagen.name=Midsommardagen
+holiday.midsommardagen.date=20100626
+holiday.allahelgonsdag.name=Alla Helgons Dag
+holiday.allahelgonsdag.date=20101106
+holiday.julafton.name=Julafton
+holiday.julafton.date=20101224
+holiday.juldagen.name=Juldagen
+holiday.juldagen.date=20101225
+holiday.annandagjul.name=Annandag jul
+holiday.annandagjul.date=20101226
+holiday.nyårsafton.name=Nyårsafton
+holiday.nyårsafton.date=20101231

doc/rc/holidays-US.rc

@@ -0,0 +1,26 @@
+holiday.newyearsday.name=New Years Day
+holiday.newyearsday.date=20100101
+holiday.martinlutherkingday.name=Martin Luther King Day
+holiday.martinlutherkingday.date=20100118
+holiday.presidentsday.name=Presidents Day
+holiday.presidentsday.date=20100215
+holiday.patriotsday.name=Patriots Day
+holiday.patriotsday.date=20100419
+holiday.memorialday.name=Memorial Day
+holiday.memorialday.date=20100531
+holiday.independenceday.name=Independence Day
+holiday.independenceday.date=20100704
+holiday.independenceday2.name=Independence Day observed
+holiday.independenceday2.date=20100705
+holiday.laborday.name=Labor Day
+holiday.laborday.date=20100906
+holiday.columbusday.name=Columbus Day
+holiday.columbusday.date=20101011
+holiday.veteransdays.name=Veterans Day
+holiday.veteransdays.date=20101111
+holiday.thanksgiving.name=Thanksgiving Day
+holiday.thanksgiving.date=20101125
+holiday.christmasday.name=Christmas Day
+holiday.christmasday.date=20101225
+holiday.newyearseve.name=New Years Eve
+holiday.newyearseve.date=20101231

doc/rc/light-16.theme

@@ -0,0 +1 @@
+# Sample task 1.9 (or later) color theme

doc/rc/light-256.theme

@@ -0,0 +1 @@
+# Sample task 1.9 (or later) color theme

html/30second.html

@@ -1,131 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>30-Second Tutorial</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title"><a name="simple">30-second Tutorial</a></h2>
-              <div class="content">
-                <p>
-                  For the excessively lazy.
-                  Add two tasks:
-                </p>
-
-                <pre><code>% task add Read task documents later
-% task add priority:H Pay bills</code></pre>
-
-                <p>
-                  Easy.  See that second one has a High priority?  Now let's look at those tasks:
-                </p>
-
-                <pre><code>% task ls
-
-ID Project Pri Description
- 2         H   Pay bills
- 1             Read task documents later</code></pre>
-
-                <p>
-                  They are ordered by priority.  Let's mark number 2 as done:
-                </p>
-
-                <pre><code>% task 2 done
-% task ls
-
-ID Project Pri Description
- 1             Read task documents later</code></pre>
-
-                <p>
-                  Gone.  Now let's delete that remaining task, because, well,
-                  why bother now we are already using task:
-                </p>
-
-                <pre><code>% task delete 1
-% task ls
-No matches</code></pre>
-
-                <p>
-                  Easy.  But now consider checking out what task can really do...
-                </p>
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/advanced.html

@@ -1,493 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Advanced Usage</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title"><a name="advanced">Advanced Usage</a></h2>
-              <div class="content">
-                <p>
-                  Here are the other commands, in some detail.
-                </p>
-
-                <strong>% task</strong>
-                <p>
-                  With no arguments, this command will generate a help message that
-                  lists all these commands.
-                </p>
-
-                <p>
-                  However, if the following configuration variable is specified:
-                </p>
-
-                <pre><code>default.command=list pri:H</code></pre>
-
-                <p>
-                  Then this command will be run whenever task is run without arguments.
-                  This means that your most common task command can be run simply
-                  with the command:
-                </p>
-
-                  <pre><code>% task
-[task list project:foo]
-
-ID Project Pri Description
- 1 foo     H   Design the thing
- 2 foo         Build the thing</code></pre>
-
-                <strong>% task projects</strong>
-                <p>
-                  This report generates a list of all the different projects that you
-                  are using along with a count of the pending tasks for each project.
-                  For example:
-                </p>
-
-                <pre><code>% task projects
-
-Project   Tasks
-Errands       1
-Birthdays     3
-Car           2</code></pre>
-
-
-                <strong>% task summary</strong>
-                <p>
-                  This report lists all the projects and a summary of their task
-                  status.
-                </p>
-
-                <pre><code>% task summary
-
-Project  Remaining Avg age Complete 0%                        100%
-Errands          1  3 days      50% XXXXXXXXXXXXXXXX
-Birthdays        3  7 mths       0%
-Car              2   2 wks      25% XXXXXXXXX</code></pre>
-
-                <p>
-                  This shows the project, the remaining tasks, the average age of each
-                  task, the percentage completed (remaining vs total) and a bar
-                  indicating that percentage.
-                </p>
-
-                <strong>% task &lt;id&gt; append ...</strong>
-                <p>
-                  Appends the additional description to an existing task.
-                </p>
-
-                <strong>% task annotate &lt;id&gt; additional note...</strong>
-                <p>
-                  Allows an annotation to be attached to an existing task.  Each
-                  annotation has a time stamp, and when displayed, the annotations
-                  are shown under the task description.  For example:
-                </p>
-
-                <pre><code>% task add Go to the supermarket
-% task annotate 1 need milk
-% task ls
-
-ID Project Pri Due Active Age     Description
- 1                                Go to the supermarket
-                                  3/23/2009 need milk</code></pre>
-                <p>
-                  The date of the annotation uses the "dateformat" configuration
-                  variable.
-                </p>
-
-                <strong>% task delete &lt;id&gt;</strong>
-                <p>
-                  There are two ways of getting rid of tasks - mark them as done, or
-                  delete them.
-                </p>
-
-                <strong>% task undelete &lt;id&gt;</strong>
-                <p>
-                  If a task was inadvertently deleted, it may be undeleted, provided that no
-                  reports have been run since the deletion.  Ideally, the undelete command is
-                  run immediately after the erroneous delete command.
-                </p>
-
-                <p>
-                  If a report is run (such as "task list"), then task performs a garbage
-                  collection that removes deleted tasks, and the task cannot be undeleted.
-                </p>
-
-                <strong>% task done &lt;id&gt;</strong>
-                <p>
-                  This is how a task is marked as done.
-                </p>
-
-                <strong>% task undo &lt;id&gt;</strong>
-                <p>
-                  If a task was recently marked as done, and no report has been run, it
-                  may be possible to cancel the completed status of the task as though
-                  "task done ..." was never run.
-                </p>
-
-                <strong>% task list ...</strong>
-                <p>
-                  The list report will show the active status, and age of the task in
-                  addition to the columns that "task ls" shows.  It is just a more
-                  detailed list.
-                </p>
-
-                <strong>% task long ...</strong>
-                <p>
-                  The long report will show the entry date and start date of a task,
-                  in addition to the columns that the "task list" shows.
-                </p>
-
-                <strong>% task start &lt;id&gt;</strong>
-                <p>
-                  This marks a task as started (and therefore active), which is shown
-                  in the "list" report:
-                </p>
-
-                <pre><code>% task list
-
-ID Project Pri Due Active Age     Description
-12 Errand  L                      Remember to deposit check
-...
-
-% task start 12
-% task list
-
-ID Project Pri Due Active Age     Description
-12 Errand  L       *      3 days  Remember to deposit check
-...</code></pre>
-
-                <strong>% task active</strong>
-                <p>
-                  Shows all active tasks, that is, the tasks for which the
-                  "task start ..." command was run, as shown above.
-                </p>
-
-                <strong>% task stop &lt;id&gt;</strong>
-                <p>
-                  Marks a task as inactive, by removing the start time.
-                </p>
-
-                <strong>% task overdue</strong>
-                <p>
-                  Simply lists all the task that have a due date that is past, in
-                  "list" format.
-                </p>
-
-                <strong>% task history</strong>
-                <p>
-                  This report shows you an overview of how many tasks were added,
-                  completed and deleted, by month.  It looks like this:
-                </p>
-
-                <pre><code>% task history
-
-Year Month     Added Completed Deleted Net
-2008 March        21        16       0   5
-     April        13        11       1   1
-     May           8        14       3  -9</code></pre>
-
-                <p>
-                  This shows that for the three months that task has been used, March
-                  and April saw the total number of tasks increase, but in May the
-                  number decreased as more task were completed than added.
-                </p>
-
-                <strong>% task calendar</strong>
-                <p>
-                  This report shows a calendar of the current month, with any task
-                  due or overdue dates marked on it.  Color is used to mark these
-                  dates.
-                </p>
-
-                <pre><code>% task calendar
-
-May 2008
-
-Su Mo Tu We Th Fr Sa
-             1  2  3
- 4  5  6  7  8  9 10
-11 12 13 14 15 16 17
-18 19 20 21 22 23 24
-25 26 27 28 29 30 31</code></pre>
-
-                <strong>% task next</strong>
-                <p>
-                  This report shows you the tasks you should probable work on next.
-                  Task will scan all the tasks and will pick two task from each
-                  project to report.  Those two tasks will be chosen in order of
-                  overdue, due soon, High, Medium or Low priority.  Essentially task
-                  chooses the two most important task for each project and displays
-                  them ordered in the usual way.
-                </p>
-
-                <p>
-                  If you wish to show a different number of tasks per project, modify
-                  the entry in .taskrc:
-                </p>
-
-                <pre><code>next=2</code></pre>
-
-                <p>
-                  To be your preferred number.
-                </p>
-
-                <strong>% task &lt;id&gt; ...</strong>
-                <p>
-                  When a task id is specified, everything applies to just that task.
-                  Suppose we needed to correct a task:
-                </p>
-
-                <pre><code>% task ls
-
-ID Project Pri Description
-12 Errand  L   Remember to deposit chekc
-...
-
-% task 12 Remember to deposit bonus check
-% task ls
-
-ID Project Pri Description
-12 Errand  L   Remember to deposit bonus check
-...</code></pre>
-
-                <strong>% task oldest</strong>
-                <p>
-                  Lists the oldest tasks.  Shows 10 tasks by default, but can be
-                  set via the "oldest" configuration variable.
-                </p>
-
-                <strong>% task newest</strong>
-                <p>
-                  Lists the newest tasks.  Shows 10 tasks by default, but can be
-                  set via the "newest" configuration variable.
-                </p>
-
-                <strong>% task &lt;id&gt; /from/to/</strong>
-                <p>
-                  If a task has been entered with a typo, it can be easily corrected
-                  by this command.  For example:
-                </p>
-
-                <pre><code>% task ls
-
-ID Project Pri Description
-12 Errand  L   Remember to deposit chekc
-...
-
-% task 12 /chekc/check/
-% task ls
-
-ID Project Pri Description
-12 Errand  L   Remember to deposit check
-...</code></pre>
-
-                <p>
-                  This command makes a single correction to the first occurrence of
-                  "from" in a task description.
-                </p>
-
-                <p>
-                  If a task is annotated, the annotation can also be modified using
-                  this command.
-                </p>
-
-                <strong>% task &lt;id&gt; /from/to/g</strong>
-                <p>
-                  The "g" modifier to the substitution command causes every occurrence
-                  of "from" to be replaced with "to", in both the description and any
-                  annotations.
-                </p>
-
-                <strong>% task tags</strong>
-                <p>
-                  This command will generate a list of all the tags that are currently
-                  in use by task.
-                </p>
-
-                <strong>% task info &lt;id&gt;</strong>
-                <p>
-                  This command gives detailed information about a single task.  It
-                  will tell you when the task was entered, when started, its status,
-                  tags, and more.
-                </p>
-
-                <strong>% task stats</strong>
-                <p>
-                  This command generates a list of statistics about your task usage,
-                  such as the average time it takes to complete a task, how often new
-                  tasks are added, and more.
-                </p>
-
-                <strong>% task completed</strong>
-                <p>
-                  This generates a list of all tasks that have been completed, sorted
-                  by their completion date.
-                </p>
-
-                <strong>% task export &lt;file name&gt;</strong>
-                <p>
-                  This instructs task to write out a CSV format dump of all tasks,
-                  both pending and completed, to the file specified.  This is how you
-                  might view tasks in a spreadsheet.
-                </p>
-
-                <strong>% task colors</strong>
-                <p>
-                  This command displays all the colors that task supports.
-                </p>
-
-                <strong>% task version</strong>
-                <p>
-                  This can be used to show the version number of task, and to display
-                  all the current configuration settings, as read from the .taskrc
-                  file.
-                </p>
-
-                <strong>% task rc:&lt;file&gt; ...</strong>
-                <p>
-                  By specifying rc:<file>, it is possible to force task to use an alternate
-                  .taskrc file.  By default, task looks in your home directory, so these two
-                  commands are essentially identical:
-                </p>
-
-                <pre><code>% task list
-% task rc:~/.taskrc list</code></pre>
-
-                <p>
-                  What this override allows, is the possibility of keeping your task lists
-                  completely separate, say for work and home.  This can be accomplished with
-                  the following commands (valid for bash):
-                </p>
-
-                <pre><code>% alias htask="task rc:/home/me/.taskrc_home"
-% alias wtask="task rc:/home/me/.taskrc_work"
-% htask list
-...
-% wtask list
-...</code></pre>
-
-                <strong>% task &lt;id&gt; "new description"</strong>
-                <p>
-                  Not strictly a command, the replacement of the description can
-                  be achieved by quoting the entire description.  The quotes are
-                  necessary in case one of the description words looks like a task
-                  command.
-                </p>
-
-                <strong>% task &lt;id&gt; fg:... bg:...</strong>
-                <p>
-                  Not strictly a command, the setting of the fg and bg (foreground
-                  and background) attributes determines the colors used to represent
-                  the task.  Valid foreground colors are:
-                </p>
-
-                <pre><code>         bold          underline          bold_underline
-black    bold_black    underline_black    bold_underline_black
-red      bold_red      underline_red      bold_underline_red
-green    bold_green    underline_green    bold_underline_green
-yellow   bold_yellow   underline_yellow   bold_underline_yellow
-blue     bold_blue     underline_blue     bold_underline_blue
-magenta  bold_magenta  underline_magenta  bold_underline_magenta
-cyan     bold_cyan     underline_cyan     bold_underline_cyan
-white    bold_white    underline_white    bold_underline_white</code></pre>
-
-                <p>
-                  Note that these are not just colors, but combinations of colors and
-                  attributes.  Valid background colors are:
-                </p>
-
-                <pre><code>on_black    on_bright_black
-on_red      on_bright_red
-on_green    on_bright_green
-on_yellow   on_bright_yellow
-on_blue     on_bright_blue
-on_magenta  on_bright_magenta
-on_cyan     on_bright_cyan
-on_white    on_bright_white</code></pre>
-
-                <p>
-                  Note also that this capability does depend on whether your terminal
-                  program can display these colors.
-                </p>
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/color.html

@@ -1,128 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Color Usage</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title"><a name="color">Colors</a></h2>
-              <div class="content">
-                <p>
-                  Task supports color in several places.  In cases where you may
-                  specify a color, a foreground, a background, or a combination
-                  foreground and background color may be used.  The following are
-                  valid foreground colors:
-                </p>
-
-                <pre><code>         bold          underline          bold_underline
-black    bold_black    underline_black    bold_underline_black
-red      bold_red      underline_red      bold_underline_red
-green    bold_green    underline_green    bold_underline_green
-yellow   bold_yellow   underline_yellow   bold_underline_yellow
-blue     bold_blue     underline_blue     bold_underline_blue
-magenta  bold_magenta  underline_magenta  bold_underline_magenta
-cyan     bold_cyan     underline_cyan     bold_underline_cyan
-white    bold_white    underline_white    bold_underline_white</code></pre>
-
-                <p>
-                  and the following are valid background colors:
-                </p>
-
-                <pre><code>on_black    on_bright_black
-on_red      on_bright_red
-on_green    on_bright_green
-on_yellow   on_bright_yellow
-on_blue     on_bright_blue
-on_magenta  on_bright_magenta
-on_cyan     on_bright_cyan
-on_white    on_bright_white</code></pre>
-
-                <p>
-                  Depending on your terminal color choices, task can display all
-                  the colors it supports with the command:
-                </p>
-
-                <img src="images/color.png" />
-
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/config.html

@@ -1,428 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Task Configuration</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title"><a name="config">Configuring Task</a></h2>
-              <div class="content">
-                <p>
-                  Task recognizes several entries in the .taskrc file for
-                  configuration purposes.  Valid entries are of the form:
-                </p>
-
-                <pre><code>name=value</code></pre>
-
-                <p>
-                  Valid examples are:
-                </p>
-
-                <dt>data.location</dt>
-                <dd>
-                  This is a path to the directory containing all the task files.
-                  By default, it is set up to be ~/.task, for example:
-                  /Users/paul/.task
-                </dd>
-
-                <dt>confirmation</dt>
-                <dd>
-                  May be "yes" or "no", and determines whether task will ask for
-                  confirmation before deleting a task.
-                </dd>
-
-                <dt>echo.command</dt>
-                <dd>
-                  May be "yes" or "no", and causes task to display the ID and
-                  description of any task when you run the start, stop, do, undo,
-                  delete and undelete commands.  The default value is "yes".
-                </dd>
-
-                <dt>nag</dt>
-                <dd>
-                   This may be a string of text, or blank.  It is used as a prompt
-                   when a task is completed that is not considered high priority.
-                   The "task next" command lists important tasks, and completing
-                   one of those does not generate this nagging.  Default value is:
-
-                   <strong>Note: try to stick to high priority tasks.  See "task next".</strong>
-                </dd>
-
-                <dt>next</dt>
-                <dd>
-                  Is a number, defaulting to 2, which is the number of tasks for
-                  each project that are shown in the "task next" command.
-                </dd>
-
-                <dt>curses</dt>
-                <dd>
-                  Determines whether task uses ncurses to establish the size of
-                  the window you are using, for text wrapping.
-                </dd>
-
-                <dt>blanklines</dt>
-                <dd>
-                  May be "on" or "off".  Prevents the display of unnecessary blank
-                  lines so that task makes better use screen real estate on small-
-                  screened devices.
-                </dd>
-
-                <dt>dateformat</dt>
-                <dd>
-                  <p>
-                    This is a string of characters that define how task formats dates.
-                    The default value is:
-                  </p>
-
-                  <pre><code>m/d/Y</code></pre>
-
-                  <p>
-                    which means dates look like:
-                  </p>
-
-                  <pre><code>6/7/2008</code></pre>
-
-                  <p>
-                    The string should contain the characters:
-
-                    <table>
-                      <tr>
-                        <th class="table_h">Character</th>
-                        <th class="table_h">Meaning</th>
-                        <th class="table_h">Example</th>
-                      </tr>
-                      <tr>
-                        <td class="table_d">m</td>
-                        <td class="table_d">minimal-digit month</td>
-                        <td class="table_d">1, 12</td>
-                      </tr>
-                      <tr>
-                        <td class="table_d">d</td>
-                        <td class="table_d">minimal-digit day</td>
-                        <td class="table_d">1, 30</td>
-                      </tr>
-                      <tr>
-                        <td class="table_d">y</td>
-                        <td class="table_d">two-digit year</td>
-                        <td class="table_d">08</td>
-                      </tr>
-                      <tr>
-                        <td class="table_d">M</td>
-                        <td class="table_d">two-digit month</td>
-                        <td class="table_d">01, 12</td>
-                      </tr>
-                      <tr>
-                        <td class="table_d">D</td>
-                        <td class="table_d">two-digit day</td>
-                        <td class="table_d">01, 30</td>
-                      </tr>
-                      <tr>
-                        <td class="table_d">Y</td>
-                        <td class="table_d">four-digit year</td>
-                        <td class="table_d">2008</td>
-                      </tr>
-                    </table>
-                  </p>
-
-                  <p>
-                    The string may also contain other characters to act as spacers,
-                    or formatting.  Other values could include (but are not limited to):
-                  </p>
-
-                  <p>
-                    <table>
-                      <tr>
-                        <th class="table_h">dateformat</td>
-                        <th class="table_h">How it looks</th>
-                      </tr>
-                      <tr>
-                        <td class="table_d">d/m/Y</td>
-                        <td class="table_d">7/6/2008</td>
-                      </tr>
-                      <tr>
-                        <td class="table_d">YMD</td>
-                        <td class="table_d">20080607</td>
-                      </tr>
-                      <tr>
-                        <td class="table_d">m-d-y</td>
-                        <td class="table_d">6-7-08</td>
-                      </tr>
-                    </table>
-                  </p>
-                </dd>
-
-                <dt>monthsperline</dt>
-                <dd>
-                  Determines how many months the "task calendar" command
-                  renders across the screen.  Defaults to however many will
-                  fit.  If more months that will fit are specified, task will
-                  only show as many that will fit.
-                </dd>
-
-                <dt>defaultwidth</dt>
-                <dd>
-                  The width of tables used when ncurses support is not available.
-                  Defaults to 80.
-                </dd>
-
-                <dt>due</dt>
-                <dd>
-
-                  This is the number of days into the future that define when a
-                  task is considered due, and is colored accordingly.
-                  Defaults to 7.
-                </dd>
-
-                <dt>color</dt>
-                <dd>
-                 May be "on" or "off".  Determines whether task uses color.
-                 When "off", task will use dashes (-----) to underline column
-                 headings.
-                </dd>
-
-                <dt>
-                  color.overdue<br />
-                  color.due<br />
-                  color.pri.H<br />
-                  color.pri.M<br />
-                  color.pri.L<br />
-                  color.pri.none<br />
-                  color.active<br />
-                  color.tagged<br />
-                  color.recurring
-                </dt>
-                <dd>
-                  These are the coloration rules.  They correspond to a particular
-                  attribute of a task, such as it being due, or being active, and
-                  specifies the automatic coloring of that task.  The value may
-                  be one optional foreground color (see below) and one optional
-                  background color.  For example, the value may be:
-                  <br />
-                  <strong>bold_red on_bright_yellow</strong>
-                </dd>
-
-                <dt>color.tag.X</dt>
-                <dd>
-                  Colors any task that has the tag X.
-                </dd>
-
-                <dt>color.project.X</dt>
-                <dd>
-                  Colors any task assigned to project X.
-                </dd>
-
-                <dt>color.keyword.X</dt>
-                <dd>
-                  Colors any task where the description contains X.
-                </dd>
-
-                <dt>default.project</dt>
-                <dd>
-                  Provides a default project name for the "task add ..." command.
-                </dd>
-
-                <dt>default.priority</dt>
-                <dd>
-                  Provides a default priority for the "task add ..." command.
-                </dd>
-
-                <dt>default.command</dt>
-                <dd>
-                  <p>
-                    Provides a default command that is run every time task is
-                    invoked with no arguments.  For example, if set to:
-                  </p>
-
-                  <pre><code>default.command=list project:foo</code></pre>
-
-                  <p>
-                    Then task will run the "list project:foo" command if no
-                    command is specified.  This means that by merely typing:
-                  </p>
-
-                  <pre><code>% task
-[task list project:foo]
-
-ID Project Pri Description
- 1 foo     H   Design the thing
- 2 foo         Build the thing</code></pre>
-
-                  <p>
-                    Note that the value of this variable is simply the command
-                    line that you would ordinarily type, but without the
-                    preceding "task" program name.
-                  </p>
-                </dd>
-
-                <dt>shadow.file</dt>
-                <dd>
-                  <p>
-                    If specified, designates a file path that will be autoamtically
-                    written to by task, whenever the task database changes.  In other
-                    words, it is automatically kept up to date.
-                  </p>
-
-                  <p>
-                    The shadow.command configuration variable is used to determine
-                    which report is written to the shadow file.  There is no color
-                    used in the shadow file.
-                  </p>
-
-                  <p>
-                    This feature can be useful in maintaining a current file for
-                    use by the "Samurize" program.
-                  </p>
-                </dd>
-
-                <dt>shadow.command</dt>
-                <dd>
-                  <p>
-                    This is the command that is run to maintain the shadow file,
-                    determined by the shadow.file configuration variable.  The
-                    format is identical to that of default.command - please see
-                    the documentation for default.command.
-                  </p>
-
-                  <p>
-                    If this command is not specified, task will use the default.command
-                    value instead.  If that is not specified, the command "list" is used.
-                  </p>
-                </dd>
-
-                <dt>shadow.notify</dt>
-                <dd>
-                  When this value is set to "on", task will display a message
-                  whenever the shadow file is updated by some task command.
-                </dd>
-
-                <dt>locking</dt>
-                <dd>
-                  <p>
-                    Determines whether task uses file locking when accessing the pending.data
-                    and completed.data files.  Default to "on".  Solaris users who store
-                    the task data files on an NFS mount may need to set locking to "off".
-                  </p>
-
-                  <p>
-                    Note that setting this value to "off" is dangerous.  It means that
-                    another program may write to the task.pending file when task is
-                    attempting to do the same.
-                  </p>
-                </dd>
-
-                <dt>import.synonym.id</dt>
-                <dt>import.synonym.uuid</dt>
-                <dt>import.synonym.status</dt>
-                <dt>import.synonym.tags</dt>
-                <dt>import.synonym.entry</dt>
-                <dt>import.synonym.start</dt>
-                <dt>import.synonym.due</dt>
-                <dt>import.synonym.recur</dt>
-                <dt>import.synonym.end</dt>
-                <dt>import.synonym.project</dt>
-                <dt>import.synonym.priority</dt>
-                <dt>import.synonym.fg</dt>
-                <dt>import.synonym.bg</dt>
-                <dt>import.synonym.description</dt>
-                <dd>
-                  If any of these configuration variables are found, they influence
-                  data import by specifying a single additional field name synonym.
-                  If a data import is failing because certain column names are not
-                  being recognized, then this is how the field mapping can be
-                  controlled.
-                </dd>
-
-                <p>
-                  Note that the command:
-                </p>
-
-                <pre><code>task version</code></pre>
-
-                <p>
-                  will display the configuration variables found in the .taskrc file,
-                  and will warn you of any variables that are not recognized.
-                </p>
-
-
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/custom.html

@@ -1,179 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Custom Reports</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title">Custom Reports</h2>
-              <div class="content">
-                <p>
-                  Task allows you to customize reports, to a limited degree.
-                  The "list", "long", "ls", "oldest" and "newest" reports are
-                  all now custom reports, whereas in previous releases of task
-                  they were not mutable.  This means they can be modified,
-                  renamed, or deleted.
-                </p>
-
-                <p>
-                  More importantly, you can define your own.  Here are the
-                  three necessary items in the .taskrc file that define a new
-                  report:
-                </p>
-
-                <code><pre>report.mine.description=Just the essentials
-report.mine.columns=id,project,priority,description
-report.mine.sort=priority-,project+</pre></code>
-
-                <p>
-                  This defines a report, called "mine", that has four columns:
-                  id, project, priority and description.  It will be sorted on
-                  two columns: by descending priority then ascending project.
-                  The description that shows up in the task command usage page
-                  is "Just the essentials".  Because this report is called
-                  "mine", it can be run with the command:
-                </p>
-
-                <code><pre>% task mine</pre></code>
-
-                <p>
-                  An optional filter can also be specified like this:
-                </p>
-
-                <code><pre>report.mine.filter=priority:H +bug</pre></code>
-
-                <p>
-                  This adds a filter so that only tasks with priority "H" and
-                  with the "bug" tag are included in the report.  This filter
-                  definition is optional.
-                </p>
-
-                <p>
-                  An optional limit can also be specified, which limits the
-                  number of tasks shown in the report.  If a limit is not
-                  specified, then the number of tasks is not limited.
-                </p>
-
-                <code><pre>report.mine.limit=10</pre></code>
-
-                <p>
-                  Here is a list of all the possible columns that may be included
-                  in a report:
-                </p>
-
-                <p>
-                  It is also possible to override the default columns names, if
-                  the following line is added to your .taskrc file:
-                </p>
-
-                <pre><code>report.mine.labels=ID,Project,Priority,Description of task</code></pre>
-
-                <p>
-                  Note that there must be the same number of labels as there are
-                  columns to label, and they must appear in the same sequence.
-                </p>
-
-                <ul>
-                  <li>id
-                  <li>uuid
-                  <li>project
-                  <li>priority
-                  <li>entry
-                  <li>start
-                  <li>due
-                  <li>age
-                  <li>active
-                  <li>tags
-                  <li>recur
-                  <li>description_only
-                  <li>description
-                  <li>tag_indicator
-                  <li>recurrence_indicator
-                </ul>
-
-                <p>
-                  Custom reports will show up in the task command line usage.
-                </p>
-
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/date.html

@@ -1,161 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Date Handling</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title">Date Handling</h2>
-              <div class="content">
-                <p>
-                  Task reads dates from the command line, and displays dates in the reports.
-                </p>
-
-                <p>
-                  In order to do this in a flexible way, task obeys a configuration variable that
-                  determines the expected and desired date format.  See the
-                  <a href="config.html">Configuring Task</a> page for details.
-                </p>
-
-                <p>
-                  In addition to exactly specifying the date, such as:
-                </p>
-
-                <pre><code>% task ... due:7/10/2008</code></pre>
-
-                <p>
-                  task supports a flexible variety of alternatives.  For example:
-                </p>
-
-                <pre><code>% task ... due:today</code></pre>
-
-                <p>
-                  Similarly:
-                </p>
-
-                <pre><code>% task ... due:yesterday
-% task ... due:tomorrow</code></pre>
-
-                <p>
-                  Here are some other forms that are accepted.  The day number, followed by an
-                  ordinal:
-                </p>
-
-                <pre><code>% task ... due:23rd</code></pre>
-
-                <p>
-                  End of month:
-                </p>
-
-                <pre><code>% task ... due:eom</code></pre>
-
-                <p>
-                  End of year:
-                </p>
-
-                <pre><code>% task ... due:eoy</code></pre>
-
-                <p>
-                  End of week (Friday):
-                </p>
-
-                <pre><code>% task ... due:eow</code></pre>
-
-                <p>
-                  Next Friday:
-                </p>
-
-                <pre><code>% task ... due:Friday</code></pre>
-
-                <p>
-                  Note that next Friday means seven days from now if today is Friday, otherwise
-                  it means the next occurring Friday.  Most of these forms may be specified using
-                  abbreviations, provided they are unique.  For example:
-                </p>
-
-                <pre><code>% task ... due:fri</code></pre>
-
-
-              </div>
-
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/faq.html

@@ -1,175 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Frequently Asked Questions</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title">Frequently Asked Questions</h2>
-              <div class="content">
-                <p>
-                (Actually, that's a misnomer.  These are really Repeatedly Asked
-                Questions.)
-                </p>
-
-                <p>
-                  <b>
-                    Q: When I redirect the output of task to a file, I lose all
-                       the colors.  How do I fix this?
-                  </b>
-                  <br />
-                  A: Task knows (or thinks it knows) when the output is not going
-                     directly to a terminal, and strips out all the color control
-                     characters.  Prevent this with the following entry in your
-                     .taskrc file:
-                  <pre><code>_forcecolor=on</code></pre>
-                </p>
-                <hr>
-
-                <p>
-                  <b>
-                    Q: How do I backup my task data files?  Where are they?
-                  </b>
-                  <br />
-                  A: Task writes all pending tasks to the file ~/.task/pending.data
-                     and all completed and deleted tasks to ~/.task/completed.data.
-                     They are text files, so they can just be copied to another
-                     location for safekeeping. Don't forget there is also the
-                     ~/.taskrc file that contains your task configuration data.
-                </p>
-                <hr>
-
-                <p>
-                  <b>
-                    Q: How can I separate my work tasks from my home tasks?
-                       Specifically, can I keep them completely separate?
-                  </b>
-                  <br />
-                  A: You can do this by creating an alternate .taskrc file,
-                     then using shell aliases.  Here is are example Bash
-                     commands to achieve this:
-
-                  <pre><code>% cp ~/.taskrc ~/.taskrc_home
-% (now edit .taskrc_home to change the value of data.location)
-% alias wtask="task"
-% alias htask="task rc:~/.taskrc_home"</code></pre>
-
-                  This gives you two commands, 'wtask' and 'htask' that
-                  operate using two different sets of task data files.
-                </p>
-                <hr>
-
-                <p>
-                  <b>
-                    Q: Can I revert to a previous version of task?  How?
-                  </b>
-                  <br />
-                  A: Yes, you can revert to a previous version of task,
-                     simply by downloading an
-                     <a href="versions.html">older version</a> and
-                     installing it.  If you find a bug in task, then this
-                     may be the only way to work around the bug, until a
-                     new release is made.
-                </p>
-                <p>
-                  Note that it is possible that the task file format will
-                  change.  For example, the format changed between versions
-                  1.5.0 and 1.6.0.  Task will automatically upgrade the file
-                  but if you need to revert to a previous version of task,
-                  there is the file format to consider.  This is yet another
-                  good reason to back up your task data files!
-                </p>
-                <hr>
-
-<!--
-                <p>
-                  <b>
-                    Q:
-                  </b>
-                  <br />
-                  A:
-                </p>
-                <hr>
--->
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/filter.html

@@ -1,133 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Task Filters</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title">Task Filters</h2>
-              <div class="content">
-                <p>
-                  A task filter is a means of reducing a task report to a
-                  subset that may consist of all tasks that have a specific
-                  project, priority, tag, or part of the description.
-                </p>
-
-                <p>
-                  A task filter consists of additional command line options,
-                  that are specified in the same way as when a task is added.
-                </p>
-
-                <p>
-                  All task reports can make use of filters.
-                </p>
-
-                <p>
-                  For example, the report:
-                </p>
-
-                <code><pre>% task list</pre></code>
-
-                <p>
-                  Lists all tasks.
-                </p>
-
-                <code><pre>% task list the</pre></code>
-
-                <p>
-                  Lists only tasks with "the" in the task description.
-                </p>
-
-                <code><pre>% task list project:Home priority:H</pre></code>
-
-                <p>
-                  Lists only tasks with both the "Home" project and "H" priority.
-                </p>
-
-                <code><pre>% task list +shopping</pre></code>
-
-                <p>
-                  Lists only tasks with the "shopping" tag.
-                </p>
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/import.html

@@ -1,158 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Data Import</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title">Data Import</h2>
-              <div class="content">
-                <p>
-                  Tasks can be imported from files with this command:
-
-                  <pre><code>% task import file</code></pre>
-
-                  A variety of different file types are recognized by task, namely:
-
-                  <ul>
-                    <li>Tasks exported from task prior to version 1.5.0.
-                    <li>Tasks exported from task version 1.5.0 and later.  The file
-                        format changed with 1.5.0.
-                    <li>todo.sh files.
-                    <li>CSV files with a variety of recognized column names.
-                    <li>Plain text files, with one task listed per line.
-                    <li>Task command line format.
-                  </ul>
-                </p>
-
-                <p>
-                  Task makes a good effort to determine which of these formats a
-                  file is.  It does this by reading the file, and looking for
-                  familiar patterns.  For example, the easiest files to recognize
-                  are those exported from task itself, because they all have a
-                  header line that comes in only three variations.  Other formats
-                  are a little harder to identify, but they all have their own
-                  identifying characteristics.
-                </p>
-
-                <p>
-                  The most complex import is when a CSV file is recognized.
-                  Task needs a field header line in order to map columns to task
-                  data items.  For example, the if the following file is
-                  imported:
-                </p>
-
-                <pre><code>number,status,task
-1,pending,task one
-2,pending,task two</code></pre>
-
-                <p>
-                  Task will map the "number" field to task's "id" field, etc,
-                  based on name.  Task has a list of synonyms that it uses to
-                  map fields, but you can specify your own override with any of
-                  the following configuration variables:
-                </p>
-
-                <ul>
-                  <li>import.synonym.id
-                  <li>import.synonym.uuid
-                  <li>import.synonym.status
-                  <li>import.synonym.tags
-                  <li>import.synonym.entry
-                  <li>import.synonym.start
-                  <li>import.synonym.due
-                  <li>import.synonym.recur
-                  <li>import.synonym.end
-                  <li>import.synonym.project
-                  <li>import.synonym.priority
-                  <li>import.synonym.fg
-                  <li>import.synonym.bg
-                  <li>import.synonym.description
-                </ul>
-
-                <p>
-                  Please note that it is wise to backup your task data files
-                  before an import.
-                </p>
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/links.html

@@ -1,214 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Task on the Web</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h1 class="title">Task on the Web</h1>
-              <p>
-                Task links from around the web...
-              </p>
-
-              <dt>
-                February 2009, <a href="http://lifehacker.com/5155450/todotxt-cli-manages-your-tasks-from-the-command-line">Todo.txt CLI Manages Your Tasks from the Command Line</a>
-              </dt>
-              <dd>
-                Gina Trapani generously mentions task in an article about the newly updated, todo.sh 2.0.
-              </dd>
-              <br>
-
-              <dt>
-                February, 2009, <a href="http://forum.worklifecreativity.net/index.php/topic,219.0.html">My command line based task management tools</a>
-              </dt>
-              <dd>
-                Richard Querin talks about his task management tools.
-                Richard generously provides the Debian packages for task.
-              </dd>
-              <br>
-
-              <dt>
-                February, 2009, <a href="http://wiki.archlinux.org/index.php/Common_Apps">Common Apps</a>
-              </dt>
-              <dd>
-                 <a href="http://wiki.archlinux.org">Archlinux.org</a> mentions task on a page which is
-                 a point of reference for people looking for software to fill a particular need.
-              </dd>
-              <br>
-
-              <dt>
-                November 2008, <a href="http://github.com/pbeckingham/task/tree/master/">Task repository on GitHub</a>
-              </dt>
-              <dd>
-                For developers: the task git repository on github.com is now public.
-              </dd>
-              <br>
-
-              <dt>
-                October 2008, <a href="http://blog.rfquerin.org/2008/10/07/using-task-and-dropbox-to-manage-your-to-do-list/">Using Task and Dropbox to manage your To-Do list</a>
-              </dt>
-              <dd>
-                by Richard Querin.  Richard discusses the ease of setting up task to
-                use DropBox to share todo lists between work and home.
-              </dd>
-              <br>
-
-              <dt>
-                September 2008, <a href="http://stasantons.blogspot.com/2008/09/task-program-visually-simple.html">Task visualization</a>
-              </dt>
-              <dd>
-                by Stas Antons.  Stas - a colleague of mine - presents a visualization
-                of the simplicity of task.
-              </dd>
-              <br>
-
-              <dt>
-                June 2008, <a href="http://blog.rfquerin.org/2008/06/17/building-debian-packages-for-task/">Building Debian Packages For Task</a>
-              </dt>
-              <dd>
-                by Richard Querin.  Richard has been providing Debian packages for the
-                various task releases, and discusses how he got up to speed.
-              </dd>
-              <br>
-
-              <dt>
-                June 2008, <a href="http://blog.rfquerin.org/2008/06/06/task-101-an-attempt-at-a-cygwin-build-how-to/">Task 1.0.1 - an attempt at a Cygwin Build How-To</a>
-              </dt>
-              <dd>
-                by Richard Querin.  Richard shows us how to build task using Cygwin, after
-                a cry for help on the todo.txt mailing list.
-              </dd>
-              <br>
-
-              <dt>
-                June 2008, <a href="http://www.youtube.com/watch?v=D2Kn4DMOVSw">The second task movie</a>
-              </dt>
-              <dd>
-                This YouTube movie was made to illustrate some of the features of the task
-                program, back when task 1.0.0 was released.  While task has grown
-                significantly since then, the commands shown are still valid.  It will
-                soon be time for a new movie!
-                <p>
-
-                This movie has a voice-over that explains what is going on.
-                <p>
-
-                For a higher-quality version, download the whole
-                <a href="http://www.beckingham.net/todo2.mov">movie file (10MB)</a>.
-              </dd>
-              <br>
-
-              <dt>
-                December 2006, <a href="http://www.youtube.com/watch?v=l68LCl6BYvs">The first task movie</a>
-              </dt>
-              <dd>
-                This original YouTube task movie was made to illustrate the features of the
-                then-unreleased task program.  The idea was to get some feedback and see
-                whether anyone was interested in a new implementation of todo.sh, that added
-                features that are not easily possible with a shell implementation.
-                <p>
-
-                This movie has no voice-over, and you may notice that it exactly duplicates
-                the commands used in the original todo.sh movie (below).  That is, until it
-                deviates because of new task commands.
-              </dd>
-              <br>
-
-              <dt>
-                June 2006, <a href="http://www.youtube.com/watch?v=daJ1Hs_y738">The original todo.sh movie</a>
-              </dt>
-              <dd>
-                by Gina Trapani.  This is the original YouTube todo.sh movie, made to
-                illustrate the power and simplicity of the original todo.sh program.
-              </dd>
-              <br>
-
-              <dt>
-                June 2006, <a href="http://todotxt.com/">Todo.sh, the inspiration for task</a>
-              </dt>
-              <dd>
-                by Gina Trapani.  The website that introduced me to the power and
-                simplicity of the original todo.sh program.  Contains useful links
-                and resources - take a look!
-              </dd>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/recur.html

@@ -1,220 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Recurring Tasks</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title">Recurring Tasks</h2>
-              <div class="content">
-                <p>
-                  Task supports recurring tasks, which is a task that keeps falling due, on a
-                  regular schedule.  An example of this may be "pay rent".  Here is how
-                  recurring tasks work in task:
-                </p>
-
-                <p>
-                  Ordinarily, a task is a single item that is entered in the pending state, and
-                  remains so until it is either completed or deleted.  This is an example of a
-                  single instance task.
-                </p>
-
-                <p>
-                  A recurring task is different.  When a recurring task is entered, it remains
-                  hidden from view, but acts as a root task for a task instances that are
-                  generated on a regular basis.  Consider the example:
-                </p>
-
-                <pre><code>% task Pay rent due:7/1/2008 recur:monthly</code></pre>
-
-                <p>
-                  If today's date is 7/10, for example, then that due date is in the past, and
-                  you might expect there to be an already overdue task for 7/1/2008, and another
-                  due on 8/1/2008.  This means that from that root, task has created two
-                  instances with different due dates.
-                </p>
-
-                <pre><code>% task list
-
-ID Project Pri Due         Active Age   Description
-1              7/1/2008           1 min Pay rent
-2              8/1/2008           1 min Pay rent
-
-2 tasks</code></pre>
-
-                <p>
-                  Task creates any overdue tasks, then creates one additional due task.  These
-                  new task instances are then completed or deleted as you normally would.
-                </p>
-
-                <p>
-                  In the example above, a new task instance is created every month, and this will
-                  repeat indefinitely.  Task also supports an end date.  Suppose you are taking
-                  every Friday off work for the summer.  You'll need to submit your TPS report on
-                  Thursdays instead:
-                </p>
-
-                <pre><code>% task TPS report due:thursday recur:weekly until:8/31/2008</code></pre>
-
-                <p>
-                  This create a weekly recurring task that expires on 8/31/2008.  What this means
-                  is that after all those task instances have been created, then completed or
-                  deleted, the root task will expire and disappear.  Task will tell you what it
-                  is doing when this happens.
-                </p>
-
-                <h4>Deletion</h4>
-                <p>
-                  When a recurring task is deleted, you will be asked if you would also like to
-                  delete all recurring task instances:
-                </p>
-
-                <pre><code>% task del 1
-Permanently delete task? (y/n) y
-This is a recurring task.  Do you want to delete all pending
-recurrences of this same task? (y/n) y</code></pre>
-
-                <h4>Modification</h4>
-                <p>
-                  When a recurring task is modified, all the other recurring task instances will
-                  be modified.  For example, if you raise the priority of one of the recurring
-                  task instances, all will be modified.
-                </p>
-
-                <h4>Recurrence Periods</h4>
-                <p>
-                  In the above examples, the recurrence period was specified as "monthly" and
-                  "weekly".  Task supports several ways of specifying this:
-                </p>
-
-                <table>
-                  <tr>
-                    <th class="table_h">Period</th>
-                    <th class="table_h">Meaning</th>
-                  </tr>
-                  <tr>
-                    <td class="table_d">daily, day, 1d, 2d ...</td>
-                    <td class="table_d">Every day, or a number of days</td>
-                  </tr>
-                  <tr>
-                    <td class="table_d">weekdays</td>
-                    <td class="table_d">
-                      Monday, Tuesday, Wednesday, Thursday and Friday,
-                      skipping weekend days
-                    </td>
-                  </tr>
-                  <tr>
-                    <td class="table_d">weekly, 1w, 2w ...</td>
-                    <td class="table_d">Every week, or a number of weeks</td>
-                  </tr>
-                  <tr>
-                    <td class="table_d">biweekly, fortnight</td>
-                    <td class="table_d">Every two weeks</td>
-                  </tr>
-                  <tr>
-                    <td class="table_d">monthly, 1m, 2m ...</td>
-                    <td class="table_d">Every month, or a number of months</td>
-                  </tr>
-                  <tr>
-                    <td class="table_d">bimonthly</td>
-                    <td class="table_d">Every two months</td>
-                  </tr>
-                  <tr>
-                    <td class="table_d">quarterly, 1q, 2q ...</td>
-                    <td class="table_d">Every three months, a quarter, or a number of quarters</td>
-                  </tr>
-                  <tr>
-                    <td class="table_d">semiannual</td>
-                    <td class="table_d">Every six months</td>
-                  </tr>
-                  <tr>
-                    <td class="table_d">annual, yearly, 1y, 2y ...</td>
-                    <td class="table_d">Every year, or a number of years</td>
-                  </tr>
-                  <tr>
-                    <td class="table_d">biannual, biyearly, 2y</td>
-                    <td class="table_d">Every two-years</td>
-                  </tr>
-                </table>
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/setup.html

@@ -1,141 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Task Setup</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title"><a name="setup">Quick Setup</a></h2>
-              <div class="content">
-                <p>
-                  Build the task program according to the directions in the INSTALL
-                  file.  This transcript illustrates a typical installation:
-                </p>
-
-                <pre><code>% ls
-task-1.6.0.tar.gz
-% gunzip task-1.6.0.tar.gz
-% tar xf task-1.6.0.tar
-% cd task-1.6.0
-% ./configure
-...
-% make
-...
-% make install     # (may require sudo, depending on --prefix)</code></pre>
-
-                <p>
-                  (For those of you using <a href="http://www.cygwin.com">Cygwin</a>,
-                  you need to make sure you have the "gcc" and "make" packages
-                  available, which are found in the "devel" category.  For more
-                  task features, also make sure you have "libncurses-devel" and
-                  "lincurse8".)
-                </p>
-
-                <p>
-                  You need to make sure that the installed task program is in your
-                  PATH environment variable.
-                </p>
-
-                <p>
-                  Task reads a configuration file - called .taskrc in your home
-                  directory - and stores pending and completed tasks in in a directory
-                  specified in the configuration file.
-                </p>
-
-                <p>
-                  The simplest way to get a configuration file and task directory is
-                  to run task.  On startup, task will check to see if it can find the
-                  configuration file and task directory, and if not found, will ask
-                  you whether it may create both.
-                </p>
-
-                <pre><code>% task version
-
-A configuration file could not be found in /Users/paul/.taskrc
-
-Would you like a sample .taskrc created, so task can proceed? (y/n) y
-Done.
-
-[then task will show version information]</code></pre>
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/shadow.html

@@ -1,129 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Task Shadow Files</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title">Task Shadow Files</h2>
-              <div class="content">
-                <p>
-                  A shadow file is a text file containing a copy of a task
-                  report.  It is automatically maintained by task whenever
-                  something changes in the task database.
-                </p>
-
-                <p>
-                  This means there is always a current version of the task
-                  report kept in a text file.  Products such as
-                  <a href="http://www.samurize.com">Samurize</a>,
-                  <a href="http://www.mulle-kybernetik.com/software/MkConsole/">MkConsole</a>,
-                  or
-                  <a href="http://projects.tynsoe.org/en/geektool/">GeekTool</a>
-                  can display this file on the computer desktop, so that it
-                  is readily visible.
-                </p>
-
-                <p>
-                  To use a shadow file, edit your .taskrc configuration file,
-                  and add three entries as shown:
-                </p>
-
-                <pre><code>shadow.file=/path/to/file
-shadow.command=list pri:H
-shadow.notify=on</code></pre>
-
-                <p>
-                  In this example the shadow file contains a report equivalent
-                  to running "task list pri:H".  Note that the third entry
-                  causes a message to be displayed whenever task updates the
-                  shadow file.  It is optional.
-                </p>
-
-                <p>
-                  You can use any task command that generates a report, and of
-                  course, you can specify any file name, provided the directory
-                  it resides in already exists.
-                </p>
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/shell.html

@@ -1,131 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Interacting with the Shell</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title"><a name="shell">Interacting with the Shell</a></h2>
-              <div class="content">
-                <p>
-                  Certain characters are interpreted by the shell.  For example, the
-                  "&amp;".  If you wish to include the &amp; in a task description,
-                  you need to escape it, so the shell doesn't interpret it.  For
-                  example:
-                </p>
-
-                <pre><code>% task add Buy bread &amp; milk</code></pre>
-
-                <p>
-                  This command is an error because of the &amp;.  The shell will
-                  consider this to be two commands:
-                </p>
-
-                <pre><code>% task add Buy bread &amp;
-% milk</code></pre>
-
-                <p>
-                  The shell treats the &amp; character as an indicator that the
-                  command is complete and should be run in the background.  Then the
-                  shell considers "milk" to be a command all by itself.  Which it is
-                  not.  One way to get around this is to individually escape the &amp;
-                  character:
-                </p>
-
-                <pre><code>% task add Buy bread \&amp; milk</code></pre>
-
-                <p>
-                  Another is to quote the entire description, with either ' or "
-                  characters:
-                </p>
-
-                <pre><code>% task add "Buy bread &amp; milk"</code></pre>
-
-                <p>
-                  Task itself interprets the commands, and it too can make mistakes.
-                  For example, any colon : character will be interpreted by task as a
-                  delimiter between an attribute name and its value.  Currently there
-                  is no workaround for this.
-                </p>
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/simple.html

@@ -1,356 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Simple Usage</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title"><a name="simple">Simple Usage</a></h2>
-              <div class="content">
-                <p>
-                  Let us begin by adding some tasks:
-                </p>
-
-                <pre><code>% task add Book plane ticket
-% task add Rent a tux
-% task add Reserve a rental car
-% task add Reserve a hotel room</code></pre>
-
-                <p>
-                  That's it.  You'll notice immediately that task has a very
-                  minimalist interface.  Let us take a look at those tasks:
-                </p>
-
-                <pre><code>% task ls
-
-ID Project Pri Description
- 1             Book plane ticket
- 2             Rent a tux
- 3             Reserve a rental car
- 4             Send John a birthday card</code></pre>
-
-                <p>
-                  The 'ls' command provides the most minimal list of tasks.  Each
-                  task has been given an id number, and you can see that there are no
-                  projects or priorities assigned.  Wait a minute - I own a tux, I
-                  don't need to rent one.  Let us delete task 2:
-                </p>
-
-                <pre><code>% task 2 delete
-Permanently delete task? (y/n) y</code></pre>
-
-                <p>
-                  Task wants you to confirm deletions.  To remove the confirmation,
-                  edit your .taskrc file and change the line:
-                </p>
-
-                <pre><code>confirmation=yes</code></pre>
-
-                <p>
-                  to have a value of "no".
-                </p>
-
-                <p>
-                  While the use of projects and priorities are not essential to
-                  benefitting from task, they can be very useful when the list of
-                  tasks grows large.  Let's assign a project to these tasks:
-                </p>
-
-                <pre><code>% task 1 project:Wedding
-% task 3 project:Wedding
-% task 4 project:Family
-% task ls
-
-  ID Project Pri Description
-   3 Family      Send John a birthday card
-   2 Wedding     Reserve a rental car
-   1 Wedding     Book plane ticket</code></pre>
-
-                <p>
-                  Notice that the id numbers have changed.  When tasks get deleted,
-                  or have their attributes changed (project, for example), the ids are
-                  prone to change.  But the id numbers will remain valid until the
-                  next 'ls' command is run.  You should only use the ids from the most
-                  recent 'ls' command.  The ids change, because task is always trying
-                  to use small numbers so that it is easy for you to enter them
-                  correctly.  Now that projects are assigned, we can look at just the
-                  Wedding project tasks:
-                </p>
-
-                <p>
-                  Subprojects are supported.  If you have a project "Wedding", you can
-                  specify that a task is a subproject "Transport" of "Wedding" by
-                  assigning the project "Wedding.Transport".  Let's do this:
-               </p>
-
-               <pre><code>% task 2 project:Wedding.Transport
-% task ls
-
-ID Project           Pri Description
- 3 Family                Send John a birthday card
- 2 Wedding.Transport     Reserve a rental car
- 1 Wedding               Book plane ticket</code></pre>
-
-                <p>
-                  Task matches the leftmost part of the project when searching, so
-                  projects may be abbreviated:
-                </p>
-
-                <pre><code>% task ls project:Wedding.Tra
-
-ID Project           Pri Description
- 2 Wedding.Transport     Reserve a rental car</code></pre>
-
-                <p>
-                  This way of matching projects can be used to see all tasks under
-                  the "Wedding" project and all subprojects:
-                </p>
-
-                <pre><code>% task ls project:Wedding
-
-ID Project           Pri Description
- 2 Wedding.Transport     Reserve a rental car
- 1 Wedding               Book plane ticket</code></pre>
-
-                <p>
-                  Let's reassign 2 back to the "Wedding" project:
-                </p>
-
-                <pre><code>% task 2 project:Wedding</code></pre>
-
-                <p>
-                  Now that projects are assigned, we can look at just the
-                  Wedding project tasks:
-                </p>
-
-                <pre><code>% task ls project:Wedding
-
-ID Project Pri Description
- 1 Wedding     Book plane ticket
- 2 Wedding     Reserve a rental car</code></pre>
-
-                <p>
-                  Any command arguments after the 'ls' are used for filtering the
-                  output.  We could also have requested:
-                </p>
-
-                <pre><code>% task ls ticket plane
-
-ID Project Pri Description
- 1 Wedding     Book plane ticket</code></pre>
-
-                <p>
-                  Now let's prioritize.  Priorities can be H, M or L (High, Medium,
-                  Low).
-                </p>
-
-                <pre><code>% task ls
-
-ID Project Pri Description
- 3 Family      Send John a birthday card
- 2 Wedding     Reserve a rental car
- 1 Wedding     Book plane ticket
-
-% task 1 priority:H
-% task 2 prior:M
-% task 3 pr:H
-Ambiguous attribute 'pr' - could be either of project, priority
-% task 3 pri:H
-% task ls
-
-ID Project Pri Description
- 3 Family  H   Send John a birthday card
- 1 Wedding H   Book plane ticket
- 2 Wedding M   Reserve a rental car</code></pre>
-
-                <p>
-                  Notice that task supports the abbreviation of words such as
-                  priority, project.  Priority can be abbreviated to pri, but not pr,
-                  because it is ambiguous.  Now that tasks have been prioritized, you
-                  can see that the tasks are being sorted by priority, with the
-                  highest priority tasks at the top.
-                </p>
-
-                <p>
-                  These attributes can all be provided when the task is added, instead
-                  of applying them afterwards, as shown.  The following command shows
-                  how to set all the attributes at once:
-                </p>
-
-                <pre><code>% task add project:Wedding priority:H Book plane ticket<code></pre>
-
-                <p>
-                  The 'ls' command provides the least information for each task.  The
-                  'list' command provides more:
-                </p>
-
-                <pre><code>% task list
-
-ID Project Pri Due Active Age    Description
- 3 Family  H              4 mins Send John a birthday card
- 1 Wedding H              5 mins Book plane ticket
- 2 Wedding M              5 mins Reserve a rental car</code></pre>
-
-                <p>
-                  Notice that a task can have a due date, and can be active.  The
-                  task lists are sorted by due date, then priority.  Let's add due
-                  dates:
-                </p>
-
-                <pre><code>% task 3 due:6/25/2008
-% task 1 due:7/31/2008
-% task list
-
-ID Project Pri Due       Active Age    Description
- 3 Family  H   6/25/2008        6 mins Send John a birthday card
- 1 Wedding H   7/31/2008        7 mins Book plane ticket
- 2 Wedding M                    7 mins Reserve a rental car</code></pre>
-
-                <p>
-                  If today's date is 6/23/2008, then task 3 is due in 2 days.  It will
-                  be colored yellow if your terminal supports color.  To change this
-                  color, edit your .taskrc file, and change the line to one of these
-                  alternatives:
-                </p>
-
-                <pre><code>color.due=red
-color.due=on_blue
-color.due=red on_blue
-color.due=bold_red on_blue</code></pre>
-
-                <p>
-                  Where color is one of the following:
-                </p>
-
-                <pre><code>black
-blue
-red
-green
-cyan
-magenta
-yellow
-white</code></pre>
-
-                <p>
-                  All colors are specified in this way.  Take a look in .taskrc for
-                  all the other color rules that you control.
-                </p>
-
-                <p>
-                  Tagging tasks is a good way to group them, aside from specifying a
-                  project.  To add a tag to a task:
-                </p>
-
-                <pre><code>% task &lt;id&gt; +tag<code></pre>
-
-                <p>
-                  The plus sign indicates that this is a tag.  Any number of tags may
-                  be applied to a task, and then used for searching.  Tags are just
-                  single words that are labels.
-                </p>
-
-                <pre><code>% task list
-
-ID Project Pri Due       Active Age    Description
- 3 Family  H   6/25/2008        8 mins Send John a birthday card
- 1 Wedding H   7/31/2008        9 mins Book plane ticket
- 2 Wedding M                    9 mins Reserve a rental car
-
-% task 1 +phone
-% task 2 +phone
-% task 3 +shopping
-% task 3 +john
-
-% task list +phone
-
-ID Project Pri Due       Active Age    Description
- 1 Wedding H   7/31/2008        9 mins Book plane ticket
- 2 Wedding M                    9 mins Reserve a rental car</code></pre>
-
-                <p>
-                  To remove a tag from a task, use the minus sign:
-                </p>
-
-                <pre><code>% task 3 -john</code></pre>
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/task.css

@@ -1,126 +0,0 @@
-body {
-	text-align: center;
-	margin: 0; padding: 1em;
-}
-
-#container {
-	width: 740px;
-	text-align: left;
-	margin: 0 auto; padding: 0;
-}
-
-#header {
-	height: 60px;
-	margin: 0 0 15px; padding: 0;
-}
-
-#page {}
-
-#content {
-	width: 500px;
-}
-
-#header a:link,
-#header a:visited {
-	color:#000;
-	text-decoration: none;
-}
-
-#header h1 {
-	font: bold 400% georgia, serif;
-	letter-spacing: -1px;
-	margin: 0;
-	float: left;
-}
-
-#header h2 {
-	font: normal 12px verdana, arial, sans-serif;
-	margin: 2.5em 0 0 0.8em;
-	float: left;
-}
-
-#content {}
-
-#content h1,
-#content h2,
-#content h3,
-#content h4,
-#content h5 {
-	font-family: "lucidamac bold", "lucida grande", arial, sans-serif;
-	letter-spacing: -1px;
-}
-
-#content h1 {
-	font-size: 24px;
-}
-
-#content h2 {
-	font-size: 22px;
-	border-bottom: 1px dotted #000;
-}
-
-#content h3 {
-	font-size: 20px;
-	border-bottom: 1px dotted #bbb;
-}
-
-#content h4 {
-	font-size: 18px;
-	border-bottom: 1px dotted #bbb;
-}
-
-#content h5 {
-	font-size: 18px;
-	background: #ffd;
-	border-bottom: 1px dotted #bbb;
-}
-
-#content p {
-	line-height: 15px;
-}
-
-#content ul,
-#content ol {
-}
-
-#content code {
-	font: normal 12px "bitstream vera sans mono", monaco "lucida console", "courier new", courier, serif;
-}
-
-#content pre {
-	color: #63FF00;
-	background: #000;
-	overflow: auto;
-	font: normal 12px "bitstream vera sans mono", monaco "lucida console", "courier new", courier, serif;
-	margin: 0.9em 0; padding: 8px;
-}
-
-dt {
-	font: bold 14px "lucida grande", verdana, arial, helvetica, sans-serif;
-}
-
-dd {
-}
-
-body {
-	font: normal 12px "lucida grande", verdana, arial, helvetica, sans-serif;
-}
-
-.small {
-	font: normal 10px verdana, arial, sans-serif;
-}
-
-.table_h {
-        background-color: #e0e0e0;
-}
-
-.table_d {
-        background-color: #f7f7f7;
-}
-input,
-textarea { font: normal 12px "bitstream vera sans", verdana, sans-serif; }
-
-abbr  { border: none; }
-cite  { font-style: normal; }
-a img { border: none; padding: 0; margin: 0; }
-

html/task.html

@@ -1,265 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Latest Release</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h1 class="title">Task</h1>
-              <p>
-                Task is an open source, command-line, TODO list manager.
-              </p>
-
-              <p>
-                Here you will find information on how to acquire, build, configure,
-                use and become proficient with the task program.
-              </p>
-
-              <ul>
-                <li><a href="setup.html">Quick Setup</a>
-                <li><a href="30second.html">30-second Tutorial</a>
-                <li><a href="simple.html">Simple Usage</a>
-                <li><a href="advanced.html">Advanced Usage</a>
-                <li><a href="shell.html">Interacting with the Shell</a>
-                <li><a href="config.html">Configuring Task</a>
-                <li><a href="color.html">Color</a>
-                <li><a href="usage.html">Task Command Usage</a>
-                <li><a href="recur.html">Recurring Tasks</a>
-                <li><a href="date.html">Date Handling</a>
-                <li><a href="troubleshooting.html">Troubleshooting</a>
-                <li><a href="versions.html">Old Versions</a>
-                <li><a href="filter.html">Filters</a>
-                <li><a href="shadow.html">Shadow Files</a>
-                <li><a href="custom.html">Custom Reports</a>
-                <li><a href="import.html">Data Import</a>
-                <li><a href="faq.html">Frequently Asked Questions</a>
-              </ul>
-
-              <p>
-                More documents are being written, and will be added here.
-              </p>
-
-              <p>
-                Alternatively, watch the
-                <a href="http://www.youtube.com/watch?v=D2Kn4DMOVSw">task movie</a>
-                which illustrates many of task's features.
-              </p>
-
-              <br />
-              <h2 class="title">Get the Latest Stable Release</h2>
-
-              <div class="content">
-                <table>
-                  <tr>
-                    <td>Source:</td>
-                    <td><a href="http://www.beckingham.net/task-1.6.0.tar.gz">task-1.6.0.tar.gz</a></td>
-                  </tr>
-                  <tr>
-                    <td>Mac OS X 10.5 (Leopard) Intel-only:</td>
-                    <td><a href="http://www.beckingham.net/task-1.6.0.pkg">task-1.6.0.pkg</a></td>
-                  </tr>
-                  <tr>
-                    <td>
-                      Debian:
-                      (Thanks to <a href="http://blog.rfquerin.org">Richard&nbsp;Querin</a>):
-                    </td>
-                    <td><a href="http://www.beckingham.net/task_1.6.0-1_i386.deb">task_1.6.0-1_i386.deb</a></td>
-                  </tr>
-                  <tr>
-                    <td>
-                      Red Hat:
-                      (Thanks to <a href="http://www.ultrafredde.com">Federico&nbsp;Hernandez</a>):
-                    </td>
-                    <td><a href="http://www.beckingham.net/task-1.6.0-1.i386.rpm">task-1.6.0-1.i386.rpm</a></td>
-                  </tr>
-                  <tr>
-                    <td>Git - get the whole source and history:</td>
-                    <td><a href="http://github.com/pbeckingham/task">http://github.com/pbeckingham/task</a></td>
-                  </tr>
-                </table>
-
-                <h4>New in version 1.6.0 (?)</h4>
-                <ul>
-                  <li>Added support for new "append" command that adds more description text to
-                      an existing task.
-                  <li>Added support for the "weekdays" recurrence, which means a task can recur
-                      five times a week, and not on weekends (thanks to Chris Pride).
-                  <li>UTF8 text is now supported in task project names, tags and descriptions.
-                  <li>Fixed bug that caused the y/n confirmation on task deletion to ignore the
-                      Enter key and fail to re-prompt (thanks to Bruce Dillahunty).
-                  <li>When the "echo.command" configuration variable is set to "yes", it causes
-                      commands that modify tasks to display which task was affected (thanks to
-                      Bruce Dillahunty).
-                  <li>A task can now be annotated with the command "task <id> annotate ...", and
-                      a timestamped annotation will appear in reports.
-                  <li>A 'description_only' column is now available for use in custom reports,
-                      and it excludes annotations.
-                  <li>A task can now be upgraded to a recurring task by adding a recurrence
-                      frequency, a due date, and an optional until date.
-                  <li>When a recurring task is modified, all other instances of the recurring
-                      task are also modified.
-                  <li>Custom reports now support user-specified column labels (thanks to T.
-                      Charles Yun).
-                  <li>Task can now import tasks from a variety of data formats, including task
-                      export files from versions 1.4.3 and earlier, versions 1.5.0 and later,
-                      todo.sh 2.x, CSV, plain text and task command line.  See online docs for
-                      full details.
-                  <li>Export was including 'id' in the column header even though it was not
-                      included in the data.
-                  <li>The task file format has changed slightly.  Please back up your task
-                      data files before upgrading to 1.6.0.
-                  <li>Added new column 'recurrence_indicator' that displays an 'R' if the task
-                      is a recurring task.  This column can be added to any custom report.
-                  <li>Added new column 'tag_indicator' that displays a '+' if the task
-                      has any tags.  This column can be added to any custom report.
-                  <li>Fixed bug where sometimes a task description was concatenated oddly if
-                      there was a colon somewhere in the description.
-                  <li>Fixed bug that caused recurring annual tasks to exhibit a creeping due
-                      date, because of an assumption of 365 days per year, which failed to
-                      consider leap years (thanks to T. Charles Yun).
-                  <li>Annotations can now be modified with the substitution commands /from/to/.
-                  <li>Substitutions can now be made global with /from/to/g and all occurrences
-                      of "from" will be replaced with "to".
-                </ul>
-
-                <p>
-                  (Find out <a href="versions.html">what was new in prior versions</a>)
-                </p>
-<!--
-                <h2>Task 1.6.0 Beta</h2>
-                <p>
-                  The next version of task is in beta.  This means it is approaching the
-                  end of the current development and testing cycle, and feedback from
-                  a wider audience is needed to find the last bugs.  If you would like
-                  to help test the next release of task, download the beta source below
-                  and install in the usual manner.
-                </p>
-                <p>
-                  Please note that beta software may contain significant bugs.  If you
-                  use this beta release, you should first backup your existing task
-                  data files.
-                </p>
-                <p>
-                  Refer to the ChangeLog file for details regarding the various fixes
-                  and enhancements.
-                </p>
-                <table>
-                  <tr>
-                    <td>Source:</td>
-                    <td><a href="http://www.beckingham.net/task-1.6.0beta.tar.gz">task-1.6.0beta.tar.gz</a></td>
-                  </tr>
-                </table>
--->
-                <h2>Troubleshooting</h2>
-                <p>
-                  Task has been built from source and tested in the following environments:
-                </p>
-
-                <p>
-                  <ul>
-                    <li>OS X 10.4 Tiger
-                    <li>OS X 10.5 Leopard
-                    <li>Fedora Core 8
-                    <li>Fedora Core 9
-                    <li>Fedora Core 10
-                    <li>Ubuntu 7 Feisty Fawn
-                    <li>Ubuntu 8 Hardy Heron
-                    <li>Ubuntu 8.10 Intrepid Ibex
-                    <li>Solaris 10
-                    <li>Cygwin 1.5.25-14
-                  </ul>
-                </p>
-
-                <p>
-                  If you have difficulties building task, have found a bug, have a
-                  suggestion for improvement, or a feature request, please send mail to
-                  <a href="mailto:task@beckingham.net">task@beckingham.net</a>.
-                </p>
-
-                <p>
-                  Take a look at the <a href="troubleshooting.html">troubleshooting guide</a>
-                  for tips and workarounds to problems.
-                </p>
-
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/troubleshooting.html

@@ -1,156 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Task Troubleshooting Guide</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h1 class="title">Task Troubleshooting Guide</h1>
-              <p>
-                Here you will find tips and suggestions for making task behave
-                properly, and bug workarounds.
-              </p>
-
-              <br />
-              <h2 class="title">Segmentation Fault for certain commands</h2>
-              <div class="content">
-                <p>
-                  Upgrading task to version 1.1.0, 1.2.0 and 1.3.0 can cause
-                  segmentation faults.  This is mostly occurring for Ubuntu users,
-                  although there is no reason for it to be limited to Ubuntu.
-                </p>
-
-                <p>
-                  Task 1.3.1 fixes this bug, but there is a workaround for users
-                  of earlier versions.  Add the following line to your ~/.taskrc
-                  file:
-                </p>
-
-                <code><pre>dateformat=m/d/Y</pre></code>
-
-                <p class="small">
-                  The "dateformat" setting is supported in task 1.1.0 and later.
-                </p>
-              </div>
-
-              <br />
-              <h2 class="title">How do I build task under Cygwin?</h2>
-              <div class="content">
-                <p>
-                  Task is built the same way everywhere.  But under Cygwin, you'll
-                  need to make sure you have the following packages available
-                  first:
-
-                  <ul>
-                    <li>gcc
-                    <li>make
-                    <li>libncurses-devel
-                    <li>libncurses8
-                  </ul>
-
-                  The gcc and make packages allow you to compile the code, and
-                  are therefore required, but the ncurses packages are optional.
-                  Ncurses will allow task to determine the width of the window, and
-                  therefore use the whole width and wrap text accordingly, for a
-                  more aesthetically pleasing display.
-                </p>
-              </div>
-
-              <br />
-              <h2 class="title">Do colors work under Cygwin?</h2>
-              <div class="content">
-                <p>
-                  They do, but only in a limited way.  You can use regular
-                  foreground colors (black, red, green ...) and you can
-                  regular background colors (on_black, on_red, on_green ...),
-                  but underline and bold are not supported.
-                </p>
-
-                <p>
-                  If you run the command:
-                  <code><pre>% task colors</pre></code>
-                  Task will display all the colors it can use, and you will
-                  see which ones you can use.
-                </p>
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/usage.html

@@ -1,153 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Task Usage</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h2 class="title"><a name="usage">Command Usage<a></h2>
-              <div class="content">
-                <pre><code>Usage: task
-       task add [tags] [attrs] desc...
-       task append [tags] [attrs] desc...
-       task annotate ID desc...
-       task completed [tags] [attrs] desc...
-       task ID [tags] [attrs] [desc...]
-       task ID /from/to/
-       task delete ID
-       task undelete ID
-       task info ID
-       task start ID
-       task stop ID
-       task done ID
-       task undo ID
-       task projects
-       task tags
-       task summary
-       task history
-       task ghistory
-       task next
-       task calendar
-       task active
-       task overdue
-       task stats
-       task export
-       task color
-       task version
-       task help
-       task list [tags] [attrs] desc...
-       task long [tags] [attrs] desc...
-       task ls [tags] [attrs] desc...
-       task newest [tags] [attrs] desc...
-       task oldest [tags] [attrs] desc...
-
-See http://www.beckingham.net/task.html for the latest releases and a full tutorial.
-
-ID is the numeric identifier displayed by the 'task list' command
-
-Tags are arbitrary words, any quantity:
-  +tag               The + means add the tag
-  -tag               The - means remove the tag
-
-Attributes are:
-  project:           Project name
-  priority:          Priority
-  due:               Due date
-  recur:             Recurrence frequency
-  until:             Recurrence end date
-  fg:                Foreground color
-  bg:                Background color
-  rc:                Alternate .taskrc file
-
-Any command or attribute name may be abbreviated if still unique:
-  task list project:Home
-  task li       pro:Home
-
-Some task descriptions need to be escaped because of the shell:
-  task add "quoted ' quote"
-  task add escaped \' quote
-
-Many characters have special meaning to the shell, including:
-  $ ! ' " ( ) ; \ ` * ? { } [ ] < > | & % # ~</code></pre>
-              <div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

html/versions.html

@@ -1,372 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <title>Task Prior Versions</title>
-    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
-    <link rel="stylesheet" href="task.css" type="text/css" />
-  </head>
-
-  <body>
-    <div id="container">
-      <table>
-        <tr>
-          <td>
-            <div id="toolbar">
-              <a href="task.html">Home</a>
-              <a href="setup.html">Setup</a>
-              <a href="30second.html">30-second Tutorial</a>
-              <a href="simple.html">Simple</a>
-              <a href="advanced.html">Advanced</a>
-              <a href="shell.html">Shell</a>
-              <a href="config.html">Configuration</a>
-              <a href="color.html">Colors</a>
-              <a href="usage.html">Usage</a>
-              <a href="recur.html">Recurrence</a>
-              <a href="date.html">Date Handling</a>
-              <a href="troubleshooting.html">Troubleshooting</a>
-              <a href="versions.html">Old Versions</a>
-              <a href="links.html">Task on the Web</a>
-            </div>
-
-            <div id="content">
-              <br />
-              <br />
-              <br />
-              <h1 class="title">Task Prior Versions</h1>
-              <br />
-
-              <div class="content">
-
-                <p>
-                  <h4>New in version 1.5.0 (3/15/2009)</h4>
-                  <table>
-                    <tr>
-                      <td>Source:</td>
-                      <td><a href="http://www.beckingham.net/task-1.5.0.tar.gz">task-1.5.0.tar.gz</a></td>
-                    </tr>
-                    <tr>
-                      <td>Mac OS X 10.5 (Leopard) Intel-only:</td>
-                      <td><a href="http://www.beckingham.net/task-1.5.0.pkg">task-1.5.0.pkg</a></td>
-                    </tr>
-                    <tr>
-                      <td>
-                        Debian:
-                        (Thanks to <a href="http://blog.rfquerin.org">Richard&nbsp;Querin</a>):
-                      </td>
-                      <td><a href="http://www.beckingham.net/task_1.5.0-1_i386.deb">task_1.5.0-1_i386.deb</a></td>
-                    </tr>
-                    <tr>
-                      <td>
-                        Red Hat:
-                        (Thanks to <a href="http://www.ultrafredde.com">Federico&nbsp;Hernandez</a>):
-                      </td>
-                      <td><a href="http://www.beckingham.net/task-1.5.0-1.i386.rpm">task-1.5.0-1.i386.rpm</a></td>
-                    </tr>
-                  </table>
-                  <ul>
-                    <li>Removed deprecated TUTORIAL file.
-                    <li>Removed support for the "showage" configuration variable.
-                    <li>"task stop" can remove the start time from a started task.
-                    <li>"task ghistory" now displays a differently aligned graph, allowing
-                        easier comparison by month of tasks added versus completed and deleted.
-                    <li>"task version" command now reports unrecognized configuration variables,
-                        which may be spelling mistakes or deprecated variables.
-                    <li>"configure --enable-debug" now supported to suppress compiler optimization
-                        to allow debugging.
-                    <li>Allow lower case priorities, and automatically upper case them.
-                    <li>Added support for "due" configuration variable which defines the number
-                        of days in the future when a task is considered due.
-                    <li>Added support for custom reports, comprised of a set of column names and
-                        sort order, with optional filtering in the configuration file.  This
-                        means user-defined reports can be written, and the reports currently
-                        in the configuration file can be renamed.  Several of task's built in
-                        reports have been converted to user-defined reports.
-                    <li>New online documentation for custom reports.
-                    <li>New algorithm for determining when the "nag" message is displayed.
-                    <li>Fixed bug where task hangs with a certain combination of recurring tasks
-                        and shadow files.
-                    <li>Fixed bug with the task sort algorithm, which led to an unstable sequence
-                        when there were only a handful of tasks.
-                    <li>Performance enhanced by eliminating unnecessary sorting.
-                    <li>Task now has a large (and growing) test suite and bug regression tests
-                        to help ensure higher quality releases.
-                    <li>Fixed bug that caused large performance hit during table rendering.
-                    <li>Fixed bug that concatenated a modified description without spaces.
-                    <li>Added new column 'recur' that displays the recurrence period of any
-                        recurring tasks.  This column can be added to any custom report.
-                    <li>Added support for "color.recurring" configuration variable which
-                        specifies the color of recurring tasks.
-                    <li>Added support for "locking" configuration variable that controls whether
-                        file locking is used.
-                    <li>Task export feature now includes recurrence information, removes nested
-                        quotes, and limits output to pending tasks.
-                    <li>Task no longer includes deleted tasks in the summary report (thanks to
-                        Benjamin Tegarden).
-                    <li>Fixed bug that prevented the summary report from properly reporting
-                        recently completed tasks.
-                  </ul>
-                </p>
-
-                <p>
-                  <h4>New in version 1.4.3 (11/1/2008)</h4>
-                  <a href="http://www.beckingham.net/task-1.4.3.tar.gz">task-1.4.3.tar.gz</a>
-                  <br />
-                  Mac OS X 10.5 (Leopard) Intel-only:
-                  <a href="http://www.beckingham.net/task-1.4.3.pkg">task-1.4.3.pkg</a>
-                  <br />
-                  Debian package: <a href="http://www.beckingham.net/task_1.4.3-1_i386.deb">task_1.4.3-1_i386.deb</a>
-                  (Thanks to <a href="http://blog.rfquerin.org">Richard Querin</a>)
-                </p>
-
-                <p>
-                  <ul>
-                    <li>Fixed misleading task count at bottom of "info" report.
-                    <li>Added support for a shadow file that contains a plain text task report,
-                        with the "shadow.file" and "shadow.command" configuration variables.
-                        The shadow file is automatically updated whenever the task database
-                        changes.  Useful for integrating with "Samurize".
-                    <li>Task now displays a message whenever a shadow file is updated, if the
-                        "shadow.notify" configuration variable is set "on".
-                    <li>Fixed bug whereby adding a task with a \n, \r or \f did not fail properly.
-                    <li>Removed "task usage" command.
-                    <li>Added documentation for Shadow files.
-                    <li>Added documentation for task filters.
-                  </ul>
-                </p>
-
-                <p>
-                  <h4>New in version 1.4.2 (9/18/2008)</h4>
-                  <a href="http://www.beckingham.net/task-1.4.2.tar.gz">task-1.4.2.tar.gz</a>
-                  <br />
-                  Mac OS X 10.5 (Leopard) Intel-only:
-                  <a href="http://www.beckingham.net/task-1.4.2.pkg">task-1.4.2.pkg</a>
-                  <br />
-                  Debian package: <a href="http://www.beckingham.net/task_1.4.2-1_i386.deb">task_1.4.2-1_i386.deb</a>
-                  (Thanks to <a href="http://blog.rfquerin.org">Richard Querin</a>)
-                </p>
-
-                <ul>
-                  <li>"task undo" can now retract a "task done" command, provided no
-                      reports have been run.
-                  <li>Task now correctly sorts on entire strings, instead of just the
-                      first character (thanks to Andy Lester).
-                  <li>Task now uses dashes (-----) to underline column headings when
-                      color is disabled (thanks to Vincent Fleuranceau).
-                  <li>Task now allows mixed case attribute names (pri:, PRI:, Pri: ...)
-                      and commands (add, ADD, Add ...) (thanks to Vincent Fleuranceau).
-                  <li>Task now supports a default project and priority for new tasks, via
-                      the new "default.project" and "default.priority" configuration variables
-                      (thanks to Vincent Fleuranceau).
-                  <li>Task supports improved word-wrapping to the terminal width.
-                  <li>Task now supports "default.command" configuration variable (for example
-                      it could contain "list due:tomorrow") which is the command that is run
-                      whenever task is invoked with no arguments.
-                  <li>Task supports modifying the existing description of a task, with the
-                      following syntax: task &lt;id&gt; "new description ...".
-                  <li>Fixed bug so that relative dates in filters (task list due:eom,
-                      task list due:tomorrow, task list due:23rd ...) are now properly
-                      supported.
-                  <li>Fixed bug so that source now properly includes &lt;string.h&gt; in
-                      order to build clean using gcc 4.3 (thanks to H. İbrahim Güngör)
-                </ul>
-
-                <p>
-                  <h4>New in version 1.4.1 (7/18/2008)</h4>
-                  <a href="http://www.beckingham.net/task-1.4.1.tar.gz">task-1.4.1.tar.gz</a>
-                  <br />
-                  Mac OS X 10.5 (Leopard) Intel-only:
-                  <a href="http://www.beckingham.net/task-1.4.1.pkg">task-1.4.1.pkg</a>
-                  <br />
-                  Debian package: <a href="http://www.beckingham.net/task_1.4.1-1_i386.deb">task_1.4.1-1_i386.deb</a>
-                  (Thanks to <a href="http://blog.rfquerin.org">Richard Querin</a>)
-                </p>
-
-                <ul>
-                  <li>Fixed bug: Descriptions could not be altered with "task 123 New description"
-                  <li>Tweak: For "task calendar" month names are now centered over the month
-                  <li>Removed TUTORIAL file contents in favor of online version
-                  <li>New Mac Intel-only Leopard (10.5) binary package
-                </ul>
-
-                <p>
-                  <h4>New in version 1.4.0 (7/10/2008)</h4>
-                  Source: <a href="http://www.beckingham.net/task-1.4.0.tar.gz">task-1.4.0.tar.gz</a>
-                  <br />
-                  Debian package: <a href="http://www.beckingham.net/task_1.4.0-1_i386.deb">task_1.4.0-1_i386.deb</a>
-                  (Thanks to <a href="http://blog.rfquerin.org">Richard Querin</a>)
-                </p>
-
-                <ul>
-                  <li>Added new <a href="recur.html">recurring tasks</a> feature
-                  <li>Added "task undelete" feature to restore a (very) recently deleted
-                      task
-                  <li>Added averages to the "task history" report
-                  <li>Added bar chart history report "task ghistory"
-                  <li>Added support for rc:&lt;file&gt; to allow override of the default
-                      ~/.taskrc file
-                  <li>Added support for relative due: dates, such as "tomorrow", "friday",
-                      "23rd", "eom"
-                  <li>Added support for task filtering on all reports
-                  <li>Automatically shuts off color, ncurses when output is not to a tty
-                  <li>Added support for the ~ character in .taskrc data.location, for flexibility
-                  <li>Allows colons on the description, provided what is to the left of the colon
-                      is not a standard attribute name
-                  <li>Fixed bug where Esc[0m sequences were being emitted for no good reason
-                  <li>Fixed bug where table headers are underlined when color is turned off
-                  <li>Fixed bug where adding a blank priority resulted in an assigned garbage value
-                  <li>Fixed bug parsing date "07/08/2008" when using dateformat "m/d/Y"
-                </ul>
-
-                <p>
-                  <h4>New in version 1.3.1</h4>
-                  Source: <a href="http://www.beckingham.net/task-1.3.1.tar.gz">task-1.3.1.tar.gz</a>
-                  <br />
-                  Debian package: <a href="http://www.beckingham.net/task_1.3.1-1_i386.deb">task_1.3.1-1_i386.deb</a>
-                  (Thanks to <a href="http://blog.rfquerin.org">Richard Querin</a>)
-                </p>
-
-                <ul>
-                  <li>New configuration variable "defaultwidth" determines the width
-                      of windows in the absense of ncurses support
-                  <li>Fixed bug where "showage" configuration variable was not being
-                      oberved by the "task long" report
-                  <li>Fixed bug causing segmentation faults (mostly for Ubuntu users)
-                      when various commands are run
-                  <li>Fixed bug so that task now will recreate a missing ~/.taskrc file,
-                      OR a missing ~/.task directory
-                </ul>
-
-                <p>
-                  <h4>New in version 1.3.0</h4>
-                  Source: <a href="http://www.beckingham.net/task-1.3.0.tar.gz">task-1.3.0.tar.gz</a>
-                  <br />
-                  Debian package: <a href="http://www.beckingham.net/task_1.3.0-0_i386.deb">task_1.3.0-0_i386.deb</a>
-                  (Thanks to <a href="http://blog.rfquerin.org">Richard Querin</a>)
-                </p>
-
-                <ul>
-                  <li>"task calendar" now displays multiple months per line, adjustable
-                      by the "monthsperline" configuration variable.  Feature added by
-                      Damian Glenny
-                  <li>Displays shorter message when a command is entered incorrectly,
-                      and the full usage for "task help"
-                  <li>"task export" can now filter tasks like the reports
-                  <li>"task oldest" shows the oldest tasks
-                  <li>"task newest" shows the newest tasks
-                  <li>Fixed bug where task generates a segmentation fault for several
-                      commands, when no "dateformat" configuration variable was present
-                  <li>Fixed bug whereby if you have more than one task with a due date,
-                      7 days gets added to the entry date of task 2..n
-                  <li>Fixed bug whereby "1 wks" was being improperly pluralized
-                </ul>
-
-                <p>
-                  <h4>New in version 1.2.0</h4>
-                  Source: <a href="http://www.beckingham.net/task-1.2.0.tar.gz">task-1.2.0.tar.gz</a>
-                  <br />
-                  Debian package: <a href="http://www.beckingham.net/task_1.2.0-1_i386.deb">task_1.2.0-1_i386.deb</a>
-                  (Thanks to <a href="http://blog.rfquerin.org">Richard Querin</a>)
-                </p>
-
-                <ul>
-                  <li>Subprojects supported - please see documentation below, or TUTORIAL
-                      file
-                  <li>"dateformat" configuration variable now properly used to parse as
-                      well as render dates
-                  <li>"task list x" now performs a caseless comparison between "x" and
-                      the task description
-                  <li>"showage" configuration variable determines whether the "Age" column
-                      should appear on the "task list" and "task next" reports
-                  <li>Improvements to the TUTORIAL file and this page
-                </ul>
-
-                <p>
-                  <h4>New in version 1.1.0</h4>
-                  Source: <a href="http://www.beckingham.net/task-1.1.0.tar.gz">task-1.1.0.tar.gz</a>
-                  <br />
-                  Debian package: <a href="http://www.beckingham.net/task_1.1.0-1_i386.deb">task_1.1.0-1_i386.deb</a>
-                  (Thanks to <a href="http://blog.rfquerin.org">Richard Querin</a>)
-                </p>
-
-                <ul>
-                  <li>"blanklines" configuration variable to stop displaying unnecessary
-                      white space and thus work better on small-screen devices
-                  <li>"dateformat" configuration now determines how dates are formatted
-                  <li>Better formatting of "task tags" output
-                  <li>This home page set up, with TUTORIAL
-                  <li>Added tags to the "task long" report
-                </ul>
-
-                <p>
-                  <h4>New in version 1.0.1</h4>
-                  Source: <a href="http://www.beckingham.net/task-1.0.1.tar.gz">task-1.0.1.tar.gz</a>
-                </p>
-
-                <ul>
-                  <li>Fixed bug where the UUID generator not properly terminating strings
-                  <li>Fixed bug where srandom/srand not called prior to custom UUID generation
-                </ul>
-
-                <p>
-                  <h4>Version 1.0.0</h4>
-                  Source: <a href="http://www.beckingham.net/task-1.0.0.tar.gz">task-1.0.0.tar.gz</a>
-                </p>
-
-                <p>
-                  Task 1.0.0 was the first publicly available version of task.
-                </p>
-
-              </div>
-
-              <br />
-              <br />
-              <div class="content">
-                <p>
-                  Copyright 2006-2009, P. Beckingham.  All rights reserved.
-                </p>
-              </div>
-            </div>
-          </td>
-
-          <td align="right" valign="top" width="200px">
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-            <br />
-
-            <script type="text/javascript"><!--
-            google_ad_client = "pub-9709799404235424";
-            /* Task Main */
-            google_ad_slot = "8660617875";
-            google_ad_width = 120;
-            google_ad_height = 600;
-            //-->
-            </script>
-            <script type="text/javascript"
-                     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
-            </script>
-          </td>
-        </tr>
-      </table>
-
-    </div>
-
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-var pageTracker = _gat._getTracker("UA-4737637-1");
-pageTracker._initData();
-pageTracker._trackPageview();
-</script>
-
-  </body>
-</html>
-

i18n/strings.de-DE

@@ -0,0 +1,157 @@
+# This is an example strings.en-US file.
+#
+# The task program has a built-in set of default strings, which are UTF8 encoded
+# for the en-US locale.  A file such as this is used to override those defaults.
+# This means that a strings file is merely a delta applied to the built-in
+# strings, so an empty string file means you get en-US.
+#
+# To use another string file, add the following entry to your .taskrc file:
+#
+#   locale=sv-SE    # Swedish string set
+
+# 1xx task shell
+100 Unbekannter Fehler #Unknown Error.
+101 Konnte nicht Datenverzeichnis HOME aus passwd Datei lesen #Could not read home directory from the passwd file.
+102 (j/n) #(y/n)
+103 Ungültige ID in Sequenz #Invalid ID in sequence
+104 Ungültige ID in Bereich #Invalid ID in range
+105 Invertierter Sequenzbereich hoch-niedrig #Inverted sequence range high-low
+106 ID Bereich zu gross #ID Range too large
+107 Keine Sequenz #Not a sequence.
+108 Task interaktiv nur möglich mit vorhandenem ncurses #Interactive task is only available when built with ncurses support.
+109 Leerer Eintrag in der Eingabe #Empty record in input
+110 Unbekanntes Zeichen am Zeilenende #Unrecognized characters at end of line
+111 Datensatz nicht als Format 4 erkannt #Record not recognized as format 4
+112 Kann leere Zeichenkette nicht ersetzen #Cannot substitute an empty string
+113 Nicht erkanntes Zeichen am Ende der Ersetzung #Unrecognized character(s) at end of substitution
+114 Fehlformulierte Ersetzung #Malformed substitution
+115 Etiketten dürfen keine Kommas enthalten #Tags are not permitted to contain commas
+
+# 2xx Commands - must be sequential
+200 aktiv #active
+201 hinzufen #add
+202 beizufügen  #append
+203 anmerkung #annotate
+204 kalender #calendar
+205 farben #colors
+206 fertiggestellt #completed
+207 löschen #delete
+208 erledigt #done
+209 duplizieren #duplicate
+210 editieren #edit
+211 export #export
+212 hilfe #help
+213 geschichte #history
+214 ggeschichte #ghistory
+215 import #import
+216 info #info
+
+218 überfällig #overdue
+219 projekte #projects
+220 start #start
+221 statistik #stats
+222 stop #stop
+223 zusammenfassung #summary
+224 etikett #tags
+225 zeitdatenblatt#timesheet
+
+227 rücksetzen #undo
+228 version #version
+
+# 3xx Attributes - must be sequential
+300 projekt #project
+301 priorität #priority
+302 vordergrund #fg
+303 hintergrund #bg
+304 fällig #due
+305 eintrag #entry
+306 start #start
+307 stop #end
+308 wiederkehrend #recur
+309 bis #until
+310 mask #mask
+311 imask #imask
+
+# 35x Attribute modifiers - must be sequential
+350 davor #before
+351 danach #after
+352 nict #not
+353 kein #none
+354 beliebig #any
+355 synth #synth
+356 unter #under
+357 über #over
+358 erstes #first
+359 letztes #last
+360 dieses #this
+361 nächste #next
+362 ist #is
+363 istnicht #isnt
+364 hat #has
+365 hatnicht #hasnt
+366 beginntmit #startswith
+367 endetmit #endswith
+
+# 4xx Columns
+
+# 5xx Colors
+500 fett #bold
+501 unterstrichen #underline
+502 fett_unterstrichen #bold_underline
+503 schwarz #black
+504 rot #red
+505 grün #green
+506 gelb #yellow
+507 blau #blue
+508 magenta #magenta
+509 cyan #cyan
+510 weiss #white
+511 fett_schwarz #bold_black
+512 fett_rot #bold_red
+513 fett_grün #bold_green
+514 fett_gelb #bold_yellow
+515 fett_blau #bold_blue
+516 fett_magenta #bold_magenta
+517 fett_cyan #bold_cyan
+518 fett_weiss #bold_white
+519 unterstrichen_schwarz #underline_black
+520 unterstrichen_rot #underline_red
+521 unterstrichen_grün #underline_green
+522 unterstrichen_gelb #underline_yellow
+523 unterstrichen_blau #underline_blue
+524 unterstrichen_magenta #underline_magenta
+525 unterstrichen_cyan #underline_cyan
+526 unterstrichen_weiss #underline_white
+527 fett_unterstrichen_schwarz #bold_underline_black
+528 fett_unterstrichen_rot #bold_underline_red
+529 fett_unterstrichen_grün #bold_underline_green
+530 fett_unterstrichen_gelb #bold_underline_yellow
+531 fett_unterstrichen_blau #bold_underline_blue
+532 fett_unterstrichen_magenta #bold_underline_magenta
+533 fett_unterstrichen_cyan #bold_underline_cyan
+534 fett_unterstrichen_weiss #bold_underline_white
+535 auf_schwarz #on_black
+536 auf_rot #on_red
+537 auf_grün #on_green
+538 auf_gelb #on_yellow
+539 auf_blau #on_blue
+540 auf_magenta #on_magenta
+541 auf_cyan #on_cyan
+542 auf_weiss #on_white
+543 auf_signal_schwarz #on_bright_black
+544 auf_signal_rot #on_bright_red
+545 auf_signal_grün #on_bright_green
+546 auf_signal_gelb #on_bright_yellow
+547 auf_signal_blau #on_bright_blue
+548 auf_signal_magenta #on_bright_magenta
+549 auf_signal_cyan #on_bright_cyan
+550 auf_signal_weiss #on_bright_white
+551 aus #off
+552 Unbekannte Farbe #Unknown color name
+
+# 6xx Config
+
+# 7xx TDB
+
+# 8xx Reports
+

i18n/strings.en-US

@@ -0,0 +1,122 @@
+# This is an example strings.en-US file.
+#
+# The task program has a built-in set of default strings, which are UTF8 encoded
+# for the en-US locale.  A file such as this is used to override those defaults.
+# This means that a strings file is merely a delta applied to the built-in
+# strings, so an empty string file means you get en-US.
+#
+# To use another string file, add the following entry to your .taskrc file:
+#
+#   locale=sv-SE    # Swedish string set
+
+# 1xx task shell
+100 Unknown Error.
+101 Could not read home directory from the passwd file.
+102 (y/n)
+103 Invalid ID in sequence
+104 Invalid ID in range
+105 Inverted sequence range high-low
+106 ID Range too large
+107 Not a sequence.
+108 Interactive task is only available when built with ncurses support.
+109 Empty record in input
+110 Unrecognized characters at end of line
+111 Record not recognized as format 4
+112 Cannot substitute an empty string
+113 Unrecognized character(s) at end of substitution
+114 Malformed substitution
+115 Tags are not permitted to contain commas
+116 You must specify a command, or a task ID to modify
+
+# 2xx Commands - must be sequential
+200 active
+201 add
+202 append
+203 annotate
+204 calendar
+205 colors
+206 completed
+207 delete
+208 done
+209 duplicate
+210 edit
+211 export
+212 help
+213 history
+214 ghistory
+215 import
+216 info
+217 prepend
+218 overdue
+219 projects
+220 start
+221 stats
+222 stop
+223 summary
+224 tags
+225 timesheet
+
+227 undo
+228 version
+229 shell
+
+# 3xx Attributes - must be sequential
+300 project
+301 priority
+302 fg
+303 bg
+304 due
+305 entry
+306 start
+307 end
+308 recur
+309 until
+310 mask
+311 imask
+
+# 35x Attribute modifiers - must be sequential
+350 before
+351 after
+352 not
+353 none
+354 any
+355 synth
+356 under
+357 over
+358 first
+359 last
+360 this
+361 next
+362 is
+363 isnt
+364 has
+365 hasnt
+366 startswith
+367 endswith
+
+# 4xx Columns
+
+# 5xx Colors
+500 bold
+501 underline
+502 on
+503 bright
+
+504 black
+505 red
+506 green
+507 yellow
+508 blue
+509 magenta
+510 cyan
+511 white
+
+520 off
+521 Unknown color name
+
+# 6xx Config
+
+# 7xx TDB
+
+# 8xx Reports
+

i18n/strings.es-ES

@@ -0,0 +1,11 @@
+# 1xx task shell
+100 Error desconocido.
+
+# 2xx Commands
+# 3xx Attributes
+# 4xx Columns
+# 5xx Colors
+# 6xx Config
+# 7xx TDB
+# 8xx Reports
+

i18n/strings.fr-FR

@@ -0,0 +1,11 @@
+# 1xx task shell
+100 Erreur inconnue.
+
+# 2xx Commands
+# 3xx Attributes
+# 4xx Columns
+# 5xx Colors
+# 6xx Config
+# 7xx TDB
+# 8xx Reports
+

i18n/strings.nl-NL

@@ -0,0 +1,11 @@
+# 1xx task shell
+100 Onbekende fout.
+
+# 2xx Commands
+# 3xx Attributes
+# 4xx Columns
+# 5xx Colors
+# 6xx Config
+# 7xx TDB
+# 8xx Reports
+

i18n/strings.sv-SE

@@ -0,0 +1,157 @@
+# This is an example strings.en-US file.
+#
+# The task program has a built-in set of default strings, which are UTF8 encoded
+# for the en-US locale.  A file such as this is used to override those defaults.
+# This means that a strings file is merely a delta applied to the built-in
+# strings, so an empty string file means you get en-US.
+#
+# To use another string file, add the following entry to your .taskrc file:
+#
+#   locale=sv-SE    # Swedish string set
+
+# 1xx task shell
+100 Okänt fel. #Unknown Error.
+101 Kunde inte läsa hemkatalogen från passwd filen. #Could not read home directory from the passwd file.
+102 (j/n) #(y/n)
+103 Ogiltig ID i sekvens #Invalid ID in sequence
+104 Ogiltig ID i spännvidd #Invalid ID in range
+105 Inverterad sekvens spännvidd hög-låg #Inverted sequence range high-low
+106 ID spännvidd för stor #ID Range too large
+107 Ingen sekvens. #Not a sequence.
+108 Interaktiv task är bara tillgänglig när den kompilerades med support för ncurses. #Interactive task is only available when built with ncurses support.
+109 Tom post i ingångsdata #Empty record in input
+110 Okänt tecknen på slutet av raden. #Unrecognized characters at end of line
+111 Post inte indentifierad som format 4 #Record not recognized as format 4
+112 Substitution av tom teckensträng är inte möjligt #Cannot substitute an empty string
+113 Pkänt tecken vid slutet av substitution #Unrecognized character(s) at end of substitution
+114 Ogiltig substitution #Malformed substitution
+115 Taggar får inte innehåller komman #Tags are not permitted to contain commas
+
+# 2xx Commands - must be sequential
+200 aktivt #active
+201 tillägg #add
+202 bifoga #append
+203 kommentera #annotate
+204 kalender #calendar
+205 färger #colors
+206 avslutad #completed
+207 stryk #delete
+208 färdig #done
+209 kopiera #duplicate
+210 redigera #edit
+211 exportera #export
+212 hjälp #help
+213 historia #history
+214 ghistoria #ghistory
+215 importera #import
+216 info #info
+
+218 försenad #overdue
+219 projekten #projects
+220 start #start
+221 statistik #stats
+222 stop #stop
+223 sammanfattning #summary
+224 taggar #tags
+225 tidsrapport #timesheet
+
+227 ångra #undo
+228 version #version
+
+# 3xx Attributes - must be sequential
+300 projekt #project
+301 prioritet #priority
+302 förgrund #fg
+303 bakgrund #bg
+304 väntad #due
+305 post #entry
+306 start #start
+307 slut #end
+308 periodirskt #recur
+309 innan #until
+310 mask #mask
+311 imask #imask
+
+# 35x Attribute modifiers - must be sequential
+350 före #before
+351 efter #after
+352 inte #not
+353 ingen #none
+354 några #any
+355 synth #synth
+356 under #under
+357 över #over
+358 första #first
+359 sista #last
+360 detta #this
+361 nästa #next
+362 är #is
+363 ärinte #isnt
+364 har #has
+365 harinte #hasnt
+366 börjarmed #startswith
+367 slutarmed #endswith
+
+# 4xx Columns
+
+# 5xx Colors
+500 fet #bold
+501 understrykt #underline
+502 fet_understrykt #bold_underline
+503 svart #black
+504 röd #red
+505 grön #green
+506 gul #yellow
+507 blå #blue
+508 magenta #magenta
+509 cyan #cyan
+510 vit #white
+511 fet_svart #bold_black
+512 fet_röd #bold_red
+513 fet_grön #bold_green
+514 fet_gul #bold_yellow
+515 fet_blå #bold_blue
+516 fet_magenta #bold_magenta
+517 fet_cyan #bold_cyan
+518 fet_vit #bold_white
+519 understrykt_svart #underline_black
+520 understrykt_röd #underline_red
+521 understrykt_grön #underline_green
+522 understrykt_gul #underline_yellow
+523 understrykt_blå #underline_blue
+524 understrykt_magenta #underline_magenta
+525 understrykt_cyan #underline_cyan
+526 understrykt_vit #underline_white
+527 fet_understrykt_svart #bold_underline_black
+528 fet_understrykt_röd #bold_underline_red
+529 fet_understrykt_grön #bold_underline_green
+530 fet_understrykt_gul #bold_underline_yellow
+531 fet_understrykt_blå #bold_underline_blue
+532 fet_understrykt_magenta #bold_underline_magenta
+533 fet_understrykt_cyan #bold_underline_cyan
+534 fet_understrykt_vit #bold_underline_white
+535 på_svart #on_black
+536 på_röd #on_red
+537 på_grön #on_green
+538 på_gul #on_yellow
+539 på_blå #on_blue
+540 på_magenta #on_magenta
+541 på_cyan #on_cyan
+542 på_vit #on_white
+543 på_ljust_svart #on_bright_black
+544 på_ljust_röd #on_bright_red
+545 på_ljust_grön #on_bright_green
+546 på_ljust_gul #on_bright_yellow
+547 på_ljust_blå #on_bright_blue
+548 på_ljust_magenta #on_bright_magenta
+549 på_ljust_cyan #on_bright_cyan
+550 på_ljust_vit #on_bright_white
+551 av #off
+552 Okänt färg namn #Unknown color name
+
+# 6xx Config
+
+# 7xx TDB
+
+# 8xx Reports
+

i18n/tips.de-DE

@@ -0,0 +1,5 @@
+%
+erster Tipp
+%
+zweiter Tipp
+%

i18n/tips.en-US

@@ -0,0 +1,5 @@
+%
+first tip
+%
+second tip
+%

i18n/tips.sv-SE

@@ -0,0 +1,5 @@
+%
+första tips
+%
+andra tips
+%

package-config/README

@@ -0,0 +1,32 @@
+The package-config directory contains the configuration files
+for building release packages for the different operating
+systems:
+
+* osx: binary packages for Mac OSX
+* fedora: rpm packages for Fedora (Linux)
+* ubuntu: deb packages for Ubuntu and (Linux)
+* cygwin_ bz2 packages for cygwin (windows)
+
+Please visit the corresponding operating systems homepage
+for instructions on how to build a binary package of task
+out of the released source tarball with these configuration
+files.
+
+For Fedora rpm packages you find instructions at
+http://fedoraproject.org/wiki/PackageMaintainers/CreatingPackageHowTo
+
+For Ubuntu deb packages you find instructions at
+https://wiki.ubuntu.com/PackagingGuide/Complete
+
+For Cygwin bz2 packages you find instructions at
+http://cygwin.com/setup.html
+
+You might also ask in the forums on taskwarrior.org if you
+have further questions.
+
+This file and the corresponding package build configuration files
+are released under the terms of the GNU General Public License as
+published by the Free Software Foundation; either version 2 of the
+License, or (at your option) any later version.
+
+Please see the file COPYING in the main directory.

package-config/cygwin/CYGWIN-PATCHES/setup.hint

@@ -0,0 +1,10 @@
+# setup.hint for task 1.8.1-1
+category: Utils
+requires: libncurses9 cygwin 
+sdesc: A command-line to do list manager
+ldesc: "Task is a command-line to do list manager.
+It has support for GTD functionality and includes
+the following features: tags, colorful tabular output,
+reports and graphs, lots of manipulation commands,
+low-level API, abbreviations for all commands and
+options, multiuser file locking, recurring tasks."

package-config/cygwin/CYGWIN-PATCHES/task-1.8.1-1.README

@@ -0,0 +1,45 @@
+task 1.8.1-1
+------------------------------------------
+
+A command-line to do list manager that can be used
+with the gtd system.
+
+Runtime requirements:
+  cygwin-1.5.25 or newer
+  libncurses
+
+Build requirements:
+  cygwin-1.5.25 or newer
+  gcc-3.4.4-1 or newer
+  libncurses-devel
+
+Canonical homepage:
+  http://taskwarrior.org
+
+Canonical download:
+  http://taskwarrior.org/download
+
+License:
+  GPLv2+
+
+Language:
+  C++
+
+------------------------------------
+
+Build instructions:
+  unpack task-1.8.1-1-src.tar.bz2
+    if you use setup to install this src package,
+    it will be unpacked under /usr/src automatically
+  cd /usr/src/task-1.8.1-1
+  ./configure --prefix=/usr
+  make
+  make install
+
+------------------------------------
+
+task was packaged for cygwin by
+Federico Hernandez <ultrafredde@gmail.com> and
+is licensed under the GPL
+
+---- task-1.8.1-1 -- 2009-08-20 ----

package-config/cygwin/task-1.8.1-1.patch

@@ -0,0 +1,63 @@
+diff -Nrup task-1.8.1-1/CYGWIN-PATCHES/setup.hint task-1.8.1-1.cygwin/CYGWIN-PATCHES/setup.hint
+--- task-1.8.1-1/CYGWIN-PATCHES/setup.hint	1970-01-01 01:00:00.000000000 +0100
++++ task-1.8.1-1.cygwin/CYGWIN-PATCHES/setup.hint	2009-08-20 15:47:56.304750000 +0200
+@@ -0,0 +1,10 @@
++# setup.hint for task 1.8.1-1
++category: Utils
++requires: libncurses9 cygwin 
++sdesc: A command-line to do list manager
++ldesc: "Task is a command-line to do list manager.
++It has support for GTD functionality and includes
++the following features: tags, colorful tabular output,
++reports and graphs, lots of manipulation commands,
++low-level API, abbreviations for all commands and
++options, multiuser file locking, recurring tasks."
+diff -Nrup task-1.8.1-1/CYGWIN-PATCHES/task-1.8.1-1.README task-1.8.1-1.cygwin/CYGWIN-PATCHES/task-1.8.1-1.README
+--- task-1.8.1-1/CYGWIN-PATCHES/task-1.8.1-1.README	1970-01-01 01:00:00.000000000 +0100
++++ task-1.8.1-1.cygwin/CYGWIN-PATCHES/task-1.8.1-1.README	2009-08-20 15:47:44.320375000 +0200
+@@ -0,0 +1,45 @@
++task 1.8.1-1
++------------------------------------------
++
++A command-line to do list manager that can be used
++with the gtd system.
++
++Runtime requirements:
++  cygwin-1.5.25 or newer
++  libncurses
++
++Build requirements:
++  cygwin-1.5.25 or newer
++  gcc-3.4.4-1 or newer
++  libncurses-devel
++
++Canonical homepage:
++  http://taskwarrior.org
++
++Canonical download:
++  http://taskwarrior.org/download
++
++License:
++  GPLv2+
++
++Language:
++  C++
++
++------------------------------------
++
++Build instructions:
++  unpack task-1.8.1-1-src.tar.bz2
++    if you use setup to install this src package,
++    it will be unpacked under /usr/src automatically
++  cd /usr/src/task-1.8.1-1
++  ./configure --prefix=/usr
++  make
++  make install
++
++------------------------------------
++
++task was packaged for cygwin by
++Federico Hernandez <ultrafredde@gmail.com> and
++is licensed under the GPL
++
++---- task-1.8.1-1 -- 2009-08-20 ----

package-config/cygwin/usr/share/doc/Cygwin/task-1.8.1-1.README

@@ -0,0 +1,45 @@
+task 1.8.1-1
+------------------------------------------
+
+A command-line to do list manager that can be used
+with the gtd system.
+
+Runtime requirements:
+  cygwin-1.5.25 or newer
+  libncurses
+
+Build requirements:
+  cygwin-1.5.25 or newer
+  gcc-3.4.4-1 or newer
+  libncurses-devel
+
+Canonical homepage:
+  http://taskwarrior.org
+
+Canonical download:
+  http://taskwarrior.org/download
+
+License:
+  GPLv2+
+
+Language:
+  C++
+
+------------------------------------
+
+Build instructions:
+  unpack task-1.8.1-1-src.tar.bz2
+    if you use setup to install this src package,
+    it will be unpacked under /usr/src automatically
+  cd /usr/src/task-1.8.1-1
+  ./configure --prefix=/usr
+  make
+  make install
+
+------------------------------------
+
+task was packaged for cygwin by
+Federico Hernandez <ultrafredde@gmail.com> and
+is licensed under the GPL
+
+---- task-1.8.1-1 -- 2009-08-20 ----

package-config/fedora/task.spec

@@ -0,0 +1,71 @@
+Name:           task
+Version:        1.8.1
+Release:        1%{?dist}
+Summary:        A command-line to do list manager
+
+Group:          Applications/Productivity
+License:        GPLv2+
+URL:            http://taskwarrior.org
+Source0:        http://taskwarrior.org/download/%{name}-%{version}.tar.gz
+BuildRoot:      %{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n)
+
+BuildRequires:  ncurses-devel
+
+%description
+Task is a command-line to do list manager. It has
+support for GTD functionality and includes the
+following features: tags, colorful tabular output,
+reports and graphs, lots of manipulation commands,
+low-level API, abbreviations for all commands and
+options, multiuser file locking, recurring tasks.
+
+%prep
+%setup -q
+
+
+%build
+%configure
+make %{?_smp_mflags}
+
+
+%install
+rm -rf $RPM_BUILD_ROOT
+make install DESTDIR=$RPM_BUILD_ROOT
+mkdir -p $RPM_BUILD_ROOT%{_sysconfdir}/bash_completion.d
+install -m 644 -T scripts/bash/task_completion.sh $RPM_BUILD_ROOT%{_sysconfdir}/bash_completion.d/task
+
+%clean
+rm -rf $RPM_BUILD_ROOT
+
+
+%files
+%defattr(-,root,root,-)
+%doc AUTHORS ChangeLog COPYING NEWS README scripts i18n
+%{_bindir}/task
+%{_mandir}/man1/task.1.gz
+%{_mandir}/man5/taskrc.5.gz
+%{_mandir}/man5/task-tutorial.5.gz
+%config(noreplace) %{_sysconfdir}/bash_completion.d
+
+
+%changelog
+* Thu Aug 20 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.8.1-1
+  Intial RPM for task bugfix release 1.8.1
+* Tue Jul 21 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.8.0-1
+  Intial RPM for task release 1.8.0
+* Mon Jul 13 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.8.0.beta3-1
+  Intial RPM for task beta release 1.8.0.beta3
+* Wed Jul 08 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.8.0.beta2-1
+  Intial RPM for task beta release 1.8.0.beta2
+* Tue Jul 07 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.8.0.beta1-1
+  Intial RPM for task beta release 1.8.0.beta1
+* Tue Jun 08 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.7.1-2
+- Fixed inclusion of manpages.
+* Tue Jun 08 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.7.1-1
+- Initial RPM for bugfix release 1.7.1.
+- Updated references to new project homepage in spec file. 
+* Tue May 19 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.7.0-2
+- Changed license to GPLv2+ and removed Requires macro.
+- See https://bugzilla.redhat.com/show_bug.cgi?id=501498
+* Tue May 19 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.7.0-1
+- Initial RPM.

package-config/osx/task.pmdoc/01local-contents.xml

@@ -0,0 +1 @@
+<pkg-contents spec="1.12"><f n="local" o="root" g="staff" p="16877" pt="/Users/paul/task-1.9.0.git/package-config/osx/local" m="false" t="file"><f n="bin" o="root" g="wheel" p="16877"><f n="task" o="root" g="wheel" p="33261"><mod>mode</mod><mod>owner</mod></f><mod>owner</mod></f><f n="share" o="root" g="wheel" p="16877"><f n="doc" o="root" g="wheel" p="16877"><f n="task" o="root" g="wheel" p="16877"><f n="AUTHORS" o="root" g="wheel" p="33188"><mod>mode</mod><mod>owner</mod></f><f n="ChangeLog" o="root" g="wheel" p="33188"><mod>mode</mod><mod>owner</mod></f><f n="COPYING" o="root" g="wheel" p="33188"><mod>mode</mod><mod>owner</mod></f><f n="NEWS" o="root" g="wheel" p="33188"><mod>mode</mod><mod>owner</mod></f><f n="README" o="root" g="wheel" p="33188"><mod>mode</mod><mod>owner</mod></f><f n="scripts" o="root" g="wheel" p="16877"><f n="bash" o="root" g="wheel" p="16877"><f n="task_completion.sh" o="root" g="wheel" p="33188"><mod>owner</mod><mod>mode</mod><mod>group</mod></f><mod>mode</mod><mod>owner</mod></f><f n="vim" o="root" g="wheel" p="16877"><f n="ftdetect" o="root" g="wheel" p="16877"><f n="task.vim" o="root" g="wheel" p="33188"><mod>mode</mod></f><mod>mode</mod></f><f n="README" o="root" g="wheel" p="33188"><mod>mode</mod></f><f n="syntax" o="root" g="wheel" p="16877"><f n="taskdata.vim" o="root" g="wheel" p="33188"><mod>mode</mod></f><f n="taskedit.vim" o="root" g="wheel" p="33188"><mod>mode</mod></f><f n="taskrc.vim" o="root" g="wheel" p="33188"><mod>mode</mod></f><mod>mode</mod></f><mod>mode</mod></f><f n="zsh" o="root" g="wheel" p="16877"><f n="_task" o="root" g="wheel" p="33188"><mod>mode</mod></f><mod>mode</mod></f><mod>mode</mod><mod>owner</mod></f><mod>mode</mod><mod>owner</mod></f><mod>mode</mod><mod>owner</mod></f><f n="man" o="root" g="wheel" p="16877"><f n="man1" o="root" g="wheel" p="16877"><f n="task.1" o="root" g="wheel" p="33188"><mod>mode</mod></f><mod>mode</mod></f><f n="man5" o="root" g="wheel" p="16877"><f n="task-color.5" o="root" g="wheel" p="33188"><mod>mode</mod></f><f n="task-faq.5" o="root" g="wheel" p="33188"><mod>mode</mod></f><f n="task-tutorial.5" o="root" g="wheel" p="33188"><mod>mode</mod></f><f n="taskrc.5" o="root" g="wheel" p="33188"><mod>mode</mod></f><mod>mode</mod></f><mod>mode</mod></f><mod>mode</mod><mod>owner</mod></f><mod>owner</mod></f></pkg-contents>

package-config/osx/task.pmdoc/01local.xml

@@ -0,0 +1 @@
+<pkgref spec="1.12" uuid="3BCF9CAB-ED33-4182-AC52-29B9F8FF9B87"><config><identifier>com.beckingham.task190.local.pkg</identifier><version>2.0</version><description></description><post-install type="none"/><requireAuthorization/><installFrom>/Users/paul/task-1.9.0.git/package-config/osx/local</installFrom><installTo mod="true" relocatable="true">/usr/local</installTo><flags><followSymbolicLinks/></flags><packageStore type="internal"></packageStore><mod>installTo.path</mod><mod>version</mod><mod>parent</mod><mod>installTo</mod><mod>relocatable</mod></config><contents><file-list>01local-contents.xml</file-list><filter>/CVS$</filter><filter>/\.svn$</filter><filter>/\.cvsignore$</filter><filter>/\.cvspass$</filter><filter>/\.DS_Store$</filter></contents></pkgref>

package-config/osx/task.pmdoc/index.xml

@@ -0,0 +1 @@
+<pkmkdoc spec="1.12"><properties><title>Task 1.9.0</title><build>/Users/paul/Desktop/task-1.9.0-sl.pkg</build><organization>com.beckingham</organization><userSees ui="easy"/><min-target os="3"/><domain anywhere="true" system="true"/></properties><distribution><versions min-spec="1.000000"/><scripts></scripts></distribution><description>Task 1.9.0 install for Snow Leopard.</description><contents><choice title="local" id="choice36" starts_selected="true" starts_enabled="true" starts_hidden="false"><pkgref id="com.beckingham.task190.local.pkg"/></choice></contents><resources bg-scale="proportional" bg-align="center"><locale lang="en"><resource mod="true" type="license">/Users/paul/task-1.9.0.git/package-config/osx/COPYING.txt</resource><resource mod="true" type="welcome">/Users/paul/task-1.9.0.git/package-config/osx/README.txt</resource></locale></resources><requirements><requirement id="tosv" operator="ge" value="'10.6.0'"><message>Task requires Mac OSX 10.6.0 (Snow Leopard) or later.</message></requirement></requirements><flags/><item type="file">01local.xml</item><mod>properties.title</mod><mod>properties.customizeOption</mod><mod>description</mod><mod>properties.anywhereDomain</mod><mod>properties.systemDomain</mod></pkmkdoc>

package-config/osx/update

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+mkdir -p local/bin
+mkdir -p local/share/doc/task/scripts/bash
+mkdir -p local/share/doc/task/scripts/vim/ftdetect
+mkdir -p local/share/doc/task/scripts/vim/syntax
+mkdir -p local/share/doc/task/scripts/zsh
+mkdir -p local/share/man/man1
+mkdir -p local/share/man/man5
+
+cp ../../README                 README.txt
+cp ../../COPYING                COPYING.txt
+
+cp ../../src/task               local/bin/
+
+cp ../../AUTHORS                local/share/doc/task/
+cp ../../ChangeLog              local/share/doc/task/
+cp ../../COPYING                local/share/doc/task/
+cp ../../NEWS                   local/share/doc/task/
+cp ../../README                 local/share/doc/task/
+
+cp ../../scripts/bash/*         local/share/doc/task/scripts/bash
+cp ../../scripts/vim/README     local/share/doc/task/scripts/vim
+cp ../../scripts/vim/ftdetect/* local/share/doc/task/scripts/vim/ftdetect
+cp ../../scripts/vim/syntax/*   local/share/doc/task/scripts/vim/syntax
+cp ../../scripts/zsh/*          local/share/doc/task/scripts/zsh
+
+cp ../../doc/man/*.1            local/share/man/man1
+cp ../../doc/man/*.5            local/share/man/man5
+

package-config/ubuntu/debian/changelog

@@ -0,0 +1,82 @@
+task (1.8.5-1ubuntu2) karmic; urgency=low
+
+  * Fixed wrong ChangeLog file
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Sat, 05 Dec 2009 23:58:36 +0100
+
+task (1.8.5-1ubuntu1) karmic; urgency=low
+
+  * Initial deb package for task bugfix release 1.8.5 
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Sat, 05 Dec 2009 23:56:36 +0100
+
+task (1.8.4-1ubuntu1) karmic; urgency=low
+
+  * Initial deb package for task bugfix release 1.8.4 on karmic koala
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Tue, 17 Nov 2009 13:12:28 +0100
+
+task (1.8.3-1ubuntu1) karmic; urgency=low
+
+  * Initial deb package for task bugfix release 1.8.3 on karmic koala
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Sat, 31 Oct 2009 22:45:10 +0100
+
+task (1.8.3-0ubuntu1) jaunty; urgency=low
+
+  * Initial deb package for task bugfix release 1.8.3 
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Wed, 21 Oct 2009 23:22:25 +0200
+
+task (1.8.2-0ubuntu1) jaunty; urgency=low
+
+  * Initial deb package for task bugfix release 1.8.2 
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Mon, 07 Sep 2009 11:35:22 +0200
+
+task (1.8.1-0ubuntu1) jaunty; urgency=low
+
+  * Initial deb package for task bugfix release 1.8.1 
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Thu, 20 Aug 2009 20:26:33 +0200
+
+task (1.8.0-0ubuntu1) jaunty; urgency=low
+
+  * Initial deb package for task release 1.8.0 
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Tue, 21 Jul 2009 15:26:33 +0200
+
+task (1.8.0-0ubuntu1~beta3) jaunty; urgency=low
+
+  * Initial deb package for task beta release 1.8.0.beta3 
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Mon, 13 Jul 2009 15:09:38 +0200
+
+task (1.8.0-0ubuntu1~beta2) jaunty; urgency=low
+
+  * Initial deb package for task beta release 1.8.0.beta2 
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Wed, 08 Jul 2009 15:40:50 +0200
+
+task (1.8.0-0ubuntu1~beta1) jaunty; urgency=low
+
+  * Initial deb package for task beta release 1.8.0.beta1 
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Tue, 07 Jul 2009 01:35:28 +0200
+
+task (1.7.1-0ubuntu1) jaunty; urgency=low
+
+  * Initial deb package for bugfix release 1.7.1
+  * Updated references to new project homepage in control file.
+  * dpatch not longer neededas upstream version contains fix
+    for taskrc.5 bug
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Tue, 09 Jun 2009 11:49:51 +0200
+
+task (1.7.0-0ubuntu1) jaunty; urgency=low
+
+  * Initial release (LP: #378847)
+  * Fixed bug in taskrc.5 man page from upstream project
+    which made lintian complain
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Wed, 27 May 2009 23:57:08 +0200

package-config/ubuntu/debian/compat

@@ -0,0 +1 @@
+7

package-config/ubuntu/debian/control

@@ -0,0 +1,19 @@
+Source: task
+Section: utils
+Priority: optional
+Maintainer: Federico Hernandez <ultrafredde@gmail.com>
+XSBC-Original-Maintainer: Federico Hernandez <ultrafredde@gmail.com>
+Build-Depends: debhelper (>= 7), autotools-dev, libncurses5-dev
+Standards-Version: 3.8.3
+Homepage: http://taskwarrior.org
+
+Package: task
+Architecture: any
+Depends: ${shlibs:Depends}
+Description: A command-line to do list manager
+ Task is a command-line to do list manager. It has
+ support for GTD functionality and includes the
+ following features: tags, colorful tabular output,
+ reports and graphs, lots of manipulation commands,
+ low-level API, abbreviations for all commands and
+ options, multiuser file locking, recurring tasks.

package-config/ubuntu/debian/copyright

@@ -0,0 +1,60 @@
+This package was debianized by:
+
+    Federico Hernandez <ultrafredde@gmail.com> on  Sat, 05 Dec 2009 23:58:36 +0100
+
+It was downloaded from:
+
+    http://taskwarrior.org
+
+Upstream Authors:
+
+    Paul Beckingham <paul@beckingham.net>
+    Federico Hernandez
+    David J Patrick
+    John Florian
+    Damian Glenny
+    Andy Lester
+    H. İbrahim Güngör
+    Stefan Dorn
+    Michael Greb
+    Benjamin Tegarden
+    Chris Pride
+    Richard Querin
+    T. Charles Yun
+    P.C. Shyamshankar
+    Johan Friis
+    Steven de Brouwer
+    Pietro Cerutti
+    Cory Donnelly
+
+Copyright:
+
+    Copyright 2006 - 2010, Paul Beckingham
+    Copyright 2009 - 2010  Federico Hernandez
+    Copyright 2009 - 2010  John Florian
+    Copyright 2009 P.C. Shyamshankar
+
+License:
+
+    This package is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This package 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.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this package; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
+
+On Debian systems, the complete text of the GNU General
+Public License can be found in `/usr/share/common-licenses/GPL-2'.
+
+The Debian packaging is:
+
+    Copyright (C) 2009 - 2010, Federico Hernandez <ultrafredde@gmail.com>
+
+and is licensed under the GPL, see above.

package-config/ubuntu/debian/docs

@@ -0,0 +1,3 @@
+AUTHORS
+NEWS
+README

package-config/ubuntu/debian/examples

@@ -0,0 +1,2 @@
+scripts
+i18n

package-config/ubuntu/debian/rules

@@ -0,0 +1,47 @@
+#!/usr/bin/make -f
+
+config.status: configure
+	dh_testdir
+	./configure $(CROSS) --prefix=/usr --docdir=$(DATADIR)/doc/task
+
+build: build-stamp
+
+build-stamp: config.status 
+	dh_testdir
+	$(MAKE)
+	touch $@
+
+clean:
+	dh_testdir
+	dh_testroot
+	[ ! -f Makefile ] || $(MAKE) distclean
+	dh_clean 
+
+install: build
+	dh_testdir
+	dh_testroot
+	dh_prep  
+	$(MAKE) DESTDIR=$(CURDIR)/debian/task install
+
+binary-indep: install
+
+binary-arch: install
+	dh_testdir
+	dh_testroot
+	dh_installchangelogs
+	dh_installdocs 
+	dh_installman
+	dh_installexamples
+	install -D -m644 scripts/bash/task_completion.sh $(CURDIR)/debian/task/etc/bash_completion.d/task
+	rm -rf $(CURDIR)/debian/task/usr/share/doc/task-1.8.5
+	dh_strip
+	dh_compress
+	dh_fixperms
+	dh_installdeb
+	dh_shlibdeps
+	dh_gencontrol
+	dh_md5sums
+	dh_builddeb
+
+binary: binary-indep binary-arch
+.PHONY: build clean binary-indep binary-arch binary install

package-config/ubuntu/debian/watch

@@ -0,0 +1,3 @@
+version=3
+
+http://taskwarrior.org/download/task-(.*)\.tar\.gz 

scripts/bash/task_completion.sh

@@ -0,0 +1,127 @@
+# bash completion support for task
+#
+# Copyright 2009-2010 Federico Hernandez
+# All rights reserved.
+#
+# This script is part of the task project.
+#
+# This program is free software; you can redistribute it and/or modify it under
+# the terms of the GNU General Public License as published by the Free Software
+# Foundation; either version 2 of the License, or (at your option) any later
+# version.
+#
+# This program 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.  See the GNU General Public License for more
+# details.
+#
+# You should have received a copy of the GNU General Public License along with
+# this program; if not, write to the
+#
+#     Free Software Foundation, Inc.,
+#     51 Franklin Street, Fifth Floor,
+#     Boston, MA
+#     02110-1301
+#     USA
+#
+# The routines will do completion of:
+#
+#    *) task subcommands
+#    *) project names
+#    *) tag names
+#
+# To use these routines:
+#
+#    1) Copy this file to somewhere (e.g. ~/.bash_completion.d/.task_completion.sh).
+#    2) Added the following line to your .bashrc:
+#        source ~/.bash_completion.d/task_completion.sh
+#
+#    OR
+#
+#    3) Copy the file to /etc/bash_complettion.d
+#    4) source /etc/bash_completion
+#
+# To submit patches/bug reports:
+#
+#    *) Go to the projects website at
+#
+#       http://taskwarrior.org
+#
+
+_task_get_tags() {
+    task _tags
+}
+
+_task_get_config() {
+    task _config
+}
+
+_task_offer_projects() {
+    COMPREPLY=( $(compgen -W "$(task _projects)" -- ${cur/*:/}) )
+}
+
+_task() 
+{
+    local cur prev opts base
+
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+    if [ ${#COMP_WORDS[*]} -gt 2 ]
+    then
+        prev2="${COMP_WORDS[COMP_CWORD-2]}"
+    else
+        prev2=""
+    fi
+#   echo -e "\ncur='$cur'"
+#   echo "prev='$prev'"
+#   echo "prev2='$prev2'"
+
+    opts="$(task _commands) $(task _ids)"
+
+    case "${prev}" in
+        :)
+            case "${prev2}" in
+                pro*)
+                    _task_offer_projects
+                    return 0
+                    ;;
+            esac
+            ;;
+        *)
+            case "${cur}" in
+                pro*:*)
+                    _task_offer_projects
+                    return 0
+                    ;;
+                :)
+                    case "${prev}" in
+                        pro*)
+                            _task_offer_projects
+                            return 0
+                            ;;
+                    esac
+                    ;;
+                +*)
+                    local tags=$(_task_get_tags | sed 's/^/+/')
+                    COMPREPLY=( $(compgen -W "${tags}" -- ${cur}) )
+                    return 0
+                    ;;
+                -*)
+                    local tags=$(_task_get_tags | sed 's/^/-/')
+                    COMPREPLY=( $(compgen -W "${tags}" -- ${cur}) )
+                    return 0
+                    ;;
+                rc.*)
+                    local config=$(_task_get_config | sed -e 's/^/rc\./' -e 's/$/:/')
+                    COMPREPLY=( $(compgen -W "${config}" -- ${cur}) )
+                    return 0
+                    ;;
+            esac
+            ;;
+    esac
+      
+    COMPREPLY=( $(compgen -W "${opts}" -- ${cur}) )
+    return 0
+}
+complete -o nospace -F _task task

scripts/vim/README

@@ -0,0 +1,59 @@
+
+              Configure VIM for Syntax Highlighting of Task Data
+
+
+The task data files (pending.data, completed.data and undo.data),
+configuration file (.taskrc) as well as edits made via commands like "task 1
+edit" can be color-highlighted if you happen to use VIM as your preferred text
+editor.  Eventually this will happen automatically in newer versions of VIM,
+but for now you have to do a little bit of file shuffling.
+
+
+                                Prerequisites
+
+For this to work, you need to first have syntax highlighting enabled when you
+use VIM.  This happens to be the default for most VIM installations, but it is
+usually quite simple if that doesn't happen to be so in your case.  Rather
+than repeat the excellent VIM documentation here, please see the appropriate
+VIM documentation itself.  Generally this can be made seen by starting
+vim/gvim and issuing the following command:
+
+    :help syntax
+
+You may prefer instead to read the help online at:
+    http://vimdoc.sourceforge.net/htmldoc/syntax.html#syntax
+
+
+                   Configuring VIM to Understand Task Data
+
+Once you have VIM's syntax highlighting enabled and working with other file
+types properly, configuring it for use with task is simple.  You simply need
+to copy some files that came with task into your home directory so that you
+have:
+
+    ~/.vim/ftdetect/task.vim
+    ~/.vim/syntax/taskdata.vim
+    ~/.vim/syntax/taskedit.vim
+    ~/.vim/syntax/taskrc.vim
+
+The source of these files varies depending on how you installed task.  If you
+installed task via a regular package (rpm or deb) you can find these files in
+/usr/share/doc/task-VERSION/scripts/vim/.  If you built task yourself from the
+tarball (using the default configure options), these will be in
+/usr/local/share/doc/task-VERSION/scripts/vim/ instead.  So you should be able
+to do one of the following:
+
+    cp -av /usr/share/doc/task-VERSION/scripts/vim/* ~/.vim/
+
+or
+
+    cp -av /usr/local/share/doc/task-VERSION/scripts/vim/* ~/.vim/
+
+You should then be ready to go.
+---
+All four above mentioned files are
+
+Copyright 2009-2010 John Florian
+
+and are available under the GNU Public License version 2 or later.
+For the full text of this license, see COPYING.

scripts/vim/ftdetect/task.vim

@@ -0,0 +1,22 @@
+" Vim support file to detect Task Warrior data and configuration files and 
+" single task edits
+"
+" Maintainer:   John Florian <jflorian@doubledog.org>
+" Updated:	Thu Dec 10 18:28:26 EST 2009
+"
+" Copyright 2009-2010 John Florian
+"
+" This file is available under the GNU Public License version 2 or later.
+" For the full text of this license, see COPYING.
+
+
+" Task Warrior data files
+au BufRead,BufNewFile {pending,completed,undo}.data	set filetype=taskdata
+
+" Task Warrior configuration file
+au BufRead,BufNewFile .taskrc				set filetype=taskrc
+
+" Task Warrior handling of 'task 42 edit'
+au BufRead,BufNewFile *.task				set filetype=taskedit
+
+" vim:noexpandtab

scripts/vim/syntax/taskdata.vim

@@ -0,0 +1,48 @@
+" Vim syntax file
+" Language:	task data
+" Maintainer:	John Florian <jflorian@doubledog.org>
+" Updated:	Wed Jul  8 19:46:20 EDT 2009
+"
+" Copyright 2009-2010 John Florian
+"
+" This file is available under the GNU Public License version 2 or later.
+" For the full text of this license, see COPYING.
+
+
+" For version 5.x: Clear all syntax items.
+" For version 6.x: Quit when a syntax file was already loaded.
+if version < 600
+  syntax clear
+elseif exists("b:current_syntax")
+  finish
+endif
+
+" Key Names for values.
+syn keyword taskdataKey		description due end entry imask mask parent
+syn keyword taskdataKey		priority project recur start status tags uuid
+syn match taskdataKey		"annotation_\d\+"
+syn match taskdataUndo		"^time.*$"
+syn match taskdataUndo		"^\(old \|new \|---\)"
+
+" Values associated with key names.
+"
+" Strings
+syn region taskdataString	matchgroup=Normal start=+"+ end=+"+
+			\	contains=taskdataEncoded,taskdataUUID,@Spell
+"
+" Special Embedded Characters (e.g., "&comma;")
+syn match taskdataEncoded	"&\a\+;" contained
+" UUIDs
+syn match taskdataUUID		"\x\{8}-\(\x\{4}-\)\{3}\x\{12}" contained
+
+
+" The default methods for highlighting.  Can be overridden later.
+hi def link taskdataEncoded	Function
+hi def link taskdataKey		Statement
+hi def link taskdataString 	String
+hi def link taskdataUUID 	Special
+hi def link taskdataUndo 	Type
+
+let b:current_syntax = "taskdata"
+
+" vim:noexpandtab

scripts/vim/syntax/taskedit.vim

@@ -0,0 +1,40 @@
+" Vim syntax file
+" Language:	support for 'task 42 edit'
+" Maintainer:	John Florian <jflorian@doubledog.org>
+" Updated:	Wed Jul  8 19:46:32 EDT 2009
+"
+" Copyright 2009-2010 John Florian
+"
+" This file is available under the GNU Public License version 2 or later.
+" For the full text of this license, see COPYING.
+
+
+" For version 5.x: Clear all syntax items.
+" For version 6.x: Quit when a syntax file was already loaded.
+if version < 600
+  syntax clear
+elseif exists("b:current_syntax")
+  finish
+endif
+
+syn match taskeditHeading	"^\s*#\s*Name\s\+Editable details\s*$" contained
+syn match taskeditHeading	"^\s*#\s*-\+\s\+-\+\s*$" contained
+syn match taskeditReadOnly	"^\s*#\s*\(UU\)\?ID:.*$" contained
+syn match taskeditReadOnly	"^\s*#\s*Status:.*$" contained
+syn match taskeditReadOnly	"^\s*#\s*i\?Mask:.*$" contained
+syn match taskeditKey		"^ *.\{-}:" nextgroup=taskeditString
+syn match taskeditComment	"^\s*#.*$"
+			\	contains=taskeditReadOnly,taskeditHeading
+syn match taskeditString	".*$" contained contains=@Spell
+
+
+" The default methods for highlighting.  Can be overridden later.
+hi def link taskeditComment	Comment
+hi def link taskeditHeading	Function
+hi def link taskeditKey		Statement
+hi def link taskeditReadOnly	Special
+hi def link taskeditString	String
+
+let b:current_syntax = "taskedit"
+
+" vim:noexpandtab

scripts/vim/syntax/taskrc.vim

@@ -0,0 +1,52 @@
+" Vim syntax file
+" Language:	support for editing task configuration file
+" Maintainer:	John Florian <jflorian@doubledog.org>
+" Updated:	Sat Feb 20 14:14:44 EST 2010
+"
+" Copyright 2009-2010 John Florian
+"
+" This file is available under the GNU Public License version 2 or later.
+" For the full text of this license, see COPYING.
+
+
+" For version 5.x: Clear all syntax items.
+" For version 6.x: Quit when a syntax file was already loaded.
+if version < 600
+  syntax clear
+elseif exists("b:current_syntax")
+  finish
+endif
+
+syn match taskrcVal	".\{-}$" 		contains=taskrcComment
+syn match taskrcEqual	"="
+syn match taskrcKey	"^\s*.\{-}="he=e-1	contains=taskrcEqual
+
+syn keyword taskrcGoodKey	locking curses confirmation next bulk nag weekstart displayweeknumber defaultwidth editor monthsperline annotations _forcecolor blanklines debug hooks fontunderline 
+
+syn match taskrcGoodKey	"\(active\|tag\|recurrence\)\.indicator"
+syn match taskrcGoodKey	"alias\.\S\{-}="he=e-1
+syn match taskrcGoodKey	"calendar\.\(legend\|holidays\|details\(\.report\)\?\)"
+syn match taskrcGoodKey	"color\(\.\(alternate\|overdue\|due\(\.today\)\?\|pri\.\([HML]\|none\)\|active\|tagged\|recurring\|header\|footnote\|\(\(tag\|project\|keyword\)\.\S\{-}\)\|debug\|\(calendar\.\(today\|due\(\.today\)\?\|overdue\|weekend\|holiday\|weeknumber\)\)\)\)\?="he=e-1
+syn match taskrcGoodKey	"complete\.all\.\(projects\|tags\)"
+syn match taskrcGoodKey	"data\.location"
+syn match taskrcGoodKey	"dateformat\(\.\(holiday\|report\)\)\?"
+syn match taskrcGoodKey	"default\.\(command\|project\|priority\)"
+syn match taskrcGoodKey	"due="he=e-1
+syn match taskrcGoodKey	"echo\.command"
+syn match taskrcGoodKey	"import\.synonym\.\(bg\|description\|due\|end\|entry\|fg\|id\|priority\|project\|recur\|start\|status\|tags\|uuid\)"
+syn match taskrcGoodKey	"report\.\S\{-}\.\(description\|columns\|labels\|sort\|filter\|dateformat\|annotations\)="he=e-1
+syn match taskrcGoodKey	"search\.case\.sensitive"
+syn match taskrcGoodKey	"shadow\.\(file\|command\|notify\)"
+syn match taskrcGoodKey	"shell\.prompt"
+
+syn match taskrcComment	"#.*$"
+
+" The default methods for highlighting.  Can be overridden later.
+hi def link taskrcComment	Comment
+hi def link taskrcKey		Statement
+hi def link taskrcVal		String
+hi def link taskrcGoodKey	Function
+
+let b:current_syntax = "taskrc"
+
+" vim:noexpandtab

scripts/zsh/_task

@@ -0,0 +1,62 @@
+#compdef task
+#
+# This script is currently unmaintained and was released for an earlier version
+# of task. We welcome any zsh user that wants to contribute to task to take a
+# look at this script and either confirm its working status or improve it.
+# Please contact us at support@taskwarrior.org if you have further questions on
+# how to contribute to task.
+#
+# zsh completion for task
+#
+# Copyright 2009 P.C. Shyamshankar
+# All rights reserved.
+#
+# This script is part of the task project.
+#
+# This program is free software; you can redistribute it and/or modify it under
+# the terms of the GNU General Public License as published by the Free Software
+# Foundation; either version 2 of the License, or (at your option) any later
+# version.
+#
+# This program 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.  See the GNU General Public License for more
+# details.
+#
+# You should have received a copy of the GNU General Public License along with
+# this program; if not, write to the
+#
+#     Free Software Foundation, Inc.,
+#     51 Franklin Street, Fifth Floor,
+#     Boston, MA
+#     02110-1301
+#     USA
+#
+
+typeset -g _task_cmds
+_task_cmds=($(task _commands))
+
+_task() {
+    _arguments -s -S \
+        "*::task command:_task_commands"
+    return 0
+}
+
+
+(( $+functions[_task_commands] )) ||
+_task_commands() {
+    local cmd ret=1
+    if (( CURRENT == 1 )); then
+        _describe -t commands 'task command' _task_cmds
+    else
+        local curcontext="${curcontext}"
+        cmd="${_task_cmds[(r)$words[1]:*]%%:*}"
+        if (( $#cmd )); then
+            curcontext="${curcontext%:*:*}:task-${cmd}"
+            _call_function ret _task_${cmd} || _message "No command remaining."
+        else
+            _message "Unknown subcommand ${cmd}"
+        fi
+        return ret
+    fi
+}

src/.gitignore

@@ -1 +1,2 @@
 *.o
+Makefile.in

src/API.cpp

@@ -0,0 +1,785 @@
+////////////////////////////////////////////////////////////////////////////////
+// Task Lua API
+//
+// Copyright 2006 - 2010, Paul Beckingham.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program 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.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+// -------------
+//
+// Copyright © 1994–2008 Lua.org, PUC-Rio.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+// 
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+// 
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+#include <iostream> // TODO Remove
+#include <algorithm>
+#include "Context.h"
+#include "API.h"
+
+extern Context context;
+Task* the_task = NULL;
+
+#ifdef HAVE_LIBLUA
+
+////////////////////////////////////////////////////////////////////////////////
+// Returns a string representing the task version number, such as '1.9.0'.
+static int api_task_version (lua_State* L)
+{
+  lua_pushstring (L, PACKAGE_VERSION);
+  return 1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Returns a string representing the Lua version number, such as '5.1.4'.
+// Lua 5.2.0 has a 'lua_version' call, but 5.1.4 is the target.
+static int api_task_lua_version (lua_State* L)
+{
+  // Convert "Lua 5.1.4" -> "5.1.4"
+  std::string ver = LUA_RELEASE;
+  lua_pushstring (L, ver.substr (4, std::string::npos).c_str ());
+  return 1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Returns the type of OS that task is running on.
+static int api_task_os (lua_State* L)
+{
+#if defined (DARWIN)
+  lua_pushstring (L, "darwin");
+#elif defined (SOLARIS)
+  lua_pushstring (L, "solaris");
+#elif defined (CYGWIN)
+  lua_pushstring (L, "cygwin");
+#elif defined (OPENBSD)
+  lua_pushstring (L, "openbsd");
+#elif defined (HAIKU)
+  lua_pushstring (L, "haiku");
+#elif defined (FREEBSD)
+  lua_pushstring (L, "freebsd");
+#elif defined (LINUX)
+  lua_pushstring (L, "linux");
+#else
+  lua_pushstring (L, "unknown");
+#endif
+
+  return 1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_feature (lua_State* L)
+{
+  std::string name = luaL_checkstring (L, 1);
+  bool value = false;
+
+  if (name == "readline")
+  {
+#ifdef HAVE_READLINE
+    value = true;
+#endif
+  }
+
+  else if (name == "ncurses")
+  {
+#ifdef HAVE_NCURSES
+     value = true;
+#endif
+  }
+
+  else if (name == "lua")
+    value = true;
+
+  lua_pushboolean (L, value ? 1 : 0);
+  return 1;
+}
+
+/*
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_aliases ()
+{
+  return {};
+}
+*/
+
+////////////////////////////////////////////////////////////////////////////////
+// Returns values from .taskrc, by name.
+static int api_task_get_config (lua_State* L)
+{
+  std::string name = luaL_checkstring (L, 1);
+  lua_pushstring (L, context.config.get (name).c_str ());
+  return 1;
+}
+
+/*
+////////////////////////////////////////////////////////////////////////////////
+-- Temporarily sets .taskrc values, by name.
+static int api_task_set_config (name, value)
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+-- Returns an internationalized string, by string ID, from the appropriate
+-- locale-based strings file.
+static int api_task_i18n_string (id)
+{
+  return "le foo"
+}
+
+////////////////////////////////////////////////////////////////////////////////
+-- Returns a list of tips, from the appropriate locale-based tips file.
+static int api_task_i18n_tips ()
+{
+  return {}
+}
+
+////////////////////////////////////////////////////////////////////////////////
+-- Returns the name of the current command.
+static int api_task_get_command ()
+{
+  return "list"
+}
+
+////////////////////////////////////////////////////////////////////////////////
+-- Returns a list of string messages generated so far.
+static int api_task_get_header_messages ()
+{
+  return {}
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_footnote_messages ()
+{
+  return {}
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_debug_messages ()
+{
+  return {}
+}
+
+////////////////////////////////////////////////////////////////////////////////
+-- Records additional messages, for subsequent display.
+static int api_task_header_message (text)
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_footnote_message (text)
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_debug_message (text)
+{
+}
+*/
+
+////////////////////////////////////////////////////////////////////////////////
+// Causes the shell or interactive mode task to exit.  Ordinarily this does not
+// occur.
+static int api_task_exit (lua_State* L)
+{
+  // TODO Is this the correct exception?  How does the shell handle this?
+  throw std::string ("Exiting.");
+  return 0;
+}
+
+/*
+////////////////////////////////////////////////////////////////////////////////
+-- Shuts off the hook system for any subsequent hook calls for this command.
+static int api_task_inhibit_further_hooks ()
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+-- Returns a table that contains a complete copy of the task.
+static int api_task_get (lua_State* L)
+{
+  return 1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+-- Creates a new task from the data specified in the table t.
+static int api_task_add (t)
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+-- Modifies the task described in the table t.
+static int api_task_modify (t)
+{
+}
+*/
+
+////////////////////////////////////////////////////////////////////////////////
+// -- 'id' is the task id passed to the hook function.  Date attributes are
+// -- returned as a numeric epoch offset.  Tags and annotations are returned
+// -- as tables.  A nil value indicates a missing value.
+static int api_task_get_uuid (lua_State* L)
+{
+  if (the_task != NULL)
+    lua_pushstring (L, the_task->get ("uuid").c_str ());
+  else
+    lua_pushnil (L);
+
+  return 1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_description (lua_State* L)
+{
+  if (the_task != NULL)
+    lua_pushstring (L, the_task->get ("description").c_str ());
+  else
+    lua_pushnil (L);
+
+  return 1;
+}
+
+/*
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_annotations (id)
+{
+  return task.annotations
+}
+*/
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_project (lua_State* L)
+{
+  if (the_task != NULL)
+    lua_pushstring (L, the_task->get ("project").c_str ());
+  else
+    lua_pushnil (L);
+
+  return 1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_priority (lua_State* L)
+{
+  if (the_task != NULL)
+    lua_pushstring (L, the_task->get ("priority").c_str ());
+  else
+    lua_pushnil (L);
+
+  return 1;
+}
+
+/*
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_tags (id)
+{
+  return task.tags
+}
+*/
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_status (lua_State* L)
+{
+  if (the_task != NULL)
+    lua_pushstring (L, Task::statusToText (the_task->getStatus ()).c_str ());
+  else
+    lua_pushnil (L);
+
+  return 1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_due (lua_State* L)
+{
+  if (the_task != NULL)
+  {
+    unsigned int value = (unsigned int) the_task->get_ulong ("due");
+    if (value)
+    {
+      lua_pushinteger (L, value);
+      return 1;
+    }
+  }
+
+  lua_pushnil (L);
+  return 1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_entry (lua_State* L)
+{
+  if (the_task != NULL)
+  {
+    unsigned int value = (unsigned int) the_task->get_ulong ("entry");
+    if (value)
+    {
+      lua_pushinteger (L, value);
+      return 1;
+    }
+  }
+
+  lua_pushnil (L);
+  return 1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_start (lua_State* L)
+{
+  if (the_task != NULL)
+  {
+    unsigned int value = (unsigned int) the_task->get_ulong ("start");
+    if (value)
+    {
+      lua_pushinteger (L, value);
+      return 1;
+    }
+  }
+
+  lua_pushnil (L);
+  return 1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_end (lua_State* L)
+{
+  if (the_task != NULL)
+  {
+    unsigned int value = (unsigned int) the_task->get_ulong ("end");
+    if (value)
+    {
+      lua_pushinteger (L, value);
+      return 1;
+    }
+  }
+
+  lua_pushnil (L);
+  return 1;
+}
+
+/*
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_recur (id)
+{
+  return task.recur
+}
+*/
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_until (lua_State* L)
+{
+  if (the_task != NULL)
+  {
+    unsigned int value = (unsigned int) the_task->get_ulong ("until");
+    if (value)
+    {
+      lua_pushinteger (L, value);
+      return 1;
+    }
+  }
+
+  lua_pushnil (L);
+  return 1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_get_wait (lua_State* L)
+{
+  if (the_task != NULL)
+  {
+    unsigned int value = (unsigned int) the_task->get_ulong ("wait");
+    if (value)
+    {
+      lua_pushinteger (L, value);
+      return 1;
+    }
+  }
+
+  lua_pushnil (L);
+  return 1;
+}
+
+/*
+////////////////////////////////////////////////////////////////////////////////
+-- 'id' is the task id passed to the hook function.  Date attributes are
+-- expected as numeric epoch offsets.  Tags and annotations are expected
+-- as tables.  A nil value indicates a missing value.
+static int api_task_set_description (id, value)
+{
+  task.description = value
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_set_annotations (id, value)
+{
+  task.annotations = value
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_set_project (id, value)
+{
+  task.project = value
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_set_priority (id, value)
+{
+  task.priority = value
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_set_tags (id, value)
+{
+  task.tags = value
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_set_status (id, value)
+{
+  task.status = value
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_set_due (id, value)
+{
+  task.due_date = value
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_set_start (id, value)
+{
+  task.start_date = value
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_set_recur (id, value)
+{
+  task.recur = value
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_set_until (id, value)
+{
+  task.until_date = value
+}
+
+////////////////////////////////////////////////////////////////////////////////
+static int api_task_set_wait (id, value)
+{
+  task.wait_date = value
+}
+*/
+
+////////////////////////////////////////////////////////////////////////////////
+API::API ()
+: L (NULL)
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+API::~API ()
+{
+  if (L)
+  {
+    lua_close (L);
+    L = NULL;
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void API::initialize ()
+{
+  // Initialize Lua.
+  L = lua_open ();
+  luaL_openlibs (L);  // TODO Error handling
+
+  // Register all the API functions in Lua global space.
+  lua_pushcfunction (L, api_task_version);               lua_setglobal (L, "task_version");
+  lua_pushcfunction (L, api_task_lua_version);           lua_setglobal (L, "task_lua_version");
+  lua_pushcfunction (L, api_task_os);                    lua_setglobal (L, "task_os");
+  lua_pushcfunction (L, api_task_feature);               lua_setglobal (L, "task_feature");
+/*
+  lua_pushcfunction (L, api_task_aliases);               lua_setglobal (L, "task_aliases");
+*/
+  lua_pushcfunction (L, api_task_get_config);            lua_setglobal (L, "task_get_config");
+/*
+  lua_pushcfunction (L, api_task_set_config);            lua_setglobal (L, "task_set_config");
+  lua_pushcfunction (L, api_task_i18n_string);           lua_setglobal (L, "task_i18n_string");
+  lua_pushcfunction (L, api_task_i18n_tips);             lua_setglobal (L, "task_i18n_tips");
+  lua_pushcfunction (L, api_task_get_command);           lua_setglobal (L, "task_get_command");
+  lua_pushcfunction (L, api_task_get_header_messages);   lua_setglobal (L, "task_get_header_messages");
+  lua_pushcfunction (L, api_task_get_footnote_messages); lua_setglobal (L, "task_get_footnote_messages");
+  lua_pushcfunction (L, api_task_get_debug_messages);    lua_setglobal (L, "task_get_debug_messages");
+  lua_pushcfunction (L, api_task_header_message);        lua_setglobal (L, "task_header_message");
+  lua_pushcfunction (L, api_task_footnote_message);      lua_setglobal (L, "task_footnote_message");
+  lua_pushcfunction (L, api_task_debug_message);         lua_setglobal (L, "task_debug_message");
+*/
+  lua_pushcfunction (L, api_task_exit);                  lua_setglobal (L, "task_exit");
+/*
+  lua_pushcfunction (L, api_task_inhibit_further_hooks); lua_setglobal (L, "task_inhibit_further_hooks");
+  lua_pushcfunction (L, api_task_get);                   lua_setglobal (L, "task_get");
+  lua_pushcfunction (L, api_task_add);                   lua_setglobal (L, "task_add");
+  lua_pushcfunction (L, api_task_modify);                lua_setglobal (L, "task_modify");
+*/
+  lua_pushcfunction (L, api_task_get_uuid);              lua_setglobal (L, "task_get_uuid");
+  lua_pushcfunction (L, api_task_get_description);       lua_setglobal (L, "task_get_description");
+/*
+  lua_pushcfunction (L, api_task_get_annotations);       lua_setglobal (L, "task_get_annotations");
+*/
+  lua_pushcfunction (L, api_task_get_project);           lua_setglobal (L, "task_get_project");
+  lua_pushcfunction (L, api_task_get_priority);          lua_setglobal (L, "task_get_priority");
+/*
+  lua_pushcfunction (L, api_task_get_tags);              lua_setglobal (L, "task_get_tags");
+*/
+  lua_pushcfunction (L, api_task_get_status);            lua_setglobal (L, "task_get_status");
+  lua_pushcfunction (L, api_task_get_due);               lua_setglobal (L, "task_get_due");
+  lua_pushcfunction (L, api_task_get_entry);             lua_setglobal (L, "task_get_entry");
+  lua_pushcfunction (L, api_task_get_start);             lua_setglobal (L, "task_get_start");
+  lua_pushcfunction (L, api_task_get_end);               lua_setglobal (L, "task_get_end");
+/*
+  lua_pushcfunction (L, api_task_get_recur);             lua_setglobal (L, "task_get_recur");
+*/
+  lua_pushcfunction (L, api_task_get_until);             lua_setglobal (L, "task_get_until");
+  lua_pushcfunction (L, api_task_get_wait);              lua_setglobal (L, "task_get_wait");
+/*
+  lua_pushcfunction (L, api_task_set_description);       lua_setglobal (L, "task_set_description");
+  lua_pushcfunction (L, api_task_set_annotations);       lua_setglobal (L, "task_set_annotations");
+  lua_pushcfunction (L, api_task_set_project);           lua_setglobal (L, "task_set_project");
+  lua_pushcfunction (L, api_task_set_priority);          lua_setglobal (L, "task_set_priority");
+  lua_pushcfunction (L, api_task_set_tags);              lua_setglobal (L, "task_set_tags");
+  lua_pushcfunction (L, api_task_set_status);            lua_setglobal (L, "task_set_status");
+  lua_pushcfunction (L, api_task_set_due);               lua_setglobal (L, "task_set_due");
+  lua_pushcfunction (L, api_task_set_start);             lua_setglobal (L, "task_set_start");
+  lua_pushcfunction (L, api_task_set_recur);             lua_setglobal (L, "task_set_recur");
+  lua_pushcfunction (L, api_task_set_until);             lua_setglobal (L, "task_set_until");
+  lua_pushcfunction (L, api_task_set_wait);              lua_setglobal (L, "task_set_wait");
+*/
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool API::callProgramHook (
+  const std::string& file,
+  const std::string& function)
+{
+  loadFile (file);
+
+  // Get function.
+  lua_getglobal (L, function.c_str ());
+  if (!lua_isfunction (L, -1))
+  {
+    lua_pop (L, 1);
+    throw std::string ("The Lua function '") + function + "' was not found.";
+  }
+
+  // Make call.
+  if (lua_pcall (L, 0, 2, 0) != 0)
+    throw std::string ("Error calling '") + function + "' - " + lua_tostring (L, -1);
+
+  // Call successful - get return values.
+  if (!lua_isnumber (L, -2))
+    throw std::string ("Error: '") + function + "' did not return a success indicator";
+
+  if (!lua_isstring (L, -1) && !lua_isnil (L, -1))
+    throw std::string ("Error: '") + function + "' did not return a message or nil";
+
+  int rc              = lua_tointeger (L, -2);
+  const char* message = lua_tostring  (L, -1);
+
+  if (rc == 0)
+  {
+    if (message)
+      context.footnote (std::string ("Warning: ") + message);
+  }
+  else
+  {
+    if (message)
+      throw std::string (message);
+  }
+
+  lua_pop (L, 1);
+  return rc == 0 ? true : false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// TODO No intention of implementing this before task 2.0.  Why?  Because we
+//      need to implement a Lua iterator, in C++, to iterate over a std::vector.
+bool API::callListHook (
+  const std::string& file,
+  const std::string& function,
+  std::vector <Task>& all)
+{
+  loadFile (file);
+
+  // TODO Get function.
+  // TODO Prepare args.
+  // TODO Make call.
+  // TODO Get exit status.
+
+  return true;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool API::callTaskHook (
+  const std::string& file,
+  const std::string& function,
+  Task& task)
+{
+  loadFile (file);
+
+  // Save the task for reference via the API.
+  current = task;
+
+  // Get function.
+  lua_getglobal (L, function.c_str ());
+  if (!lua_isfunction (L, -1))
+  {
+    lua_pop (L, 1);
+    throw std::string ("The Lua function '") + function + "' was not found.";
+  }
+
+  // Prepare args.
+  lua_pushnumber (L, current.id);
+
+  // Expose the task.
+  the_task = &current;
+
+  // Make call.
+  if (lua_pcall (L, 1, 2, 0) != 0)
+    throw std::string ("Error calling '") + function + "' - " + lua_tostring (L, -1);
+
+  // Hide the task.
+  the_task = NULL;
+
+  // Call successful - get return values.
+  if (!lua_isnumber (L, -2))
+    throw std::string ("Error: '") + function + "' did not return a success indicator";
+
+  if (!lua_isstring (L, -1) && !lua_isnil (L, -1))
+    throw std::string ("Error: '") + function + "' did not return a message or nil";
+
+  int rc              = lua_tointeger (L, -2);
+  const char* message = lua_tostring  (L, -1);
+
+  if (rc == 0)
+  {
+    if (message)
+      context.footnote (std::string ("Warning: ") + message);
+  }
+  else
+  {
+    if (message)
+      throw std::string (message);
+  }
+
+  lua_pop (L, 1);
+  return rc == 0 ? true : false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool API::callFieldHook (
+  const std::string& file,
+  const std::string& function,
+  const std::string& name,
+  std::string& value)
+{
+  loadFile (file);
+
+  // Get function.
+  lua_getglobal (L, function.c_str ());
+  if (!lua_isfunction (L, -1))
+  {
+    lua_pop (L, 1);
+    throw std::string ("The Lua function '") + function + "' was not found.";
+  }
+
+  // Prepare args.
+  lua_pushstring (L, name.c_str ());
+  lua_pushstring (L, value.c_str ());
+
+  // Make call.
+  if (lua_pcall (L, 2, 3, 0) != 0)
+    throw std::string ("Error calling '") + function + "' - " + lua_tostring (L, -1);
+
+  // Call successful - get return values.
+  if (!lua_isstring (L, -3))
+    throw std::string ("Error: '") + function + "' did not return a modified value";
+
+  if (!lua_isnumber (L, -2))
+    throw std::string ("Error: '") + function + "' did not return a success indicator";
+
+  if (!lua_isstring (L, -1) && !lua_isnil (L, -1))
+    throw std::string ("Error: '") + function + "' did not return a message or nil";
+
+  const char* new_value = lua_tostring  (L, -3);
+  int rc                = lua_tointeger (L, -2);
+  const char* message   = lua_tostring  (L, -1);
+
+  if (rc == 0)
+  {
+    // Overwrite with the modified value.
+    value = new_value;
+
+    if (message)
+      context.footnote (std::string ("Warning: ") + message);
+  }
+  else
+  {
+    if (message)
+      throw std::string (message);
+  }
+
+  lua_pop (L, 1);
+  return rc == 0 ? true : false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void API::loadFile (const std::string& file)
+{
+  // If the file is not loaded.
+  if (std::find (loaded.begin (), loaded.end (), file) == loaded.end ())
+  {
+    // Load the file, if possible.
+    if (luaL_loadfile (L, file.c_str ()) || lua_pcall (L, 0, 0, 0))
+      throw std::string ("Error: ") + std::string (lua_tostring (L, -1));
+
+    // Mark this as loaded, so as to not bother again.
+    loaded.push_back (file);
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+
+#endif
+

src/API.h

@@ -0,0 +1,74 @@
+////////////////////////////////////////////////////////////////////////////////
+// task - a command line task list manager.
+//
+// Copyright 2006 - 2010, Paul Beckingham.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program 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.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+////////////////////////////////////////////////////////////////////////////////
+#ifndef INCLUDED_API
+#define INCLUDED_API
+
+#include "auto.h"
+#ifdef HAVE_LIBLUA
+
+#include <vector>
+#include <string>
+#include "Task.h"
+
+extern "C"
+{
+  #include "lua.h"
+  #include "lualib.h"
+  #include "lauxlib.h"
+}
+
+class API
+{
+public:
+  API ();
+  API (const API&);
+  API& operator= (const API&);
+  ~API ();
+
+  void initialize ();
+  bool callProgramHook (const std::string&, const std::string&);
+  bool callListHook    (const std::string&, const std::string&, std::vector <Task>&);
+  bool callTaskHook    (const std::string&, const std::string&, Task&);
+  bool callFieldHook   (const std::string&, const std::string&, const std::string&, std::string&);
+
+private:
+  void loadFile (const std::string&);
+
+public:
+  lua_State* L;
+  std::vector <std::string> loaded;
+
+  // Context for the API.
+//  std::vector <Task> all;
+  Task current;
+//  std::string& name;
+//  std::string& value;
+};
+
+#endif
+#endif
+////////////////////////////////////////////////////////////////////////////////

src/Att.cpp

@@ -0,0 +1,817 @@
+////////////////////////////////////////////////////////////////////////////////
+// task - a command line task list manager.
+//
+// Copyright 2006 - 2010, Paul Beckingham.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program 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.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+////////////////////////////////////////////////////////////////////////////////
+
+#include <sstream>
+#include <stdlib.h>
+#include <string.h>
+#include "text.h"
+#include "Color.h"
+#include "util.h"
+#include "Date.h"
+#include "Duration.h"
+#include "Context.h"
+#include "Att.h"
+
+extern Context context;
+
+static const char* internalNames[] =
+{
+  "entry",
+  "start",
+  "end",
+  "parent",
+  "uuid",
+  "mask",
+  "imask",
+  "limit",
+  "status",
+  "description",
+};
+
+static const char* modifiableNames[] =
+{
+  "project",
+  "priority",
+  "fg",
+  "bg",
+  "due",
+  "recur",
+  "until",
+  "wait",
+};
+
+// Synonyms on the same line.
+static const char* modifierNames[] =
+{
+  "before",     "under",    "below",
+  "after",      "over",     "above",
+  "none",
+  "any",
+  "is",         "equals",
+  "isnt",       "not",
+  "has",        "contains",
+  "hasnt",
+  "startswith", "left",
+  "endswith",   "right",
+  "word",
+  "noword"
+};
+
+#define NUM_INTERNAL_NAMES   (sizeof (internalNames)   / sizeof (internalNames[0]))
+#define NUM_MODIFIABLE_NAMES (sizeof (modifiableNames) / sizeof (modifiableNames[0]))
+#define NUM_MODIFIER_NAMES   (sizeof (modifierNames)   / sizeof (modifierNames[0]))
+
+////////////////////////////////////////////////////////////////////////////////
+Att::Att ()
+: mName ("")
+, mValue ("")
+, mMod ("")
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Att::Att (const std::string& name, const std::string& mod, const std::string& value)
+{
+  mName  = name;
+  mValue = value;
+  mMod   = mod;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Att::Att (const std::string& name, const std::string& mod, int value)
+{
+  mName = name;
+
+  std::stringstream s;
+  s << value;
+  mValue = s.str ();
+
+  mMod = mod;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Att::Att (const std::string& name, const std::string& value)
+{
+  mName  = name;
+  mValue = value;
+  mMod   = "";
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Att::Att (const std::string& name, int value)
+{
+  mName = name;
+
+  std::stringstream s;
+  s << value;
+  mValue = s.str ();
+
+  mMod = "";
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Att::Att (const Att& other)
+{
+  mName  = other.mName;
+  mValue = other.mValue;
+  mMod   = other.mMod;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Att& Att::operator= (const Att& other)
+{
+  if (this != &other)
+  {
+    mName  = other.mName;
+    mValue = other.mValue;
+    mMod   = other.mMod;
+  }
+
+  return *this;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Att::~Att ()
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// For parsing.
+bool Att::valid (const std::string& input) const
+{
+  Nibbler n (input);
+  std::string ignored;
+  if (n.getUntilOneOf (".:", ignored))
+  {
+    if (ignored.length () == 0)
+      return false;
+
+    while (n.skip ('.'))
+      if (!n.getUntilOneOf (".:", ignored))
+        return false;
+
+    if (n.skip (':') &&
+        (n.getQuoted ('"', ignored) ||
+         n.getUntil  (' ', ignored) ||
+         n.getUntilEOS (ignored)    ||
+         n.depleted ()))
+      return true;
+
+    return false;
+  }
+
+  return false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool Att::validInternalName (const std::string& name)
+{
+  for (unsigned int i = 0; i < NUM_INTERNAL_NAMES; ++i)
+    if (name == internalNames[i])
+      return true;
+
+  return false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool Att::validModifiableName (const std::string& name)
+{
+  for (unsigned int i = 0; i < NUM_MODIFIABLE_NAMES; ++i)
+    if (name == modifiableNames[i])
+      return true;
+
+  return false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool Att::validNameValue (
+  const std::string& name,
+  const std::string& mod,
+  const std::string& value)
+{
+  std::string writableName  = name;
+  std::string writableMod   = mod;
+  std::string writableValue = value;
+  return Att::validNameValue (writableName, writableMod, writableValue);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool Att::validNameValue (
+  std::string& name,
+  std::string& mod,
+  std::string& value)
+{
+  // First, guess at the full attribute name.
+  std::vector <std::string> candidates;
+  for (unsigned i = 0; i < NUM_INTERNAL_NAMES; ++i)
+    candidates.push_back (internalNames[i]);
+
+  for (unsigned i = 0; i < NUM_MODIFIABLE_NAMES; ++i)
+    candidates.push_back (modifiableNames[i]);
+
+  std::vector <std::string> matches;
+  autoComplete (name, candidates, matches);
+
+  if (matches.size () == 0)
+    return false;
+
+  else if (matches.size () != 1)
+  {
+    std::string error = "Ambiguous attribute '" + name + "' - could be either of "; // TODO i18n
+
+    std::string combined;
+    join (combined, ", ", matches);
+
+    throw error + combined;
+  }
+
+  name = matches[0];
+
+  // Second, guess at the modifier name.
+  if (mod != "")
+  {
+    candidates.clear ();
+    for (unsigned i = 0; i < NUM_MODIFIER_NAMES; ++i)
+      candidates.push_back (modifierNames[i]);
+
+    matches.clear ();
+    autoComplete (mod, candidates, matches);
+
+    if (matches.size () == 0)
+      throw std::string ("Unrecognized modifier '") + mod + "'";
+
+    else if (matches.size () != 1)
+    {
+      std::string error = "Ambiguous modifier '" + mod + "' - could be either of "; // TODO i18n
+
+      std::string combined;
+      join (combined, ", ", matches);
+      error += combined;
+
+      throw error + combined;
+    }
+
+    mod = matches[0];
+  }
+
+  // Some attributes are intended to be private, unless the command is read-
+  // only, in which cased these are perfectly valid elements of a filter.
+  if (context.cmd.isWriteCommand () &&
+      !validModifiableName (name))
+    throw std::string ("\"") +
+          name               +
+          "\" is not an attribute you may modify directly.";
+
+  // Thirdly, make sure the value has the expected form or values.
+  if (name == "project")
+  {
+    if (!noSpaces (value))
+      throw std::string ("The '") + name + "' attribute may not contain spaces.";
+  }
+
+  else if (name == "priority")
+  {
+    if (value != "")
+    {
+      value = upperCase (value);
+      if (value != "H" &&
+          value != "M" &&
+          value != "L")
+        throw std::string ("\"") +
+              value              +
+              "\" is not a valid priority.  Use H, M, L or leave blank.";
+    }
+  }
+
+  else if (name == "description")
+  {
+    if (context.cmd.isWriteCommand ())
+    {
+      if (value == "")
+        throw std::string ("The '") + name + "' attribute must not be blank.";
+
+      if (!noVerticalSpace (value))
+        throw std::string ("The '") + name + "' attribute must not contain vertical white space.";
+    }
+  }
+
+  else if (name == "fg" || name == "bg")
+  {
+    // TODO Determine whether color abbreviations are supported, and if so,
+    //      modify 'value' here accordingly.
+  }
+
+  else if (name == "due"   ||
+           name == "until" ||
+           name == "wait")
+  {
+    // Validate and convert to epoch.
+    if (value != "")
+      value = Date (value, context.config.get ("dateformat")).toEpochString ();
+  }
+
+  else if (name == "recur")
+  {
+    // Just validate, don't convert to days.
+    Duration d;
+    if (value != "")
+      d.parse (value);
+  }
+
+  else if (name == "limit")
+  {
+    if (value == "" || !digitsOnly (value))
+      throw std::string ("The '") + name + "' attribute must be an integer.";
+  }
+
+  else if (name == "status")
+  {
+    value = lowerCase (value);
+
+    std::vector <std::string> matches;
+    std::vector <std::string> candidates;
+    candidates.push_back ("pending");
+    candidates.push_back ("completed");
+    candidates.push_back ("deleted");
+    candidates.push_back ("recurring");
+    candidates.push_back ("waiting");
+    autoComplete (value, candidates, matches);
+
+    if (matches.size () == 1)
+      value = matches[0];
+    else
+      throw std::string ("\"") +
+            value              +
+            "\" is not a valid status.  Use 'pending', 'completed', 'deleted', 'recurring' or 'waiting'.";
+  }
+
+  else if (! validInternalName (name) &&
+           ! validModifiableName (name))
+    throw std::string ("'") + name + "' is not a recognized attribute.";
+
+  return true;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// TODO Deprecated - remove.
+bool Att::validMod (const std::string& mod)
+{
+  for (unsigned int i = 0; i < NUM_MODIFIER_NAMES; ++i)
+    if (modifierNames[i] == mod)
+      return true;
+
+  return false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// The type of an attribute is useful for modifier evaluation.
+std::string Att::type (const std::string& name) const
+{
+  if (name == "due"   ||
+      name == "until" ||
+      name == "start" ||
+      name == "entry" ||
+      name == "end"   ||
+      name == "wait")
+    return "date";
+
+  else if (name == "recur")
+    return "duration";
+
+  else if (name == "limit")
+    return "number";
+
+  else
+    return "text";
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// The type of an attribute is useful for modifier evaluation.
+std::string Att::modType (const std::string& name) const
+{
+  if (name == "hasnt" ||
+      name == "isnt"  ||
+      name == "not"   ||  // TODO Verify this.
+      name == "noword")
+    return "negative";
+
+  return "positive";
+}
+
+////////////////////////////////////////////////////////////////////////////////
+//
+// start --> name --> . --> mod --> : --> " --> value --> " --> end
+//            |                     ^
+//            |_____________________|
+//
+void Att::parse (const std::string& input)
+{
+  Nibbler n (input);
+  parse (n);
+}
+
+void Att::parse (Nibbler& n)
+{
+  // Ensure a clean object first.
+  mName  = "";
+  mValue = "";
+  mMod   = "";
+
+  if (n.getUntilOneOf (".:", mName))
+  {
+    if (mName.length () == 0)
+      throw std::string ("Missing attribute name"); // TODO i18n
+
+    if (n.skip ('.'))
+    {
+      std::string mod;
+      if (n.getUntil (":", mod))
+      {
+        if (validMod (mod))
+          mMod = mod;
+        else
+          throw std::string ("The name '") + mod + "' is not a valid modifier"; // TODO i18n
+      }
+      else
+        throw std::string ("Missing . or : after modifier"); // TODO i18n
+    }
+
+    if (n.skip (':'))
+    {
+      // Both quoted and unquoted Att's are accepted.
+      // Consider removing this for a stricter parse.
+      if (n.getQuoted ('"', mValue) ||
+          n.getUntil  (' ', mValue))
+      {
+        decode (mValue);
+      }
+    }
+    else
+      throw std::string ("Missing : after attribute name"); // TODO i18n
+  }
+  else
+    throw std::string ("Missing : after attribute name"); // TODO i18n
+
+/* TODO This might be too slow to include.  Test this assumption.
+  validNameValue (mName, mMod, mValue);
+*/
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// "this" is the attribute that has modifiers.  "other" is the attribute from a
+// Record that does not have modifiers, but may have a value.
+bool Att::match (const Att& other) const
+{
+  // All matches are assumed to pass, any short-circuit on non-match.
+  bool case_sensitive = context.config.getBoolean ("search.case.sensitive");
+
+  // If there are no mods, just perform a straight compare on value.
+  if (mMod == "")
+  {
+    if (!compare (mValue, other.mValue, (bool) case_sensitive))
+      return false;
+  }
+
+  // has = contains as a substring.
+  else if (mMod == "has" || mMod == "contains") // TODO i18n
+  {
+    if (find (other.mValue, mValue, (bool) case_sensitive) == std::string::npos)
+      return false;
+  }
+
+  // is = equal.  Nop.
+  else if (mMod == "is" || mMod == "equals") // TODO i18n
+  {
+    if (!compare (mValue, other.mValue, (bool) case_sensitive))
+      return false;
+  }
+
+  // isnt = not equal.
+  else if (mMod == "isnt" || mMod == "not") // TODO i18n
+  {
+    if (compare (mValue, other.mValue, (bool) case_sensitive))
+      return false;
+  }
+
+  // any = any value, but not empty value.
+  else if (mMod == "any") // TODO i18n
+  {
+    if (other.mValue == "")
+      return false;
+  }
+
+  // none = must have empty value.
+  else if (mMod == "none") // TODO i18n
+  {
+    if (other.mValue != "")
+      return false;
+  }
+
+  // startswith = first characters must match.
+  else if (mMod == "startswith" || mMod == "left") // TODO i18n
+  {
+    if (other.mValue.length () < mValue.length ())
+      return false;
+
+      if (!compare (mValue, other.mValue.substr (0, mValue.length ()), (bool) case_sensitive))
+      return false;
+  }
+
+  // endswith = last characters must match.
+  else if (mMod == "endswith" || mMod == "right") // TODO i18n
+  {
+    if (other.mValue.length () < mValue.length ())
+      return false;
+
+    if (!compare (mValue, other.mValue.substr (
+                    other.mValue.length () - mValue.length (),
+                    std::string::npos), (bool) case_sensitive))
+      return false;
+  }
+
+  // hasnt = does not contain as a substring.
+  else if (mMod == "hasnt") // TODO i18n
+  {
+    if (find (other.mValue, mValue, (bool) case_sensitive) != std::string::npos)
+      return false;
+  }
+
+  // before = under = below = <
+  else if (mMod == "before" || mMod == "under" || mMod == "below")
+  {
+    std::string which = type (mName);
+    if (which == "duration")
+    {
+      Duration literal (mValue);
+      Duration variable ((time_t)atoi (other.mValue.c_str ()));
+      if (!(variable < literal))
+        return false;
+    }
+    else if (which == "date")
+    {
+      Date literal (mValue.c_str (), context.config.get ("dateformat"));
+      Date variable ((time_t)atoi (other.mValue.c_str ()));
+      if (other.mValue == "" || ! (variable < literal))
+        return false;
+    }
+    else if (which == "number")
+    {
+      if (atoi (mValue.c_str ()) >= atoi (other.mValue.c_str ()))
+        return false;
+    }
+    else if (which == "text")
+    {
+      if (mValue <= other.mValue)
+        return false;
+    }
+  }
+
+  // after = over = above = >
+  else if (mMod == "after" || mMod == "over" || mMod == "above")
+  {
+    std::string which = type (mName);
+    if (which == "duration")
+    {
+      Duration literal (mValue);
+      Duration variable ((time_t)atoi (other.mValue.c_str ()));
+      if (! (variable > literal))
+        return false;
+    }
+    else if (which == "date")
+    {
+      Date literal (mValue.c_str (), context.config.get ("dateformat"));
+      Date variable ((time_t)atoi (other.mValue.c_str ()));
+      if (! (variable > literal))
+        return false;
+    }
+    else if (which == "number")
+    {
+      if (atoi (mValue.c_str ()) <= atoi (other.mValue.c_str ()))
+        return false;
+    }
+    else if (which == "text")
+    {
+      if (mValue >= other.mValue)
+        return false;
+    }
+  }
+
+  // word = contains as a substring, with word boundaries.
+  else if (mMod == "word") // TODO i18n
+  {
+    // Fail if the substring is not found.
+    std::string::size_type sub = find (other.mValue, mValue, (bool) case_sensitive);
+    if (sub == std::string::npos)
+      return false;
+
+    // Also fail if there is no word boundary at beginning and end.
+    if (!isWordStart (other.mValue, sub))
+      return false;
+
+    if (!isWordEnd (other.mValue, sub + mValue.length () - 1))
+      return false;
+  }
+
+  // noword = does not contain as a substring, with word boundaries.
+  else if (mMod == "noword") // TODO i18n
+  {
+    // Fail if the substring is not found.
+    std::string::size_type sub = find (other.mValue, mValue);
+    if (sub != std::string::npos &&
+        isWordStart (other.mValue, sub) &&
+        isWordEnd (other.mValue, sub + mValue.length () - 1))
+    {
+      return false;
+    }
+  }
+
+  return true;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// name : " value "
+std::string Att::composeF4 () const
+{
+  std::string output = "";
+
+  if (mName != "" && mValue != "")
+  {
+    std::string value = mValue;
+    encode (value);
+    enquote (value);
+
+    output += mName + ":" + value;
+  }
+
+  return output;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Att::mod (const std::string& input)
+{
+  if (input != "" && !validMod (input))
+    throw std::string ("The name '") + input + "' is not a valid modifier"; // TODO i18n
+
+  mMod = input;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+std::string Att::mod () const
+{
+  return mMod;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+std::string Att::name () const
+{
+  return mName;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Att::name (const std::string& name)
+{
+  mName = name;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+std::string Att::value () const
+{
+  return mValue;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Att::value (const std::string& value)
+{
+  mValue = value;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+int Att::value_int () const
+{
+  return atoi (mValue.c_str ());
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Att::value_int (int value)
+{
+  std::stringstream s;
+  s << value;
+  mValue = s.str ();
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Add quotes.
+void Att::enquote (std::string& value) const
+{
+  value = '"' + value + '"';
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Remove quotes.  Instead of being picky, just remove them all.  There should
+// be none within the value, and this will correct for one possible corruption
+// that hand-editing the pending.data file could cause.
+void Att::dequote (std::string& value) const
+{
+  std::string::size_type quote;
+  while ((quote = value.find ('"')) != std::string::npos)
+    value.replace (quote, 1, "");
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Encode values prior to serialization.
+//   \t -> &tab;
+//   '  -> &squot;
+//   "  -> &dquot;
+//   ,  -> &comma;
+//   [  -> &open;
+//   ]  -> &close;
+//   :  -> &colon;
+void Att::encode (std::string& value) const
+{
+  std::string::size_type i;
+
+  while ((i = value.find ('\t')) != std::string::npos)
+    value.replace (i, 1, "&tab;"); // no i18n
+
+  while ((i = value.find ('\'')) != std::string::npos)
+    value.replace (i, 1, "&squot;"); // no i18n
+
+  while ((i = value.find ('"')) != std::string::npos)
+    value.replace (i, 1, "&dquot;"); // no i18n
+
+  while ((i = value.find (',')) != std::string::npos)
+    value.replace (i, 1, "&comma;"); // no i18n
+
+  while ((i = value.find ('[')) != std::string::npos)
+    value.replace (i, 1, "&open;"); // no i18n
+
+  while ((i = value.find (']')) != std::string::npos)
+    value.replace (i, 1, "&close;"); // no i18n
+
+  while ((i = value.find (':')) != std::string::npos)
+    value.replace (i, 1, "&colon;"); // no i18n
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Decode values after parse.
+//   \t <- &tab;
+//   "  <- &quot; or &dquot;
+//   '  <- &squot;
+//   ,  <- &comma;
+//   [  <- &open;
+//   ]  <- &close;
+//   :  <- &colon;
+void Att::decode (std::string& value) const
+{
+  std::string::size_type i;
+
+  while ((i = value.find ("&tab;")) != std::string::npos) // no i18n
+    value.replace (i, 5, "\t");
+
+  while ((i = value.find ("&dquot;")) != std::string::npos) // no i18n
+    value.replace (i, 7, "\"");
+
+  while ((i = value.find ("&squot;")) != std::string::npos) // no i18n
+    value.replace (i, 7, "'");
+
+  while ((i = value.find ("&quot;")) != std::string::npos) // no i18n
+    value.replace (i, 6, "\"");
+
+  while ((i = value.find ("&comma;")) != std::string::npos) // no i18n
+    value.replace (i, 7, ",");
+
+  while ((i = value.find ("&open;")) != std::string::npos) // no i18n
+    value.replace (i, 6, "[");
+
+  while ((i = value.find ("&close;")) != std::string::npos) // no i18n
+    value.replace (i, 7, "]");
+
+  while ((i = value.find ("&colon;")) != std::string::npos) // no i18n
+    value.replace (i, 7, ":");
+}
+
+////////////////////////////////////////////////////////////////////////////////

src/Att.h

@@ -0,0 +1,85 @@
+////////////////////////////////////////////////////////////////////////////////
+// task - a command line task list manager.
+//
+// Copyright 2006 - 2010, Paul Beckingham.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program 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.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+////////////////////////////////////////////////////////////////////////////////
+#ifndef INCLUDED_ATT
+#define INCLUDED_ATT
+
+#include <string>
+#include <vector>
+#include "Nibbler.h"
+
+class Att
+{
+public:
+  Att ();
+  Att (const std::string&, const std::string&, const std::string&);
+  Att (const std::string&, const std::string&, int);
+  Att (const std::string&, const std::string&);
+  Att (const std::string&, int);
+  Att (const Att&);
+  Att& operator= (const Att&);
+  ~Att ();
+
+  bool valid (const std::string&) const;
+  static bool validInternalName (const std::string&);
+  static bool validModifiableName (const std::string&);
+  static bool validNameValue (const std::string&, const std::string&, const std::string&);
+  static bool validNameValue (std::string&, std::string&, std::string&);
+  static bool validMod (const std::string&);
+  std::string type (const std::string&) const;
+  std::string modType (const std::string&) const;
+  void parse (const std::string&);
+  void parse (Nibbler&);
+  bool match (const Att&) const;
+
+  std::string composeF4 () const;
+
+  void mod (const std::string&);
+  std::string mod () const;
+
+  std::string name () const;
+  void name (const std::string&);
+
+  std::string value () const;
+  void value (const std::string&);
+
+  int value_int () const;
+  void value_int (int);
+
+private:
+  void enquote (std::string&) const;
+  void dequote (std::string&) const;
+  void encode (std::string&) const;
+  void decode (std::string&) const;
+
+private:
+  std::string mName;
+  std::string mValue;
+  std::string mMod;
+};
+
+#endif
+////////////////////////////////////////////////////////////////////////////////

src/Cmd.cpp

@@ -0,0 +1,240 @@
+////////////////////////////////////////////////////////////////////////////////
+// task - a command line task list manager.
+//
+// Copyright 2006 - 2010, Paul Beckingham.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program 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.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+////////////////////////////////////////////////////////////////////////////////
+
+#include <algorithm>
+#include "Cmd.h"
+#include "Context.h"
+#include "util.h"
+#include "text.h"
+#include "i18n.h"
+#include "main.h"
+
+extern Context context;
+
+////////////////////////////////////////////////////////////////////////////////
+Cmd::Cmd ()
+: command ("")
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Cmd::Cmd (const std::string& input)
+{
+  parse (input);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Cmd::~Cmd ()
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Determines whether the string represents a unique command name or custom
+// report name.
+bool Cmd::valid (const std::string& input)
+{
+  load ();
+
+  std::vector <std::string> matches;
+  autoComplete (lowerCase (context.canonicalize (input)), commands, matches);
+  return matches.size () == 1 ? true : false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Determines whether the string represents a valid custom report name.
+bool Cmd::validCustom (const std::string& input)
+{
+  load ();
+
+  std::vector <std::string> matches;
+  autoComplete (lowerCase (context.canonicalize (input)), customReports, matches);
+  return matches.size () == 1 ? true : false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Cmd::parse (const std::string& input)
+{
+  load ();
+
+  std::string candidate = lowerCase (context.canonicalize (input));
+
+  std::vector <std::string> matches;
+  autoComplete (candidate, commands, matches);
+  if (1 == matches.size ())
+    command = matches[0];
+
+  else if (0 == matches.size ())
+    command = "";
+
+  else
+  {
+    std::string error = "Ambiguous command '" + candidate + "' - could be either of "; // TODO i18n
+
+    std::string combined;
+    join (combined, ", ", matches);
+    throw error + combined;
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Cmd::load ()
+{
+  if (commands.size () == 0)
+  {
+    commands.push_back ("_projects");
+    commands.push_back ("_tags");
+    commands.push_back ("_commands");
+    commands.push_back ("_ids");
+    commands.push_back ("_config");
+    commands.push_back ("_version");
+    commands.push_back (context.stringtable.get (CMD_ADD,       "add"));
+    commands.push_back (context.stringtable.get (CMD_APPEND,    "append"));
+    commands.push_back (context.stringtable.get (CMD_ANNOTATE,  "annotate"));
+    commands.push_back (context.stringtable.get (CMD_CALENDAR,  "calendar"));
+    commands.push_back (context.stringtable.get (CMD_COLORS,    "colors"));
+    commands.push_back (context.stringtable.get (CMD_CONFIG,    "config"));
+    commands.push_back (context.stringtable.get (CMD_DELETE,    "delete"));
+    commands.push_back (context.stringtable.get (CMD_DONE,      "done"));
+    commands.push_back (context.stringtable.get (CMD_DUPLICATE, "duplicate"));
+    commands.push_back (context.stringtable.get (CMD_EDIT,      "edit"));
+    commands.push_back (context.stringtable.get (CMD_EXPORT,    "export"));
+    commands.push_back (context.stringtable.get (CMD_HELP,      "help"));
+    commands.push_back (context.stringtable.get (CMD_HISTORY,   "history"));
+    commands.push_back (context.stringtable.get (CMD_GHISTORY,  "ghistory"));
+    commands.push_back (context.stringtable.get (CMD_IMPORT,    "import"));
+    commands.push_back (context.stringtable.get (CMD_INFO,      "info"));
+    commands.push_back (context.stringtable.get (CMD_PREPEND,   "prepend"));
+    commands.push_back (context.stringtable.get (CMD_PROJECTS,  "projects"));
+#ifdef FEATURE_SHELL
+    commands.push_back (context.stringtable.get (CMD_SHELL,     "shell"));
+#endif
+    commands.push_back (context.stringtable.get (CMD_START,     "start"));
+    commands.push_back (context.stringtable.get (CMD_STATS,     "stats"));
+    commands.push_back (context.stringtable.get (CMD_STOP,      "stop"));
+    commands.push_back (context.stringtable.get (CMD_SUMMARY,   "summary"));
+    commands.push_back (context.stringtable.get (CMD_TAGS,      "tags"));
+    commands.push_back (context.stringtable.get (CMD_TIMESHEET, "timesheet"));
+    commands.push_back (context.stringtable.get (CMD_UNDO,      "undo"));
+    commands.push_back (context.stringtable.get (CMD_VERSION,   "version"));
+
+    // Now load the custom reports.
+    std::vector <std::string> all;
+    context.config.all (all);
+
+    foreach (i, all)
+    {
+      if (i->substr (0, 7) == "report.")
+      {
+        std::string report = i->substr (7);
+        std::string::size_type columns = report.find (".columns");
+        if (columns != std::string::npos)
+        {
+          report = report.substr (0, columns);
+
+          // Make sure a custom report does not clash with a built-in
+          // command.
+          if (std::find (commands.begin (), commands.end (), report) != commands.end ())
+            throw std::string ("Custom report '") + report +
+                  "' conflicts with built-in task command.";
+
+          // A custom report is also a command.
+          customReports.push_back (report);
+          commands.push_back (report);
+        }
+      }
+    }
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Cmd::allCustomReports (std::vector <std::string>& all) const
+{
+  all = customReports;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Cmd::allCommands (std::vector <std::string>& all) const
+{
+  all.clear ();
+  foreach (command, commands)
+    if (command->substr (0, 1) != "_")
+      all.push_back (*command);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Commands that do not directly modify the data files.
+bool Cmd::isReadOnlyCommand ()
+{
+  if (command == "_projects"                                          ||
+      command == "_tags"                                              ||
+      command == "_commands"                                          ||
+      command == "_ids"                                               ||
+      command == "_config"                                            ||
+      command == "_version"                                           ||
+      command == context.stringtable.get (CMD_CALENDAR,  "calendar")  ||
+      command == context.stringtable.get (CMD_COLORS,    "colors")    ||
+      command == context.stringtable.get (CMD_CONFIG,    "config")    ||
+      command == context.stringtable.get (CMD_EXPORT,    "export")    ||
+      command == context.stringtable.get (CMD_HELP,      "help")      ||
+      command == context.stringtable.get (CMD_HISTORY,   "history")   ||
+      command == context.stringtable.get (CMD_GHISTORY,  "ghistory")  ||
+      command == context.stringtable.get (CMD_INFO,      "info")      ||
+      command == context.stringtable.get (CMD_PROJECTS,  "projects")  ||
+      command == context.stringtable.get (CMD_SHELL,     "shell")     ||
+      command == context.stringtable.get (CMD_STATS,     "stats")     ||
+      command == context.stringtable.get (CMD_SUMMARY,   "summary")   ||
+      command == context.stringtable.get (CMD_TAGS,      "tags")      ||
+      command == context.stringtable.get (CMD_TIMESHEET, "timesheet") ||
+      command == context.stringtable.get (CMD_VERSION,   "version")   ||
+      validCustom (command))
+    return true;
+
+  return false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Commands that directly modify the data files.
+bool Cmd::isWriteCommand ()
+{
+  if (command == context.stringtable.get (CMD_ADD,       "add")       ||
+      command == context.stringtable.get (CMD_APPEND,    "append")    ||
+      command == context.stringtable.get (CMD_ANNOTATE,  "annotate")  ||
+      command == context.stringtable.get (CMD_DELETE,    "delete")    ||
+      command == context.stringtable.get (CMD_DONE,      "done")      ||
+      command == context.stringtable.get (CMD_DUPLICATE, "duplicate") ||
+      command == context.stringtable.get (CMD_EDIT,      "edit")      ||
+      command == context.stringtable.get (CMD_IMPORT,    "import")    ||
+      command == context.stringtable.get (CMD_PREPEND,   "prepend")   ||
+      command == context.stringtable.get (CMD_START,     "start")     ||
+      command == context.stringtable.get (CMD_STOP,      "stop")      ||
+      command == context.stringtable.get (CMD_UNDO,      "undo"))
+    return true;
+
+  return false;
+}
+
+////////////////////////////////////////////////////////////////////////////////

src/Cmd.h

@@ -0,0 +1,64 @@
+////////////////////////////////////////////////////////////////////////////////
+// task - a command line task list manager.
+//
+// Copyright 2006 - 2010, Paul Beckingham.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program 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.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+////////////////////////////////////////////////////////////////////////////////
+#ifndef INCLUDED_CMD
+#define INCLUDED_CMD
+
+#include <vector>
+#include <string>
+
+class Cmd
+{
+public:
+  Cmd ();                      // Default constructor
+  Cmd (const std::string&);    // Default constructor
+  ~Cmd ();                     // Destructor
+
+  Cmd (const Cmd&);
+  Cmd& operator= (const Cmd&);
+
+  bool valid            (const std::string&);
+  bool validCustom      (const std::string&);
+  void parse            (const std::string&);
+  void allCustomReports (std::vector <std::string>&) const;
+  void allCommands      (std::vector <std::string>&) const;
+
+  bool isReadOnlyCommand ();
+  bool isWriteCommand ();
+
+public:
+  std::string command;
+
+private:
+  void load ();
+
+private:
+  std::vector <std::string> commands;
+  std::vector <std::string> customReports;
+};
+
+#endif
+////////////////////////////////////////////////////////////////////////////////

src/Color.cpp

@@ -0,0 +1,557 @@
+////////////////////////////////////////////////////////////////////////////////
+// task - a command line task list manager.
+//
+// Copyright 2006 - 2010, Paul Beckingham.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program 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.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+////////////////////////////////////////////////////////////////////////////////
+#include <iostream>
+#include <iomanip>
+#include <sstream>
+#include <vector>
+#include <algorithm>
+#include "Color.h"
+#include "text.h"
+#include "i18n.h"
+
+////////////////////////////////////////////////////////////////////////////////
+static struct
+{
+  Color::color_id id;
+  int string_id;
+  std::string english_name;
+  int index;                    // offset red=3 (therefore fg=33, bg=43)
+} allColors[] =
+{
+  // Color.h enum    i18n.h          English     Index
+  { Color::nocolor,  0,              "none",     0},
+  { Color::black,    CCOLOR_BLACK,   "black",    1}, // fg 29+0  bg 39+0
+  { Color::red,      CCOLOR_RED,     "red",      2},
+  { Color::green,    CCOLOR_GREEN,   "green",    3},
+  { Color::yellow,   CCOLOR_YELLOW,  "yellow",   4},
+  { Color::blue,     CCOLOR_BLUE,    "blue",     5},
+  { Color::magenta,  CCOLOR_MAGENTA, "magenta",  6},
+  { Color::cyan,     CCOLOR_CYAN,    "cyan",     7},
+  { Color::white,    CCOLOR_WHITE,   "white",    8},
+
+};
+
+#define NUM_COLORS (sizeof (allColors) / sizeof (allColors[0]))
+
+////////////////////////////////////////////////////////////////////////////////
+Color::Color ()
+: value (0)
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Color::Color (const Color& other)
+{
+  value = other.value;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Color::Color (unsigned int c)
+: value (0)
+{
+  if (!(c & _COLOR_HASFG)) value &= ~_COLOR_FG;
+  if (!(c & _COLOR_HASBG)) value &= ~_COLOR_BG;
+
+  value = c & (_COLOR_256 | _COLOR_HASBG | _COLOR_HASFG |_COLOR_UNDERLINE |
+               _COLOR_BOLD | _COLOR_BRIGHT | _COLOR_BG | _COLOR_FG);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Supports the following constructs:
+//   [bright] [color] [on color] [bright] [underline]
+//
+// Where [color] is one of:
+//   black
+//   red
+//   ...
+//   grayN  0 <= N <= 23       fg 38;5;232 + N              bg 48;5;232 + N
+//   greyN  0 <= N <= 23       fg 38;5;232 + N              bg 48;5;232 + N
+//   colorN 0 <= N <= 255      fg 38;5;N                    bg 48;5;N
+//   rgbRGB 0 <= R,G,B <= 5    fg 38;5;16 + R*36 + G*6 + B  bg 48;5;16 + R*36 + G*6 + B
+Color::Color (const std::string& spec)
+: value (0)
+{
+  // By converting underscores to spaces, we inherently support the old "on_red"
+  // style of specifying background colors.  We consider underscores to be
+  // deprecated.
+  std::string modifiable_spec = spec;
+  std::replace (modifiable_spec.begin (), modifiable_spec.end (), '_', ' ');
+
+  // Split spec into words.
+  std::vector <std::string> words;
+  split (words, modifiable_spec, ' ');
+
+  // Construct the color as two separate colors, then blend them later.  This
+  // make it possible to declare a color such as "color1 on black", and have
+  // the upgrade work properly.
+  unsigned int fg_value = 0;
+  unsigned int bg_value = 0;
+
+  bool bg = false;
+  int index;
+  std::string word;
+  std::vector <std::string>::iterator it;
+  for (it = words.begin (); it != words.end (); ++it)
+  {
+    word = lowerCase (trim (*it));
+
+         if (word == "bold")      fg_value |= _COLOR_BOLD;
+    else if (word == "bright")    bg_value |= _COLOR_BRIGHT;
+    else if (word == "underline") fg_value |= _COLOR_UNDERLINE;
+    else if (word == "on")        bg = true;
+
+    // X where X is one of black, red, blue ...
+    else if ((index = find (word)) != -1)
+    {
+      if (bg)
+      {
+        bg_value |= _COLOR_HASBG;
+        bg_value |= index << 8;
+      }
+      else
+      {
+        fg_value |= _COLOR_HASFG;
+        fg_value |= index;
+      }
+    }
+
+    // greyN/grayN, where 0 <= N <= 23.
+    else if (word.substr (0, 4) == "grey" ||
+             word.substr (0, 4) == "gray")
+    {
+      index = atoi (word.substr (4).c_str ());
+      if (index < 0 || index > 23)
+        throw std::string ("The color '") + *it + "' is not recognized.";
+
+      if (bg)
+      {
+        bg_value |= _COLOR_HASBG;
+        bg_value |= (index + 232) << 8;
+        bg_value |= _COLOR_256;
+      }
+      else
+      {
+        fg_value |= _COLOR_HASFG;
+        fg_value |= index + 232;
+        fg_value |= _COLOR_256;
+      }
+    }
+
+    // rgbRGB, where 0 <= R,G,B <= 5.
+    else if (word.substr (0, 3) == "rgb")
+    {
+      index = atoi (word.substr (3).c_str ());
+      if (word.length () != 6 ||
+          index < 0 || index > 555)
+        throw std::string ("The color '") + *it + "' is not recognized.";
+
+      int r = atoi (word.substr (3, 1).c_str ());
+      int g = atoi (word.substr (4, 1).c_str ());
+      int b = atoi (word.substr (5, 1).c_str ());
+      if (r < 0 || r > 5 ||
+          g < 0 || g > 5 ||
+          b < 0 || b > 5)
+        throw std::string ("The color '") + *it + "' is not recognized.";
+
+      index = 16 + r*36 + g*6 + b;
+
+      if (bg)
+      {
+        bg_value |= _COLOR_HASBG;
+        bg_value |= index << 8;
+        bg_value |= _COLOR_256;
+      }
+      else
+      {
+        fg_value |= _COLOR_HASFG;
+        fg_value |= index;
+        fg_value |= _COLOR_256;
+      }
+    }
+
+    // colorN, where 0 <= N <= 255.
+    else if (word.substr (0, 5) == "color")
+    {
+      index = atoi (word.substr (5).c_str ());
+      if (index < 0 || index > 255)
+        throw std::string ("The color '") + *it + "' is not recognized.";
+
+      upgrade ();
+
+      if (bg)
+      {
+        bg_value |= _COLOR_HASBG;
+        bg_value |= index << 8;
+        bg_value |= _COLOR_256;
+      }
+      else
+      {
+        fg_value |= _COLOR_HASFG;
+        fg_value |= index;
+        fg_value |= _COLOR_256;
+      }
+    }
+    else if (word != "")
+      throw std::string ("The color '") + *it + "' is not recognized.";
+  }
+
+  // Now combine the fg and bg into a single color.
+  value = fg_value;
+  blend (Color (bg_value));
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Color::Color (color_id fg)
+: value (0)
+{
+  if (fg != Color::nocolor)
+  {
+    value |= _COLOR_HASFG;
+    value |= fg;
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Color::Color (color_id fg, color_id bg)
+: value (0)
+{
+  if (bg != Color::nocolor)
+  {
+    value |= _COLOR_HASBG;
+    value |= (bg << 8);
+  }
+
+  if (fg != Color::nocolor)
+  {
+    value |= _COLOR_HASFG;
+    value |= fg;
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Color::Color (color_id fg, color_id bg, bool underline, bool bold, bool bright)
+: value (0)
+{
+  value |= ((underline ? 1 : 0) << 18)
+        |  ((bold      ? 1 : 0) << 17)
+        |  ((bright    ? 1 : 0) << 16);
+
+  if (bg != Color::nocolor)
+  {
+    value |= _COLOR_HASBG;
+    value |= (bg << 8);
+  }
+
+  if (fg != Color::nocolor)
+  {
+    value |= _COLOR_HASFG;
+    value |= fg;
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Color::~Color ()
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Color& Color::operator= (const Color& other)
+{
+  if (this != &other)
+    value = other.value;
+
+  return *this;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Color::operator std::string () const
+{
+  std::string description;
+  if (value & _COLOR_BOLD) description += "bold";
+
+  if (value & _COLOR_UNDERLINE)
+    description += std::string (description.length () ? " " : "") + "underline";
+
+  if (value & _COLOR_HASFG)
+    description += std::string (description.length () ? " " : "") + fg ();
+
+  if (value & _COLOR_HASBG)
+  {
+    description += std::string (description.length () ? " " : "") + "on";
+
+    if (value & _COLOR_BRIGHT)
+      description += std::string (description.length () ? " " : "") + "bright";
+
+    description += " " + bg ();
+  }
+
+  return description;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Color::operator int () const
+{
+  return (int) value;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// If 'other' has styles that are compatible, merge them into this.  Colors in
+// other take precedence.
+void Color::blend (const Color& other)
+{
+  Color c (other);
+  value |= (c.value & _COLOR_UNDERLINE);    // Always inherit underline.
+
+  // 16 <-- 16.
+  if (!(value   & _COLOR_256) &&
+      !(c.value & _COLOR_256))
+  {
+    value |= (c.value & _COLOR_BOLD);       // Inherit bold.
+    value |= (c.value & _COLOR_BRIGHT);     // Inherit bright.
+
+    if (c.value & _COLOR_HASFG)
+    {
+      value |= _COLOR_HASFG;                // There is now a color.
+      value &= ~_COLOR_FG;                  // Remove previous color.
+      value |= (c.value & _COLOR_FG);       // Apply other color.
+    }
+
+    if (c.value & _COLOR_HASBG)
+    {
+      value |= _COLOR_HASBG;                // There is now a color.
+      value &= ~_COLOR_BG;                  // Remove previous color.
+      value |= (c.value & _COLOR_BG);       // Apply other color.
+    }
+
+    return;
+  }
+
+  // Upgrade either color, if necessary.
+  if (!(value   & _COLOR_256)) upgrade ();
+  if (!(c.value & _COLOR_256)) c.upgrade ();
+
+  // 256 <-- 256.
+  if (c.value & _COLOR_HASFG)
+  {
+    value |= _COLOR_HASFG;                  // There is now a color.
+    value &= ~_COLOR_FG;                    // Remove previous color.
+    value |= (c.value & _COLOR_FG);         // Apply other color.
+  }
+
+  if (c.value & _COLOR_HASBG)
+  {
+    value |= _COLOR_HASBG;                  // There is now a color.
+    value &= ~_COLOR_BG;                    // Remove previous color.
+    value |= (c.value & _COLOR_BG);         // Apply other color.
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Color::upgrade ()
+{
+  if (!(value & _COLOR_256))
+  {
+    if (value & _COLOR_HASFG)
+    {
+      bool bold = value & _COLOR_BOLD;
+      unsigned int fg = value & _COLOR_FG;
+      value &= ~_COLOR_FG;
+      value &= ~_COLOR_BOLD;
+      value |= (bold ? fg + 7 : fg - 1);
+    }
+
+    if (value & _COLOR_HASBG)
+    {
+      bool bright = value & _COLOR_BRIGHT;
+      unsigned int bg = (value & _COLOR_BG) >> 8;
+      value &= ~_COLOR_BG;
+      value &= ~_COLOR_BRIGHT;
+      value |= (bright ? bg + 7 : bg - 1) << 8;
+    }
+
+    value |= _COLOR_256;
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Sample color codes:
+//   red                  \033[31m
+//   bold red             \033[91m
+//   underline red        \033[4;31m
+//   bold underline red   \033[1;4;31m
+//
+//   on red               \033[41m
+//   on bright red        \033[101m
+//
+//   256 fg               \033[38;5;Nm
+//   256 bg               \033[48;5;Nm
+std::string Color::colorize (const std::string& input)
+{
+  if (value == 0)
+    return input;
+
+  int count = 0;
+  std::stringstream result;
+
+  // 256 color
+  if (value & _COLOR_256)
+  {
+    bool needTerminator = false;
+
+    if (value & _COLOR_UNDERLINE)
+    {
+      result << "\033[4m";
+      needTerminator = true;
+    }
+
+    if (value & _COLOR_HASFG)
+    {
+      result << "\033[38;5;" << (value & _COLOR_FG) << "m";
+      needTerminator = true;
+    }
+
+    if (value & _COLOR_HASBG)
+    {
+      result << "\033[48;5;" << ((value & _COLOR_BG) >> 8) << "m";
+      needTerminator = true;
+    }
+
+    result << input;
+    if (needTerminator)
+      result << "\033[0m";
+
+    return result.str ();
+  }
+
+  // 16 color
+  if (value != 0)
+  {
+    result << "\033[";
+
+    if (value & _COLOR_BOLD)
+    {
+      if (count++) result << ";";
+      result << "1";
+    }
+
+    if (value & _COLOR_UNDERLINE)
+    {
+      if (count++) result << ";";
+      result << "4";
+    }
+
+    if (value & _COLOR_HASFG)
+    {
+      if (count++) result << ";";
+      result << (29 + (value & _COLOR_FG));
+    }
+
+    if (value & _COLOR_HASBG)
+    {
+      if (count++) result << ";";
+      result << ((value & _COLOR_BRIGHT ? 99 : 39) + ((value & _COLOR_BG) >> 8));
+    }
+
+    result << "m" << input << "\033[0m";
+    return result.str ();
+  }
+
+  return input;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+std::string Color::colorize (const std::string& input, const std::string& spec)
+{
+  Color c (spec);
+  return c.colorize (input);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool Color::nontrivial ()
+{
+  return value != 0 ? true : false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+int Color::find (const std::string& input)
+{
+  for (unsigned int i = 0; i < NUM_COLORS; ++i)
+    if (allColors[i].english_name == input)
+      return (int) i;
+
+  return -1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+std::string Color::fg () const
+{
+  int index = value & _COLOR_FG;
+
+  if (value & _COLOR_256)
+  {
+    if (value & _COLOR_HASFG)
+    {
+      std::stringstream s;
+      s << "color" << (value & _COLOR_FG);
+      return s.str ();
+    }
+  }
+  else
+  {
+    for (unsigned int i = 0; i < NUM_COLORS; ++i)
+      if (allColors[i].index == index)
+        return allColors[i].english_name;
+  }
+
+  return "";
+}
+
+////////////////////////////////////////////////////////////////////////////////
+std::string Color::bg () const
+{
+  int index = (value & _COLOR_BG) >> 8;
+
+  if (value & _COLOR_256)
+  {
+    if (value & _COLOR_HASBG)
+    {
+      std::stringstream s;
+      s << "color" << ((value & _COLOR_BG) >> 8);
+      return s.str ();
+    }
+  }
+  else
+  {
+    for (unsigned int i = 0; i < NUM_COLORS; ++i)
+      if (allColors[i].index == index)
+        return allColors[i].english_name;
+  }
+
+  return "";
+}
+
+////////////////////////////////////////////////////////////////////////////////

src/Color.h

@@ -0,0 +1,78 @@
+////////////////////////////////////////////////////////////////////////////////
+// task - a command line task list manager.
+//
+// Copyright 2006 - 2010, Paul Beckingham.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program 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.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+////////////////////////////////////////////////////////////////////////////////
+#ifndef INCLUDED_COLOR
+#define INCLUDED_COLOR
+
+#include <string>
+
+////////////////////////////////////////////////////////////////////////////////
+#define _COLOR_256       0x00200000  // 256-color mode.
+#define _COLOR_HASBG     0x00100000  // Has background color (all values taken).
+#define _COLOR_HASFG     0x00080000  // Has foreground color (all values taken).
+#define _COLOR_UNDERLINE 0x00040000  // General underline attribute.
+#define _COLOR_BOLD      0x00020000  // 16-color bold attribute.
+#define _COLOR_BRIGHT    0x00010000  // 16-color bright background attribute.
+#define _COLOR_BG        0x0000FF00  // 8-bit background color index.
+#define _COLOR_FG        0x000000FF  // 8-bit foreground color index.
+
+class Color
+{
+public:
+  enum color_id {nocolor = 0, black, red, green, yellow, blue, magenta, cyan, white};
+
+  Color ();
+  Color (const Color&);
+  Color (unsigned int);                         // 256 | UNDERLINE | BOLD | BRIGHT | (BG << 8) | FG
+  Color (const std::string&);                   // "red on bright black"
+  Color (color_id);                             // fg.
+  Color (color_id, color_id);                   // fg, bg.
+  Color (color_id, color_id, bool, bool, bool); // fg, bg, underline, bold, bright
+  ~Color ();
+  Color& operator= (const Color&);
+  operator std::string () const;
+  operator int () const;
+
+  void upgrade ();
+  void blend (const Color&);
+
+  std::string colorize (const std::string&);
+  static std::string colorize (const std::string&, const std::string&);
+
+  bool nontrivial ();
+
+private:
+  int find (const std::string&);
+  std::string fg () const;
+  std::string bg () const;
+
+private:
+  unsigned int value;
+};
+
+#endif
+
+////////////////////////////////////////////////////////////////////////////////

src/Config.cpp

@@ -1,7 +1,7 @@
 ///////////////////////////////////////////////////////////////////////////////
 // task - a command line task list manager.
 //
-// Copyright 2006 - 2009, Paul Beckingham.
+// Copyright 2006 - 2010, Paul Beckingham.
 // All rights reserved.
 //
 // This program is free software; you can redistribute it and/or modify it under
@@ -27,54 +27,283 @@
 #include <iostream>
 #include <fstream>
 #include <sstream>
+#include <algorithm>
 #include <sys/types.h>
 #include <sys/stat.h>
 #include <unistd.h>
 #include <stdlib.h>
 #include <pwd.h>
-#include "task.h"
+#include "Directory.h"
+#include "Date.h"
+#include "File.h"
 #include "Config.h"
+#include "text.h"
+#include "util.h"
+#include "../auto.h"
 
 ////////////////////////////////////////////////////////////////////////////////
-// These are default (but overridable) reports.  These entries are necessary
-// because these three reports were converted from hard-coded reports to custom
-// reports, and therefore need these config file entries.  However, users are
-// already used to seeing these five reports, but do not have these entries.
-// The choice was a) make users edit their .taskrc files, b) write a .taskrc
-// upgrade program to make the change, or c) this.
+// This string is used in two ways:
+// 1) It is used to create a new .taskrc file, by copying it directly to disk.
+// 2) It is parsed and used as default values for all Config.get calls.
+std::string Config::defaults =
+  "# Task program configuration file.\n"
+  "# For more documentation, see http://taskwarrior.org or try 'man task', 'man task-faq',\n"
+  "# 'man task-tutorial', 'man task-color' or 'man taskrc'\n"
+  "\n"
+  "# Here is an example of entries that use the default, override and blank values\n"
+  "#   variable=foo   -- By specifying a value, this overrides the default\n"
+  "#   variable=      -- By specifying no value, this means no default\n"
+  "#   #variable=foo  -- By commenting out the line, this uses the default\n"
+  "\n"
+  "# Files\n"
+  "data.location=~/.task\n"
+  "locking=on                             # Use file-level locking\n"
+  "\n"
+  "# Terminal\n"
+  "curses=on                              # Use ncurses library to determine terminal width\n"
+  "defaultwidth=80                        # Without ncurses, assumed width\n"
+  "#editor=vi                             # Preferred text editor\n"
+  "\n"
+  "# Miscellaneous\n"
+  "confirmation=yes                       # Confirmation on delete, big changes\n"
+  "echo.command=yes                       # Details on command just run\n"
+  "annotations=full                       # Level of verbosity for annotations: full, sparse or none\n"
+  "next=2                                 # How many tasks per project in next report\n"
+  "bulk=2                                 # > 2 tasks considered 'a lot', for confirmation\n"
+  "nag=You have higher priority tasks.    # Nag message to keep you honest\n"                      // TODO
+  "search.case.sensitive=yes              # Setting to no allows case insensitive searches\n"
+  "active.indicator=*                     # What to show as an active task indicator\n"
+  "tag.indicator=+                        # What to show as a tag indicator\n"
+  "recurrence.indicator=R                 # What to show as a task recurrence indicator\n"
+  "\n"
+  "# Dates\n"
+  "dateformat=m/d/Y                       # Preferred input and display date format\n"
+  "dateformat.holiday=YMD                 # Preferred input date format for holidays\n"
+  "dateformat.report=m/d/Y                # Preferred display date format for repors\n"
+  "weekstart=Sunday                       # Sunday or Monday only\n"
+  "displayweeknumber=yes                  # Show week numbers on calendar\n"
+  "due=7                                  # Task is considered due in 7 days\n"
+  "\n"
+  "# Calendar controls\n"
+  "calendar.legend=yes                    # Display the legend on calendar\n"
+  "calendar.details=sparse                # Calendar shows information for tasks w/due dates: full, sparse or none\n"
+  "calendar.details.report=list           # Report to use when showing task information in cal\n"
+  "calendar.holidays=none                 # Show public holidays on calendar:full, sparse or none\n"
+  "#monthsperline=3                       # Number of calendar months on a line\n"
+  "\n"
+  "# Color controls.\n"
+  "color=on                                      # Enable color\n"
+  "#color.header=bold green                      # Color of header messages\n"
+  "#color.footnote=bold green                    # Color of footnote messages\n"
+  "color.summary.bar=on green                    # Color of summary report progress bar\n"
+  "color.summary.background=on black             # Color of summary report background\n"
+  "color.calendar.today=black on cyan            # Color of today in calendar\n"
+  "color.calendar.due=black on green             # Color of days  with due tasks in calendar\n"
+  "color.calendar.due.today=black on magenta     # Color of today with due tasks in calendar\n"
+  "color.calendar.overdue=black on red           # Color of days  with overdue tasks in calendar\n"
+  "color.calendar.weekend=bright white on black  # Color of weekend days in calendar\n"
+  "color.calendar.holiday=black on bright yellow # Color of public holidays in calendar\n"
+  "color.calendar.weeknumber=black on white      # Color of the weeknumbers in calendar\n"
+  "#color.debug=magenta                          # Color of diagnostic output\n"
+  "\n"
+  "# The following rules are presented in their order of precedence.\n"
+  "# The higher the color rule is up this list, the higher precedence\n"
+  "# it has in determining the color for the task.  Precedence is shown\n"
+  "# in brackets [1]\n"
+  "#color.recurring=on red                # [1]  Color of recur.any: tasks\n"
+  "color.overdue=bold red                 # [2]  Color of overdue tasks\n"
+  "color.due.today=bold magenta           # [3]  Color of tasks due today\n"
+  "color.due=bold yellow                  # [4]  Color of due tasks\n"
+  "#color.keyword.car=on blue             # [5]  Color of description.contains:car tasks\n"
+  "#color.project.garden=on green         # [6]  Color of project:garden tasks\n"
+  "#color.tag.bug=yellow                  # [7]  Color of +bug tasks\n"
+  "color.active=bold cyan                 # [8]  Color of active tasks\n"
+  "#color.pri.none=white on blue          # [9]  Color of priority:  tasks\n"
+  "color.pri.H=bold                       # [9]  Color of priority:H tasks\n"
+  "#color.pri.M=on yellow                 # [9]  Color of priority:M tasks\n"
+  "#color.pri.L=on green                  # [9]  Color of priority:L tasks\n"
+  "color.tagged=yellow                    # [10]  Color of tagged tasks\n"
+  "#color.alternate=on rgb253             # [11] Alternate color for line coloring\n"
+  "\n"
+  "# Shadow file support\n"
+  "#shadow.file=/tmp/shadow.txt           # Location of shadow file\n"
+  "#shadow.command=list                   # Task command for shadow file\n"
+  "#shadow.notify=on                      # Footnote when updated\n"
+  "\n"
+  "#default.project=foo                   # Default project for 'add' command\n"
+  "#default.priority=M                    # Default priority for 'add' command\n"
+  "default.command=list                   # When no arguments are specified\n"
+  "\n"
+  "_forcecolor=no                         # Forces color to be on, even for non TTY output\n"
+  "blanklines=true                        # Use more whitespace in output\n"
+  "complete.all.projects=no               # Include old project names in 'projects' command\n"     // TODO
+  "complete.all.tags=no                   # Include old tag names in 'tags' command\n"             // TODO
+  "debug=no                               # Display diagnostics\n"
+  "hooks=off                              # Hook system master switch\n"
+  "fontunderline=yes                      # Uses underlines rather than -------\n"
+  "shell.prompt=task>                     # Prompt used by the shell command\n"                    // TODO
+  "\n"
+  "# Import heuristics - alternate names for fields (comma-separated list of names)\n"
+  "#import.synonym.bg=?\n"
+  "#import.synonym.description=?\n"
+  "#import.synonym.due=?\n"
+  "#import.synonym.end=?\n"
+  "#import.synonym.entry=?\n"
+  "#import.synonym.fg=?\n"
+  "#import.synonym.id=?\n"
+  "#import.synonym.priority=?\n"
+  "#import.synonym.project=?\n"
+  "#import.synonym.recur=?\n"
+  "#import.synonym.start=?\n"
+  "#import.synonym.status=?\n"
+  "#import.synonym.tags=?\n"
+  "#import.synonym.uuid=?\n"
+  "\n"
+  "# Aliases - alternate names for commands\n"
+  "alias.rm=delete                        # Alias for the delete command\n"
+  "\n"
+  "# Fields: id,uuid,project,priority,priority_long,entry,entry_time,\n"                           // TODO
+  "#         start,entry_time,due,recur,recurrence_indicator,age,\n"                               // TODO
+  "#         age_compact,active,tags,tag_indicator,description,\n"                                 // TODO
+  "#         description_only,end,end_time,countdown,countdown_compact\n"                          // TODO
+  "# Description:   This report is ...\n"
+  "# Sort:          due+,priority-,project+\n"
+  "# Filter:        pro:x pri:H +bug limit:10\n"
+  "# Dateformat:    due date format in reports\n"
+  "\n"
+  "# task long\n"
+  "report.long.description=Lists all task, all data, matching the specified criteria\n"
+  "report.long.columns=id,project,priority,entry,start,due,recur,countdown,age,tags,description\n"
+  "report.long.labels=ID,Project,Pri,Added,Started,Due,Recur,Countdown,Age,Tags,Description\n"
+  "report.long.sort=due+,priority-,project+\n"
+  "report.long.filter=status:pending\n"
+  "#report.long.dateformat=m/d/Y\n"
+  "#report.long.annotations=full\n"
+  "\n"
+  "# task list\n"
+  "report.list.description=Lists all tasks matching the specified criteria\n"
+  "report.list.columns=id,project,priority,due,active,age,description\n"
+  "report.list.labels=ID,Project,Pri,Due,Active,Age,Description\n"
+  "report.list.sort=due+,priority-,project+\n"
+  "report.list.filter=status:pending\n"
+  "#report.list.dateformat=m/d/Y\n"
+  "#report.list.annotations=full\n"
+  "\n"
+  "# task ls\n"
+  "report.ls.description=Minimal listing of all tasks matching the specified criteria\n"
+  "report.ls.columns=id,project,priority,description\n"
+  "report.ls.labels=ID,Project,Pri,Description\n"
+  "report.ls.sort=priority-,project+\n"
+  "report.ls.filter=status:pending\n"
+  "#report.ls.dateformat=m/d/Y\n"
+  "#report.ls.annotations=full\n"
+  "\n"
+  "# task minimal\n"
+  "report.minimal.description=A really minimal listing\n"
+  "report.minimal.columns=id,project,description\n"
+  "report.minimal.labels=ID,Project,Description\n"
+  "report.minimal.sort=project+,description+\n"
+  "report.minimal.filter=status:pending\n"
+  "#report.minimal.dateformat=m/d/Y\n"
+  "#report.minimal.annotations=full\n"
+  "\n"
+  "# task newest\n"
+  "report.newest.description=Shows the newest tasks\n"
+  "report.newest.columns=id,project,priority,due,active,age,description\n"
+  "report.newest.labels=ID,Project,Pri,Due,Active,Age,Description\n"
+  "report.newest.sort=id-\n"
+  "report.newest.filter=status:pending limit:10\n"
+  "#report.newest.dateformat=m/d/Y\n"
+  "#report.newest.annotations=full\n"
+  "\n"
+  "# task oldest\n"
+  "report.oldest.description=Shows the oldest tasks\n"
+  "report.oldest.columns=id,project,priority,due,active,age,description\n"
+  "report.oldest.labels=ID,Project,Pri,Due,Active,Age,Description\n"
+  "report.oldest.sort=id+\n"
+  "report.oldest.filter=status:pending limit:10\n"
+  "#report.oldest.dateformat=m/d/Y\n"
+  "#report.oldest.annotations=full\n"
+  "\n"
+  "# task overdue\n"
+  "report.overdue.description=Lists overdue tasks matching the specified criteria\n"
+  "report.overdue.columns=id,project,priority,due,active,age,description\n"
+  "report.overdue.labels=ID,Project,Pri,Due,Active,Age,Description\n"
+  "report.overdue.sort=due+,priority-,project+\n"
+  "report.overdue.filter=status:pending due.before:today\n"
+  "#report.overdue.dateformat=m/d/Y\n"
+  "#report.overdue.annotations=full\n"
+  "\n"
+  "# task active\n"
+  "report.active.description=Lists active tasks matching the specified criteria\n"
+  "report.active.columns=id,project,priority,due,active,age,description\n"
+  "report.active.labels=ID,Project,Pri,Due,Active,Age,Description\n"
+  "report.active.sort=due+,priority-,project+\n"
+  "report.active.filter=status:pending start.any:\n"
+  "#report.active.dateformat=m/d/Y\n"
+  "#report.active.annotations=full\n"
+  "\n"
+  "# task completed\n"
+  "report.completed.description=Lists completed tasks matching the specified criteria\n"
+  "report.completed.columns=end,project,priority,age,description\n"
+  "report.completed.labels=Complete,Project,Pri,Age,Description\n"
+  "report.completed.sort=end+,priority-,project+\n"
+  "report.completed.filter=status:completed\n"
+  "#report.completed.dateformat=m/d/Y\n"
+  "#report.completed.annotations=full\n"
+  "\n"
+  "# task recurring\n"
+  "report.recurring.description=Lists recurring tasks matching the specified criteria\n"
+  "report.recurring.columns=id,project,priority,due,recur,active,age,description\n"
+  "report.recurring.labels=ID,Project,Pri,Due,Recur,Active,Age,Description\n"
+  "report.recurring.sort=due+,priority-,project+\n"
+  "report.recurring.filter=status:pending parent.any:\n"
+  "#report.recurring.dateformat=m/d/Y\n"
+  "#report.recurring.annotations=full\n"
+  "\n"
+  "# task waiting\n"
+  "report.waiting.description=Lists all waiting tasks matching the specified criteria\n"
+  "report.waiting.columns=id,project,priority,wait,age,description\n"
+  "report.waiting.labels=ID,Project,Pri,Wait,Age,Description\n"
+  "report.waiting.sort=wait+,priority-,project+\n"
+  "report.waiting.filter=status:waiting\n"
+  "#report.waiting.dateformat=m/d/Y\n"
+  "#report.waiting.annotations=full\n"
+  "\n"
+  "# task all\n"
+  "report.all.description=Lists all tasks matching the specified criteria\n"
+  "report.all.columns=id,project,priority,due,active,age,description\n"
+  "report.all.labels=ID,Project,Pri,Due,Active,Age,Description\n"
+  "report.all.sort=due+,priority-,project+\n"
+  "#report.all.dateformat=m/d/Y\n"
+  "#report.all.annotations=full\n"
+  "\n"
+  "# task next\n"
+  "report.next.description=Lists the most urgent tasks\n"
+  "report.next.columns=id,project,priority,due,active,age,description\n"
+  "report.next.labels=ID,Project,Pri,Due,Active,Age,Description\n"
+  "report.next.sort=due+,priority-,project+\n"
+  "report.next.filter=status:pending\n"
+  "#report.next.dateformat=m/d/Y\n"
+  "#report.next.annotations=full\n"
+  "\n";
+
+////////////////////////////////////////////////////////////////////////////////
+// DO NOT CALL Config::setDefaults.
+//
+// This is a default constructor, and as such is only used to:
+//   a) initialize a default Context constructor
+//   b) run unit tests
+//
+// In all real use cases, Config::load is called.
 Config::Config ()
 {
-  (*this)["report.long.description"]   = "Lists all task, all data, matching the specified criteria";
-  (*this)["report.long.columns"]       = "id,project,priority,entry,start,due,recur,age,tags,description";
-  (*this)["report.long.labels"]        = "ID,Project,Pri,Added,Started,Due,Recur,Age,Tags,Description";
-  (*this)["report.long.sort"]          = "due+,priority-,project+";
-
-  (*this)["report.list.description"]   = "Lists all tasks matching the specified criteria";
-  (*this)["report.list.columns"]       = "id,project,priority,due,active,age,description";
-  (*this)["report.list.labels"]        = "ID,Project,Pri,Due,Active,Age,Description";
-  (*this)["report.list.sort"]          = "due+,priority-,project+";
-
-  (*this)["report.ls.description"]     = "Minimal listing of all tasks matching the specified criteria";
-  (*this)["report.ls.columns"]         = "id,project,priority,description";
-  (*this)["report.ls.labels"]          = "ID,Project,Pri,Description";
-  (*this)["report.ls.sort"]            = "priority-,project+";
-
-  (*this)["report.newest.description"] = "Shows the newest tasks";
-  (*this)["report.newest.columns"]     = "id,project,priority,due,active,age,description";
-  (*this)["report.newest.labels"]      = "ID,Project,Pri,Due,Active,Age,Description";
-  (*this)["report.newest.sort"]        = "id-";
-  (*this)["report.newest.limit"]       = "10";
-
-  (*this)["report.oldest.description"] = "Shows the oldest tasks";
-  (*this)["report.oldest.columns"]     = "id,project,priority,due,active,age,description";
-  (*this)["report.oldest.labels"]      = "ID,Project,Pri,Due,Active,Age,Description";
-  (*this)["report.oldest.sort"]        = "id+";
-  (*this)["report.oldest.limit"]       = "10";
 }
 
 ////////////////////////////////////////////////////////////////////////////////
 Config::Config (const std::string& file)
 {
+  setDefaults ();
   load (file);
 }
 
@@ -82,156 +311,128 @@ Config::Config (const std::string& file)
 // Read the Configuration file and populate the *this map.  The file format is
 // simply lines with name=value pairs.  Whitespace between name, = and value is
 // not tolerated, but blank lines and comments starting with # are allowed.
-bool Config::load (const std::string& file)
+//
+// Nested files are now supported, with the following construct:
+//   include /absolute/path/to/file
+//
+void Config::load (const std::string& file, int nest /* = 1 */)
 {
-  std::ifstream in;
-  in.open (file.c_str (), std::ifstream::in);
-  if (in.good ())
+  if (nest > 10)
+    throw std::string ("Configuration file nested to more than 10 levels deep"
+                       " - this has to be a mistake.");
+
+  // First time in, load the default values.
+  if (nest == 1)
   {
-    std::string line;
-    while (getline (in, line))
+    setDefaults ();
+    original_file = File (file);
+  }
+
+  // Read the file, then parse the contents.
+  std::string contents;
+  if (File::read (file, contents) && contents.length ())
+    parse (contents, nest);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Config::parse (const std::string& input, int nest /* = 1 */)
+{
+  // Shortcut case for default constructor.
+  if (input.length () == 0)
+    return;
+
+  // Split the input into lines.
+  std::vector <std::string> lines;
+  split (lines, input, "\n");
+
+  // Parse each line.
+  std::vector <std::string>::iterator it;
+  for (it = lines.begin (); it != lines.end (); ++it)
+  {
+    std::string line = *it;
+
+    // Remove comments.
+    std::string::size_type pound = line.find ("#"); // no i18n
+    if (pound != std::string::npos)
+      line = line.substr (0, pound);
+
+    line = trim (line, " \t"); // no i18n
+
+    // Skip empty lines.
+    if (line.length () > 0)
     {
-      // Remove comments.
-      size_type pound = line.find ("#");
-      if (pound != std::string::npos)
-        line = line.substr (0, pound);
-
-      line = trim (line, " \t");
-
-      // Skip empty lines.
-      if (line.length () > 0)
+      std::string::size_type equal = line.find ("="); // no i18n
+      if (equal != std::string::npos)
       {
-        size_type equal = line.find ("=");
-        if (equal != std::string::npos)
+        std::string key   = trim (line.substr (0, equal), " \t"); // no i18n
+        std::string value = trim (line.substr (equal+1, line.length () - equal), " \t"); // no i18n
+
+        (*this)[key] = value;
+      }
+      else
+      {
+        std::string::size_type include = line.find ("include"); // no i18n.
+        if (include != std::string::npos)
         {
-          std::string key   = trim (line.substr (0, equal), " \t");
-          std::string value = trim (line.substr (equal+1, line.length () - equal), " \t");
-          (*this)[key] = value;
+          Path included (trim (line.substr (include + 7), " \t"));
+          if (included.is_absolute ())
+          {
+            if (included.readable ())
+              this->load (included, nest + 1);
+            else
+              throw std::string ("Could not read include file '") + included.data + "'";
+          }
+          else
+            throw std::string ("Can only include files with absolute paths, not '") + included.data + "'";
         }
-      }
-    }
-
-    in.close ();
-    return true;
-  }
-
-  return false;
-}
-
-////////////////////////////////////////////////////////////////////////////////
-void Config::createDefault (const std::string& home)
-{
-  // Strip trailing slash off home directory, if necessary.
-  std::string terminatedHome = home;
-  if (home[home.length () - 1] == '/')
-    terminatedHome = home.substr (0, home.length () - 1);
-
-  // Determine default names of init file and task directory.
-  std::string rcFile  = terminatedHome + "/.taskrc";
-  std::string dataDir = terminatedHome + "/.task";;
-
-  // If rcFile is not found, offer to create one.
-  if (-1 == access (rcFile.c_str (), F_OK))
-  {
-    if (confirm (
-          "A configuration file could not be found in "
-        + rcFile
-        + "\n\n"
-        + "Would you like a sample .taskrc created, so task can proceed?"))
-    {
-      // Create a sample .taskrc file.
-      FILE* out;
-      if ((out = fopen (rcFile.c_str (), "w")))
-      {
-        fprintf (out, "data.location=%s\n", dataDir.c_str ());
-        fprintf (out, "confirmation=yes\n");
-        fprintf (out, "echo.command=yes\n");
-        fprintf (out, "next=2\n");
-        fprintf (out, "dateformat=m/d/Y\n");
-        fprintf (out, "#monthsperline=2\n");
-        fprintf (out, "curses=on\n");
-        fprintf (out, "color=on\n");
-        fprintf (out, "due=7\n");
-        fprintf (out, "nag=You have higher priority tasks.\n");
-        fprintf (out, "locking=on\n");
-
-        fprintf (out, "color.overdue=bold_red\n");
-        fprintf (out, "color.due=bold_yellow\n");
-        fprintf (out, "color.pri.H=bold\n");
-        fprintf (out, "#color.pri.M=on_yellow\n");
-        fprintf (out, "#color.pri.L=on_green\n");
-        fprintf (out, "#color.pri.none=white on_blue\n");
-        fprintf (out, "color.active=bold_cyan\n");
-        fprintf (out, "color.tagged=yellow\n");
-        fprintf (out, "#color.tag.bug=yellow\n");
-        fprintf (out, "#color.project.garden=on_green\n");
-        fprintf (out, "#color.keyword.car=on_blue\n");
-        fprintf (out, "#color.recurring=on_red\n");
-        fprintf (out, "#shadow.file=%s/shadow.txt\n", dataDir.c_str ());
-        fprintf (out, "#shadow.command=list\n");
-        fprintf (out, "#shadow.notify=on\n");
-        fprintf (out, "#default.project=foo\n");
-        fprintf (out, "#default.priority=M\n");
-        fprintf (out, "default.command=list\n");
-
-        // Custom reports.
-        fprintf (out, "# Fields: id,uuid,project,priority,entry,start,due,recur,age,active,tags,description\n");
-        fprintf (out, "#         description_only\n");
-        fprintf (out, "# Description:   This report is ...\n");
-        fprintf (out, "# Sort:          due+,priority-,project+\n");
-        fprintf (out, "# Filter:        pro:x pri:H +bug\n");
-        fprintf (out, "# Limit:         10\n");
-
-        fprintf (out, "report.long.description=Lists all task, all data, matching the specified criteria\n");
-        fprintf (out, "report.long.columns=id,project,priority,entry,start,due,recur,age,tags,description\n");
-        fprintf (out, "report.long.sort=due+,priority-,project+\n");
-
-        fprintf (out, "report.list.description=Lists all tasks matching the specified criteria\n");
-        fprintf (out, "report.list.columns=id,project,priority,due,active,age,description\n");
-        fprintf (out, "report.list.sort=due+,priority-,project+\n");
-
-        fprintf (out, "report.ls.description=Minimal listing of all tasks matching the specified criteria\n");
-        fprintf (out, "report.ls.columns=id,project,priority,description\n");
-        fprintf (out, "report.ls.sort=priority-,project+\n");
-
-        fprintf (out, "report.newest.description=Shows the newest tasks\n");
-        fprintf (out, "report.newest.columns=id,project,priority,due,active,age,description\n");
-        fprintf (out, "report.newest.sort=id-\n");
-        fprintf (out, "report.newest.limit=10\n");
-
-        fprintf (out, "report.oldest.description=Shows the oldest tasks\n");
-        fprintf (out, "report.oldest.columns=id,project,priority,due,active,age,description\n");
-        fprintf (out, "report.oldest.sort=id+\n");
-        fprintf (out, "report.oldest.limit=10\n");
-
-        fclose (out);
-
-        std::cout << "Done." << std::endl;
+        else
+          throw std::string ("Malformed entry '") + line + "'";
       }
     }
   }
-
-  this->load (rcFile);
-
-  if (-1 == access (dataDir.c_str (), F_OK))
-    mkdir (dataDir.c_str (), S_IRWXU);
 }
 
 ////////////////////////////////////////////////////////////////////////////////
-// Return the configuration value given the specified key.
-const std::string Config::get (const char* key)
+void Config::createDefaultRC (const std::string& rc, const std::string& data)
 {
-  return this->get (std::string (key));
+  // Override data.location in the defaults.
+  std::string::size_type loc = defaults.find ("data.location=~/.task");
+  //                                      loc+0^          +14^   +21^
+
+  Date now;
+  std::stringstream contents;
+  contents << "# [Created by "
+           << PACKAGE_STRING
+           << " "
+           << now.toStringWithTime ()
+           << "]\n"
+           << defaults.substr (0, loc + 14)
+           << data
+           << defaults.substr (loc + 21);
+
+  // Write out the new file.
+  if (! File::write (rc, contents.str ()))
+    throw std::string ("Could not write to '") + rc + "'";
 }
 
 ////////////////////////////////////////////////////////////////////////////////
-// Return the configuration value given the specified key.  If a default_value
-// is present, it will be the returned value in the event of a missing key.
-const std::string Config::get (
-  const char* key,
-  const char* default_value)
+void Config::createDefaultData (const std::string& data)
 {
-  return this->get (std::string (key), std::string (default_value));
+  Directory d (data);
+  if (! d.exists ())
+    d.create ();
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Config::setDefaults ()
+{
+  parse (defaults);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Config::clear ()
+{
+  std::map <std::string, std::string>::clear ();
 }
 
 ////////////////////////////////////////////////////////////////////////////////
@@ -242,56 +443,42 @@ const std::string Config::get (const std::string& key)
 }
 
 ////////////////////////////////////////////////////////////////////////////////
-// Return the configuration value given the specified key.  If a default_value
-// is present, it will be the returned value in the event of a missing key.
-const std::string Config::get (
-  const std::string& key,
-  const std::string& default_value)
+const int Config::getInteger (const std::string& key)
 {
   if ((*this).find (key) != (*this).end ())
-    return (*this)[key];
+    return atoi ((*this)[key].c_str ());
 
-  return default_value;
+  return 0;
 }
 
 ////////////////////////////////////////////////////////////////////////////////
-bool Config::get (const std::string& key, bool default_value)
+const double Config::getReal (const std::string& key)
+{
+  if ((*this).find (key) != (*this).end ())
+    return atof ((*this)[key].c_str ());
+
+  return 0.0;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+const bool Config::getBoolean (const std::string& key)
 {
   if ((*this).find (key) != (*this).end ())
   {
     std::string value = lowerCase ((*this)[key]);
-
-    if (value == "t"      ||
-        value == "true"   ||
-        value == "1"      ||
-        value == "yes"    ||
-        value == "on"     ||
-        value == "enable" ||
-        value == "enabled")
+    if (value == "t"      ||  // TODO i18n
+        value == "true"   ||  // TODO i18n
+        value == "1"      ||  // no i18n
+        value == "+"      ||  // no i18n
+        value == "y"      ||  // TODO i18n
+        value == "yes"    ||  // TODO i18n
+        value == "on"     ||  // TODO i18n
+        value == "enable" ||  // TODO i18n
+        value == "enabled")   // TODO i18n
       return true;
-
-    return false;
   }
 
-  return default_value;
-}
-
-////////////////////////////////////////////////////////////////////////////////
-int Config::get (const std::string& key, const int default_value)
-{
-  if ((*this).find (key) != (*this).end ())
-    return ::atoi ((*this)[key].c_str ());
-
-  return default_value;
-}
-
-////////////////////////////////////////////////////////////////////////////////
-double Config::get (const std::string& key, const double default_value)
-{
-  if ((*this).find (key) != (*this).end ())
-    return ::atof ((*this)[key].c_str ());
-
-  return default_value;
+  return false;
 }
 
 ////////////////////////////////////////////////////////////////////////////////
@@ -325,3 +512,37 @@ void Config::all (std::vector<std::string>& items)
 }
 
 ////////////////////////////////////////////////////////////////////////////////
+std::string Config::checkForDeprecatedColor ()
+{
+  int count = 0;
+  std::vector <std::string> deprecated;
+  foreach (i, *this)
+  {
+    if (i->first.find ("color.") != std::string::npos)
+    {
+      std::string value = get (i->first);
+      if (value.find ("_") != std::string::npos)
+      {
+        ++count;
+        deprecated.push_back (i->first);
+      }
+    }
+  }
+
+  std::stringstream out;
+  if (count)
+  {
+    out << "Your .taskrc file contains color settings that use deprecated "
+        << "underscores.  Please check:"
+        << std::endl;
+
+    foreach (i, deprecated)
+      out << "  " << *i << "=" << get (*i) << std::endl;
+
+    out << std::endl;
+  }
+
+  return out.str ();
+}
+
+////////////////////////////////////////////////////////////////////////////////

src/Config.h

@@ -1,7 +1,7 @@
 ////////////////////////////////////////////////////////////////////////////////
 // task - a command line task list manager.
 //
-// Copyright 2006 - 2009, Paul Beckingham.
+// Copyright 2006 - 2010, Paul Beckingham.
 // All rights reserved.
 //
 // This program is free software; you can redistribute it and/or modify it under
@@ -30,6 +30,7 @@
 #include <map>
 #include <vector>
 #include <string>
+#include "File.h"
 
 class Config : public std::map <std::string, std::string>
 {
@@ -37,20 +38,34 @@ public:
   Config ();
   Config (const std::string&);
 
-  bool load (const std::string&);
-  void createDefault (const std::string&);
+  Config (const Config&);
+  Config& operator= (const Config&);
+
+  void load (const std::string&, int nest = 1);
+  void parse (const std::string&, int nest = 1);
+
+  void createDefaultRC (const std::string&, const std::string&);
+  void createDefaultData (const std::string&);
+  void setDefaults ();
+  void clear ();
+
+  const std::string get        (const std::string&);
+  const int         getInteger (const std::string&);
+  const double      getReal    (const std::string&);
+  const bool        getBoolean (const std::string&);
 
-  const std::string get (const char*);
-  const std::string get (const char*, const char*);
-  const std::string get (const std::string&);
-  const std::string get (const std::string&, const std::string&);
-  bool get (const std::string&, bool);
-  int get (const std::string&, const int);
-  double get (const std::string&, const double);
   void set (const std::string&, const int);
   void set (const std::string&, const double);
   void set (const std::string&, const std::string&);
   void all (std::vector <std::string>&);
+
+  std::string checkForDeprecatedColor ();
+
+public:
+  File original_file;
+
+private:
+  static std::string defaults;
 };
 
 #endif

src/Context.cpp

@@ -0,0 +1,871 @@
+////////////////////////////////////////////////////////////////////////////////
+// task - a command line task list manager.
+//
+// Copyright 2006 - 2010, Paul Beckingham.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program 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.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+////////////////////////////////////////////////////////////////////////////////
+
+#include <iostream>
+#include <fstream>
+#include <pwd.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+#include "Context.h"
+#include "Directory.h"
+#include "File.h"
+#include "Timer.h"
+#include "text.h"
+#include "util.h"
+#include "main.h"
+#include "i18n.h"
+#include "../auto.h"
+
+////////////////////////////////////////////////////////////////////////////////
+Context::Context ()
+: config ()
+, filter ()
+, keymap ()
+, sequence ()
+, subst ()
+, task ()
+, tdb ()
+, stringtable ()
+, program ("")
+, file_override ("")
+, var_overrides ("")
+, cmd ()
+, inShadow (false)
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Context::~Context ()
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Context::initialize (int argc, char** argv)
+{
+  // Capture the args.
+  for (int i = 0; i < argc; ++i)
+  {
+    if (i == 0)
+    {
+      program = argv[i];
+      std::string::size_type cal = program.find ("/cal");
+      if (program == "cal" ||
+          (cal != std::string::npos && program.length () == cal + 4))
+        args.push_back ("calendar");
+    }
+    else
+      args.push_back (argv[i]);
+  }
+
+  initialize ();
+
+  // Hook system init, plus post-start event occurring at the first possible
+  // moment after hook initialization.
+  hooks.initialize ();
+  hooks.trigger ("post-start");
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Context::initialize ()
+{
+  Timer t ("Context::initialize");
+
+  // Load the configuration file from the home directory.  If the file cannot
+  // be found, offer to create a sample one.
+  loadCorrectConfigFile ();
+  loadAliases ();
+
+  // When redirecting output to a file, do not use color, curses.
+  if (!isatty (fileno (stdout)))
+  {
+    config.set ("curses", "off");
+
+    if (! config.getBoolean ("_forcecolor"))
+      config.set ("color",  "off");
+  }
+
+  if (config.getBoolean ("color"))
+    initializeColorRules ();
+
+  // Load appropriate stringtable as soon after the config file as possible, to
+  // allow all subsequent messages to be localizable.
+  Directory location (config.get ("data.location"));
+  std::string locale = config.get ("locale");
+
+  // If there is a locale variant (en-US.<variant>), then strip it.
+  std::string::size_type period = locale.find ('.');
+  if (period != std::string::npos)
+    locale = locale.substr (0, period);
+
+  if (locale != "")
+    stringtable.load (location.data + "/strings." + locale);
+
+  // TODO Handle "--version, -v" right here?
+
+  // init TDB.
+  tdb.clear ();
+  std::vector <std::string> all;
+  split (all, location, ',');
+  foreach (path, all)
+    tdb.location (*path);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+int Context::run ()
+{
+  int rc;
+  std::string output;
+  try
+  {
+    parse ();               // Parse command line.
+    rc = dispatch (output); // Dispatch to command handlers.
+  }
+
+  catch (const std::string& error)
+  {
+    footnote (error);
+    rc = 2;
+  }
+
+  catch (...)
+  {
+    footnote (stringtable.get (100, "Unknown error."));
+    rc = 3;
+  }
+
+  // Dump all debug messages.
+  hooks.trigger ("pre-debug");
+  if (config.getBoolean ("debug"))
+    foreach (d, debugMessages)
+      if (config.getBoolean ("color") || config.getBoolean ("_forcecolor"))
+        std::cout << colorizeDebug (*d) << std::endl;
+      else
+        std::cout << *d << std::endl;
+  hooks.trigger ("post-debug");
+
+  // Dump all headers.
+  hooks.trigger ("pre-header");
+  foreach (h, headers)
+    if (config.getBoolean ("color") || config.getBoolean ("_forcecolor"))
+      std::cout << colorizeHeader (*h) << std::endl;
+    else
+      std::cout << *h << std::endl;
+  hooks.trigger ("post-header");
+
+  // Dump the report output.
+  hooks.trigger ("pre-output");
+  std::cout << output;
+  hooks.trigger ("post-output");
+
+  // Dump all footnotes.
+  hooks.trigger ("pre-footnote");
+  foreach (f, footnotes)
+    if (config.getBoolean ("color") || config.getBoolean ("_forcecolor"))
+      std::cout << colorizeFootnote (*f) << std::endl;
+    else
+      std::cout << *f << std::endl;
+  hooks.trigger ("post-footnote");
+
+  hooks.trigger ("pre-exit");
+  return rc;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+int Context::dispatch (std::string &out)
+{
+  int rc = 0;
+
+  Timer t ("Context::dispatch");
+
+  hooks.trigger ("pre-dispatch");
+
+  // TODO Just look at this thing.  It cries out for a dispatch table.
+       if (cmd.command == "projects")      { rc = handleProjects           (out); }
+  else if (cmd.command == "tags")          { rc = handleTags               (out); }
+  else if (cmd.command == "colors")        { rc = handleColor              (out); }
+  else if (cmd.command == "version")       { rc = handleVersion            (out); }
+  else if (cmd.command == "config")        { rc = handleConfig             (out); }
+  else if (cmd.command == "help")          { rc = longUsage                (out); }
+  else if (cmd.command == "stats")         { rc = handleReportStats        (out); }
+  else if (cmd.command == "info")          { rc = handleInfo               (out); }
+  else if (cmd.command == "history")       { rc = handleReportHistory      (out); }
+  else if (cmd.command == "ghistory")      { rc = handleReportGHistory     (out); }
+  else if (cmd.command == "summary")       { rc = handleReportSummary      (out); }
+  else if (cmd.command == "calendar")      { rc = handleReportCalendar     (out); }
+  else if (cmd.command == "timesheet")     { rc = handleReportTimesheet    (out); }
+  else if (cmd.command == "add")           { rc = handleAdd                (out); }
+  else if (cmd.command == "append")        { rc = handleAppend             (out); }
+  else if (cmd.command == "prepend")       { rc = handlePrepend            (out); }
+  else if (cmd.command == "annotate")      { rc = handleAnnotate           (out); }
+  else if (cmd.command == "done")          { rc = handleDone               (out); }
+  else if (cmd.command == "delete")        { rc = handleDelete             (out); }
+  else if (cmd.command == "start")         { rc = handleStart              (out); }
+  else if (cmd.command == "stop")          { rc = handleStop               (out); }
+  else if (cmd.command == "export")        { rc = handleExport             (out); }
+  else if (cmd.command == "import")        { rc = handleImport             (out); }
+  else if (cmd.command == "duplicate")     { rc = handleDuplicate          (out); }
+  else if (cmd.command == "edit")          { rc = handleEdit               (out); }
+#ifdef FEATURE_SHELL
+  else if (cmd.command == "shell")         {      handleShell              (   ); }
+#endif
+  else if (cmd.command == "undo")          {      handleUndo               (   ); }
+  else if (cmd.command == "_projects")     { rc = handleCompletionProjects (out); }
+  else if (cmd.command == "_tags")         { rc = handleCompletionTags     (out); }
+  else if (cmd.command == "_commands")     { rc = handleCompletionCommands (out); }
+  else if (cmd.command == "_ids")          { rc = handleCompletionIDs      (out); }
+  else if (cmd.command == "_config")       { rc = handleCompletionConfig   (out); }
+  else if (cmd.command == "_version")      { rc = handleCompletionVersion  (out); }
+  else if (cmd.command == "" &&
+           sequence.size ())               { rc = handleModify             (out); }
+
+  // Command that display IDs and therefore need TDB::gc first.
+  else if (cmd.command == "next")          { if (!inShadow) tdb.gc (); rc = handleReportNext (out); }
+  else if (cmd.validCustom (cmd.command))  { if (!inShadow) tdb.gc (); rc = handleCustomReport  (cmd.command, out); }
+
+  // If the command is not recognized, display usage.
+  else                                     { hooks.trigger ("pre-usage-command");
+                                             rc = shortUsage (out);
+                                             hooks.trigger ("post-usage-command"); }
+
+  // Only update the shadow file if such an update was not suppressed (shadow),
+  if (cmd.isWriteCommand () && !inShadow)
+    shadow ();
+
+  hooks.trigger ("post-dispatch");
+  return rc;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Context::shadow ()
+{
+  // Determine if shadow file is enabled.
+  File shadowFile (config.get ("shadow.file"));
+  if (shadowFile.data != "")
+  {
+    inShadow = true;  // Prevents recursion in case shadow command writes.
+
+    // TODO Reinstate these checks.
+/*
+    // Check for silly shadow file settings.
+    if (shadowFile == dataLocation + "/pending.data")
+      throw std::string ("Configuration variable 'shadow.file' is set to "
+                         "overwrite your pending tasks.  Please change it.");
+
+    if (shadowFile == dataLocation + "/completed.data")
+      throw std::string ("Configuration variable 'shadow.file' is set to "
+                         "overwrite your completed tasks.  Please change it.");
+*/
+
+    std::string oldCurses = config.get ("curses");
+    std::string oldColor  = config.get ("color");
+
+    clear ();
+
+    // Run report.  Use shadow.command, using default.command as a fallback
+    // with "list" as a default.
+    std::string command = config.get ("shadow.command");
+    if (command == "")
+      command = config.get ("default.command");
+
+    split (args, command, ' ');
+
+    initialize ();
+    config.set ("curses", "off");
+    config.set ("color",  "off");
+
+    parse ();
+    std::string result;
+    (void)dispatch (result);
+    std::ofstream out (shadowFile.data.c_str ());
+    if (out.good ())
+    {
+      out << result;
+      out.close ();
+    }
+    else
+      throw std::string ("Could not write file '") + shadowFile.data + "'";
+
+    config.set ("curses", oldCurses);
+    config.set ("color",  oldColor);
+
+    // Optionally display a notification that the shadow file was updated.
+    if (config.getBoolean ("shadow.notify"))
+      footnote (std::string ("[Shadow file '") + shadowFile.data + "' updated]");
+
+    inShadow = false;
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Only allows aliases 10 deep.
+std::string Context::canonicalize (const std::string& input) const
+{
+  std::string canonical = input;
+
+  // First try to autocomplete the alias.
+  std::vector <std::string> options;
+  std::vector <std::string> matches;
+  foreach (name, aliases)
+    options.push_back (name->first);
+
+  autoComplete (input, options, matches);
+  if (matches.size () == 1)
+  {
+    canonical = matches[0];
+
+    // Follow the chain.
+    int i = 10;  // Safety valve.
+    std::map <std::string, std::string>::const_iterator found;
+    while ((found = aliases.find (canonical)) != aliases.end () && i-- > 0)
+      canonical = found->second;
+
+    if (i < 1)
+      return input;
+  }
+
+  return canonical;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Context::disallowModification () const
+{
+  if (task.size ()         ||
+      subst.mFrom != ""    ||
+      tagAdditions.size () ||
+      tagRemovals.size ())
+    throw std::string ("The '")
+        + cmd.command
+        + "' command does not allow further modification of a task.";
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Context::loadCorrectConfigFile ()
+{
+  // Set up default locations.
+  struct passwd* pw = getpwuid (getuid ());
+  if (!pw)
+    throw std::string (
+      stringtable.get (
+        SHELL_READ_PASSWD,
+        "Could not read home directory from the passwd file."));
+
+  std::string home = pw->pw_dir;
+  File      rc   (home + "/.taskrc");
+  Directory data (home + "./task");
+
+  // Is there an file_override for rc:?
+  foreach (arg, args)
+  {
+    if (*arg == "--")
+      break;
+    else if (arg->substr (0, 3) == "rc:")
+    {
+      file_override = *arg;
+      rc = File (arg->substr (3));
+
+      home = rc;
+      std::string::size_type last_slash = rc.data.rfind ("/");
+      if (last_slash != std::string::npos)
+        home = rc.data.substr (0, last_slash);
+      else
+        home = ".";
+
+      args.erase (arg);
+      header ("Using alternate .taskrc file " + rc.data); // TODO i18n
+      break;
+    }
+  }
+
+  // Load rc file.
+  config.clear ();       // Dump current values.
+  config.load  (rc);     // Load new file.
+
+  if (config.get ("data.location") != "")
+    data = Directory (config.get ("data.location"));
+
+  // Are there any var_overrides for data.location?
+  foreach (arg, args)
+  {
+    if (*arg == "--")
+      break;
+    else if (arg->substr (0, 17) == "rc.data.location:" ||
+             arg->substr (0, 17) == "rc.data.location=")
+    {
+      data = Directory (arg->substr (17));
+      header ("Using alternate data.location " + data.data); // TODO i18n
+      break;
+    }
+  }
+
+  // Do we need to create a default rc?
+  if (! rc.exists ())
+  {
+    if (confirm ("A configuration file could not be found in " // TODO i18n
+               + home
+               + "\n\n"
+               + "Would you like a sample "
+               + rc.data
+               + " created, so task can proceed?"))
+    {
+      config.createDefaultRC (rc, data);
+    }
+    else
+      throw std::string ("Cannot proceed without rc file.");
+  }
+
+  // Create data location, if necessary.
+  config.createDefaultData (data);
+
+  // TODO find out why this was done twice - see tw #355
+  // Load rc file.
+  //config.clear ();       // Dump current values.
+  //config.setDefaults (); // Add in the custom reports.
+  //config.load (rc);      // Load new file.
+
+  // Apply overrides of type: "rc.name:value", or "rc.name=value".
+  std::vector <std::string> filtered;
+  bool foundTerminator = false;
+  foreach (arg, args)
+  {
+    if (*arg == "--")
+    {
+      foundTerminator = true;
+      filtered.push_back (*arg);
+    }
+    else if (!foundTerminator &&
+             arg->substr (0, 3) == "rc.")
+    {
+      std::string name;
+      std::string value;
+      Nibbler n (*arg);
+      if (n.getUntil ('.', name)       &&
+          n.skip ('.')                 &&
+          n.getUntilOneOf (":=", name) &&
+          n.skipN (1)                  &&
+          n.getUntilEOS (value))
+      {
+        config.set (name, value);
+        var_overrides += " " + *arg;
+        footnote (std::string ("Configuration override ") +  // TODO i18n
+                  arg->substr (3));
+      }
+    }
+    else
+      filtered.push_back (*arg);
+  }
+
+  args = filtered;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Context::loadAliases ()
+{
+  aliases.clear ();
+
+  std::vector <std::string> vars;
+  config.all (vars);
+  foreach (var, vars)
+  {
+    if (var->substr (0, 6) == "alias.")
+    {
+      std::string alias = var->substr (6);
+      std::string canonical = config.get (*var);
+
+      aliases[alias] = canonical;
+      debug (std::string ("Alias ") + alias + " -> " + canonical);
+    }
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Context::parse ()
+{
+  parse (args, cmd, task, sequence, subst, filter);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Context::parse (
+  std::vector <std::string>& parseArgs,
+  Cmd& parseCmd,
+  Task& parseTask,
+  Sequence& parseSequence,
+  Subst& parseSubst,
+  Filter& parseFilter)
+{
+  Timer t ("Context::parse");
+
+  Att attribute;
+  tagAdditions.clear ();
+  tagRemovals.clear ();
+  std::string descCandidate        = "";
+  bool terminated                  = false;
+  bool foundSequence               = false;
+  bool foundSomethingAfterSequence = false;
+
+  foreach (arg, parseArgs)
+  {
+    if (!terminated)
+    {
+      // The '--' argument shuts off all parsing - everything is an argument.
+      if (*arg == "--")
+      {
+        debug ("parse terminator '" + *arg + "'");
+        terminated = true;
+      }
+
+      // Sequence
+      // Note: "add" doesn't require an ID
+      else if (parseCmd.command != "add"          &&
+               ! foundSomethingAfterSequence &&
+               parseSequence.valid (*arg))
+      {
+        debug ("parse sequence '" + *arg + "'");
+        parseSequence.parse (*arg);
+        foundSequence = true;
+      }
+
+      // Tags to include begin with '+'.
+      else if (arg->length () > 1 &&
+               (*arg)[0] == '+'   &&
+               noSpaces (*arg))
+      {
+        debug ("parse tag addition '" + *arg + "'");
+        if (foundSequence)
+          foundSomethingAfterSequence = true;
+
+        if (arg->find (',') != std::string::npos)
+          throw stringtable.get (TAGS_NO_COMMA,
+                                 "Tags are not permitted to contain commas.");
+
+        tagAdditions.push_back (arg->substr (1));
+        parseTask.addTag       (arg->substr (1));
+      }
+
+      // Tags to remove begin with '-'.
+      else if (arg->length () > 1 &&
+               (*arg)[0] == '-'   &&
+               noSpaces (*arg))
+      {
+        debug ("parse tag removal '" + *arg + "'");
+        if (foundSequence)
+          foundSomethingAfterSequence = true;
+
+        if (arg->find (',') != std::string::npos)
+          throw stringtable.get (TAGS_NO_COMMA,
+                                 "Tags are not permitted to contain commas.");
+
+        tagRemovals.push_back (arg->substr (1));
+      }
+
+      // Atributes - name[.mod]:[value]
+      else if (attribute.valid (*arg))
+      {
+        debug ("parse attribute '" + *arg + "'");
+        if (foundSequence)
+          foundSomethingAfterSequence = true;
+
+        attribute.parse (*arg);
+
+        // There has to be a better way.  And it starts with a fresh coffee.
+        std::string name = attribute.name ();
+        std::string mod = attribute.mod ();
+        std::string value = attribute.value ();
+        if (attribute.validNameValue (name, mod, value))
+        {
+          attribute.name (name);
+          attribute.mod (mod);
+          attribute.value (value);
+
+          // Preserve modifier in the key, to allow multiple modifiers on the
+          // same attribute.  Bug #252.
+          if (name != "" && mod != "")
+            parseTask[name + "." + mod] = attribute;
+          else
+            parseTask[name] = attribute;
+
+          autoFilter (attribute, parseFilter);
+        }
+
+        // *arg has the appearance of an attribute (foo:bar), but isn't
+        // recognized, so downgrade it to part of the description.
+        else
+        {
+          if (foundSequence)
+            foundSomethingAfterSequence = true;
+
+          if (descCandidate.length ())
+            descCandidate += " ";
+          descCandidate += *arg;
+        }
+      }
+
+      // Substitution of description and/or annotation text.
+      else if (parseSubst.valid (*arg))
+      {
+        if (foundSequence)
+          foundSomethingAfterSequence = true;
+
+        debug ("parse subst '" + *arg + "'");
+        parseSubst.parse (*arg);
+      }
+
+      // It might be a command if one has not already been found.
+      else if (parseCmd.command == "" &&
+               parseCmd.valid (*arg))
+      {
+        debug ("parse cmd '" + *arg + "'");
+        parseCmd.parse (*arg);
+
+        if (foundSequence)
+          foundSomethingAfterSequence = true;
+      }
+
+      // Anything else is just considered description.
+      else
+      {
+        if (foundSequence)
+          foundSomethingAfterSequence = true;
+
+        if (descCandidate.length ())
+          descCandidate += " ";
+        descCandidate += *arg;
+      }
+    }
+
+    // Command is terminated, therefore everything subsequently is a description.
+    else
+    {
+      debug ("parse post-termination description '" + *arg + "'");
+      if (foundSequence)
+        foundSomethingAfterSequence = true;
+
+      if (descCandidate.length ())
+        descCandidate += " ";
+      descCandidate += *arg;
+    }
+  }
+
+  if (descCandidate != "" && noVerticalSpace (descCandidate))
+  {
+    debug ("parse description '" + descCandidate + "'");
+    parseTask.set ("description", descCandidate);
+
+    // Now convert the description to a filter on each word, if necessary.
+    if (parseCmd.isReadOnlyCommand ())
+    {
+      std::vector <std::string> words;
+      split (words, descCandidate, ' ');
+      std::vector <std::string>::iterator it;
+      for (it = words.begin (); it != words.end (); ++it)
+      {
+        Att a ("description", "contains", *it);
+        autoFilter (a, parseFilter);
+      }
+    }
+  }
+
+  // At this point, either a sequence or a command should have been found.
+  if (parseSequence.size () == 0 && parseCmd.command == "")
+    parseCmd.parse (descCandidate);
+
+  // Read-only command (reports, status, info ...) use filters.  Write commands
+  // (add, done ...) do not.  The filter was constructed iteratively above, but
+  // tags were omitted, so they are added now.
+  if (parseCmd.isReadOnlyCommand ())
+    autoFilter (parseFilter);
+
+  // If no command was specified, and there were no command line arguments
+  // then invoke the default command.
+  if (parseCmd.command == "" && parseArgs.size () == 0)
+  {
+    // Apply overrides, if any.
+    std::string defaultCommand = config.get ("default.command");
+    if (defaultCommand != "")
+    {
+      // Add on the overrides.
+      defaultCommand += " " + file_override + " " + var_overrides;
+
+      // Stuff the command line.
+      args.clear ();
+      split (args, defaultCommand, ' ');
+      header ("[task " + trim (defaultCommand) + "]");
+
+      // Reinitialize the context and recurse.
+      file_override = "";
+      var_overrides = "";
+      footnotes.clear ();
+      initialize ();
+      parse (args, cmd, task, sequence, subst, filter);
+    }
+    else
+      throw stringtable.get (
+        CMD_MISSING,
+        "You must specify a command, or a task ID to modify");
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Note: The reason some of these are commented out is because the ::clear
+// method is not really "clear" but "clear_some".  Some members do not need to
+// be initialized.  That makes this method something of a misnomer.  So be it.
+void Context::clear ()
+{
+//  Config                    config;
+  filter.clear ();
+//  Keymap                    keymap;
+  sequence.clear ();
+  subst.clear ();
+//  task.clear ();
+  task = Task ();
+  tdb.clear ();
+//  stringtable.clear ();
+  program = "";
+  args.clear ();
+  file_override = "";
+  var_overrides = "";
+  cmd.command = "";
+  tagAdditions.clear ();
+  tagRemovals.clear ();
+
+  clearMessages ();
+  inShadow = false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Add all the attributes in the task to the filter.  All except uuid.
+void Context::autoFilter (Att& a, Filter& f)
+{
+  // Words are found in the description using the .has modifier.
+  if (a.name () == "description" && a.mod () == "")
+  {
+    std::vector <std::string> words;
+    split (words, a.value (), ' ');
+    foreach (word, words)
+    {
+      f.push_back (Att ("description", "has", *word));
+      debug ("auto filter: " + a.name () + ".has:" + *word);
+    }
+  }
+
+  // Projects are matched left-most.
+  else if (a.name () == "project" && a.mod () == "")
+  {
+    if (a.value () != "")
+    {
+      f.push_back (Att ("project", "startswith", a.value ()));
+      debug ("auto filter: " + a.name () + ".startswith:" + a.value ());
+    }
+    else
+    {
+      f.push_back (Att ("project", "is", a.value ()));
+      debug ("auto filter: " + a.name () + ".is:" + a.value ());
+    }
+  }
+
+  // The limit attribute does not participate in filtering, and needs to be
+  // specifically handled in handleCustomReport.
+  else if (a.name () == "limit")
+  {
+  }
+
+  // Every task has a unique uuid by default, and it shouldn't be included,
+  // because it is guaranteed to not match.
+  else if (a.name () == "uuid")
+  {
+  }
+
+  // The mechanism for filtering on tags is +/-<tag>.
+  // Do not handle here - see below.
+  else if (a.name () == "tags")
+  {
+  }
+
+  // Generic attribute matching.
+  else
+  {
+    f.push_back (a);
+    debug ("auto filter: " +
+           a.name () +
+           (a.mod () != "" ?
+             ("." + a.mod () + ":") :
+             ":") +
+           a.value ());
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+// Add all the tags in the task to the filter.
+void Context::autoFilter (Filter& f)
+{
+  // This is now a correct implementation of a filter on the presence or absence
+  // of a tag.  The prior code provided the illusion of leftmost partial tag
+  // matches, but was really using the 'contains' and 'nocontains' attribute
+  // modifiers.  See bug #293.
+
+  // Include tagAdditions.
+  foreach (tag, tagAdditions)
+  {
+    f.push_back (Att ("tags", "word", *tag));
+    debug ("auto filter: +" + *tag);
+  }
+
+  // Include tagRemovals.
+  foreach (tag, tagRemovals)
+  {
+    f.push_back (Att ("tags", "noword", *tag));
+    debug ("auto filter: -" + *tag);
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Context::header (const std::string& input)
+{
+  headers.push_back (input);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Context::footnote (const std::string& input)
+{
+  footnotes.push_back (input);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Context::debug (const std::string& input)
+{
+  debugMessages.push_back (input);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Context::clearMessages ()
+{
+  headers.clear ();
+  footnotes.clear ();
+  debugMessages.clear ();
+}
+
+////////////////////////////////////////////////////////////////////////////////

src/Context.h

@@ -0,0 +1,104 @@
+////////////////////////////////////////////////////////////////////////////////
+// task - a command line task list manager.
+//
+// Copyright 2006 - 2010, Paul Beckingham.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program 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.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+////////////////////////////////////////////////////////////////////////////////
+#ifndef INCLUDED_CONTEXT
+#define INCLUDED_CONTEXT
+
+#include "Filter.h"
+#include "Keymap.h"
+#include "Config.h"
+#include "Sequence.h"
+#include "Subst.h"
+#include "Cmd.h"
+#include "Task.h"
+#include "TDB.h"
+#include "StringTable.h"
+#include "Hooks.h"
+
+class Context
+{
+public:
+  Context ();                          // Default constructor
+  ~Context ();                         // Destructor
+
+  Context (const Context&);
+  Context& operator= (const Context&);
+
+  void initialize (int, char**);       // all startup
+  void initialize ();                  // for reinitializing
+  int run ();                          // task classic
+  int interactive ();                  // task interactive (not implemented)
+  int dispatch (std::string&);         // command handler dispatch
+  void shadow ();                      // shadow file update
+
+  int getWidth ();                     // determine terminal width
+
+  void header (const std::string&);    // Header message sink
+  void footnote (const std::string&);  // Footnote message sink
+  void debug (const std::string&);     // Debug message sink
+  void clearMessages ();
+
+  void parse ();
+  void parse (std::vector <std::string>&, Cmd&, Task&, Sequence&, Subst&, Filter&);
+  void clear ();
+
+  std::string canonicalize (const std::string&) const;
+  void disallowModification () const;
+
+private:
+  void loadCorrectConfigFile ();
+  void loadAliases ();
+  void autoFilter (Att&, Filter&);
+  void autoFilter (Filter&);
+
+public:
+  Config                    config;
+  Filter                    filter;
+  Keymap                    keymap;
+  Sequence                  sequence;
+  Subst                     subst;
+  Task                      task;
+  TDB                       tdb;
+  StringTable               stringtable;
+  std::string               program;
+  std::vector <std::string> args;
+  std::string               file_override;
+  std::string               var_overrides;
+  Cmd                       cmd;
+  std::map <std::string, std::string> aliases;
+  std::vector <std::string> tagAdditions;
+  std::vector <std::string> tagRemovals;
+  Hooks                     hooks;
+
+private:
+  std::vector <std::string> headers;
+  std::vector <std::string> footnotes;
+  std::vector <std::string> debugMessages;
+  bool                      inShadow;
+};
+
+#endif
+////////////////////////////////////////////////////////////////////////////////

src/Date.cpp

@@ -1,7 +1,7 @@
 ////////////////////////////////////////////////////////////////////////////////
 // task - a command line task list manager.
 //
-// Copyright 2006 - 2009, Paul Beckingham.
+// Copyright 2006 - 2010, Paul Beckingham, Federico Hernandez.
 // All rights reserved.
 //
 // This program is free software; you can redistribute it and/or modify it under
@@ -25,11 +25,17 @@
 //
 ////////////////////////////////////////////////////////////////////////////////
 #include <iostream>
+#include <sstream>
 #include <time.h>
 #include <assert.h>
 #include <stdlib.h>
-#include "task.h"
+#include <ctype.h>
 #include "Date.h"
+#include "text.h"
+#include "util.h"
+#include "Context.h"
+
+extern Context context;
 
 ////////////////////////////////////////////////////////////////////////////////
 // Defaults to "now".
@@ -49,9 +55,27 @@ Date::Date (const int m, const int d, const int y)
 {
   // Error if not valid.
   struct tm t = {0};
-  t.tm_mday = d;
-  t.tm_mon = m - 1;
-  t.tm_year = y - 1900;
+  t.tm_isdst = -1;   // Requests that mktime determine summer time effect.
+  t.tm_mday  = d;
+  t.tm_mon   = m - 1;
+  t.tm_year  = y - 1900;
+
+  mT = mktime (&t);
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Date::Date (const int m,  const int d,  const int y,
+            const int hr, const int mi, const int se)
+{
+  // Error if not valid.
+  struct tm t = {0};
+  t.tm_isdst = -1;   // Requests that mktime determine summer time effect.
+  t.tm_mday  = d;
+  t.tm_mon   = m - 1;
+  t.tm_year  = y - 1900;
+  t.tm_hour  = hr;
+  t.tm_min   = mi;
+  t.tm_sec   = se;
 
   mT = mktime (&t);
 }
@@ -59,9 +83,16 @@ Date::Date (const int m, const int d, const int y)
 ////////////////////////////////////////////////////////////////////////////////
 Date::Date (const std::string& mdy, const std::string& format /* = "m/d/Y" */)
 {
-  int month = 0;
-  int day   = 0;
-  int year  = 0;
+  int month  = 0;
+  int day    = 0;
+  int year   = 0;
+  int hour   = 0;
+  int minute = 0;
+  int second = 0;
+
+  // Perhaps it is an epoch date, in string form?
+  if (isEpoch (mdy))
+    return;
 
   // Before parsing according to "format", perhaps this is a relative date?
   if (isRelativeDate (mdy))
@@ -76,42 +107,42 @@ Date::Date (const std::string& mdy, const std::string& format /* = "m/d/Y" */)
     // Single or double digit.
     case 'm':
       if (i >= mdy.length () ||
-          ! ::isdigit (mdy[i]))
+          ! isdigit (mdy[i]))
       {
-        throw std::string ("\"") + mdy + "\" is not a valid date.";
+        throw std::string ("\"") + mdy + "\" is not a valid date (m).";
       }
 
-      if (i + 1 < mdy.length ()                                         &&
-          (mdy[i + 0] == '0' || mdy[i + 0] == '1')                      &&
-          ::isdigit (mdy[i + 1]))
+      if (i + 1 < mdy.length ()                    &&
+          (mdy[i + 0] == '0' || mdy[i + 0] == '1') &&
+          isdigit (mdy[i + 1]))
       {
-        month = ::atoi (mdy.substr (i, 2).c_str ());
+        month = atoi (mdy.substr (i, 2).c_str ());
         i += 2;
       }
       else
       {
-        month = ::atoi (mdy.substr (i, 1).c_str ());
+        month = atoi (mdy.substr (i, 1).c_str ());
         ++i;
       }
       break;
 
     case 'd':
       if (i >= mdy.length () ||
-          ! ::isdigit (mdy[i]))
+          ! isdigit (mdy[i]))
       {
-        throw std::string ("\"") + mdy + "\" is not a valid date.";
+        throw std::string ("\"") + mdy + "\" is not a valid date (d).";
       }
 
       if (i + 1 < mdy.length ()                                                              &&
           (mdy[i + 0] == '0' || mdy[i + 0] == '1' || mdy[i + 0] == '2' || mdy[i + 0] == '3') &&
-          ::isdigit (mdy[i + 1]))
+          isdigit (mdy[i + 1]))
       {
-        day = ::atoi (mdy.substr (i, 2).c_str ());
+        day = atoi (mdy.substr (i, 2).c_str ());
         i += 2;
       }
       else
       {
-        day = ::atoi (mdy.substr (i, 1).c_str ());
+        day = atoi (mdy.substr (i, 1).c_str ());
         ++i;
       }
       break;
@@ -119,74 +150,202 @@ Date::Date (const std::string& mdy, const std::string& format /* = "m/d/Y" */)
     // Double digit.
     case 'y':
       if (i + 1 >= mdy.length () ||
-          ! ::isdigit (mdy[i + 0]) ||
-          ! ::isdigit (mdy[i + 1]))
+          ! isdigit (mdy[i + 0]) ||
+          ! isdigit (mdy[i + 1]))
       {
-        throw std::string ("\"") + mdy + "\" is not a valid date.";
+        throw std::string ("\"") + mdy + "\" is not a valid date (y).";
       }
 
-      year = ::atoi (mdy.substr (i, 2).c_str ()) + 2000;
+      year = atoi (mdy.substr (i, 2).c_str ()) + 2000;
       i += 2;
       break;
 
     case 'M':
       if (i + 1 >= mdy.length () ||
-          ! ::isdigit (mdy[i + 0]) ||
-          ! ::isdigit (mdy[i + 1]))
+          ! isdigit (mdy[i + 0]) ||
+          ! isdigit (mdy[i + 1]))
       {
-        throw std::string ("\"") + mdy + "\" is not a valid date.";
+        throw std::string ("\"") + mdy + "\" is not a valid date (M).";
       }
 
-      month = ::atoi (mdy.substr (i, 2).c_str ());
+      month = atoi (mdy.substr (i, 2).c_str ());
       i += 2;
       break;
 
     case 'D':
       if (i + 1 >= mdy.length () ||
-          ! ::isdigit (mdy[i + 0]) ||
-          ! ::isdigit (mdy[i + 1]))
+          ! isdigit (mdy[i + 0]) ||
+          ! isdigit (mdy[i + 1]))
       {
-        throw std::string ("\"") + mdy + "\" is not a valid date.";
+        throw std::string ("\"") + mdy + "\" is not a valid date (D).";
+      }
+
+      day = atoi (mdy.substr (i, 2).c_str ());
+      i += 2;
+      break;
+
+    case 'V':
+      if (i + 1 >= mdy.length () ||
+          ! isdigit (mdy[i + 0]) ||
+          ! isdigit (mdy[i + 1]))
+      {
+        throw std::string ("\"") + mdy + "\" is not a valid date (V).";
       }
 
-      day = ::atoi (mdy.substr (i, 2).c_str ());
       i += 2;
       break;
 
     // Quadruple digit.
     case 'Y':
       if (i + 3 >= mdy.length () ||
-          ! ::isdigit (mdy[i + 0]) ||
-          ! ::isdigit (mdy[i + 1]) ||
-          ! ::isdigit (mdy[i + 2]) ||
-          ! ::isdigit (mdy[i + 3]))
+          ! isdigit (mdy[i + 0]) ||
+          ! isdigit (mdy[i + 1]) ||
+          ! isdigit (mdy[i + 2]) ||
+          ! isdigit (mdy[i + 3]))
       {
-        throw std::string ("\"") + mdy + "\" is not a valid date.";
+        throw std::string ("\"") + mdy + "\" is not a valid date (Y).";
       }
 
-      year = ::atoi (mdy.substr (i, 4).c_str ());
+      year = atoi (mdy.substr (i, 4).c_str ());
       i += 4;
       break;
 
+    // Short names with 3 characters
+    case 'a':
+      if (i + 2 >= mdy.length () ||
+          isdigit (mdy[i + 0]) ||
+          isdigit (mdy[i + 1]) ||
+          isdigit (mdy[i + 2]))
+      {
+        throw std::string ("\"") + mdy + "\" is not a valid date (a).";
+      }
+
+      i += 3;
+      break;
+
+    case 'b':
+      if (i + 2 >= mdy.length () ||
+          isdigit (mdy[i + 0]) ||
+          isdigit (mdy[i + 1]) ||
+          isdigit (mdy[i + 2]))
+      {
+        throw std::string ("\"") + mdy + "\" is not a valid date (b).";
+      }
+
+      month = Date::monthOfYear (mdy.substr (i, 3).c_str());
+      i += 3;
+      break;
+
+    // Long names
+    case 'A':
+      if (i + 2 >= mdy.length () ||
+          isdigit (mdy[i + 0]) ||
+          isdigit (mdy[i + 1]) ||
+          isdigit (mdy[i + 2]))
+      {
+        throw std::string ("\"") + mdy + "\" is not a valid date (A).";
+      }
+
+      i += Date::dayName( Date::dayOfWeek (mdy.substr (i, 3).c_str()) ).size();
+      break;
+
+    case 'B':
+      if (i + 2 >= mdy.length () ||
+          isdigit (mdy[i + 0]) ||
+          isdigit (mdy[i + 1]) ||
+          isdigit (mdy[i + 2]))
+      {
+        throw std::string ("\"") + mdy + "\" is not a valid date (B).";
+      }
+
+      month = Date::monthOfYear (mdy.substr (i, 3).c_str());
+      i += Date::monthName(month).size();
+      break;
+
+    // Single or double digit.
+    case 'h':
+      if (i >= mdy.length () ||
+          ! isdigit (mdy[i]))
+      {
+        throw std::string ("\"") + mdy + "\" is not a valid date (h).";
+      }
+
+      if (i + 1 < mdy.length ()                    &&
+          (mdy[i + 0] == '0' || mdy[i + 0] == '1' || mdy[i + 0] == '2') &&
+          isdigit (mdy[i + 1]))
+      {
+        hour = atoi (mdy.substr (i, 2).c_str ());
+        i += 2;
+      }
+      else
+      {
+        hour = atoi (mdy.substr (i, 1).c_str ());
+        ++i;
+      }
+      break;
+
+    case 'H':
+      if (i + 1 >= mdy.length () ||
+          ! isdigit (mdy[i + 0]) ||
+          ! isdigit (mdy[i + 1]))
+      {
+        throw std::string ("\"") + mdy + "\" is not a valid date (H).";
+      }
+
+      hour = atoi (mdy.substr (i, 2).c_str ());
+      i += 2;
+      break;
+
+    case 'N':
+      if (i + 1 >= mdy.length () ||
+          ! isdigit (mdy[i + 0]) ||
+          ! isdigit (mdy[i + 1]))
+      {
+        throw std::string ("\"") + mdy + "\" is not a valid date (N).";
+      }
+
+      minute = atoi (mdy.substr (i, 2).c_str ());
+      i += 2;
+      break;
+
+    case 'S':
+      if (i + 1 >= mdy.length () ||
+          ! isdigit (mdy[i + 0]) ||
+          ! isdigit (mdy[i + 1]))
+      {
+        throw std::string ("\"") + mdy + "\" is not a valid date (S).";
+      }
+
+      second = atoi (mdy.substr (i, 2).c_str ());
+      i += 2;
+      break;
+
     default:
       if (i >= mdy.length () ||
           mdy[i] != format[f])
       {
-        throw std::string ("\"") + mdy + "\" is not a valid date.";
+        throw std::string ("\"") + mdy + "\" is not a valid date (DEFAULT).";
       }
       ++i;
       break;
     }
   }
 
-  if (!valid (month, day, year))
-    throw std::string ("\"") + mdy + "\" is not a valid date.";
+  if (i < mdy.length ())
+    throw std::string ("\"") + mdy + "\" is not a valid date in " + format + " format.";
 
-  // Duplicate Date::Date (const int, const int, const int);
+  if (!valid (month, day, year))
+    throw std::string ("\"") + mdy + "\" is not a valid date (VALID).";
+
+  // Convert to epoch.
   struct tm t = {0};
-  t.tm_mday = day;
-  t.tm_mon = month - 1;
-  t.tm_year = year - 1900;
+  t.tm_isdst = -1;   // Requests that mktime determine summer time effect.
+  t.tm_mday  = day;
+  t.tm_mon   = month - 1;
+  t.tm_year  = year - 1900;
+  t.tm_hour  = hour;
+  t.tm_min   = minute;
+  t.tm_sec   = second;
 
   mT = mktime (&t);
 }
@@ -208,6 +367,14 @@ time_t Date::toEpoch ()
   return mT;
 }
 
+////////////////////////////////////////////////////////////////////////////////
+std::string Date::toEpochString ()
+{
+  std::stringstream epoch;
+  epoch << mT;
+  return epoch.str ();
+}
+
 ////////////////////////////////////////////////////////////////////////////////
 void Date::toEpoch (time_t& epoch)
 {
@@ -238,13 +405,22 @@ const std::string Date::toString (const std::string& format /*= "m/d/Y" */) cons
     char c = localFormat[i];
     switch (c)
     {
-    case 'm': sprintf (buffer, "%d",   this->month ());      break;
-    case 'M': sprintf (buffer, "%02d", this->month ());      break;
-    case 'd': sprintf (buffer, "%d",   this->day ());        break;
-    case 'D': sprintf (buffer, "%02d", this->day ());        break;
-    case 'y': sprintf (buffer, "%02d", this->year () % 100); break;
-    case 'Y': sprintf (buffer, "%d",   this->year ());       break;
-    default:  sprintf (buffer, "%c",   c);                   break;
+    case 'm': sprintf (buffer, "%d",   this->month ());                        break;
+    case 'M': sprintf (buffer, "%02d", this->month ());                        break;
+    case 'd': sprintf (buffer, "%d",   this->day ());                          break;
+    case 'D': sprintf (buffer, "%02d", this->day ());                          break;
+    case 'y': sprintf (buffer, "%02d", this->year () % 100);                   break;
+    case 'Y': sprintf (buffer, "%d",   this->year ());                         break;
+    case 'a': sprintf (buffer, "%.3s", Date::dayName (dayOfWeek ()).c_str ()); break;
+    case 'A': sprintf (buffer, "%s",   Date::dayName (dayOfWeek ()).c_str ()); break;
+    case 'b': sprintf (buffer, "%.3s", Date::monthName (month ()).c_str ());   break;
+    case 'B': sprintf (buffer, "%.9s", Date::monthName (month ()).c_str ());   break;
+    case 'V': sprintf (buffer, "%02d", Date::weekOfYear (Date::dayOfWeek (context.config.get ("weekstart")))); break;
+    case 'h': sprintf (buffer, "%d",   this->hour ());                         break;
+    case 'H': sprintf (buffer, "%02d", this->hour ());                         break;
+    case 'N': sprintf (buffer, "%02d", this->minute ());                       break;
+    case 'S': sprintf (buffer, "%02d", this->second ());                       break;
+    default:  sprintf (buffer, "%c",   c);                                     break;
     }
 
     formatted += buffer;
@@ -253,6 +429,51 @@ const std::string Date::toString (const std::string& format /*= "m/d/Y" */) cons
   return formatted;
 }
 
+////////////////////////////////////////////////////////////////////////////////
+const std::string Date::toStringWithTime (const std::string& format /*= "m/d/Y" */) const
+{
+  // Format as above.
+  std::string formatted = toString (format);
+
+  char buffer[12];
+  sprintf (buffer, " %d:%02d:%02d", hour (), minute (), second ());
+  formatted += buffer;
+
+  return formatted;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool Date::valid (const std::string& input, const std::string& format)
+{
+  try
+  {
+    Date test (input, format);
+  }
+
+  catch (...)
+  {
+    return false;
+  }
+
+  return true;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool Date::valid (const int m, const int d, const int y, const int hr,
+                  const int mi, const int se)
+{
+  if (hr < 0 || hr > 23)
+    return false;
+
+  if (mi < 0 || mi > 59)
+    return false;
+
+  if (se < 0 || se > 59)
+    return false;
+
+  return Date::valid (m, d, y);
+}
+
 ////////////////////////////////////////////////////////////////////////////////
 bool Date::valid (const int m, const int d, const int y)
 {
@@ -277,9 +498,11 @@ bool Date::leapYear (int year)
 {
   bool ly = false;
 
-       if (!(year % 4))   ly = true;
-  else if (!(year % 400)) ly = true;
-  else if (!(year % 100)) ly = false;
+  // (year % 4 == 0) && (year % 100 !=0)  OR
+  // (year % 400 == 0)
+  // are leapyears
+
+  if (((!(year % 4)) && (year % 100)) || (!(year % 400))) ly = true;
 
   return ly;
 }
@@ -354,6 +577,28 @@ std::string Date::dayName (int dow)
   return days[dow];
 }
 
+////////////////////////////////////////////////////////////////////////////////
+int Date::weekOfYear (int weekStart) const
+{
+  struct tm* t = localtime (&mT);
+  char   weekStr[3];
+
+  if (weekStart == 0)
+    strftime(weekStr, sizeof(weekStr), "%U", t);
+  else if (weekStart == 1)
+    strftime(weekStr, sizeof(weekStr), "%V", t);
+  else
+    throw std::string ("The 'weekstart' configuration variable may "
+                       "only contain 'Sunday' or 'Monday'.");
+
+  int weekNumber = atoi (weekStr);
+
+  if (weekStart == 0)
+    weekNumber += 1;
+
+  return weekNumber;
+}
+
 ////////////////////////////////////////////////////////////////////////////////
 int Date::dayOfWeek () const
 {
@@ -366,17 +611,64 @@ int Date::dayOfWeek (const std::string& input)
 {
   std::string in = lowerCase (input);
 
-  if (in == "sunday")     return 0;
-  if (in == "monday")     return 1;
-  if (in == "tuesday")    return 2;
-  if (in == "wednesday")  return 3;
-  if (in == "thursday")   return 4;
-  if (in == "friday")     return 5;
-  if (in == "saturday")   return 6;
+  if (in == "sunday"    || in == "sun")   return 0;
+  if (in == "monday"    || in == "mon")   return 1;
+  if (in == "tuesday"   || in == "tue")   return 2;
+  if (in == "wednesday" || in == "wed")   return 3;
+  if (in == "thursday"  || in == "thu")   return 4;
+  if (in == "friday"    || in == "fri")   return 5;
+  if (in == "saturday"  || in == "sat")   return 6;
 
   return -1;
 }
 
+////////////////////////////////////////////////////////////////////////////////
+int Date::monthOfYear (const std::string& input)
+{
+  std::string in = lowerCase (input);
+
+  if (in == "january"   || in == "jan")     return  1;
+  if (in == "february"  || in == "feb")     return  2;
+  if (in == "march"     || in == "mar")     return  3;
+  if (in == "april"     || in == "apr")     return  4;
+  if (in == "may"       || in == "may")     return  5;
+  if (in == "june"      || in == "jun")     return  6;
+  if (in == "july"      || in == "jul")     return  7;
+  if (in == "august"    || in == "aug")     return  8;
+  if (in == "september" || in == "sep")     return  9;
+  if (in == "october"   || in == "oct")     return 10;
+  if (in == "november"  || in == "nov")     return 11;
+  if (in == "december"  || in == "dec")     return 12;
+
+  return -1;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+time_t Date::easter (int year)
+{
+  int Y = year;
+  int a = Y % 19;
+  int b = Y / 100;
+  int c = Y % 100;
+  int d = b / 4;
+  int e = b % 4;
+  int f = (b + 8) / 25;
+  int g = (b - f + 1) / 3;
+  int h = (19 * a + b - d - g + 15) % 30;
+  int i = c / 4;
+  int k = c % 4;
+  int L = (32 + 2 * e + 2 * i - h - k) % 7;
+  int m = (a + 11 * h + 22 * L) / 451;
+  int month = (h + L - 7 * m + 114) / 31;
+  int day = ((h + L - 7 * m + 114) % 31) + 1;
+  struct tm t = {0};
+  t.tm_isdst = -1;   // Requests that mktime determine summer time effect.
+  t.tm_mday  = day;
+  t.tm_mon   = month - 1;
+  t.tm_year  = year - 1900;
+  return mktime (&t);
+}
+
 ////////////////////////////////////////////////////////////////////////////////
 int Date::month () const
 {
@@ -398,6 +690,27 @@ int Date::year () const
   return t->tm_year + 1900;
 }
 
+////////////////////////////////////////////////////////////////////////////////
+int Date::hour () const
+{
+  struct tm* t = localtime (&mT);
+  return t->tm_hour;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+int Date::minute () const
+{
+  struct tm* t = localtime (&mT);
+  return t->tm_min;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+int Date::second () const
+{
+  struct tm* t = localtime (&mT);
+  return t->tm_sec;
+}
+
 ////////////////////////////////////////////////////////////////////////////////
 bool Date::operator== (const Date& rhs)
 {
@@ -434,6 +747,18 @@ bool Date::operator>= (const Date& rhs)
   return mT >= rhs.mT;
 }
 
+////////////////////////////////////////////////////////////////////////////////
+bool Date::sameHour (const Date& rhs)
+{
+  if (this->year ()  == rhs.year ()  &&
+      this->month () == rhs.month () &&
+      this->day ()   == rhs.day ()   &&
+      this->hour ()  == rhs.hour ())
+    return true;
+
+  return false;
+}
+
 ////////////////////////////////////////////////////////////////////////////////
 bool Date::sameDay (const Date& rhs)
 {
@@ -467,7 +792,7 @@ bool Date::sameYear (const Date& rhs)
 ////////////////////////////////////////////////////////////////////////////////
 Date Date::operator+ (const int delta)
 {
-  return Date::Date (mT + delta);
+  return Date (mT + delta);
 }
 
 ////////////////////////////////////////////////////////////////////////////////
@@ -490,6 +815,19 @@ time_t Date::operator- (const Date& rhs)
   return mT - rhs.mT;
 }
 
+////////////////////////////////////////////////////////////////////////////////
+bool Date::isEpoch (const std::string& input)
+{
+  if (digitsOnly (input) &&
+      input.length () > 8)
+  {
+    mT = (time_t) atoi (input.c_str ());
+    return true;
+  }
+
+  return false;
+}
+
 ////////////////////////////////////////////////////////////////////////////////
 // If the input string looks like a relative date, determine that date, set mT
 // and return true.
@@ -524,6 +862,13 @@ bool Date::isRelativeDate (const std::string& input)
   supported.push_back ("eow");
   supported.push_back ("eom");
   supported.push_back ("eoy");
+  supported.push_back ("goodfriday");
+  supported.push_back ("easter");
+  supported.push_back ("eastermonday");
+  supported.push_back ("ascension");
+  supported.push_back ("pentecost");
+  supported.push_back ("midsommar");
+  supported.push_back ("midsommarafton");
 
   std::vector <std::string> matches;
   if (autoComplete (in, supported, matches) == 1)
@@ -588,6 +933,60 @@ bool Date::isRelativeDate (const std::string& input)
       mT = then.mT;
       return true;
     }
+    else if (found == "goodfriday")
+    {
+      Date then (Date::easter(today.year()));
+      mT = then.mT - 86400*2;
+      return true;
+    }
+    else if (found == "easter")
+    {
+      Date then (Date::easter(today.year()));
+      mT = then.mT;
+      return true;
+    }
+    else if (found == "eastermonday")
+    {
+      Date then (Date::easter(today.year()));
+      mT = then.mT + 86400;
+      return true;
+    }
+    else if (found == "ascension")
+    {
+      Date then (Date::easter(today.year()));
+      mT = then.mT + 86400*39;
+      return true;
+    }
+    else if (found == "pentecost")
+    {
+      Date then (Date::easter(today.year()));
+      mT = then.mT + 86400*49;
+      return true;
+    }
+    else if (found == "midsommar")
+    {
+      for (int midsommar = 20; midsommar <= 26; midsommar++)
+      {
+        Date then (6, midsommar, today.year ());
+        if (6 == then.dayOfWeek ())
+        {
+          mT = then.mT;
+          return true;
+        }
+      }
+    }
+    else if (found == "midsommarafton")
+    {
+      for (int midsommar = 19; midsommar <= 25; midsommar++)
+      {
+        Date then (6, midsommar, today.year ());
+        if (5 == then.dayOfWeek ())
+        {
+          mT = then.mT;
+          return true;
+        }
+      }
+    }
   }
 
   // Support "21st" to indicate the next date that is the 21st day.
@@ -599,13 +998,13 @@ bool Date::isRelativeDate (const std::string& input)
 
     if (isdigit (input[1]))
     {
-      number = ::atoi (input.substr (0, 2).c_str ());
-      ordinal = lowerCase (input.substr (2, std::string::npos));
+      number = atoi (input.substr (0, 2).c_str ());
+      ordinal = lowerCase (input.substr (2));
     }
     else
     {
-      number = ::atoi (input.substr (0, 2).c_str ());
-      ordinal = lowerCase (input.substr (1, std::string::npos));
+      number = atoi (input.substr (0, 2).c_str ());
+      ordinal = lowerCase (input.substr (1));
     }
 
     // Sanity check.

src/Date.h

@@ -1,7 +1,7 @@
 ////////////////////////////////////////////////////////////////////////////////
 // task - a command line task list manager.
 //
-// Copyright 2006 - 2009, Paul Beckingham.
+// Copyright 2006 - 2010, Paul Beckingham, Federico Hernandez.
 // All rights reserved.
 //
 // This program is free software; you can redistribute it and/or modify it under
@@ -27,8 +27,10 @@
 #ifndef INCLUDED_DATE
 #define INCLUDED_DATE
 
+#include <stdio.h>
 #include <string>
 
+
 class Date;
 
 class Date
@@ -37,27 +39,39 @@ public:
            Date ();
            Date (time_t);
            Date (const int, const int, const int);
+           Date (const int, const int, const int, const int, const int, const int);
            Date (const std::string&, const std::string& format = "m/d/Y");
            Date (const Date&);
   virtual ~Date ();
 
   void toEpoch (time_t&);
   time_t toEpoch ();
+  std::string toEpochString ();
   void toMDY (int&, int&, int&);
   const std::string toString (const std::string& format = "m/d/Y") const;
+  const std::string toStringWithTime (const std::string& format = "m/d/Y") const;
+  static bool valid (const std::string&, const std::string& format = "m/d/Y");
+  static bool valid (const int, const int, const int, const int, const int, const int);
   static bool valid (const int, const int, const int);
 
+  static time_t easter (int year);
   static bool leapYear (int);
   static int daysInMonth (int, int);
   static std::string monthName (int);
   static void dayName (int, std::string&);
   static std::string dayName (int);
+  static int weekOfYear (const std::string&);
   static int dayOfWeek (const std::string&);
+  static int monthOfYear (const std::string&);
 
   int month () const;
   int day () const;
   int year () const;
+  int weekOfYear (int) const;
   int dayOfWeek () const;
+  int hour () const;
+  int minute () const;
+  int second () const;
 
   bool operator== (const Date&);
   bool operator!= (const Date&);
@@ -65,6 +79,7 @@ public:
   bool operator>  (const Date&);
   bool operator<= (const Date&);
   bool operator>= (const Date&);
+  bool sameHour   (const Date&);
   bool sameDay    (const Date&);
   bool sameMonth  (const Date&);
   bool sameYear   (const Date&);
@@ -76,6 +91,7 @@ public:
   time_t operator- (const Date&);
 
 private:
+  bool isEpoch (const std::string&);
   bool isRelativeDate (const std::string&);
 
 protected:

src/Directory.cpp

@@ -0,0 +1,144 @@
+////////////////////////////////////////////////////////////////////////////////
+// task - a command line task list manager.
+//
+// Copyright 2006 - 2009, Paul Beckingham.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program 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.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+////////////////////////////////////////////////////////////////////////////////
+
+#include <unistd.h>
+#include <sys/stat.h>
+#include <sys/types.h>
+#include <dirent.h>
+#include <string.h>
+#include "Directory.h"
+#include "../auto.h"
+
+////////////////////////////////////////////////////////////////////////////////
+Directory::Directory ()
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Directory::Directory (const Directory& other)
+: File::File (other)
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Directory::Directory (const File& other)
+: File::File (other)
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Directory::Directory (const Path& other)
+: File::File (other)
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Directory::Directory (const std::string& in)
+: File::File (in)
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Directory::~Directory ()
+{
+}
+
+////////////////////////////////////////////////////////////////////////////////
+Directory& Directory::operator= (const Directory& other)
+{
+  if (this != &other)
+  {
+    File::operator= (other);
+  }
+
+  return *this;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool Directory::create ()
+{
+  return mkdir (data.c_str (), 0755) == 0 ? true : false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+bool Directory::remove ()
+{
+  return rmdir (data.c_str ()) == 0 ? true : false;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+std::vector <std::string> Directory::list ()
+{
+  std::vector <std::string> files;
+  list (data, files, false);
+  return files;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+std::vector <std::string> Directory::listRecursive ()
+{
+  std::vector <std::string> files;
+  list (data, files, true);
+  return files;
+}
+
+////////////////////////////////////////////////////////////////////////////////
+void Directory::list (
+  const std::string& base,
+  std::vector <std::string>& results,
+  bool recursive)
+{
+  DIR* dp = opendir (base.c_str ());
+  if (dp != NULL)
+  {
+    struct dirent* de;
+    while ((de = readdir (dp)) != NULL)
+    {
+      if (!strcmp (de->d_name, ".") ||
+          !strcmp (de->d_name, ".."))
+        continue;
+
+#if defined (SOLARIS) || defined (HAIKU)
+      struct stat s;
+      stat (de->d_name, &s);
+      if (recursive && s.st_mode & S_IFDIR)
+        list (base + "/" + de->d_name, results, recursive);
+      else
+        results.push_back (base + "/" + de->d_name);
+#else
+      if (recursive && de->d_type == DT_DIR)
+        list (base + "/" + de->d_name, results, recursive);
+      else
+        results.push_back (base + "/" + de->d_name);
+#endif
+    }
+
+    closedir (dp);
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////

src/Directory.h

@@ -0,0 +1,55 @@
+////////////////////////////////////////////////////////////////////////////////
+// task - a command line task list manager.
+//
+// Copyright 2006 - 2009, Paul Beckingham.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program 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.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+////////////////////////////////////////////////////////////////////////////////
+#ifndef INCLUDED_DIRECTORY
+#define INCLUDED_DIRECTORY
+
+#include "File.h"
+
+class Directory : public File
+{
+public:
+  Directory ();
+  Directory (const Directory&);
+  Directory (const File&);
+  Directory (const Path&);
+  Directory (const std::string&);
+  virtual ~Directory ();
+
+  Directory& operator= (const Directory&);
+
+  virtual bool create ();
+  virtual bool remove ();
+
+  std::vector <std::string> list ();
+  std::vector <std::string> listRecursive ();
+
+private:
+  void list (const std::string&, std::vector <std::string>&, bool);
+};
+
+#endif
+////////////////////////////////////////////////////////////////////////////////