Release date for 1.9.4

- a few words on the cmake config variables special to task

.gitignore

@@ -1,4 +1,3 @@
-Makefile.in
 aclocal.m4
 autom4te.cache
 auto.h*
@@ -6,8 +5,24 @@ config.h.in
 config.status
 src/.deps
 src/Makefile
-src/task
+*/*task
+*/*libtask.a
 stamp-h1
 Makefile
+Makefile.in
 configure
 config.log
+www.xls
+src/tests/all.log
+src/tests/*.data
+*~
+.*.swp
+package-config/osx/binary/task
+CMakeCache.txt
+CMakeFiles
+cmake_install.cmake
+install_manifest.txt
+_CPack_Packages
+CPackConfig.cmake
+CPackSourceConfig.cmake
+commit.h

AUTHORS

@@ -1,6 +1,82 @@
-Principal Author
-  Paul Beckingham, paul@beckingham.net
+The development of taskwarrior was made possible by the significant
+contributions of the following people:
 
-Contributing Authors
+  Paul Beckingham    (Principal Author)
+  Federico Hernandez (Package Maintainer & Contributing Author)
+  David J Patrick    (Designer)
+  John Florian       (Contributing Author)
+  Cory Donnelly      (Contributing Author)
+  Johannes Schlatow  (Contributing Author)
 
+The following submitted code, packages or analysis, and deserve special thanks:
+
+  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
+  Alexander Neumann
+  Emil Sköldberg
+  Michal Josífko
+  Ed Neville
+  Kevin Owens
+  Mick Koch
+  Kathryn Andersen
+  Alexander Schremmer
+  Jostein Berntsen
+  Andraž 'ruskie' Levstik
+  Irfan Siddiqui
+  Itay Perl
+  Sander Marechal
+  Stephen Heywood
+  Nicola Busanello
+  Eric Fluger
+  Andreas Poisel
+
+Thanks to the following, who submitted detailed bug reports and excellent
+suggestions:
+
+  Eugene Kramer
+  Srijith K
+  Bruce Israel
+  Thomas Engel
+  Nishiishii
+  galvanizd
+  Vincent Fleuranceau
+  ArchiMark
+  Carlos Yoder
+  Russell Friesenhahn
+  Paolo Marsi
+  Eric Farris
+  Bruce Dillahunty
+  Askme Too
+  Mike Adonay
+  Thomas@BIC
+  Ian Mortimer
+  Zach Frazier
+  Ivo Jimenez
+  Joe Pulliam
+  Juergen Daubert
+  Rich Mintz
+  Seneca Cunningham
+  Dirk Deimeke
+  Michelle Crane
+  Elizabeth Maxson
+  Peter De Poorter
+  Max Muller
+  Thomas Sattler
+  Erlan Sergaziev
+  Steve Rader
+  Andy Kriger
+  Patrick R McDonald
+  Pete Lewis
+  Bryce Harrington
 

CMakeLists.txt

@@ -0,0 +1,104 @@
+cmake_minimum_required (VERSION 2.8)
+include (CheckFunctionExists)
+
+set (HAVE_CMAKE true)
+
+project (task)
+set (PROJECT_VERSION "1.9.4")
+
+SET (TASK_MAN1DIR share/man/man1 CACHE STRING "Installation directory for man pages, section 1")
+SET (TASK_MAN5DIR share/man/man5 CACHE STRING "Installation directory for man pages, section 5")
+SET (TASK_DOCDIR  share/doc/task CACHE STRING "Installation directory for doc files")
+SET (TASK_BINDIR  bin            CACHE STRING "Installation directory for the binary")
+
+message ("-- Looking for SHA1 references")
+if (EXISTS .git/index)
+  set (HAVE_COMMIT true)
+  execute_process (COMMAND git log -1 --pretty=format:%h
+                   OUTPUT_VARIABLE COMMIT)
+  configure_file ( ${CMAKE_SOURCE_DIR}/commit.h.in
+                   ${CMAKE_SOURCE_DIR}/commit.h)
+  message ("-- Found SHA1 reference: ${COMMIT}")
+endif (EXISTS .git/index)
+
+
+set (PACKAGE "${PROJECT_NAME}")
+set (VERSION "${PROJECT_VERSION}")
+set (PACKAGE_BUGREPORT "support@taskwarrior.org")
+set (PACKAGE_NAME "${PACKAGE}")
+set (PACKAGE_TARNAME "${PACKAGE}")
+set (PACKAGE_VERSION "${VERSION}")
+set (PACKAGE_STRING "${PACKAGE} ${VERSION}")
+
+message ("-- Looking for Lua51")
+find_package (Lua51)
+if (LUA51_FOUND)
+  message ("-- Found Lua51: ${LUA_LIBRARIES}")
+  set (HAVE_LIBLUA true)
+  set (TASK_INCLUDE_DIRS ${TASK_INCLUDE_DIRS} ${LUA_INCLUDE_DIR})
+  set (TASK_LIBRARIES    ${TASK_LIBRARIES}    ${LUA_LIBRARIES})
+endif (LUA51_FOUND)
+
+message ("-- Looking for pthread")
+find_path (PTHREAD_INCLUDE_DIR pthread.h)
+find_library (PTHREAD_LIBRARY NAMES pthread)
+if (PTHREAD_INCLUDE_DIR AND PTHREAD_LIBRARY)
+  message ("-- Found pthread: ${PTHREAD_LIBRARY}")
+  set (HAVE_LIBPTHREAD true)
+  set (TASK_INCLUDE_DIRS ${TASK_INCLUDE_DIRS} ${PTHREAD_INCLUDE_DIR})
+  set (TASK_LIBRARIES    ${TASK_LIBRARIES}    ${PTHREAD_LIBRARIES})
+endif (PTHREAD_INCLUDE_DIR AND PTHREAD_LIBRARY)
+
+#message ("-- Looking for readline")
+#find_path    (READLINE_INCLUDE_DIR   readline/readline.h)
+#find_library (READLINE_LIBRARY NAMES readline)
+#if (READLINE_INCLUDE_DIR AND READLINE_LIBRARY)
+#  message ("-- Found readline: ${READLINE_LIBRARY}")
+#  set (HAVE_LIBREADLINE true)
+#  set (HAVE_READLINE true)
+#  set (TASK_INCLUDE_DIRS ${TASK_INCLUDE_DIRS} ${READLINE_INCLUDE_DIR})
+#  set (TASK_LIBRARIES    ${TASK_LIBRARIES }   ${READLINE_LIBRARIES})
+#endif (READLINE_INCLUDE_DIR AND READLINE_LIBRARY)
+
+check_function_exists (random  HAVE_RANDOM)
+check_function_exists (srandom HAVE_SRANDOM)
+check_function_exists (uuid_unparse_lower HAVE_UUID)
+
+if (${CMAKE_SYSTEM_NAME} MATCHES "Linux")
+  set (LINUX true)
+elseif (${CMAKE_SYSTEM_NAME} MATCHES "Darwin")
+  set (DARWIN true)
+elseif (${CMAKE_SYSTEM_NAME} MATCHES "FreeBSD")
+	set (FREEBSD true)
+else (${CMAKE_SYSTEM_NAME} MATCHES "Linux")
+  set (UNKNOWN true)
+endif (${CMAKE_SYSTEM_NAME} MATCHES "Linux")
+
+message ("-- Configuring auto.h")
+configure_file (
+  ${CMAKE_SOURCE_DIR}/cmake.h.in
+  ${CMAKE_SOURCE_DIR}/auto.h)
+
+add_subdirectory (src)
+add_subdirectory (doc)
+add_subdirectory (i18n)
+add_subdirectory (scripts)
+if (EXISTS test)
+  add_subdirectory (test EXCLUDE_FROM_ALL)
+endif (EXISTS test)
+
+set (doc_FILES NEWS ChangeLog README INSTALL AUTHORS COPYING)
+foreach (doc_FILE ${doc_FILES})
+  install (FILES ${doc_FILE}  DESTINATION ${TASK_DOCDIR})
+endforeach (doc_FILE)
+
+# ---
+
+set (CPACK_SOURCE_GENERATOR "TGZ")
+set (CPACK_SOURCE_PACKAGE_FILE_NAME ${PACKAGE_NAME}-${PACKAGE_VERSION})
+set (CPACK_SOURCE_IGNORE_FILES  "CMakeCache" "CMakeFiles" "CPackConfig" "CPackSourceConfig"
+                                "_CPack_Packages" "cmake_install" "install_manifest"
+                                "Makefile$" "test" "package-config" "misc/*"
+                                "src/task$" "src/libtask.a" "auto.h$"
+                                "/\\.gitignore" "/\\.git/" "swp$")
+include (CPack)

DEVELOPERS

@@ -1,20 +0,0 @@
-Developers may wish to change task, and here is a high-level guide to the files
-included.
-
-  task.{cpp,h}    Functions that implement the task commands, and main.
-  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
-

INSTALL

@@ -1,234 +1,149 @@
 Installation Instructions
-*************************
+-------------------------
 
-Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2005,
-2006 Free Software Foundation, Inc.
+# Building task with autotools is deprecated and will be phased out.
+#
+# Please follow the instructions below to build task with cmake.
+#
+# In case you still want or need to build task with autotools:
+#
+#    $ ./configure
+#    $ make
+#    $ sudo make install
+#
+# For more details on using autotools and options to ./configure please refer
+# to the autoconf manual.
 
-This file is free documentation; the Free Software Foundation gives
-unlimited permission to copy, distribute and modify it.
+Pre-requisites
+--------------
+
+You will need the CMake build system installed in order to build taskwarrior
+from source.
+
+Optionally, you might want to have Lua installed, if you wish to write plugins
+and modify taskwarrior.
+
+More information on cmake can be obtained at http://cmake.org
 
 Basic Installation
-==================
+------------------
 
-Briefly, the shell commands `./configure; make; make install' should
-configure, build, and install this package.  The following
-more-detailed instructions are generic; see the `README' file for
-instructions specific to this package.
+Briefly, these shell commands will unpack, build and install taskwarrior:
 
-   The `configure' shell script attempts to guess correct values for
-various system-dependent variables used during compilation.  It uses
-those values to create a `Makefile' in each directory of the package.
-It may also create one or more `.h' files containing system-dependent
-definitions.  Finally, it creates a shell script `config.status' that
-you can run in the future to recreate the current configuration, and a
-file `config.log' containing compiler output (useful mainly for
-debugging `configure').
+  $ tar xzf task-X.Y.Z.tar.gz                     [1]
+  $ cd task-X.Y.Z                                 [2]
+  $ cmake .                                       [3]
+  $ make                                          [4]
+  $ sudo make install                             [5]
+  $ cd .. ; rm -r task-X.Y.Z                      [6]
 
-   It can also use an optional file (typically called `config.cache'
-and enabled with `--cache-file=config.cache' or simply `-C') that saves
-the results of its tests to speed up reconfiguring.  Caching is
-disabled by default to prevent problems with accidental use of stale
-cache files.
+These commands are explained below:
 
-   If you need to do unusual things to compile the package, please try
-to figure out how `configure' could check whether to do them, and mail
-diffs or instructions to the address given in the `README' so they can
-be considered for the next release.  If you are using the cache, and at
-some point `config.cache' contains results you don't want to keep, you
-may remove or edit it.
+  1. Unpacks the source tarball.  This creates the directory task-X.Y.Z,
+     containing all the code.
 
-   The file `configure.ac' (or `configure.in') is used to create
-`configure' by a program called `autoconf'.  You need `configure.ac' if
-you want to change it or regenerate `configure' using a newer version
-of `autoconf'.
+  2. Change directory to the root of the distribution.
 
-The simplest way to compile this package is:
+  3. Invokes CMake to scan for dependencies and machine-specific details, then
+     generate the makefiles.  This may take a minute.
 
-  1. `cd' to the directory containing the package's source code and type
-     `./configure' to configure the package for your system.
+  4. Builds taskwarrior.  This may take a minute.
 
-     Running `configure' might take a while.  While running, it prints
-     some messages telling which features it is checking for.
+  5. Installs the program, documentation and other data files.
 
-  2. Type `make' to compile the package.
+  6. Removes the temporary directory.
 
-  3. Optionally, type `make check' to run any self-tests that come with
-     the package.
 
-  4. Type `make install' to install the programs and any data files and
-     documentation.
+Build and configurations options
+--------------------------------
 
-  5. You can remove the program binaries and object files from the
-     source code directory by typing `make clean'.  To also remove the
-     files that `configure' created (so you can compile the package for
-     a different kind of computer), type `make distclean'.  There is
-     also a `make maintainer-clean' target, but that is intended mainly
-     for the package's developers.  If you use it, you may have to get
-     all sorts of other programs in order to regenerate files that came
-     with the distribution.
+You can customize the configuration run with cmake variables. This will modify the
+installation process:
 
-Compilers and Options
-=====================
+To change the installation directory you use the following configuration variable:
 
-Some systems require unusual options for compilation or linking that the
-`configure' script does not know about.  Run `./configure --help' for
-details on some of the pertinent environment variables.
+  $ cmake -DCMAKE_INSTALL_PREFIX=<path-to-installation-dir> .
 
-   You can give `configure' initial values for configuration parameters
-by setting variables in the command line or in the environment.  Here
-is an example:
+cmake configuration variables are applied with the -D option and consist of a <name>
+and a <value>:
 
-     ./configure CC=c99 CFLAGS=-g LIBS=-lposix
+  $ cmake -D<name>=<value> .
 
-   *Note Defining Variables::, for more details.
+Four more variables can customize the installation process. The following table lists
+them and their defaults plus the CMAKE_INSTALL_PREFIX:
 
-Compiling For Multiple Architectures
-====================================
+  CMAKE_INSTALL_PREFIX  /usr/local
+  TASK_BINDIR           bin
+  TASK_DOCDIR           share/doc/task
+  TASK_MAN1DIR          share/man/man1
+  TASK_MAN5DIR          share/man/man5
 
-You can compile the package for more than one kind of computer at the
-same time, by placing the object files for each architecture in their
-own directory.  To do this, you can use GNU `make'.  `cd' to the
-directory where you want the object files and executables to go and run
-the `configure' script.  `configure' automatically checks for the
-source code in the directory that `configure' is in and in `..'.
+The correpsonding TASK_* variables will be combined with CMAKE_INSTALL_PREFIX to get
+absolute installation directoris:
 
-   With a non-GNU `make', it is safer to compile the package for one
-architecture at a time in the source code directory.  After you have
-installed the package for one architecture, use `make distclean' before
-reconfiguring for another architecture.
+  CMAKE_INSTALL_PREFIZ/TASK_BINDIR   /usr/local/bin
+  CMAKE_INSTALL_PREFIZ/TASK_DOCDIR   /usr/local/share/doc/task
+  CMAKE_INSTALL_PREFIZ/TASK_MAN1DIR  /usr/local/share/man/man1
+  CMAKE_INSTALL_PREFIZ/TASK_MAN5DIR  /usr/local/share/man/man5
 
-Installation Names
-==================
 
-By default, `make install' installs the package's commands under
-`/usr/local/bin', include files under `/usr/local/include', etc.  You
-can specify an installation prefix other than `/usr/local' by giving
-`configure' the option `--prefix=PREFIX'.
+Uninstallation
+--------------
 
-   You can specify separate installation prefixes for
-architecture-specific files and architecture-independent files.  If you
-pass the option `--exec-prefix=PREFIX' to `configure', the package uses
-PREFIX as the prefix for installing programs and libraries.
-Documentation and other data files still use the regular prefix.
+To uninstall taskwarrior, you need the Makefiles, so if you deleted them in
+step 7 above, they must first be regenerated by following steps [1], [2] and
+[3].  Then simply run:
 
-   In addition, if you use an unusual directory layout you can give
-options like `--bindir=DIR' to specify different values for particular
-kinds of files.  Run `configure --help' for a list of the directories
-you can set and what kinds of files go in them.
+    $ sudo make uninstall TODO TODO TODO -- cmake doesn't include uninstall
 
-   If the package supports it, you can cause programs to be installed
-with an extra prefix or suffix on their names by giving `configure' the
-option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'.
 
-Optional Features
-=================
+Taskwarrior Build Notes
+-----------------------
 
-Some packages pay attention to `--enable-FEATURE' options to
-`configure', where FEATURE indicates an optional part of the package.
-They may also pay attention to `--with-PACKAGE' options, where PACKAGE
-is something like `gnu-as' or `x' (for the X Window System).  The
-`README' should mention any `--enable-' and `--with-' options that the
-package recognizes.
+Taskwarrior 1.9.4 has dependencies that are detected by cmake in almost all cases,
+but there are situations and operating systems that mean you will need to offer
+a little help.
 
-   For packages that use the X Window System, `configure' can usually
-find the X include and library files automatically, but if it doesn't,
-you can use the `configure' options `--x-includes=DIR' and
-`--x-libraries=DIR' to specify their locations.
+If taskwarrior 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.
 
-Specifying the System Type
-==========================
 
-There may be some features `configure' cannot figure out automatically,
-but needs to determine by the type of machine the package will run on.
-Usually, assuming the package is built to be run on the _same_
-architectures, `configure' can figure that out, but if it prints a
-message saying it cannot guess the machine type, give it the
-`--build=TYPE' option.  TYPE can either be a short name for the system
-type, such as `sun4', or a canonical name which has the form:
+Operating System Notes
+----------------------
 
-     CPU-COMPANY-SYSTEM
+Cygwin
+  If 'make install' fails when writing to the /usr/local/share/ directory,
+  this may be because your current login doesn't have permission to write
+  to the Windows directory containing your Cygwin installation. Either
+  login to Windows as an Administrator and try the 'make install' process
+  again, or reinstall Cygwin under your normal Windows login.
 
-where SYSTEM can have one of these forms:
 
-     OS KERNEL-OS
+Darwin
+  If you're having trouble with Lua, check to see if the include files were
+  installed. If you're using fink, this will require the lua51-dev package in
+  addition to lua51.
 
-   See the file `config.sub' for the possible values of each field.  If
-`config.sub' isn't included in this package, then this package doesn't
-need to know the machine type.
 
-   If you are _building_ compiler tools for cross-compiling, you should
-use the option `--target=TYPE' to select the type of system they will
-produce code for.
+Troubleshooting
+---------------
 
-   If you want to _use_ a cross compiler, that generates code for a
-platform different from the build platform, you should specify the
-"host" platform (i.e., that on which the generated programs will
-eventually be run) with `--host=TYPE'.
+If you've recently made changes to dependencies (by reinstalling Lua, for
+example) be sure to rerun 'cmake .' before trying to execute 'make' again.
 
-Sharing Defaults
-================
+CMake will run and locate all the necessary pieces for the build, and create
+a Makefile.  There may be errors and warnings when running CMake, or there
+may be compiler errors and warnings when running 'make'.  Sometimes you will run
+CMake with no reported problems, and the build will fail later.  This is
+almost always because CMake is mistaken about some assumption.
 
-If you want to set default values for `configure' scripts to share, you
-can create a site shell script called `config.site' that gives default
-values for variables like `CC', `cache_file', and `prefix'.
-`configure' looks for `PREFIX/share/config.site' if it exists, then
-`PREFIX/etc/config.site' if it exists.  Or, you can set the
-`CONFIG_SITE' environment variable to the location of the site script.
-A warning: not all `configure' scripts look for a site script.
+If a build does not succeed, please send the contents of the 'CMakeCache.txt' 
+and 'CMakeFiles/CMakeOutput.log' files to support@taskwarrior.org, or post a
+message in the support forums at taskwarrior.org along with the information.
 
-Defining Variables
-==================
-
-Variables not defined in a site shell script can be set in the
-environment passed to `configure'.  However, some packages may run
-configure again during the build, and the customized values of these
-variables may be lost.  In order to avoid this problem, you should set
-them in the `configure' command line, using `VAR=value'.  For example:
-
-     ./configure CC=/usr/local2/bin/gcc
-
-causes the specified `gcc' to be used as the C compiler (unless it is
-overridden in the site shell script).
-
-Unfortunately, this technique does not work for `CONFIG_SHELL' due to
-an Autoconf bug.  Until the bug is fixed you can use this workaround:
-
-     CONFIG_SHELL=/bin/bash /bin/bash ./configure CONFIG_SHELL=/bin/bash
-
-`configure' Invocation
-======================
-
-`configure' recognizes the following options to control how it operates.
-
-`--help'
-`-h'
-     Print a summary of the options to `configure', and exit.
-
-`--version'
-`-V'
-     Print the version of Autoconf used to generate the `configure'
-     script, and exit.
-
-`--cache-file=FILE'
-     Enable the cache: use and save the results of the tests in FILE,
-     traditionally `config.cache'.  FILE defaults to `/dev/null' to
-     disable caching.
-
-`--config-cache'
-`-C'
-     Alias for `--cache-file=config.cache'.
-
-`--quiet'
-`--silent'
-`-q'
-     Do not print messages saying which checks are being made.  To
-     suppress all normal output, redirect it to `/dev/null' (any error
-     messages will still be shown).
-
-`--srcdir=DIR'
-     Look for the package's source code in directory DIR.  Usually
-     `configure' can determine that directory automatically.
-
-`configure' also accepts some other, not widely useful, options.  Run
-`configure --help' for more details.
+If CMake runs but taskwarrior does not build, please send the contents of the
+above files as well as a transcript from the build, which is not written to a
+file and must be captured from the terminal.
 
+---

Makefile.am

@@ -1,3 +1,27 @@
 SUBDIRS = src
-EXTRA_DIST = TUTORIAL 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 doc/man/task-sync.5
+
+#docdir = $(datadir)/doc/${PACKAGE}-${VERSION}
+doc_DATA = AUTHORS ChangeLog COPYING NEWS README INSTALL
+
+bashscriptsdir = $(docdir)
+nobase_dist_bashscripts_DATA = scripts/bash/task_completion.sh
+
+zshscriptsdir = $(docdir)
+nobase_dist_zshscripts_DATA = scripts/zsh/_task
+
+addonsdir = $(docdir)
+nobase_dist_addons_DATA = scripts/add-ons/export-csv.pl scripts/add-ons/export-ical.pl scripts/add-ons/export-xml.pl scripts/add-ons/export-xml.py scripts/add-ons/export-xml.rb scripts/add-ons/export-yaml.pl
+
+fishdir = $(docdir)
+nobase_dist_fish_DATA = scripts/fish/task.fish
+
+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/dark-16.theme doc/rc/dark-256.theme doc/rc/dark-blue-256.theme doc/rc/dark-green-256.theme doc/rc/dark-red-256.theme doc/rc/dark-violets-256.theme doc/rc/dark-yellow-green.theme doc/rc/holidays-AT.rc doc/rc/holidays-CA.rc doc/rc/holidays-DE.rc doc/rc/holidays-DK.rc doc/rc/holidays-ES.rc doc/rc/holidays-FR.rc doc/rc/holidays-IT.rc doc/rc/holidays-NL.rc doc/rc/holidays-NO.rc doc/rc/holidays-NZ.rc doc/rc/holidays-SE.rc doc/rc/holidays-UK.rc doc/rc/holidays-US.rc doc/rc/light-16.theme doc/rc/light-256.theme doc/rc/dark-gray-256.theme

NEWS

@@ -1,30 +1,100 @@
-Welcome to Task 1.0.0.
 
-Task has been built and tested on the following configurations:
+New Features in taskwarrior 1.9.4
 
-  - OS X 10.4 Tiger
-  - OS X 10.5 Leopard
-  - Fedora Core 8
-  - Fedora Core 9
-  - Ubuntu 8 Hardy Heron
-  - Solaris 10
+  - New burndown charts.
+  - New 'count' helper command.
+  - Inifinite width reports, when redirecting output.
+  - Added highlighting for the show command that indicates which values differ
+    from the defaults.
+  - Added change log display to the 'info' command.
+  - The first month in the calendar report can now be changed with an offset
+    value.
+  - No more dependency on ncurses.
+  - New '_query' helper command for script writers, which accepts a filter like
+    any other report, but returns unformatted JSON.  The new alias 'export.json'
+    maps to the _query command.
+  - Import can now read from files and URLs.
+  - Assorted bug fixes.
+  - New literal date "later" and "someday" to be used with the wait attribute to
+    hide a task until somepoint in time (this sets the wait date to 1/18/2038).
+  - Total active time now shown on the info report.
+  - Add-on scripts: export-xml.pl, export-xml.py, export-xml.rb, export-ical.pl,
+    export-csv.pl and export-yaml.pl.
+  - New dark-gray-256 color theme.
 
-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):
+  Please refer to the ChangeLog file for full details.  There are too many to
+  list here.
 
-  - Do nothing.  Bug probably won't get fixed.
+New commands in taskwarrior 1.9.4
 
-  - 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.
+  - 'burndown.daily', 'burndown.weekly', 'burndown.monthly', also with
+    'burndown' that is an alias to burndown.weekly.
+  - 'count' accepts a filter, and simply returns a count of the tasks
+    matching the filter.  Used as a helper command by scripts.
+  - '_query' helper command for all future export formats.
 
-  - 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.
+New configuration options in taskwarrior 1.9.4
 
-  - 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.
+  - color.burndown.pending, color.burndown.started and color.burndown.done
+    control the color of the burndown charts.
+  - burndown.bias, which is a tweakable control for the completion estimation
+    for the burndown charts, and is documented in taskrc(5).
+  - defaultwidth=0 is causes word-wrapping to be turned off, and effectively
+    set reports to potentially have infinite width .
+  - journal.info controls whether a change log for each task is displayed by
+    the 'info' command.
+  - gc=off can be used, temporarily, to defer GC until later commands, which
+    eliminates problems with task ID numbers for script writers.
+  - calendar.offset=off and calendar.offset.value=-1 to apply an offset value
+    to change the effective first month in the calendar report.
+  - default.due can be specified, and adds a default due date to all added
+    and imported tasks that don't otherwise have a due date.
+  - edit.verbose can be set to 'off' to eliminated the help text when using
+    the 'task edit' command.
+  - xterm.title can be set to 'on' to update the xterm window title when a
+    report is run.
+  - new holidays configuration file for New Zealand, Italy, Austria.
+
+Newly deprecated features in taskwarrior 1.9.4
+
+  - The export commands (export, export.csv, export.yaml, export.ical and
+    export.vcalendar) are deprecated, and will be replaced in future releases
+    by add-on scripts.
+
+---
+
+Taskwarrior has been built and tested on the following configurations:
+
+  * OS X 10.6 Snow Leopard and 10.5 Leopard
+  * Fedora 14 Laughlin, 13 Goddard
+  * Ubuntu 10.10 Maverick Meerkat, 10.04 Lucid Lynx
+  * Debian Sid
+  * Slackware 12.2
+  * Arch Linux
+  * Gentoo Linux
+  * SliTaz Linux
+  * CRUX Linux
+  * SuSE 11.3
+  * Solaris 10 and 8
+  * OpenBSD 4.5
+  * FreeBSD
+  * NetBSD
+  * Cygwin 1.7 and 1.5
+  * Haiku R1/alpha1
+
+---
+
+While Taskwarrior has undergone testing, bugs are sure to remain.  If you
+encounter a bug, please enter a new issue at:
+
+  http://taskwarrior.org/projects/taskwarrior/issues/new
+
+Or you can also report the issue in the forums at:
+
+  http://taskwarrior.org/projects/taskwarrior/boards
+
+Or just send a message to:
+
+  support@taskwarrior.org
 
 Thank you.
-

README

@@ -1,48 +1,23 @@
-Thank you for taking a look at task.  Task is a GTD utility featuring:
 
-  - Robust C++ implementation
-  - Tags
-  - Colorful, tabular output
-  - Reports
-  - Lots of commands
-  - Low-level API
-  - Abbreviations for all commands, options
-  - Multi-user file locking
-  - Clean architecture allowing quick addition of new features
+Thank you for taking a look at taskwarrior!
 
-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.
+Taskwarrior 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.  Taskwarrior 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 jump straight to the TUTORIAL file, or perhaps 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 TUTORIAL
-file are the quickest way for you to make that decision.
-
-Task is based on ideas presented in the todo.sh script, found on:
-
-  http://todotxt.org
-
-Task has a few 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 taskwarrior.
 
+---

TUTORIAL

@@ -1,654 +0,0 @@
-Task program tutorial, for version 1.0.0
-----------------------------------------
-
-This guide shows how to quickly set up the task program, and become proficient
-with it.
-
-  Contents:
-    Quick Setup
-    Simple Usage
-    Advanced Usage
-    Interacting with the Shell
-    Configuring Task
-    Colors
-
-
-
-Quick Setup
------------
-
-Build the task program according to the directions in the INSTALL file.  This
-transcript illustrates a typical installation:
-
-  % ls
-  task-1.0.0.tar.gz
-  % gunzip task-1.0.0.tar.gz
-  % tar xf task-1.0.0.tar
-  % cd task-1.0.0
-  % ./configure
-  ...
-  % make
-  ...
-  % make install     # (may require sudo, depending on --prefix)
-
-You need to make sure that the installed task program is in your PATH
-environment variable.
-
-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.
-
-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.
-
-  % 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]
-
-
-Simple Usage
-------------
-
-Let us begin by adding some tasks:
-
-  % task add Book plane ticket
-  % task add Rent a tux
-  % task add Reserve a rental car
-  % task add Reserve a hotel room
-
-That's it.  You'll notice immediately that task has a very minimalist
-interface.  Let us take a look at those tasks:
-
-  % 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
-
-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:
-
-  % task 2 delete
-  Permanently delete task? (y/n) y
-
-Task wants you to confirm deletions.  To remove the confirmation, edit your
-.taskrc file and change the line:
-
-  confirmation=yes
-
-to have a value of "no".
-
-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:
-
-  % 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
-
-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:
-
-  % task ls project:Wedding
-
-  ID Project Pri Description          
-   1 Wedding     Book plane ticket
-   2 Wedding     Reserve a rental car
-
-Any command arguments after the 'ls' are used for filtering the output.  We
-could also have requested:
-
-  % task ls ticket plane
-
-  ID Project Pri Description       
-   1 Wedding     Book plane ticket
-
-Now let's prioritize.  Priorities can be H, M or L (High, Medium, Low).
-
-  % 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
-
-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.
-
-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:
-
-  % task add project:Wedding priority:H Book plane ticket
-
-The 'ls' command provides the least information for each task.  The 'list'
-command provides more:
-
-  % 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
-
-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:
-
-  % 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
-
-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:
-
-  color.due=red
-  color.due=on_blue
-  color.due=red on_blue
-  color.due=bold_red on_blue
-
-Where color is one of the following:
-
-  black
-  blue
-  red
-  green
-  cyan
-  magenta
-  yellow
-  white
-
-All colors are specified in this way.  Take a look in .taskrc for all the other
-color rules that you control.
-
-Tagging tasks is a good way to group them, aside from specifying a project.  To
-add a tag to a task:
-
-  % task <id> +tag
-
-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.
-
-  % 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
-
-To remove a tag from a task, use the minus sign:
-
-  % task 3 -john
-
-
-
-Advanced Use
-------------
-
-Here are the other commands, in some detail.  Note that the command:
-
-  % task
-
-with no arguments will generate a help message that lists all these commands.
-
-
-% task projects
----------------
-
-  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:
-
-    % task projects
-
-    Project   Tasks
-    Errands       1
-    Birthdays     3
-    Car           2
-
-
-
-% task summary
---------------
-
-  This report lists all the projects and a summary of their task status.
-
-    % 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
-
-  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.
-
-
-
-% task delete <id>
-------------------
-
-  There are two ways of getting rid of tasks - mark them as done, or delete
-  them.
-
-
-
-% task done <id>
-----------------
-
-  This is how a task is marked as done.
-
-
-
-% task list ...
----------------
-
-  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.
-
-
-
-% task long ...
----------------
-
-  The long report will show the entry date and start date of a task, in
-  addition to the columns that the "task list" shows.
-
-
-
-% task start <id>
------------------
-
-  This marks a task as started (and therefore active), which is shown in the
-  "list" report:
-
-    % 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
-    ...
-
-
-
-% task active
--------------
-
-  Shows all active tasks, that is, the tasks for which the "task start ..."
-  command was run, as shown above.
-
-
-
-% task overdue
---------------
-
-  Simply lists all the task that have a due date that is past, in "list"
-  format.
-
-
-
-% task history
---------------
-
-  This report shows you an overview of how many tasks were added, completed and
-  deleted, by month.  It looks like this:
-
-    % task history 
-
-    Year Month     Added Completed Deleted Net
-    2008 March        21        16       0   5
-         April        13        11       1   1
-         May           8        14       3  -9
-
-  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.
-
-
-
-% task calendar
----------------
-
-  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.
-
-    % 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
-
-
-
-% task next
------------
-
-  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.
-
-  If you wish to show a different number of tasks per project, modify the entry
-  in .taskrc:
-
-    next=2
-
-  To be your preferred number.
-
-
-
-% task <id> ...
----------------
-
-  When a task id is specified, everything applies to just that task.  Suppose
-  we needed to correct a task:
-
-  % 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
-  ...
-
-
-
-% task /from/to/
-----------------
-
-  If a task has been entered with a typo, it can be easily corrected by this
-  command.  For example:
-
-    % 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
-    ...
-
-  This command makes single corrections to a task description.
-
-
-
-% task tags
------------
-
-  This command will generate a list of all the tags that are currently in use
-  by task.
-
-
-
-% task info <id>
-----------------
-
-  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.
-
-
-
-% task stats
-------------
-
-  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.
-
-
-
-% task completed
-----------------
-
-  This generates a list of all tasks that have been completed, sorted by their
-  completion date.
-
-
-
-% task export <file name>
--------------------------
-
-  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.
-
-
-
-% task colors
--------------
-
-  This command displays all the colors that task supports.
-
-
-
-% task usage
-------------
-
-  If logging has been enabled by the "command.logging=on" directive in the
-  .taskrc file, then task will record every command that is run.  When this
-  command is run, task will display a count of how many times each command was
-  used.
-
-  This command is for the purpose of seeing whether command are actually used.
-
-
-
-% task version
---------------
-
-  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.
-
-
-
-Interacting with the Shell
---------------------------
-
-  Certain characters are interpreted by the shell.  For example, the "&".  If
-  you wish to include the & in a task description, you need to escape it, so
-  the shell doesn't interpret it.  For example:
-
-    % task add Buy bread & milk
-
-  This command is an error because of the &.  The shell will consider this to
-  be two commands:
-
-    % task add Buy bread &
-    % milk
-
-  The shell treats the & 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 & character:
-
-    % task add Buy bread \& milk
-
-  Another is to quote the entire description, with either ' or " characters:
-
-    % task add "Buy bread & milk"
-
-  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.
-
-
-
-% task <id> fg:... bg:...
--------------------------
-
-  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:
-
-  Valid background colors are:
-
-  Note that these are not just colors, but combinations of colors and
-  attributes.
-
-  Note also that this capability does depend on whether your terminal program
-  can display these colors.
-
-
-
-
-Configuring Task
-----------------
-
-  Task recognizes several entries in the .taskrc file for configuration
-  purposes.  Valid entries are of the form:
-
-    name=value
-
-  Valid examples are:
-
-    data.location       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
-
-    command.logging     May be "on" or "off", defaulting to "off".  This
-                        determines whether task records commands.  This is not
-                        generally useful, except while developing task.
-
-    confirmation        May be "yes" or "no", and determines whether task will
-                        ask for confirmation before deleting a task.
-
-    nag                 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:
-
-                          Note: try to stick to high priority tasks.
-                          See "task next".
-
-    next                Is a number, defaulting to 2, which is the number of
-                        tasks for each project that are shown in the "task next"
-                        command.
-
-    curses              Determines whether task uses ncurses to establish the
-                        size of the window you are using, for text wrapping.
-
-    color               May be "on" or "off".  Determines whether task uses
-                        color.
-
-    color.overdue       These are the coloration rules.  They correspond to a
-    color.due           particular attribute of a task, such as it being due, or
-    color.pri.H         being active, and specifies the automatic coloring of
-    color.pri.M         that task.
-    color.pri.L
-    color.pri.none      The value may be one optional foreground color (see
-    color.active        below) and one optional background color.
-    color.tagged
-                        For example, the value may be:
- 
-                          bold_red on_bright_yellow
-
-    color.tag.X         Colors any task that has the tag X.
-
-    color.project.X     Colors any task assigned to project X.
-
-    color.keyword.X     Colors any task where the description contains X.
-
-
-Colors
-------
-
-  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:
-
-             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
-
-  and the following are valid background colors:
-
-    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
-

announcement.txt

@@ -1,36 +0,0 @@
-Some considerable time ago - longer than I had hoped - I demonstrated an
-alternate implementation of the todo script, called task, in the form of a
-YouTube movie:
-
-  http://www.youtube.com/watch?v=l68LCl6BYvs
-
-A lot has happened since then, and the task program has been slowly improving
-thanks to feedback from some early testers, and continuous use by me.  Today,
-I have uploaded a new movie:
-
-  http://www.youtube.com/watch?v=D2Kn4DMOVSw
-
-This movie includes most of the changes and improvements to task, but behind
-the scenes are the biggest changes.  There was a rewrite of the underlying
-storage mechanism yielding a clean API for the front end, and the code was
-reviewed for portability and converted to use GNU autoconf/automake.
-
-Task has been released under GPL, and so far has been tested on:
-
-  Max OS X 10.4 (Tiger)
-  Max OS X 10.5 (Leopard)
-  Fedora 8
-  Fedora 9
-  Ubuntu 8 (Hardy Heron)
-  Solaris 10
-
-Task has been making me more organized and productive for some time now.
-Perhaps some of you might find it useful, and I welcome feedback of all kinds.
-
-You can find the task source code at:
-
-  http://www.beckingham.net/task-1.0.0.tar.gz
-
-Thank you.
-Paul Beckingham
-

cmake.h.in

@@ -0,0 +1,48 @@
+/* cmake.h.in. Creates auto.h during a cmake run */
+
+/* Package information */
+#define PACKAGE "${PACKAGE}"
+#define VERSION "${VERSION}"
+#define PACKAGE_BUGREPORT "${PACKAGE_BUGREPORT}"
+#define PACKAGE_NAME      "${PACKAGE_NAME}"
+#define PACKAGE_TARNAME   "${PACKAGE_TARNAME}"
+#define PACKAGE_VERSION   "${PACKAGE_VERSION}"
+#define PACKAGE_STRING    "${PACKAGE_STRING}"
+
+/* git information */
+#cmakedefine HAVE_COMMIT
+
+/* cmake information */
+#cmakedefine HAVE_CMAKE
+#define CMAKE_VERSION "${CMAKE_VERSION}"
+
+/* Compiling platform */
+#cmakedefine LINUX
+#cmakedefine DARWIN
+#cmakedefine CYGWIN
+#cmakedefine FREEBSD
+#cmakedefine OPENBSD
+#cmakedefine HAIKU
+#cmakedefine SOLARIS
+#cmakedefine WIN32
+#cmakedefine UNKNOWN
+
+/* Found the lua library */
+#cmakedefine HAVE_LIBLUA
+
+/* Found the pthread library */
+#cmakedefine HAVE_LIBPTHREAD
+
+/* Found the readline library */
+#cmakedefine HAVE_READLINE
+#cmakedefine HAVE_LIBREADLINE
+
+/* Found random */
+#cmakedefine HAVE_RANDOM
+
+/* Found srandom */
+#cmakedefine HAVE_SRANDOM
+
+/* Found uuid_unparse_lower */
+#cmakedefine HAVE_UUID
+

commit.h.in

@@ -0,0 +1,4 @@
+/* commit.h.in. Creates commit.h during a cmake run */
+
+/* git information */
+#define COMMIT "${COMMIT}"

configure.ac

@@ -2,24 +2,172 @@
 # Process this file with autoconf to produce a configure script.
 
 AC_PREREQ(2.61)
-AC_INIT(task, 1.0.0, bugs@beckingham.net)
-AM_INIT_AUTOMAKE
-AC_CONFIG_SRCDIR([src/task.cpp])
-AC_CONFIG_HEADER([auto.h])
+AC_INIT(task, 1.9.4, support@taskwarrior.org)
 
-# Checks for programs.
+
+# Source type.
 AC_PROG_CXX
 AC_PROG_CC
 AC_LANG(C++)
 
+
+# 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
+
+
+# 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])
+
+# The following code should replace the one line above, but is not working.
+# Anyone know why?
+
+#  # check for lua. this is separate from the above libraries because it's
+#  # liblua50 on debian and liblua everywhere else.
+#  AC_CHECK_LIB(lua, lua_open, LIB_LUA="-llua")
+#  AC_CHECK_LIB(lualib, luaopen_base, LIB_LUA_LIB=-llualib, , [$LIB_LUA -ldl -lm])
+#
+#  if test "x${LIB_LUA}" = "x"; then
+#    echo "Could not find liblua. Please install liblua 5.1+"
+#    exit 1
+#  fi
+#
+#  if test "x${LIB_LUA_LIB}" = "x"; then
+#    echo "Could not find liblualib. Please install liblualib 5.1+"
+#    exit 1
+#  fi
+#
+#  LDFLAGS="$LDFLAGS $LIB_LUA $LIB_LUA_LIB"
+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 libraries.
-AC_CHECK_LIB(ncurses,initscr)
-AC_CHECK_LIB(ncurses,endwin)
+AC_CHECK_LIB(pthread,pthread_create)
+
 
 # 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([string vector map])
+AC_CHECK_HEADERS([sstream string vector map])
+
 
 # Checks for typedefs, structures, and compiler characteristics.
 AC_HEADER_STDBOOL
@@ -29,12 +177,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/CMakeLists.txt

@@ -0,0 +1,13 @@
+message ("-- Configuring man pages")
+set (man_FILES task-color.5 task-faq.5 task-sync.5 task-tutorial.5 task.1 taskrc.5)
+foreach (man_FILE ${man_FILES})
+  configure_file (
+    man/${man_FILE}.in
+    man/${man_FILE})
+endforeach (man_FILE)
+
+install (DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/man/ DESTINATION ${TASK_MAN1DIR}
+                                                    FILES_MATCHING PATTERN "*.1")
+install (DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/man/ DESTINATION ${TASK_MAN5DIR}
+                                                    FILES_MATCHING PATTERN "*.5")
+install (DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/rc   DESTINATION ${TASK_DOCDIR})

doc/man/.gitignore

@@ -0,0 +1,6 @@
+task-color.5
+task-faq.5
+task-sync.5
+task-tutorial.5
+task.1
+taskrc.5

doc/man/task-color.5.in

@@ -0,0 +1,324 @@
+.TH task-color 5 2011-03-03 "${PACKAGE_STRING}" "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 taskwarrior that you want to use color.  This is the default for
+taskwarrior, 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 taskwarrior is ready.
+
+.SH AUTOMATIC MONOCHROME
+It should be mentioned that taskwarrior is aware of whether its output is going
+to a terminal, or to a file or through a pipe.  When taskwarrior 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?  Taskwarrior
+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 taskwarrior 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
+Taskwarrior 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
+
+Taskwarrior 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.  Taskwarrior 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 LEGEND
+Taskwarrior will show examples of all defined colors used in your .taskrc, or
+theme, if you run this command:
+
+    $ task color legend
+
+This gives you an example of each of the colors, so you can see the effect,
+without necessarily creating a set of tasks that meet each of the rule criteria.
+
+.SH RULES
+Taskwarrior 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!
+
+The precedence for the color rules is determined by the configuration
+variable 'rule.precedence.color', which by default contains:
+
+    due.today,active,blocked,overdue,due,keyword,project,tag,recurring,pri,tagged
+
+These are just the color rules with the 'color.' prefix removed.  The
+rule 'color.due.today' is the highest precedence, and 'color.tagged' is the lowest.
+
+The keyword rule shown here as 'keyword' corresponds to a wildcard pattern,
+meaning 'color.keyword.*', or in other words all the keyword rules.  Similarly
+for the 'color.tag.*' and 'color.project.*' rules.
+
+There is also 'color.project.none', 'color.tag.none' and 'color.pri.none'.
+
+.SH THEMES
+Taskwarrior 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:
+
+.RS
+include /usr/local/share/doc/task/rc/dark-256.theme
+.RE
+
+You can use any of the standard taskwarrior themes:
+
+.RS
+light-16.theme
+.br
+light-256.theme
+.br
+dark-16.theme
+.br
+dark-256.theme
+.br
+dark-red-256.theme
+.br
+dark-green-256.theme
+.br
+dark-blue-256.theme
+.RE
+
+You can also see how the theme will color the various tasks with the command:
+
+    $ task color legend
+
+Better yet, create your own, and share it.  We will gladly host the theme file
+on <http://taskwarrior.org>.
+
+.SH "CREDITS & COPYRIGHTS"
+Taskwarrior was written by P. Beckingham <paul@beckingham.net>.
+.br
+Copyright (C) 2006 \- 2011 P. Beckingham
+
+This man page was originally written by Paul Beckingham.
+
+Taskwarrior 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),
+.BR task-sync(5)
+
+For more information regarding taskwarrior, 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 taskwarrior may be reported to the issue-tracker at
+<http://taskwarrior.org>

doc/man/task-faq.5.in

@@ -0,0 +1,361 @@
+.TH task-faq 5 2011-03-03 "${PACKAGE_STRING}" "User Manuals"
+
+.SH NAME
+task-faq \- A FAQ for the task(1) command line todo manager.
+
+.SH DESCRIPTION
+Taskwarrior 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.
+Taskwarrior has a rich list of commands that allow you to do various things with it.
+
+.SH WELCOME
+Welcome to the taskwarrior FAQ.  If you have would like to see a question answered
+here, please send us a note at <support@taskwarrior.org>.
+
+.TP
+.B Q: When I redirect the output to a file, I lose all the colors.  How do I fix this?
+A: Taskwarrior knows (or thinks it knows) when the output is not going directly
+to a terminal, and strips out all the color control characters.  This is based
+on the assumption that the color control codes are not wanted in the file.
+Prevent this with the following entry in your .taskrc file:
+
+   _forcecolor=on
+
+There is an additional problem with using pagers such as 'less' and 'more'.
+When using less, these options will preserve the color codes:
+
+    task ... | less -FrX
+
+There have been problems reported with the Linux 'more' pager, which inserts
+newline characters.
+
+.TP
+.B Q: How do I backup my taskwarrior data files? Where are they?
+A: Taskwarrior 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
+taskwarrior configuration data.  To be sure, and to future-proof your backup,
+consider backing up all the files in the ~/.task directory.
+
+.TP
+.B Q: How can I separate my work tasks from my home tasks? Specifically, can I keep them completely separate?
+A: You can do this by creating an alternate .taskrc file, then using shell
+aliases. Here are example Bash commands to achieve this:
+
+    % cp ~/.taskrc ~/.taskrc_home
+    % (now edit .taskrc_home to change the value of data.location)
+    % alias wtask="task" 
+    % alias htask="task rc:~/.taskrc_home" 
+
+This gives you two commands, 'wtask' and 'htask' that operate using two
+different sets of task data files.
+
+.TP
+.B Q: Can I revert to a previous version of taskwarrior? How?
+A: Yes, you can revert to a previous version of task, simply by downloading an
+older version and installing it. If you find a bug in task, then this may be the
+only way to work around the bug, until a patch release is made.
+
+Note that it is possible that the taskwarrior file format will change. For
+example, the format changed between versions 1.5.0 and 1.6.0. Taskwarrior will
+automatically upgrade the file but if you need to revert to a previous version
+of taskwarrior, there is the file format to consider. This is yet another good
+reason to back up your task data files!
+
+.TP
+.B Q: How do I build taskwarrior under Cygwin?
+A: Take a look at the README.build file, where the latest information on build
+issues is kept.  Taskwarrior is built the same way everywhere. But under Cygwin,
+you'll need to make sure you have the following packages available first:
+
+    gcc
+    make
+
+The gcc and make packages allow you to compile the code, and are therefore
+required.
+
+.TP
+.B Q: Do colors work under Cygwin?
+A: 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.
+
+If you run the command:
+
+    % task colors
+
+Taskwarrior will display all the colors it can use, and you will see which ones
+you can use.
+
+Note that if you install the 'mintty' shell in Cygwin, then you can use 256
+colors.
+
+See the 'man task-color' for more details on which colors can be used.
+
+.TP
+.B Q: Where does taskwarrior store the data?
+By default, taskwarrior creates a .taskrc file in your home directory and
+populates it with defaults.  Taskwarrior 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 taskwarrior 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, taskwarrior will offer to create a
+default one for you.  Another way to do this is with the command:
+
+    $ task rc:new-file version
+
+Taskwarrior will create 'new-file' if it doesn't already exist.  There will not
+be much in it though - taskwarrior relies heavily on default values, which can
+be seen with this command:
+
+    $ task show
+
+which lists all the currently known settings.  If you have just created
+new-file, then this command lists only the defaults.
+
+Note that this is a good way to learn about new configuration settings,
+particularly if your .taskrc file was created by an older version.
+
+.TP
+.B Q: Do I need to back up my taskwarrior 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 taskwarrior 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: I don't like dropbox. Is there another way to synchronize my tasks?
+Of course. Especially if you want to modify tasks offline on both machines and
+synchronize them later on. For this purpose there is a 'merge' command which is
+is able to insert the modifications you made to one of your task databases into
+a second database.
+
+Here is a basic example of the procedure:
+
+    $ task merge ssh://user@myremotehost/.task/
+    $ task push ssh://user@myremotehost/.task/
+
+The first command fetches the undo.data file from the remote system, reads the
+changes made and updates the local database. When this merge command completes,
+you should copy all the local .data files to the remote system either by using
+the push command explicitly or by activating the merge.autopush feature in the 
+~/.taskrc file. This way you ensure that both systems are fully synchronized.
+
+.TP
+.B Q: The undo.data file gets very large - do I need it?
+You need it if you want the undo capability, or the merge capability mentioned
+above.  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 taskwarrior, because it is never read until you want
+to undo.  Otherwise taskwarrior 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 version 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?
+Use one of our provided color themes, or create your own - after all, they are
+just collections of color settings.
+
+See the task-color(5) man page for an in-depth explanation of the color rules.
+
+.TP
+.B Q: How can I make taskwarrior 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: Taskwarrior 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
+
+taskwarrior 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 ID numbers change?
+Taskwarrior 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"), the numbers are assigned before display.
+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
+taskwarrior 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 taskwarrior 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'?
+Taskwarriors 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.
+
+.TP
+.B Q: How do I delete an annotation?
+Taskwarrior now has a 'denotate' command to remove annotations.  Here is an
+example:
+
+    $ task add Original task
+    $ task 1 annotate foo
+    $ task 1 annotate bar
+    $ task 1 annotate foo bar
+
+Now to delete the first annotation, use:
+
+    $ task 1 denotate foo
+
+This takes the fragment 'foo' and compares it to each of the annotations. In
+this example, it will remove the first annotation, not the third, because it is
+an exact match.  If there are no exact matches, it will remove the first
+non-exact match:
+
+    $ task 1 denotate ar
+
+This will remove the second annotation - the first non-exact match.
+
+.TP
+.B Q: Why Lua as an extension language?
+Lua has many positive attributes:
+
+- Lua is written using tight, fast, standard C
+- Lua is a breeze to integrate into any product
+- The Lua source code is beautifully written
+- Lua is a small language
+
+Guile, Scheme and Neko were also considered.
+
+.TP
+.B Q: How can I help?
+There are lots of ways.  Here are some:
+
+ - Provide feedback on what works, what does not
+ - Tell us how task does or does not fit your workflow
+ - Tell people about task
+ - Report bugs when you see them
+ - Contribute to our Wiki
+ - Suggest features
+ - Write unit tests
+ - Fix bugs
+
+.SH "CREDITS & COPYRIGHTS"
+Taskwarrior was written by P. Beckingham <paul@beckingham.net>.
+.br
+Copyright (C) 2006 \- 2011 P. Beckingham
+
+This man page was originally written by P. Beckingham.
+
+Taskwarrior 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),
+.BR task-sync(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 taskwarrior may be reported to the issue-tracker at
+<http://taskwarrior.org>

doc/man/task-sync.5.in

@@ -0,0 +1,361 @@
+.TH task-sync 5 2011-03-03 "${PACKAGE_STRING}" "User Manuals"
+
+.SH NAME
+task-sync \- A tutorial for the task(1) data synchronization capabilities.
+
+.SH DESCRIPTION
+Taskwarrior has built-in support for synchronization, which can be used to keep
+two task databases up to date, regardless of which one is used.  This capability
+can also be used to keep a backup copy of your task database on another machine.
+
+Taskwarrior can use various protocols for transferring the data.
+
+.SH HOW IT WORKS
+If you were to manually attempt to keep two separate task databases up to date,
+you would need to inspect both databases, and detect changes that occurred in
+each one.  Those changes would need to be migrated to the other database, while
+being careful not to miss a change, and not to confuse an 'add' in one with
+a 'delete' in the other.
+
+The synchronization feature does just this.  It can transfer task databases,
+compare tasks, and apply changes where necessary.
+
+.SH NEW COMMANDS
+Taskwarrior has 'pull', 'push' and 'merge' commands which perform the steps
+necessary to move files around and combine them.  In the common use case, you
+would only need to use the 'merge' command.  These commands take an argument
+that is a URI, which indicates where the remote database resides.
+
+To be clear, the local database always refers to your ~/.task directory (unless
+overridden), and the remote database is always specified by URI.
+
+.SH MERGE
+The merge command will fetch task data via URI and combine it with the local
+task database.  The syntax is:
+
+.br
+.RS
+task merge [<URI>]
+.RE
+
+The URI is optional if the
+.B merge.default.uri
+configuration variable is set.  The URI may point to a different directory, or
+it may be a different computer.  Here is an example of the merge command:
+
+.br
+.RS
+$ task merge ~/work/
+.RE
+
+This URI (~/work/) is a path name, which means the remote database is on the
+same computer.  Taskwarrior will fetch the data from the URI, and merge it with
+your local data in ~/.task.
+
+When complete, you will be asked whether you would like to push the combined
+data back to the remote location specified by the URI.  This is useful if you
+are keeping two task databases synchronized, but it can be turned off.  See
+CONFIGURATION.
+
+Note that a merge operation is not atomically reversible.  You could however
+run the 'task undo' command repeatedly to undo the effects.
+
+.SH PUSH
+The push command will copy the local task database to the specified URI.  The
+syntax is:
+
+.br
+.RS
+task push [<URI>]
+.RE
+
+The URI is optional if the
+.B push.default.uri
+configuration variable is set.  This command is useful for making backup copies
+of your task database.
+
+Note that the task files at the location specified by the URI are simply
+overwritten, so don't expect any merging to occur.  Misused, push can be
+dangerous.
+
+.SH PULL
+The pull command will copy a task database from a URI to the local task database
+(~/.task by default).  The syntax is:
+
+.br
+.RS
+task pull [<URI>]
+.RE
+
+The URI is optional if the
+.B pull.default.uri
+configuration variable is set.  This command is useful for restoring a backup
+copy of your task database.
+
+Note that your local task database files will be simply overwritten by the files
+obtained from the location specified by the URI, so don't expect any merging to
+occur.  Misused, pull can be dangerous.
+
+.SH URI TYPES
+The most basic URI is a path name on the local machine.  An example would be:
+
+.br
+.RS
+/home/bob/.task/
+.RE
+
+All the other URIs allow access to remote machines.  The first uses SSH and scp
+(either form can be used):
+
+.br
+.RS
+ssh://[user@]host[:port]/path/to/undo.data
+.br
+[user@]host:/path/
+.RE
+
+Rsync is another supported protocol that minimizes network traffic, by a clever
+algorithm that doesn't copy files that have not changed:
+
+.br
+.RS
+rsync://[user@]host.xz[:port]/path/to/undo.data
+.RE
+
+Curl supports several protocols that can transfer data using HTTP, HTTPS and
+FTP:
+
+.br
+.RS
+http://host[:port]/path/to/undo.data
+.br
+https://host[:port]/path/to/undo.data
+.br
+ftp://[user@]host[:port]/path/to/undo.data
+.RE
+
+You can use single quotes to encapsulate user names that contain delimiting 
+characters like '@', '/' or ':', e.g.:
+
+.br
+.RS
+ssh://'user@name'@host/
+.RE
+
+Remember to escape the quotes on your shell:
+
+.br
+.RS
+$ task push ftp://\'user@name\':host/
+.RE
+
+.SH CONFLICTS
+When modifications on the local and remote machine conflict, for example if
+both machines change the project name of the same task to different values,
+then Taskwarrior automatically selects the most recent change.  Thus, there
+are no conflicts.
+
+.SH EXAMPLE - Backup on another machine
+One very good use of 'push' is to make backup copies of your task database in
+another location.  Suppose your task database is kept in the usual place, in
+the ~/.task directory, and you wanted to make a backup copy in ~/backup.  You
+would use this command:
+
+.br
+.RS
+$ task push ~/backup/
+.RE
+
+This would copy the files in ~/.task to ~/backup, overwriting the files that
+were already in ~/backup.  To backup your files to another machine, you could
+use:
+
+.br
+.RS
+$ task push user@host:backup
+.RE
+
+This could be improved by setting the
+.B push.default.uri
+configuration variable and then relying on the default, like this:
+
+.br
+.RS
+$ task config push.default.uri user@host:backup
+.RE
+
+and then you need only run the push command:
+
+.br
+.RS
+$ task push
+.RE
+
+and the default push URI will be used.  If you wanted to restore a backup, you
+simply use the pull command instead:
+
+.br
+.RS
+$ task pull user@host:backup
+.RE
+
+This can be simplified by setting the
+.B pull.default.uri
+configuration variable and then relying on the default, like this:
+
+.br
+.RS
+$ task config pull.default.uri user@host:backup
+.RE
+
+Note that pull and push will blindly overwrite the task files without any
+merging.  Be careful.
+
+.SH EXAMPLE - Keeping two task databases synchronized
+The most common synchronization will be to keep two task databases synchronized
+on different machines.  Here is a full example, including setup that illustrates
+this.
+
+Suppose there are two machines, named 'local' and 'remote', for simplicity.
+Taskwarrior is installed on both machines.  The different machines are
+indicated here by the prompt.  Suppose Alice enters two tasks on her local
+machine:
+
+.br
+.RS
+local> task add Deliver the new budget proposal due:tuesday
+.br
+local> task add Set up a meeting with Bob
+.RE
+
+Then later adds a task on the remote machine:
+
+.br
+.RS
+remote> task add Present the budget proposal at the big meeting due:thursday
+.RE
+
+Now on the local machine, Alice merges the two task databases:
+
+.br
+.RS
+local> task merge alice@remote:.task
+.br
+Would you like to push the changes to 'alice@remote:.task'?  Y
+.RE
+
+Taskwarrior has combined the two task databases on local, then pushed the
+changes back to remote.  Now suppose Alice changes the due date for task 1
+on remote:
+
+.br
+.RS
+remote> task 1 due:wednesday
+.RE
+
+Now on the local machine, Alice sets up a default URI and autopush:
+
+.br
+.RS
+local> task config merge.default.uri alice@remote:.task
+.br
+local> task config merge.autopush yes
+.RE
+
+Now Alice can simply run merge to make sure that the new due date is copied to
+the local machine:
+
+.br
+.RS
+local> task merge
+.RE
+
+This time the URI is determined automatically, and after the merge the files are
+pushed back to the remote machine.  In a similar way, the remote machine can
+also be configured to merge from the local machine and push back to it.  Then it
+is just a matter of Alice remembering to merge now and then, from either
+machine, to have her data in two (or even more) places.
+
+.SH CONFIGURATION
+By setting these configuration variables, it is possible to simplify the
+synchronization commands, by relying on the defaults or alias names.
+
+.br
+.B merge.autopush=yes|no|ask
+.RS
+This controls whether the automatic push after a merge is performed, not
+performed, or whether the user is asked every time.  The default value is 'ask'.
+.RE
+
+.br
+.B merge.default.uri=<uri>
+.RS
+Sets a default URI so that just the 'task merge' command be run without the
+need to retype the URI every time. You can also use this configuration scheme
+to set alias names, e.g. set merge.desktop.uri and run 'task merge desktop'.
+.RE
+
+.br
+.B push.default.uri=<uri>
+.RS
+Sets a default URI so that just the 'task push' command be run without the
+need to retype the URI every time. You can also use this configuration scheme
+to set alias names, e.g. set push.desktop.uri and run 'task push desktop'.
+.RE
+
+.br
+.B pull.default.uri=<uri>
+.RS
+Sets a default URI so that just the 'task pull' command be run without the
+need to retype the URI every time. You can also use this configuration scheme
+to set alias names, e.g. set pull.desktop.uri and run 'task pull desktop'.
+.RE
+
+Note that, when using SSH/scp, hostnames will be expanded due to the ssh 
+configuration file ~/.ssh/config.
+
+.SH EXTERNAL DEPENDENCIES
+Depending on the URI protocols used, the utilities 'scp', 'rsync' and 'curl'
+must be installed and accessible via the $PATH environment variable.
+
+If you have deleted your ~/.task/undo.data file to save space, you will be
+unable to merge.  The change transactions stored in the undo.data file are
+used for synchronization.
+
+.SH "CREDITS & COPYRIGHTS"
+task was written by P. Beckingham <paul@beckingham.net>.
+.br
+Copyright (C) 2006 \- 2011 P. Beckingham, F. Hernandez.
+
+The sync capabilities were written by J. Schlatow.
+Parts copyright (C) 2010 - 2011 J. Schlatow.
+
+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),
+.BR task-tutorial(5),
+.BR ssh_config(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.in

@@ -0,0 +1,788 @@
+.TH task 1 2011-03-03 "${PACKAGE_STRING}" "User Manuals"
+
+.SH NAME
+task \- A command line todo manager.
+
+.SH SYNOPSIS
+.B task [subcommand] [args]
+
+.SH DESCRIPTION
+Taskwarrior 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.
+
+At the core, taskwarrior is a list processing program. You add text and
+additional related parameters and redisplay the information in a nice way.  It
+turns into a todo list program when you add due dates and recurrence. It turns
+into an organized todo list program when you add priorities, tags (one word
+descriptors), project groups, etc.  Taskwarrior turns into an organized to do
+list program when you modify the configuration file to have the output displayed
+the way you want to see it.
+
+.SH SUBCOMMANDS
+
+.TP
+.B add [tags] [attrs] description
+Adds a new task to the task list.
+
+.TP
+.B log [tags] [attrs] description
+Adds a new task that is already completed, to the task list.
+
+.TP
+.B annotate ID description
+Adds an annotation to an existing task.
+
+.TP
+.B denotate ID description
+Deletes an annotation for the specified task. If the provided description
+matches an annotation exactly, the corresponding annotation is deleted. If the
+provided description matches annotations partly, the first partly matched
+annotation is deleted.
+
+.TP
+.B info ID
+Shows all data and metadata for the specified task.
+
+.TP
+.B ID
+With an ID but no specific command, taskwarrior runs the "info" command.
+
+.TP
+.B undo
+Reverts the most recent action.  Obeys the confirmation setting.
+
+.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 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 that are currently used by pending tasks, and the
+number of tasks for each.
+
+.TP
+.B tags
+Show a list of all tags used.  Any special tags used are highlighted.
+
+.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.  Alias to history.monthly.
+
+.TP
+.B history.annual
+Shows a report of task history by year.
+
+.TP
+.B ghistory
+Shows a graphical report of task status by month.  Alias to ghistory.monthly.
+
+.TP
+.B ghistory.annual
+Shows a graphical report of task status by year.
+
+.TP
+.B burndown.daily
+Shows a graphical burndown chart, by day.
+
+.TP
+.B burndown.weekly
+Shows a graphical burndown chart, by week.
+
+.TP
+.B burndown.monthly
+Shows a graphical burndown chart, 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 in a variety of formats, from file or URL.
+
+.TP
+.B export
+Exports all tasks in the default format.  This is an alias to the command
+export.yaml.  Redirect the output to a file, if you wish to save it, or pipe it
+to another command.
+
+.TP
+.B export.csv
+Exports all tasks in CSV format.
+Redirect the output to a file, if you wish to save it, or pipe it to another
+command.
+
+.TP
+.B export.ical
+Exports all tasks in iCalendar format.
+Redirect the output to a file, if you wish to save it, or pipe it to another
+command.
+
+.TP
+.B export.yaml
+Exports all tasks in YAML 1.1 format.
+Redirect the output to a file, if you wish to save it, or pipe it to another
+command.
+
+.TP
+.B merge URL
+Merges two task databases by comparing the modifications that are stored in the
+undo.data files. The location of the second undo.data file must be passed on as
+argument. URL may have the following syntaxes:
+
+	ssh://[user@]host.xz[:port]/path/to/undo.data
+
+	rsync://[user@]host.xz[:port]/path/to/undo.data
+
+	[user@]host.xz:path/to/undo.data
+
+	/path/to/local/undo.data
+
+You can set aliases for frequently used URLs in the .taskrc.
+
+.TP
+.B push URL
+Pushes the task database to a remote another location for distributing the
+changes made by the merge command.
+
+(See annotations above for valid URL syntaxes.)
+
+.TP
+.B pull URL
+Overwrites the task database with those files found at the URL.
+
+(See annotations above for valid URL syntaxes.)
+
+.TP
+.B color [sample | legend]
+Displays all possible colors, a named sample, or a legend containing all
+currently defined colors.
+
+.TP
+.B count [filter]
+Displays only a count of tasks matching the filter.
+
+.TP
+.B version
+Shows the taskwarrior version number
+
+.TP
+.B help
+Shows the long usage text.
+
+.TP 
+.B show [all | substring]"
+Shows all the current settings in the taskwarrior configuration file. If a
+substring is specified just the settings containing that substring will be
+displayed.
+
+.TP
+.B config [name [value | '']]
+Add, modify and remove settings directly in the taskwarrior configuration.
+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
+
+.SH MODIFYING SUBCOMMANDS
+
+.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.
+
+If either 'from' or 'to' contain spaces, you will need to put quotes around
+the whole thing.
+
+.TP
+.B ID /from/to/g
+Performs all substitutions on task description and annotation for fixing
+mistakes.
+
+If either 'from' or 'to' contain spaces, you will need to put quotes around
+the whole thing.
+
+.TP
+.B edit ID
+Launches an editor to let you modify all aspects of a task directly.
+In general, this is not the recommended method of modifying tasks, but is
+provided for exceptional circumstances.  Use carefully.
+
+.TP
+.B append [tags] [attrs] description
+Appends information to an existing task.
+
+.TP
+.B prepend [tags] [attrs] description
+Prepends information to an existing task.
+
+.SH REPORT SUBCOMMANDS
+
+A report is a listing of information from the task database. There are several
+reports currently predefined in taskwarrior. 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 [filter]
+Shows all tasks matching the filter that are started but not completed.
+
+.TP
+.B all [filter]
+Shows all tasks matching the filter, including parents of recurring tasks.
+
+.TP
+.B completed [filter]
+Shows all tasks matching the filter that are completed.
+
+.TP
+.B minimal [filter]
+Provides a minimal listing of tasks matching the filter.
+
+.TP
+.B ls [filter]
+Provides a short listing of tasks matching the filter.
+
+.TP
+.B list [filter]
+Provides a more detailed listing of tasks matching the filter.
+
+.TP
+.B long [filter]
+Provides the most detailed listing of tasks with filter.
+
+.TP
+.B newest [filter]
+Shows the newest tasks with filter.
+
+.TP
+.B oldest [filter]
+Shows the oldest tasks with filter
+
+.TP
+.B overdue [filter]
+Shows all incomplete tasks matching the filter
+that are beyond their due date.
+
+.TP
+.B recurring [filter]
+Shows all recurring tasks matching the filter.
+
+.TP
+.B waiting [filter]
+Shows all waiting tasks matching the filter.
+
+.TP
+.B blocked [filter]
+Shows all blocked tasks, that are dependent on other tasks, matching the filter.
+
+.TP
+.B unblocked [filter]
+Shows all tasks that are not blocked by dependencies, matching the filter.
+
+.TP
+.B next [filter]
+Shows all tasks with upcoming due dates matching the filter.
+
+.SH FILTERS
+
+A filter is a set of search criteria that the report applies before displaying
+the results.  For example, to list all tasks belonging to the 'Home' project:
+
+    task list project:Home
+
+You can specify multiple filters, each of which further restrict the results:
+
+    task list project:Home +weekend garden
+
+This example applies three filters: the 'Home' project, the 'weekend' tag, and
+the description or annotations must contain the characters 'garden'.  In this
+example, 'garden' is translated internally to:
+
+    description.contains:garden
+
+as a convenient shortcut.  The 'contains' here is an attribute modifier, which
+is used to exert more control over the filter than simply absence or presence.
+See 'ATTRIBUTE MODIFIERS' for a complete list of modifiers.
+
+.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.
+
+Certain tags (called 'special tags'), can be used to affect the way tasks are
+treated.  For example, is a task has the special tag 'nocolor', then it is
+exempt from all color rules.  The supported special tags are:
+
+    +nocolor     Disable color rules processing for this task
+    +nonag       Completion of this task suppresses all nag messages
+    +nocal       This task will not appear on the calendar
+
+.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 tasks a report should show, if a positive
+integer is given.  The value 'page' may also be used, and will limit the
+report output to as many lines of text as will fit on screen.  This defaults
+to 25 lines.
+
+.TP
+.B wait:<wait-date>
+Date until task becomes pending.
+
+.TP
+.B depends:<id1,id2 ...>
+Declares this task to be dependent on id1 and id2.  This means that the tasks
+id1 and id2 should be completed before this task.  Consequently, this task will
+then show up on the 'blocked' report.
+
+.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 contains)
+.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
+
+The
+.I before
+modifier is used to compare values, preserving semantics, so project.before:B
+list all projects that begin with 'A'.  Priority 'L' is before 'M', and
+due:2011-01-01 is before due:2011-01-02.  The synonyms 'under' and 'below' are
+included to allow filters that read more naturally.
+
+The
+.I after
+modifier is the inverse of the
+.I before
+modifier.
+
+The
+.I none
+modifier requires that the attribute does not have a value.  For example:
+
+    task list priority:
+    task list priority.none:
+
+are equivalent, and list tasks that do not have a priority.
+
+The
+.I any
+modifier requires that the attribute has a value, but any value will suffice.
+
+The
+.I is
+modifier requires an exact match with the value.
+
+The
+.I isnt
+modifier is the inverse of the
+.I is
+modifier.
+
+The
+.I has
+modifier is used to search for a substring, such as:
+
+    task list description.has:foo
+    task list foo
+
+which are equivalent and will return any task that has 'foo' in the description
+or annotations.
+
+The
+.I hasnt
+modifier is the inverse of the
+.I has
+modifier.
+
+The
+.I startswith
+modifier matches against the left, or beginning of an attribute, such that:
+
+    task list project.startswith:H
+    task list project:H
+
+are equivalent and will match any project starting with 'H'.
+
+The
+.I endswith
+modifier matches against the right, or end of an attribute.
+
+The
+.I word
+modifier requires that the attribute contain the whole word specified, such
+that this:
+
+    task list description.word:bar
+
+will match the description 'foo bar baz' but does not match 'dog food'.
+
+The
+.I noword
+modifier is the inverse of the
+.I word
+modifier.
+
+.SH SPECIFYING DATES AND FREQUENCIES
+
+.SS DATES
+Taskwarrior 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 taskwarrior 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
+.br
+task ... due:3wks
+.br
+task ... due:1day
+.br
+task ... due:9hrs
+
+.TP
+Start of (work) week (Monday), calendar week (Sunday or Monday), month and year
+.br
+task ... due:sow
+.br
+task ... due:soww
+.br
+task ... due:socw
+.br
+task ... due:som
+.br
+task ... due:soy
+
+.TP
+End of (work) week (Friday), calendar week (Saturday or Sunday), month and year
+.br
+task ... due:eow
+.br
+task ... due:eoww
+.br
+task ... due:eocw
+.br
+task ... due:eom
+.br
+task ... due:eoy
+
+.TP
+At some point or later
+.br
+task ... wait:later
+.br
+task ... wait:someday
+
+This sets the wait date to 1/18/2038.
+
+.TP
+Next occurring weekday
+task ... due:fri
+.RE
+
+.SS FREQUENCIES
+Recurrence periods. Taskwarrior 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 taskwarrior commands may be abbreviated as long as a unique prefix is used,
+for example:
+
+.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 taskwarrior to treat all other args
+as description:
+
+.RS
+$ task add -- project:Home needs scheduling
+.RE
+
+In other situations, the shell sees spaces and breaks up arguments.  For
+example, this command:
+
+.RS
+$ task 123 /from this/to that/
+.RE
+
+is broken up into several arguments, which is corrected with quotes:
+
+.RS
+$ task 123 "/from this/to that/"
+.RE
+
+.SH CONFIGURATION FILE AND OVERRIDE OPTIONS
+Taskwarrior 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"
+Taskwarrior was written by P. Beckingham <paul@beckingham.net>.
+.br
+Copyright (C) 2006 \- 2011 P. Beckingham
+
+This man page was originally written by P.C. Shyamshankar, and has been modified
+and supplemented by Federico Hernandez.
+
+Thank also to T. Charles Yun.
+
+Taskwarrior 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),
+.BR task-sync(5)
+
+For more information regarding taskwarrior, 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 taskwarrior may be reported to the issue-tracker at
+<http://taskwarrior.org>

doc/misc/grammar.bnf

@@ -0,0 +1,241 @@
+# This document defines the BNF grammar that will be supported in Taskwarrior
+# 2.1.
+
+
+# Commands (alphabetically)
+
+command_add         ::= "add" ws+ task-elements ;
+
+command_annotate    ::= "annotate" ws+ range ws+ words ;
+
+command_append      ::= "append" ws+ range ws+ words ;
+
+command_burndown    ::= "burndown.monthly" ws+ filter
+                      | "burndown.weekly"  ws+ filter
+                      | "burndown.daily"   ws+ filter
+                      | "burndown.monthly"
+                      | "burndown.weekly"
+                      | "burndown.daily"
+                      ;
+
+command_calendar    ::= "calendar" ws+ "due" ws+ filter
+                      | "calendar" ws+ "due"
+                      | "calendar" ws+ "y" ws+ filter
+                      | "calendar" ws+ "y"
+                      | "calendar" ws+ year ws+ filter
+                      | "calendar" ws+ year
+                      | "calendar" ws+ year ws+ month ws+ filter
+                      | "calendar" ws+ year ws+ month
+                      | "calendar" ws+ month-name ws+ filter
+                      | "calendar" ws+ month-name
+                      | "calendar" ws+ filter
+                      | "calendar"
+                      ;
+
+command_colors      ::= "colors" ws+ "legend"
+                      | "colors" ws+ "sample"
+                      | "colors"
+                      ;
+
+command_config      ::= "config" ws+ word ws+ words
+                      | "config" ws+ word
+                      ;
+
+command_count       ::= "count" ws+ filter
+                      | "count"
+                      ;
+
+# TODO en-passant
+command_delete      ::= "delete" ws+ range ;
+
+command_denotate    ::= "denotate" ws+ range ws+ pattern ;
+
+command_diagnostics ::= "diagnostics" ;
+
+# TODO en-passant
+command_done        ::= "done" ws+ range ;
+
+# TODO en-passant
+command_duplicate   ::= "duplicate" ws+ range ;
+
+command_edit        ::= "edit" ws+ range ;
+
+command_ghistory    ::= "ghistory.annual"  ws+ filter
+                      | "ghistory.monthly" ws+ filter
+                      | "ghistory.weekly"  ws+ filter
+                      | "ghistory.daily"   ws+ filter
+                      | "ghistory.annual"
+                      | "ghistory.monthly"
+                      | "ghistory.weekly"
+                      | "ghistory.daily"
+                      ;
+
+command_help        ::= "help" ;
+
+command_history     ::= "history.annual"  ws+ filter
+                      | "history.monthly" ws+ filter
+                      | "history.weekly"  ws+ filter
+                      | "history.daily"   ws+ filter
+                      | "history.annual"
+                      | "history.monthly"
+                      | "history.weekly"
+                      | "history.daily"
+                      ;
+
+command_import      ::= "import" ws+ file
+                      | "import" ws+ "-"
+                      ;
+
+command_info        ::= "info" ws+ range
+                      ;
+
+command_log         ::= "log" ws+ task-elements ;
+
+command_merge       ::= "merge" ws+ url ;
+
+command_prepend     ::= "prepend" ws+ range ws+ words ;
+
+command_projects    ::= "projects" ws+ filter
+                      | "projects"
+                      ;
+
+command_pull        ::= "pull" ws+ url ;
+
+command_push        ::= "push" ws+ url ;
+
+command_shell       ::= "shell" ;
+
+command_show        ::= "show" ws+ pattern
+                      | "show"
+                      ;
+
+command_start       ::= "start" ws+ range
+                      | "start"
+                      ;
+
+command_stats       ::= "statistics" ws+ filter
+                      | "statistics"
+                      ;
+
+command_stop        ::= "stop" ws+ range
+                      | "stop"
+                      ;
+
+command_summary     ::= "summary" ws+ filter
+                      | "summary"
+                      ;
+
+command_tags        ::= "tags" ;
+
+command_timesheet   ::= "timesheet" ws+ digit
+                      | "timesheet"
+                      ;
+
+command_undo        ::= "undo" ;
+
+command_version     ::= "version" ;
+
+# command_report      ::= report ws+ filter ;
+
+
+# Helper Commands (alphabetically)
+
+helper_query        ::= "query" ws+ filter
+                      | "query"
+                      ;
+
+
+# Primitives
+range               ::=   ;
+id-equivalent       ::= uuid | id ;
+id                  ::= digit+ ;
+uuid                ::=   ;
+attribute           ::=   ;
+modifier            ::=   ;
+
+task-elements       ::= task-element+ ;
+
+task-element        ::= attribute ws+
+                      | tag ws+
+                      | word ws+
+                      ;
+
+filter              ::= filter-elements+ ;
+
+filter-elements     ::= range
+                      | pattern
+                      | filter-attribute ;
+
+filter-attribute    ::= field modifier? ":" value? ;
+
+modifier            ::= ".above"
+                      | ".after"
+                      | ".any"
+                      | ".before"
+                      | ".below"
+                      | ".contains"
+                      | ".endswith"
+                      | ".equals"
+                      | ".has"
+                      | ".hasnt"
+                      | ".is"
+                      | ".isnt"
+                      | ".left"
+                      | ".none"
+                      | ".not"
+                      | ".noword"
+                      | ".over"
+                      | ".right"
+                      | ".startswith"
+                      | ".under"
+                      | ".word"
+                      ;
+
+value               ::=   ;
+
+year                ::= digit digit digit digit ;
+
+month               ::= "1" | "2" | "3" |  "4" |  "5" |  "6"
+                      | "7" | "8" | "9" | "10" | "11" | "12"
+                      ;
+
+# TODO Case-insensitive
+month-name          ::= "january"
+                      | "february"
+                      | "march"
+                      | "april"
+                      | "may"
+                      | "june"
+                      | "july"
+                      | "august"
+                      | "september"
+                      | "october"
+                      | "november"
+                      | "december"
+                      ;
+
+filter-attribute    ::= field "." modifier ":" value
+                      | field "." modifier ":"
+                      | field ":" value
+                      | field ":"
+                      ;
+
+tag                 ::= "+" word
+                      | "-" word ;
+
+substitution        ::= "/" pattern "/" words "/" "g"? ;
+
+pattern             ::=   ;
+url                 ::=   ;
+file                ::=   ;
+words               ::=   ;
+word                ::=   ;
+
+
+# Fundamentals
+
+digit               ::= "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" ;
+ws                  ::= " " | "\t" ;
+
+# End
+

doc/misc/run.193

@@ -0,0 +1,533 @@
+#! /bin/bash
+
+rm -f /Users/paul/.task/pending.data /Users/paul/.task/completed.data /Users/paul/.task/undo.data
+
+echo 'data.location=~/.task' > /Users/paul/.taskrc
+echo 'color=off' >> /Users/paul/.taskrc
+echo 'color.summary.background=on gray3' >> /Users/paul/.taskrc
+echo '#include /usr/local/share/doc/task/rc/dark-blue-256.theme' >> /Users/paul/.taskrc
+echo '#include /usr/local/share/doc/task/rc/dark-red-256.theme' >> /Users/paul/.taskrc
+echo '#include /usr/local/share/doc/task/rc/dark-256.theme' >> /Users/paul/.taskrc
+
+# 1 Intro
+
+# 2 Basic usage
+echo Basic usage --------------------------------------------------------------
+echo $ task add Select a free weekend in November
+task add Select a free weekend in November
+echo $ task add Select and book a venue
+task add Select and book a venue
+echo $ task add Come up with a guest list
+task add Come up with a guest list
+echo $ task add Mail invitations
+task add Mail invitations
+echo $ task add Select a caterer
+task add Select a caterer
+echo $ task list
+task list
+echo $ task log Order a special cake
+task log Order a special cake
+echo $ task 4 duplicate /Mail/Design/
+task 4 duplicate /Mail/Design/
+echo $ task 4 duplicate /Mail/Print/
+task 4 duplicate /Mail/Print/
+echo $ task list
+task list
+echo $ task 3 done
+task 3 done
+echo $ task list
+task list
+
+# 3 Projects
+echo Projects --------------------------------------------------------------
+echo $ task add Pay teh rent on teh 31st
+task add Pay teh rent on teh 31st
+echo $ task 7 /teh/the/g
+task 7 /teh/the/g
+echo $ task list
+task list
+echo $ task 7 project:home
+task 7 project:home
+echo $ task 1-6 project:party
+echo 'All' | task 1-6 project:party
+echo $ task projects
+task projects
+echo $ task list project:home
+task list project:home
+echo $ task li pro:par
+task li pro:par
+
+# 4 Priorities
+echo Priorities --------------------------------------------------------------
+echo $ task 1-3,5 priority:H
+echo 'All' | task 1-3,5 priority:H
+echo $ task list
+task list
+echo $ task 3 pri:
+task 3 pri:
+
+# 5 Tags
+echo Tags --------------------------------------------------------------
+echo $ task list
+task list
+echo $ task 3,5,6 +mall
+echo 'All' | task 3,5,6 +mall
+echo $ task long
+task long
+echo $ task list +mall
+task list +mall
+echo $ task 3 -mall
+task 3 -mall
+
+# 6 Modifications
+echo Modifications --------------------------------------------------------------
+echo $ task 7 Pay rent at the end of the month
+echo 'Yes' | task 7 Pay rent at the end of the month
+echo $ task add music
+task add music
+echo $ task 8 prepend Select some
+task 8 prepend Select some
+echo $ task 8 append for after dinner
+task 8 append for after dinner
+echo $ task list
+task list
+echo $ task edit
+#task edit
+echo $ task add Hire a band?
+#task add Hire a band?
+echo $ task add Hire a band\?
+#task add Hire a band\?
+echo $ task add "Hire a band?"
+#task add "Hire a band?"
+echo $ task add -- Hire a band\? +dj
+task add -- Hire a band\? +dj
+echo $ task undo
+echo 'y' | task undo
+echo $ task 1 delete
+echo 'y' | task 1 delete
+echo $ task undo
+echo 'y' | task undo
+
+# 7 Info
+echo Info --------------------------------------------------------------
+echo $ task 1 info
+task 1 info
+echo $ task stats
+task stats
+
+# 8 Annotations
+echo Annotations --------------------------------------------------------------
+echo $ task 1 annotate the 13 looks good
+task 1 annotate the 13 looks good
+sleep 1
+echo $ task 1 annotate or the 14th
+task 1 annotate or the 14th
+echo $ task list
+task list
+echo $ task list rc.annotations:full
+task list rc.annotations:full
+echo $ task list rc.annotations:sparse
+task list rc.annotations:sparse
+echo $ task list rc.annotations:none
+task list rc.annotations:none
+echo $ task 1 denotate 14th
+task 1 denotate 14th
+echo $ task list
+task list
+
+# 9 Configuration
+echo Configuration --------------------------------------------------------------
+echo $ task show
+task show
+echo $ task config answer forty-two
+echo 'y' | task config answer forty-two
+echo $ task show answer
+task show answer
+echo $ task config answer
+echo 'y' | task config answer
+echo $ task rc.report.list.sort=description+ list
+task rc.report.list.sort=description+ list
+
+# 10 Defaults
+echo Defaults --------------------------------------------------------------
+echo $ task config default.command list
+echo 'y' | task config default.command list
+echo $ task 
+task 
+echo $ task config default.priority H
+echo 'y' | task config default.priority H
+echo $ task config default.project Work
+echo 'y' | task config default.project Work
+echo $ task add New task
+task add New task
+echo $ task list
+task list
+echo $ task undo
+echo 'y' | task undo
+echo $ task config default.priority
+echo 'y' | task config default.priority
+echo $ task config default.project
+echo 'y' | task config default.project
+
+# 11 Aliases
+echo Aliases --------------------------------------------------------------
+echo $ task config alias.zzz list
+echo 'y' | task config alias.zzz list
+echo $ task zzz
+task zzz
+echo $ task z
+task z
+
+# 12 Color
+echo Color --------------------------------------------------------------
+echo $ task config color on
+echo 'y' | task config color on
+echo $ task list
+task list
+echo $ task 1 bg:on_red
+task 1 bg:on_red
+echo $ task list
+task list
+echo $ task 1 bg:
+task 1 bg:
+echo $ task color
+task color
+echo $ task color white on red
+task color white on red
+echo $ task color legend
+task color legend
+echo vi ~/.taskrc # include /usr/local/share/doc/task/rc/dark-blue-256.theme
+#vi ~/.taskrc # include /usr/local/share/doc/task/rc/dark-blue-256.theme
+echo 'include /usr/local/share/doc/task/rc/dark-blue-256.theme' >> x
+echo $ task color legend
+task color legend
+echo $ task list
+task list
+echo vi ~/.taskrc # include /usr/local/share/doc/task/rc/dark-red-256.theme
+#vi ~/.taskrc # include /usr/local/share/doc/task/rc/dark-red-256.theme
+sed 's/blue/red/' x >x2 && mv x2 x
+echo $ task color legend
+task color legend
+echo $ task list
+task list
+echo vi ~/.taskrc # include /usr/local/share/doc/task/rc/dark-256.theme
+#vi ~/.taskrc # include /usr/local/share/doc/task/rc/dark-256.theme
+sed 's/red-//' x >x2 && mv x2 x
+echo $ task list
+task list
+echo $ task "rc.color.project.party=on rgb001" rc.color.keyword.invit=bold list
+task "rc.color.project.party=on rgb001" rc.color.keyword.invit=bold list
+echo $ man task-color
+#man task-color
+
+# 13 Active tasks
+echo Active tasks --------------------------------------------------------------
+echo $ task 2 start
+task 2 start
+echo $ task list
+task list
+echo $ task active
+task active
+echo $ task 2 stop
+task 2 stop
+
+echo $ task config journal.time on
+task config journal.time on
+echo $ task config rc.dateformat.xxx xxx
+task config rc.dateformat.xxx xxx
+echo $ task config dateformat.annotation 'Y/m/d H:N'
+task config dateformat.annotation 'Y/m/d H:N'
+echo $ task 2 start
+task 2 start
+echo $ task list venue
+task list venue
+echo $ task 2 stop
+task 2 stop
+echo $ task list venue
+task list venue
+
+# 14 Due dates
+echo Due dates --------------------------------------------------------------
+echo $ task 1 due:7/31/2010
+task 1 due:7/31/2010
+echo $ task 1 due:2wks
+task 1 due:2wks
+echo $ task 1 due:-2wks
+task 1 due:-2wks
+echo $ task 1 due:eom
+task 1 due:eom
+echo $ task 2 due:8th
+task 2 due:8th
+echo $ task 2 due:sunday
+task 2 due:sunday
+echo $ task 5 due:eow
+task 5 due:eow
+echo $ task list
+task list
+echo $ task overdue
+task overdue
+echo $ task rc.dateformat.report:Y-M-DTH:N:SZ list
+task rc.dateformat.report:Y-M-DTH:N:SZ list
+
+# 15 Calendar
+echo Calendar --------------------------------------------------------------
+echo $ task calendar
+task calendar
+echo $ vi ~/.taskrc # include /usr/local/share/doc/task/rc/holidays-US.rc
+#vi ~/.taskrc # include /usr/local/share/doc/task/rc/holidays-US.rc
+echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
+echo $ task calendar
+task calendar
+echo $ task cal 2010
+task cal 2010
+echo $ task rc.calendar.details:full cal
+task rc.calendar.details:full cal
+echo $ task rc.calendar.holidays:full cal
+task rc.calendar.holidays:full cal
+
+# 16 Recurrence
+echo Recurrence --------------------------------------------------------------
+echo $ task 7 info
+task 7 info
+echo $ task 7 due:eom recur:monthly
+task 7 due:eom recur:monthly
+echo $ task 7
+task 7
+echo $ task 7 until:eoy
+task 7 until:eoy
+echo $ task recurring
+task recurring
+echo $ task add Pay taxes due:4/15/2007 recur:yearly
+task add Pay taxes due:4/15/2007 recur:yearly
+echo $ task long
+task long
+echo $ task 11 delete
+printf "y\ny\n" | task 11 delete      # y, y
+echo $ task list
+task list
+
+# 17 Shell
+echo Shell --------------------------------------------------------------
+echo $ task shell
+#task shell
+echo '> projects'
+#> projects
+echo '> tags'
+#> tags
+echo '> list'
+#> list
+echo '> quit'
+#> quit
+
+# 18 Special tags
+echo Special tags --------------------------------------------------------------
+echo $ task 6 +nocolor
+task 6 +nocolor
+echo $ task list
+task list
+echo $ task tags
+task tags
+echo $ task 6 -nocolor
+task 6 -nocolor
+
+# 19 Waiting
+echo Waiting --------------------------------------------------------------
+echo $ task add Look for new apartment due:eoy
+task add Look for new apartment due:eoy
+echo $ task list
+task list
+echo $ task 10 wait:12/1/2010
+task 10 wait:12/1/2010
+echo $ task list
+task list
+echo $ task waiting
+task waiting
+echo $ task add Do something in a few seconds
+task add Do something in a few seconds
+echo $ task 11 wait:5s
+task 11 wait:5s
+echo $ task list
+task list
+sleep 5
+echo $ task list
+task list
+echo $ task 11 rc.confirmation:no delete
+task 11 rc.confirmation:no delete
+
+# 20 Dependencies
+echo Dependencies --------------------------------------------------------------
+echo $ task list pro:party
+task list pro:party
+echo $ task 3 depends:6
+task 3 depends:6
+echo $ task 6 dep:5
+task 6 dep:5
+echo $ task 2 dep:1
+task 2 dep:1
+echo $ task 5 dep:1,2
+task 5 dep:1,2
+echo $ task 4 dep:1
+task 4 dep:1
+echo $ task long pro:party
+task long pro:party
+echo $ task 5 dep:-1
+task 5 dep:-1
+echo $ task blocked
+task blocked
+echo $ task unblocked
+task  unblocked
+echo $ task 1 info
+task  1 info
+echo $ task 2 info
+task  2 info
+echo $ task 2 done
+echo 'y' | task  2 done
+echo $ task 1 info
+task  1 info
+
+# 21 Reports
+echo Reports --------------------------------------------------------------
+echo $ task minimal
+task  minimal
+echo $ task ls
+task  ls
+echo $ task list
+task  list
+echo $ task long
+task  long
+echo $ task all
+task  all
+echo $ task completed
+task  completed
+echo $ task recurring
+task  recurring
+echo $ task waiting
+task  waiting
+echo $ task blocked
+task  blocked
+echo $ task oldest
+task  oldest
+echo $ task newest
+task  newest
+echo $ task timesheet
+task  timesheet
+echo $ task next
+task  next
+
+# 22 Custom report
+echo Custom report --------------------------------------------------------------
+echo 'report.foo.description=My own report'     >> x
+echo 'report.foo.columns=id,entry,description'  >> x
+echo 'report.foo.labels=ID,Entered,Description' >> x
+echo 'report.foo.sort=entry+,description+'      >> x
+echo 'report.foo.filter=status:pending'         >> x
+echo 'task help | grep foo'
+task  help | grep foo
+echo $ task show report.foo
+task  show report.foo
+echo $ task foo
+task  foo
+
+# 23 Charts
+echo Charts --------------------------------------------------------------
+echo $ task history
+task history
+echo $ task history.annual
+task history.annual
+echo $ task ghistory
+task ghistory
+echo $ task ghistory.annual
+task ghistory.annual
+echo $ task summary
+task summary
+
+# 24 Advanced filters
+echo Advanced filters --------------------------------------------------------------
+echo $ task list
+task  list
+echo $ task list invit
+task  list invit
+echo $ task list description.contains:invit
+task  list description.contains:invit
+echo $ task list desc.word:the
+task  list desc.word:the
+echo $ task list desc.noword:invitations
+task  list desc.noword:invitations
+echo $ task list pro:party
+task  list pro:party
+echo $ task list pro.is:party
+task  list pro.is:party
+echo $ task list pro.not:party
+task  list pro.not:party
+echo $ task list pro:party priority.over:L
+task  list pro:party priority.over:L
+echo $ task list pro:party limit:2
+task  list pro:party limit:2
+echo $ task list limit:page
+task  list limit:page
+echo $ task all status:pending
+task  all status:pending
+echo $ task all status:waiting
+task  all status:waiting
+
+# 25 Import/export
+echo Import/export --------------------------------------------------------------
+echo $ task export.csv
+task  export.csv
+echo $ task export.csv venue
+task  export.csv venue
+echo $ task export.vcalendar venue
+task  export.vcalendar venue
+echo $ task export.yaml venue
+task  export.yaml venue
+
+cat <<EOF >file.text
+Remember to read the task man page
+EOF
+cat file.text
+echo $ task import file.text
+printf "y\n" | task  import file.text
+
+cat <<EOF >file.yaml
+%YAML 1.1
+---
+  task:
+    description: Visit http://taskwarrior.org
+    due: 1281844800
+    entry: 1281289630
+    priority: H
+    project: work
+    status: pending
+    uuid: 23afada0-a446-8d5a-c213-30d99d52c4b0
+...
+EOF
+cat file.yaml
+echo $ task import file.yaml
+printf "y\n" | task  import file.yaml
+echo $ task new limit:2
+task  new limit:2
+
+# 26 Help
+echo Help --------------------------------------------------------------
+echo $ task help
+task  help
+echo $ man task
+#man task
+echo $ man taskrc
+#man taskrc
+echo $ man task-color
+#man task-color
+echo $ man task-tutorial
+#man task-tutorial
+echo $ man task-faq
+#man task-faq
+echo $ man task-sync
+#man task-sync
+
+# 27 Wrap up
+echo Wrap up --------------------------------------------------------------
+echo $ task version
+task  version
+
+exit
+

doc/misc/run.sample.annotate

@@ -0,0 +1,16 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=120' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
+echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
+echo 'color.alternate=' >> x
+
+exit
+

doc/misc/run.sample.attmod

@@ -0,0 +1,16 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=120' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
+echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
+echo 'color.alternate=' >> x
+
+exit
+

doc/misc/run.sample.blue

@@ -0,0 +1,74 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=120' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-blue-256.theme' >> x
+echo 'color.alternate=' >> x
+
+echo 'report.list.columns=id,project,priority_long,start,due,recur,age_compact,tags,description' >> x
+echo 'report.list.labels=ID,Project,Pri,Started,Due,Recur,Age,Tags,Description' >> x
+echo 'report.list.sort=due+,priority_long-,project+' >> x
+
+# Import tasks with old timestamps
+cat <<EOF >file.yaml
+%YAML 1.1
+---
+  task:
+    description: Try out the color themes
+    entry: 1281914800
+    start: 1282044800
+    project: software
+    status: pending
+    uuid: 13afada0-a446-8d5a-c213-30d99d52c4b0
+  task:
+    description: Visit http://taskwarrior.org
+    entry: 1281089630
+    tags: www
+    priority: H
+    project: software
+    status: pending
+    uuid: 23afada0-a446-8d5a-c213-30d99d52c4b0
+  task:
+    description: Review task list
+    entry: 1281289630
+    due: 1282844800
+    recur: weekly
+    project: gtd
+    status: pending
+    uuid: 33afada0-a446-8d5a-c213-30d99d52c4b0
+  task:
+    description: Try out latest FireFox beta
+    entry: 1281289630
+    project: software
+    status: pending
+    uuid: 43afada0-a446-8d5a-c213-30d99d52c4b0
+...
+EOF
+
+printf "y\n" | task rc:x import file.yaml
+
+# Now the visible part.
+echo
+echo '$ task 1 annotate Try the blue one first'
+task rc:x 1 annotate Try the blue one first
+
+echo
+echo '$ task list'
+task rc:x list
+
+echo
+echo '$ task list due.before:eow'
+task rc:x list due.before:eow
+
+echo
+echo '$ task 2 done'
+task rc:x 2 done
+
+exit
+

doc/misc/run.sample.cal

@@ -0,0 +1,71 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=120' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
+echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
+echo 'color.alternate=' >> x
+
+echo 'report.list.columns=id,project,priority_long,start,due,recur,age_compact,tags,description' >> x
+echo 'report.list.labels=ID,Project,Pri,Started,Due,Recur,Age,Tags,Description' >> x
+echo 'report.list.sort=due+,priority_long-,project+' >> x
+
+# Import tasks with old timestamps
+cat <<EOF >file.yaml
+%YAML 1.1
+---
+  task:
+    description: Try out the color themes
+    entry: 1281914800
+    start: 1282044800
+    project: software
+    status: pending
+    uuid: 13afada0-a446-8d5a-c213-30d99d52c4b0
+  task:
+    description: Visit http://taskwarrior.org
+    entry: 1281089630
+    tags: www
+    priority: H
+    project: software
+    status: pending
+    uuid: 23afada0-a446-8d5a-c213-30d99d52c4b0
+  task:
+    description: Review task list
+    entry: 1281289630
+    due: 1282844800
+    recur: weekly
+    project: gtd
+    status: pending
+    uuid: 33afada0-a446-8d5a-c213-30d99d52c4b0
+  task:
+    description: Try out latest FireFox beta
+    entry: 1281289630
+    project: software
+    status: pending
+    uuid: 43afada0-a446-8d5a-c213-30d99d52c4b0
+...
+EOF
+
+printf "y\n" | task rc:x import file.yaml
+
+# Now the visible part.
+echo
+echo '$ task calendar sep 2010'
+task rc:x calendar sep 2010
+
+echo
+echo '$ task calendar'
+task rc:x calendar
+
+echo
+echo '$ task overdue'
+task rc:x 2 done
+
+exit
+

doc/misc/run.sample.color

@@ -0,0 +1,19 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-green-256.theme' >> x
+
+
+# Now the visible part.
+echo
+echo '$ task color'
+task rc:x color
+
+exit
+

doc/misc/run.sample.deps

@@ -0,0 +1,38 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=120' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
+echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
+echo 'color.alternate=' >> x
+
+echo 'report.list.columns=id,project,priority_long,start,due,recur,age_compact,tags,description' >> x
+echo 'report.list.labels=ID,Project,Pri,Started,Due,Recur,Age,Tags,Description' >> x
+echo 'report.list.sort=due+,priority_long-,project+' >> x
+
+# Now the visible part.
+
+echo
+echo $ task add project:Cake Mix the ingredients
+task rc:x add project:Cake Mix the ingredients
+
+echo
+echo $ task add project:Cake Bake the cake depends:1
+task rc:x add project:Cake Bake the cake depends:1
+
+echo
+echo $ task add project:Cake Eat the cake depends:2
+task rc:x add project:Cake Eat the cake depends:2
+
+echo
+echo $ task 2 info
+task rc:x 2 info
+
+exit
+

doc/misc/run.sample.format

@@ -0,0 +1,50 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=95' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-256.theme' >> x
+echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
+echo 'color.alternate=' >> x
+echo 'due=6' >> x
+echo 'dateformat=YMD-H:N' >> x
+echo 'dateformat.report=YMD-H:N' >> x
+echo 'color.due=rgb530' >> x
+
+echo 'report.list.columns=id,project,priority_long,due,recur,description' >> x
+echo 'report.list.labels=ID,Pro,Pri,Due,Recur,Description' >> x
+echo 'report.list.sort=due+,priority_long-,project+' >> x
+
+# Now the visible part.
+echo
+echo '$ task config rc.dateformat YMD-H:N'
+echo "Are you sure you want to add 'dateformat' with a value of 'YMD-H:N'? (y/n) y"
+echo 'Config file .taskrc modified.'
+
+echo
+echo '$ task add Spa appointment due:20100917-11:30'
+task rc:x add Lunch with Sue due:20100917-11:30
+
+echo
+echo '$ task list'
+task rc:x list
+
+echo
+echo '$ task list rc.dateformat.report=m-d-Y'
+task rc:x list rc.dateformat.report=m-d-Y
+
+echo
+echo '$ task list rc.dateformat.report=YMDHNS'
+task rc:x list rc.dateformat.report=YMDHNS
+
+echo
+echo '$ task list rc.dateformat.report="A, B D, Y (wkV)"'
+task rc:x list rc.dateformat.report="A, B D, Y (wkV)"
+
+exit
+

doc/misc/run.sample.ghistory

@@ -0,0 +1,16 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=120' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
+echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
+echo 'color.alternate=' >> x
+
+exit
+

doc/misc/run.sample.holidays

@@ -0,0 +1,47 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=95' >> x
+echo 'monthsperline=3' >> x
+echo 'calendar.details.report=list' >> x
+echo 'calendar.details=full' >> x
+echo 'calendar.holidays=full' >> x
+echo 'calendar.legend=yes' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-green-256.theme' >> x
+echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
+
+# Import tasks with old timestamps
+cat <<EOF >file.yaml
+%YAML 1.1
+---
+  task:
+    description: Put some more sample screenshots on taskwarrior.org
+    entry: 1283593511
+    project: 1.9.3
+    status: pending
+    due: 1284647841
+    uuid: 89295b14-9e15-4771-9dd9-7e82cf8b67b5
+    annotation:
+      entry: 1283593519
+      description: Show the calendar with holidays
+    annotation:
+      entry: 1283693560
+      description: Show a task that is due
+...
+EOF
+
+printf "y\n" | task rc:x import file.yaml
+
+# Now the visible part.
+echo
+echo '$ task calendar'
+task rc:x calendar
+
+exit
+

doc/misc/run.sample.info

@@ -0,0 +1,39 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=95' >> x
+echo 'include /usr/local/share/doc/task/rc/light-256.theme' >> x
+echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
+echo 'color.alternate=on rgb253' >> x
+echo 'due=6' >> x
+echo 'color.due=color0' >> x
+echo 'color.tagged=color0' >> x
+
+echo 'report.list.columns=id,project,priority_long,due,recur,description' >> x
+echo 'report.list.labels=ID,Pro,Pri,Due,Recur,Description' >> x
+echo 'report.list.sort=due+,priority_long-,project+' >> x
+
+# Now the visible part.
+echo
+echo '$ task add Get stationery supplies proj:office pri:H due:sat +@mall +@weekend'
+task rc:x add Get stationery supplies proj:office pri:H due:sat +@mall +@weekend
+
+echo
+echo '$ task annotate 1 Remember to get batteries'
+task rc:x annotate 1 Remember to get batteries
+sleep 2
+
+echo
+echo '$ task annotate 1 I wonder if they have that antique fanfold computer paper'
+task rc:x annotate 1 I wonder if they have that antique fanfold computer paper
+
+echo
+echo '$ task 1 info'
+task rc:x 1 info
+

doc/misc/run.sample.journal

@@ -0,0 +1,42 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=90' >> x
+echo 'journal.time=yes' >> x
+echo 'dateformat.annotation=Y/m/d H:N' >> x
+#echo 'include /usr/local/share/doc/task/rc/dark-256.theme' >> x
+#echo 'include /usr/local/share/doc/task/rc/dark-green-256.theme' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-yellow-green.theme' >> x
+
+# Now the visible part.
+echo
+echo '$ task add Complete the client report due:friday +@work'
+task rc:x add Complete the client report due:friday +@work
+echo
+echo '$ task config journal.time on'
+echo "Are you sure you want to add 'journal.time' with a value of 'on'? (y/n) y"
+echo 'Config file .taskrc modified.'
+echo
+echo '$ task start 1'
+task rc:x start 1
+echo
+echo '(some work happens)'
+sleep 2
+echo
+echo '$ task list'
+task rc:x list
+echo
+echo '$ task stop 1'
+task rc:x stop 1
+echo
+echo '$ task list'
+task rc:x list
+
+exit
+

doc/misc/run.sample.recur

@@ -0,0 +1,35 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=95' >> x
+echo 'monthsperline=3' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
+echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
+echo 'color.alternate=' >> x
+echo 'due=3' >> x
+
+echo 'report.list.columns=id,project,priority_long,start,due,recur,age_compact,description' >> x
+echo 'report.list.labels=ID,Project,Pri,Started,Due,Recur,Age,Description' >> x
+echo 'report.list.sort=due+,priority_long-,project+' >> x
+
+# Now the visible part.
+echo
+echo '$ task add Deposit paycheck due:friday recur:14days +@bank'
+task rc:x add Deposit paycheck due:friday recur:14days
+
+echo
+echo '$ task calendar rc.recurrence.limit=6'
+task rc:x calendar rc.recurrence.limit=6
+
+echo
+echo '$ task list'
+task rc:x list
+
+exit
+

doc/misc/run.sample.red

@@ -0,0 +1,74 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=120' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-red-256.theme' >> x
+echo 'color.alternate=' >> x
+
+echo 'report.list.columns=id,project,priority_long,start,due,recur,age_compact,tags,description' >> x
+echo 'report.list.labels=ID,Project,Pri,Started,Due,Recur,Age,Tags,Description' >> x
+echo 'report.list.sort=due+,priority_long-,project+' >> x
+
+# Import tasks with old timestamps
+cat <<EOF >file.yaml
+%YAML 1.1
+---
+  task:
+    description: Try out the color themes
+    entry: 1281914800
+    start: 1282044800
+    project: software
+    status: pending
+    uuid: 13afada0-a446-8d5a-c213-30d99d52c4b0
+  task:
+    description: Visit http://taskwarrior.org
+    entry: 1281089630
+    tags: www
+    priority: H
+    project: software
+    status: pending
+    uuid: 23afada0-a446-8d5a-c213-30d99d52c4b0
+  task:
+    description: Review task list
+    entry: 1281289630
+    due: 1282844800
+    recur: weekly
+    project: gtd
+    status: pending
+    uuid: 33afada0-a446-8d5a-c213-30d99d52c4b0
+  task:
+    description: Try out latest FireFox beta
+    entry: 1281289630
+    project: software
+    status: pending
+    uuid: 43afada0-a446-8d5a-c213-30d99d52c4b0
+...
+EOF
+
+printf "y\n" | task rc:x import file.yaml
+
+# Now the visible part.
+echo
+echo '$ task 1 annotate Try the red one next'
+task rc:x 1 annotate Try the red one next
+
+echo
+echo '$ task list'
+task rc:x list
+
+echo
+echo '$ task 2 done'
+task rc:x 2 done
+
+echo
+echo '$ task summary'
+task rc:x summary
+
+exit
+

doc/misc/run.sample.summary

@@ -0,0 +1,16 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=120' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
+echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
+echo 'color.alternate=' >> x
+
+exit
+

doc/misc/run.sample.timesheet

@@ -0,0 +1,63 @@
+#! /bin/bash
+
+# Small script to create a fragment of output for display on the front page
+# of taskwarrior.org, as a teaser.
+
+rm pending.data completed.data undo.data
+
+echo 'data.location=.' > x
+echo '_forcecolor=on' >> x
+echo 'defaultwidth=120' >> x
+echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
+echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
+echo 'color.alternate=' >> x
+
+echo 'report.list.columns=id,project,priority_long,start,due,recur,age_compact,tags,description' >> x
+echo 'report.list.labels=ID,Project,Pri,Started,Due,Recur,Age,Tags,Description' >> x
+echo 'report.list.sort=due+,priority_long-,project+' >> x
+
+# Import tasks with old timestamps
+cat <<EOF >file.yaml
+%YAML 1.1
+---
+  task:
+    description: Try out the color themes
+    entry: 1281914800
+    start: 1282044800
+    project: software
+    status: pending
+    uuid: 13afada0-a446-8d5a-c213-30d99d52c4b0
+  task:
+    description: Visit http://taskwarrior.org
+    entry: 1281089630
+    tags: www
+    priority: H
+    project: software
+    status: pending
+    uuid: 23afada0-a446-8d5a-c213-30d99d52c4b0
+  task:
+    description: Review task list
+    entry: 1281289630
+    due: 1282844800
+    recur: weekly
+    project: gtd
+    status: pending
+    uuid: 33afada0-a446-8d5a-c213-30d99d52c4b0
+  task:
+    description: Try out latest FireFox beta
+    entry: 1281289630
+    project: software
+    status: pending
+    uuid: 43afada0-a446-8d5a-c213-30d99d52c4b0
+...
+EOF
+
+printf "y\n" | task rc:x import file.yaml
+
+# Now the visible part.
+echo
+echo '$ task timesheet 2'
+task rc:x timesheet 2
+
+exit
+

doc/misc/script-193.txt

@@ -0,0 +1,534 @@
+[Make window 116x32 for movie recording, light text, dark background]
+
+This is the script from which a 1.9.3-specific movie will be made.  On the left
+are the typed commands, and on the right is the voice track.
+
+It is intended that the left and right be combined and the result will be a new
+task-tutorial.5 man page.
+
+
+
+---------------------------------------- Intro -----------------------------------------------------
+
+http://taskwarrior.org                   Hello, and welcome to this taskwarrior version 1.9.3 demo.
+                                         I'm going to show you over 100 features, so don't blink, or
+                                         you'll miss some.  Even experienced users are going to learn
+                                         *something*.
+
+                                         I will start off with basic usage, and proceed to more
+                                         sophisticated commands as we go along.
+
+---------------------------------------- Basic Usage -----------------------------------------------
+
+                                         Let's get started.  We're planning a party, and there is a
+                                         lot of work to do, so let's capture these tasks.
+task add Select a free weekend in August First decide 'when'.
+task add Select and book a venue         Then decide 'where'.
+task add Come up with a guest list       Then decide 'who'.
+task add Mail invitations                Let's send out nice invitations.
+task add Select a caterer                And a caterer.
+
+task list                                Let's take a look.  Good.
+
+task log Order a special cake            Now I've already ordered a cake, so rather than 'add' this,
+                                         I'm going to 'log' it.  This just means that I want to keep
+                                         track of the task, but I've already done it.  It saves me a
+                                         step.
+
+task 4 duplicate /Mail/Design/           As for those invitations, I'm going to need to design them
+task 4 dup /Mail/Print/                  first.  And I'm also going to need print them.  Here we are
+task list                                duplicating a task and making a substitution.  Notice how
+                                         the commands can be abbreviated, provided they are still
+                                         unique.
+
+task 3 done                              That looks good - but now I think of it, I already have my
+task list                                guest list, so I can mark that one as done.
+
+                                         And that's basic usage, and you already know enough to be
+                                         productive using taskwarrior.  If you stopped here, you
+                                         would be perfectly able to manage your task list.
+
+                                         But if you want to see what it can really do, keep watching...
+
+---------------------------------------- Projects --------------------------------------------------
+
+task add Pay teh rent on teh 31st        Remember to pay the rent at the end of the month.  Oh,
+task 7 /teh/teh/g                        that was sloppy, but it can be fixed with a global
+task list                                substitution.
+
+task 7 project:home                      We can now use projects to separate home chores from the
+                                         party preparation.  Let's assign that last task to the
+                                         'home' project.  Note that a task may only belong to one
+                                         project.
+
+task 1-6 project:party                   And we will put those first six tasks in the 'party'
+                                         project.  See how we specify a range of tasks?  Taskwarrior
+                                         will want to confirm bulk changes like this, but we'll
+                                         accept all changes here.
+
+task projects                            Now that we have multiple projects, as shown here, we can
+task list project:home                   use project as a filter for the list report.  You can see
+task li pro:par                          again that we can abbreviate 'list' and 'project', but when
+                                         we abbreviate 'party', we are filtering all the projects
+                                         that begin with 'par'.
+
+---------------------------------------- Priorities ------------------------------------------------
+
+task 1-3,5 priority:H                    Priorities are another way to organize tasks.  You can use
+task list                                priority values of high, medium and low, and taskwarrior
+                                         knows these as H, M or L.
+
+task 3 pri:                              You can remove priorities by specifying a blank value.
+
+---------------------------------------- Tags ------------------------------------------------------
+
+task list                                A task may only have one project, but it may have any number
+                                         of tags, which are just single words associated with the task.
+
+task 3,5,6 +mall                         I can go to the print shop at the mall, and do all the
+                                         invitation tasks, so let's tag them all.
+
+task long                                The long report shows tags, too,
+
+task list +mall                          and I can use tags as a filter to any report too.
+
+task 3 -mall                             I made a mistake - I can't mail out the invitations at the
+                                         mall, so let's remove that tag.
+
+---------------------------------------- Modifications ---------------------------------------------
+
+task 7 Pay rent at the end of the month  Task 7 is not worded correctly, so I can modify that by
+                                         specifying a task ID and a new description.  This is also
+                                         considered a bulk change, and so requires confirmation.
+
+task add music                           We'll need music.
+task 8 prepend Select some               I can prepend to that.
+task 8 append for after dinner           I can append to that.
+task list
+
+task edit                                I can also go straight into an editor and modify anything.
+
+task add Hire a band?    <---            Sometimes the command will confuse the shell.  In this case,
+                                         what would happen if there was a file named 'bands' in the
+                                         current directory?  The shell would expand that wildcard,
+                                         so to avoid that, you can...
+task add Hire a band\?   <---            escape the wildcard...
+task add "Hire a band?"  <---            or quote the whole description...
+
+task add -- Hire a band\? +dj            You can also use the minus minus operator which tells
+                                         taskwarrior to stop being clever and interpret the rest
+                                         of the arguments as a task description.  Otherwise, that
+                                         +dj would be interpreted as a tag.
+
+task undo                                We don't need a band, so the easiest way to get rid of that
+                                         task is to undo the last change.  Taskwarrior has a
+                                         complete undo stack, so you can undo all the way back to
+                                         the beginning.
+task 1 delete                            The undo operation gets rid of the task completely, but I
+task undo                                could also have just deleted the task, then the deletion
+                                         itself would be tracked, and also undoable.
+
+---------------------------------------- Info ------------------------------------------------------
+
+task 1 info                              During that undo operation, taskwarrior displayed metadata
+task 1                                   that is associated with the task.  You can display this
+                                         with the info command, and its shortcut.
+
+task stats                               There are also statistics that taskwarrior gathers, which
+                                         I can display.
+
+---------------------------------------- Annotations -----------------------------------------------
+
+task 1 annotate the 12th looks good      Annotations are little notes that can be added to a task.
+task 1 annotate or the 13th              There can be any number, and each has a time stamp.
+task list
+task list rc.annotations:full            You can choose to display annotations in different ways.
+task list rc.annotations:sparse
+task list rc.annotations:none
+
+task 1 denotate 13th                     Annotations can be removed by providing a matching pattern.
+task list
+
+---------------------------------------- Configuration ---------------------------------------------
+
+task show                                There is a 'show' command, that is used to display the
+                                         active configuration.  There are hundreds of settings that
+                                         can be changed, and every one has a sensible default.
+
+man taskrc                               If you want a complete list of all the settings and their
+                                         meanings, read the man page.
+
+task config answer 42                    The 'config' command is used to modify the settings, and in
+                                         this case the configuration variable 'answer' is given the
+                                         value of 42.
+
+task show answer                         The 'show' command indicates that the value was changed,
+task config answer                       and also that the variable is unrecognized.  The show
+                                         command performs a detailed check on your configuration, and
+                                         alerts you to several kinds of problem.  The config command
+                                         can also remove a value.
+
+task rc.report.list.sort=description+ list
+                                         A very powerful feature is the ability to override the
+                                         configuration variables temporarily.  Here I am requesting
+                                         an ascending sort on the description field only.
+
+---------------------------------------- Defaults --------------------------------------------------
+
+task config default.command list         There is a default command, which can be set to anything,
+task                                     in this case it is set to the 'list' report.  Then running
+                                         taskwarrior with no command name runs the default command.
+
+task config default.priority H           I can also specify a default priority and project, which
+task config default.project Work         means that any tasks added will use them, unless an
+task add New task                        alternative is provided.
+task list
+
+task undo                                Let's just revert those changes, to clean up.
+task config default.priority
+task config default.project
+
+---------------------------------------- Aliases ---------------------------------------------------
+
+task config alias.zzz list               You can create aliases to effectively rename commands.
+task zzz
+
+task z                                   You can abbreviate those, too.
+
+---------------------------------------- Color -----------------------------------------------------
+
+task config color on                     All the examples so far have been shown with color turned
+task list                                off.  How about some color?
+
+                                         What you see is the result of a set of color rules being
+                                         applied to the tasks.  There is a hierarchy of color rules
+                                         that colorize a task based on the metadata
+
+task 1 "bg:on red"                       Here is an example of an explicit override to the color
+task list                                rules where a specific task is given a red background.
+task 1 bg:                               Note that the quotes are necessary, otherwise the shell
+                                         will consider "bg:on" and "red" to be separate arugments.
+
+task color                               Taskwarrior supports 256 colors on certain terminal
+                                         emulators, and this shows the range of colors available.
+
+task color white on red                  This is how to show a color sample.
+
+task color legend                        Or samples of all the active color settings.
+
+                                         Themes are a simple way to use coordinated color schemes
+                                         so by including a color theme into the configuration file,
+                                         you can see some striking effects.
+
+                                         A blue theme.
+
+# include /usr/local/share/doc/task/rc/dark-blue-256.theme
+vi ~/.taskrc
+task color legend
+task list
+                                         A red theme.
+
+# include /usr/local/share/doc/task/rc/dark-red-256.theme
+vi ~/.taskrc
+task color legend
+task list
+                                         A general dark theme.
+
+# include /usr/local/share/doc/task/rc/dark-256.theme
+vi ~/.taskrc
+task list
+
+                                         Here is are two color rules that specify a dark blue
+                                         background for all tasks that are part of the 'party'
+                                         project, and uses bold to identify any tasks with the
+                                         keyword 'invitations' in the description.
+
+task "rc.color.project.party=on rgb001" rc.color.keyword.invit=bold list
+
+man task-color                           There is a man page with a writeup of all the color
+                                         capabilities.
+
+---------------------------------------- Active tasks ----------------------------------------------
+
+task 2 start                             I'm selecting a venue, so let's indicate that task 2 is
+task list                                active by starting it.  See how active tasks are affected
+                                         by the color rules.
+
+task active                              There is an active report that shows only active tasks, and
+task 2 stop                              you can mark any active task as inactive, by stopping it.
+
+task config journal.time on (y)          There is a journalling feature that records the start and
+
+task config dateformat.annotation 'Y/m/d H:N' (y)
+
+task 2 start                             stop times as annotations.  We'll turn that on, and add
+task list venue                          the time to the annotation date format.
+task 2 stop
+task list venue
+
+---------------------------------------- Due dates -------------------------------------------------
+
+task 1 due:7/31/2010                     Due dates can be specified as dates...
+task 1 due:2wks                          as some distance into the future...
+task 1 due:-2wks                         or past...
+task 1 due:eom                           or by mnemonic (end of month)...
+task 2 due:8th                           or by ordinal...
+task 2 due:sunday                        or by day of week...
+task 5 due:eow                           
+task list                                Some of these dates are in the past, so now you see there
+task overdue                             are overdue tasks.  Due dates have different colors for
+                                         due, imminent, today and overdue values.
+
+task rc.dateformat.report:Y-M-DTH:N:SZ list
+                                         You can also choose the format - for input and output.
+
+---------------------------------------- Calendar --------------------------------------------------
+
+task calendar                            When tasks have due dates, you can see them on the calendar.
+
+vi ~/.taskrc
+# include /usr/local/share/doc/task/rc/holidays-US.rc
+task calendar
+                                         Taskwarrior provides sample holiday files.  You can create
+                                         your own, or use one of the samples to show holidays on the
+                                         calendar.
+
+task cal 2010                            You can see the whole year.
+task rc.calendar.details:full cal        You can see the tasks with due dates also.
+task rc.calendar.holidays:full cal       And you can see the holidays.
+
+---------------------------------------- Recurrence ------------------------------------------------
+
+task 7 info                              Remember the task we added to pay the rent?  We're going to
+task 7 due:eom recur:monthly             need to do that every month.  Recurring tasks allow us to
+task 7                                   set up a single task that keeps coming back, just as you'd
+                                         expect.
+
+task 7 until:eoy                         You can also limit the extent of the recurrence.  Let's make
+                                         sure the task doesn't recur after the lease ends.
+
+task recurring                           And there is a recurring report that shows you only the
+                                         recurring tasks.
+
+                                         To illustrate a point, let's set up a recurring annual task
+                                         as a reminder to pay taxes, and put the due date in the past.
+                                         This will cause task to fill in the gaps, and create a series
+                                         of severely overdue tasks.
+
+task add Pay taxes due:4/15/2007 recur:yearly
+task long
+
+task 11 delete    # y y                  Deletions to recurring tasks can be escalated to include all
+task list                                the recurrences of a task.
+
+---------------------------------------- Shell -----------------------------------------------------
+
+task shell                               You can use the shell command to create a more immersive
+task> projects                           environment.  Any task command you run outside the shell
+task> tags                               can also be run inside the shell, without the need to prefix
+task> list                               every command with "task".
+task> quit
+
+---------------------------------------- Special Tags ----------------------------------------------
+
+task 6 +nocolor                          You've seen tags, but there are also 'special tags' that
+task list                                have effects on individual tasks.  The 'nocolor' special
+                                         tag causes the color rules to be bypassed.
+
+task tags                                Special tags are highlighted by the 'tags' command.
+
+task 6 -nocolor                          There are others - the 'nonag' special tag prevents the
+                                         generation of nag messages when you work on low priority
+                                         tasks when there are more important ones.
+
+                                         The 'nocal' special tag will prevent a task from appearing
+                                         on the calendar.
+
+---------------------------------------- Waiting ---------------------------------------------------
+
+task add Look for new apartment due:eoy  When you have a task with a due date that is far out into
+task list                                the future, you may want to hide that task for a while.
+
+task 10 wait:12/1/2010                   You can provide a wait date for a task, and it will remain
+task list                                hidden until that date.  It will no longer be cluttering
+task waiting                             your task list, but it is still there, and visible using
+                                         the 'waiting' report.  When the wait date comes, the task
+                                         will just pop back into the list.
+
+task add Do something in a few seconds   To illustrate this, let's set up a task with a very short
+task 11 wait:5s                          wait time of five seconds.
+
+task list                                It's gone.
+(sleep 5)                                We wait for 5 seconds...
+task list                                And it's back.
+task 11 rc.confirmation:no delete        And now it's deleted.
+
+---------------------------------------- Dependencies ----------------------------------------------
+
+task list pro:party                      Taskwarrior supports dependencies.  Let's take a look at the
+                                         party planning tasks, and assign dependencies.
+
+task 3 depends:6                         Let's see.  I can't mail invitations until they are printed.
+task 6 dep:5                             I can't print them until I design them.
+task 2 dep:1                             I need to select a weekend before a location.
+task 5 dep:1,2                           Design depends on location and weekend.
+task 4 dep:1                             And the caterer needs to know where.
+
+task long pro:party                      All my tasks are blocked except task 1.  That makes sense.
+
+task 5 dep:-1                            Hmm, that double dependency isn't right.
+
+task blocked                             Here are the blocked tasks.
+task unblocked                           and the opposite, the unblocked tasks.
+
+task 1 info                              If we look at task 1 closely, we can see that it is blocking
+task 2 info                               2 and 4.  And if we look at task 2, we see that it is
+                                         blocked by 1, and blocking 5.
+
+                                         This is called a dependency chain, which is a string of tasks
+                                         that are all connected not only by their project, but by
+                                         dependencies.
+
+                                         Now we understand that task 1 should be done first, but you
+                                         may still violate the laws of physics if you wish. Let's
+                                         complete task 2 and see what happens.
+
+task 2 done  (y)                         Taskwarrior realizes what you are doing, and offers to fix
+task 1 info                              the dependency chain to reflect what you have done.
+
+---------------------------------------- Reports ---------------------------------------------------
+
+task minimal                             Taskwarrior has a good many reports.  There is the bare minimum.
+task ls                                  The simple.
+task list                                The standard.
+task long                                The kitchen sink.
+task all                                 The packrat.
+task completed                           Nostalgia.
+task recurring                           Groundhog day.
+task waiting                             Surprises.
+task blocked                             Wedged.
+task unblocked                           Unencumbered.
+task oldest                              Ancient history.
+task newest                              Contemporary.
+task timesheet                           Corporate.
+task next                                And "what should I work on next?"  This one can be useful
+                                         because it pulls a few of the highest priority tasks from
+                                         all the projects.  It's the report we should all be using.
+
+---------------------------------------- Custom Report ---------------------------------------------
+
+                                         You can even define your own custom report.  Let's quickly
+                                         create a custom report - we'll call it foo - and I can
+                                         choose from a long list of fields to include in the report,
+                                         but I want to see the ID, the date when I entered the task,
+                                         and the description.  I can specify the labels for those
+                                         columns, the sort order of the report, and I can filter.
+
+cat >> ~/.taskrc
+report.foo.description=My own report
+report.foo.columns=id,entry,description
+report.foo.labels=ID,Entered,Description
+report.foo.sort=entry+,description+
+report.foo.filter=status:pending
+
+task help | grep foo                     Custom reports also show up on the help output.
+
+task show report.foo                     I can inspect the configuration.
+
+task foo                                 And they can be run just like the other reports.
+
+---------------------------------------- Charts ----------------------------------------------------
+
+task history                             The history report gives monthly totals of tasks added,
+task history.annual                      completed and deleted.  There is also an annual version.
+
+task ghistory                            There is a graphical monthly...
+task ghistory.annual                     and annual version.
+
+task summary                             There is a project summary report that shows progress in
+                                         all the projects.
+
+---------------------------------------- Advanced Filters ------------------------------------------
+
+task list                                Filters are a very powerful tool.  First here is an
+task list invit                          unfiltered list, which shows all tasks.  Now again, but with
+                                         the text 'invit', which acts as a filter on the description
+                                         field.
+
+task list description.contains:invit     This is the equivalent form using attribute modifiers.  In
+                                         this example we are filtering on descriptions that contain
+                                         the word fragment.  Here we are using the 'contains'
+                                         modifier, but there are many others.
+
+task list desc.word:the                  All tasks containing the whole word 'the'.  See how
+                                         annotations are also searched?
+
+task list desc.noword:invitations        Here is a list of all tasks that do not contain the whole
+                                         word 'invitations'.
+
+task list pro:party                      Here list all tasks in the 'party' project.
+task list pro.is:party                   And the full equivalent.
+task list pro.not:party                  Here list tasks that are not in the 'party' project.  I
+                                         could have also used 'isnt' here - there are several
+                                         synonyms for modifiers, so that the filter can be written
+                                         so that it reads naturally.
+
+task list pro:party pri.over:L           Here the 'over' modifier is filtering on priorities that
+                                         sort higher than 'Low', and also filtering on the 'party'
+                                         project.  There are two terms in this filter.
+
+task list pro:party limit:2              Same again, but only show me the first two tasks.
+task list limit:page                     Now all tasks, but just show the first page of tasks.  I
+                                         don't have a page full of tasks here, but you get the idea.
+
+task all status:pending                  Now you can see how some of the built-in reports work.  The
+                                         'list' report is just all tasks, filtered so that only the
+                                         pending tasks are shown.
+
+task all status:waiting                  The 'waiting' report is similarly defined.
+
+---------------------------------------- Import/Export ---------------------------------------------
+
+task export.csv                          You can export your tasks.  Here you see all tasks being
+                                         exported in CSV format.
+
+task export.csv venue                    Let's just export one task in CSV format...
+task export.vcalendar venue              Or in VCalendar format...
+task export.yaml venue                   Or YAML.
+
+cat file.text                            I can also import.  Here I am importing simple lines of
+task import file.text                    text.  Taskwarrior recognizes the format and confirms.
+
+cat file.yaml                            Here is a YAML example.  Taskwarrior can read several
+task import file.yaml                    formats, including old versions of its data files.  Using
+                                         YAML, you can round-trip the data without loss.
+
+task new limit:2                         Here are the imported tasks.
+
+---------------------------------------- Help ------------------------------------------------------
+
+task help                                You'll find a quick reference page built in, with the 'help'
+man task                                 command, or perhaps you'll want to take a look at the several
+man taskrc                               man pages installed.  This demo has superficially shown
+man task-color                           many features which have more capability and depth which you
+                                         can find in the man pages, and online.
+
+man task-tutorial                        This screencast is actually just a recording of me going
+                                         through the tutorial.
+
+man task-faq                             Some frequently asked questions are answered here.
+
+man task-sync                            You've patiently watched this whole movie, so here's your
+                                         reward - taskwarrior 1.9.3 has network synchronization
+                                         features, for sharing tasks across computers.  But this is
+                                         just a teaser - synch will be shown in the next movie.
+
+---------------------------------------- Wrap up ---------------------------------------------------
+
+task version                             And that's it.  Don't forget to take a look at
+                                         taskwarrior.org.
+
+                                         Thank you for watching.
+
+---------------------------------------- End -------------------------------------------------------
+

doc/misc/script-color.txt

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

doc/misc/script.txt

@@ -0,0 +1,109 @@
+                                         Hello, and welcome to this quick demo of the
+                                         taskwarrior program.
+
+task add do laundry                      Let's add some tasks
+                                         I need to do laundry
+
+task add project:garage order dumpster   Oh yeah, I need to order the dumpster
+
+task add +phone tell mom i loveher       Must call Mom  (that "phone" there is a tag - they can
+                                           be useful for searching and categorizing)
+task add +phone pro:garage schedule
+  goodwill pickup
+
+task ad +email pro:garage ask Tom if     Notice I can abbreviate commands
+  he wants that old bkie
+
+task ls                                  Let's see what we've got
+                                         Oh, I spelled bike wrong
+
+task 5 /bkie/bike/
+task ls                                  That's better
+
+task 1 pro:home                          Let's assign projects
+task 3 pro:home tell mom I love her
+task ls pro:garage
+
+task long pro:garage                     Let's see all the columns
+
+task list pro:garage                     There are different ways to list
+
+task lis +phone                          By tag
+task li pro:garage +phone                By project and tag
+task l mom                               By word
+
+task 1 priority:H                        Priorities can be High, Medium or Low
+task pri:H 3
+task 1 pri:M
+task li                                  The list is sorted by priority.
+
+task 2 pri:L
+task li
+
+task done 3                              Suppose task 3 is done
+task li                                  ...and it's gone
+
+task 2 +phone +mistake                   Lets add tags
+
+# Oops!
+task 2 -mistake                          or remove tags
+
+task tags                                or look at all the tags
+
+task info 2                              or all the details
+
+task projects                            or all the projects
+
+task 3 fg:bold                           Let's make it colorful
+task 4 fg:bold_green
+task li
+task 3 fg:bold_underline_white
+task li
+
+task 4 bg:on_bright_red fg:bold_yellow
+task li                                  Oh that's just nasty - let's get rid of that.
+task 4 bg:
+task li
+task 4 fg:
+task 3 fg:
+
+task colors                              There are many combinations to choose from
+
+task 1 due:6/8/2008                      Let's add a due date
+date
+
+task li
+task calendar                            Notice the due task is in yellow, today is marked cyan
+
+task 1 due:5/20/2008                     This is now an overdue task
+task li                                  and it shows up red
+task overdue
+task cal
+
+task export file.csv                     You can export the tasks to a spreadsheet
+cat file.csv
+
+task start 1                             Started tasks can be used as reminders
+                                           of what you are supposed to be doing
+
+task active                              They show up as active
+task done 1                              Let's clear out a couple
+task li
+task done 3
+task active
+
+task summary                             Summary shows progress on all projects
+
+task history                             History shows general activity - how many added,
+                                           completed etc, by month
+
+task ghistory                            This report shows a histogram of tasks that were
+                                           added (in red), completed (in green) and deleted
+                                           (in yellow), all by month.
+
+                                         And that's it.  There are more commands than this
+                                         covered in the online documentation, but this should give
+                                         the basic idea.
+
+                                         Thank you for watching.
+

doc/rc/dark-16.theme

@@ -0,0 +1,75 @@
+################################################################################
+# Sample taskwarrior 1.9 (or later) dark 16-color theme
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2006 - 2011, Paul Beckingham, Federico Hernandez.
+# 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
+#
+################################################################################
+
+color=on
+color.header=yellow
+color.footnote=yellow
+color.debug=yellow
+
+color.summary.bar=black on green
+color.summary.background=white on black
+
+color.history.add=black on red
+color.history.done=black on green
+color.history.delete=black on yellow
+
+color.burndown.pending=on red
+color.burndown.started=on yellow
+color.burndown.done=on green
+
+color.sync.added=green
+color.sync.changed=yellow
+color.sync.rejected=red
+
+color.undo.before=red
+color.undo.after=green
+
+color.calendar.today=bold white on bright blue
+color.calendar.due=white on red
+color.calendar.due.today=bold white on red
+color.calendar.overdue=black on bright red
+color.calendar.weekend=white on bright black
+color.calendar.holiday=black on bright yellow
+color.calendar.weeknumber=bold blue
+
+color.recurring=magenta
+color.overdue=bold red
+color.due.today=red
+color.due=red
+color.active=black on bright green
+color.pri.none=
+color.pri.H=bold white
+color.pri.M=white
+color.pri.L=
+color.tagged=green
+color.blocked=black on white
+color.project.none=
+color.tag.none=
+color.alternate=
+

doc/rc/dark-256.theme

@@ -0,0 +1,75 @@
+###############################################################################
+# Sample taskwarrior 1.9 (or later) dark 256-color theme
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2006 - 2011, Paul Beckingham, Federico Hernandez.
+# 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
+#
+################################################################################
+
+color=on
+color.header=color3
+color.footnote=color3
+color.debug=color3
+
+color.summary.bar=black on rgb141
+color.summary.background=white on color0
+
+color.history.add=color0 on rgb500
+color.history.done=color0 on rgb050
+color.history.delete=color0 on rgb550
+
+color.burndown.pending=on color9
+color.burndown.started=on color11
+color.burndown.done=on rgb010
+
+color.sync.added=rgb010
+color.sync.changed=color11
+color.sync.rejected=color9
+
+color.undo.before=color1
+color.undo.after=color2
+
+color.calendar.today=color15 on rgb013
+color.calendar.due=color0 on color1
+color.calendar.due.today=color15 on color1
+color.calendar.overdue=color0 on color9
+color.calendar.weekend=on color235
+color.calendar.holiday=color0 on color11
+color.calendar.weeknumber=rgb013
+
+color.recurring=rgb013
+color.overdue=color9
+color.due.today=rgb400
+color.due=color1
+color.active=rgb555 on rgb410
+color.pri.none=
+color.pri.H=color255
+color.pri.M=color250
+color.pri.L=color245
+color.tagged=rgb031
+color.blocked=white on color8
+color.project.none=
+color.tag.none=
+color.alternate=on color233
+

doc/rc/dark-blue-256.theme

@@ -0,0 +1,75 @@
+###############################################################################
+# Sample taskwarrior 1.9 (or later) dark 256-color theme, featuring blue.
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2006 - 2011, Paul Beckingham, Federico Hernandez.
+# 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
+#
+################################################################################
+
+color=on
+color.header=rgb013
+color.footnote=rgb013
+color.debug=rgb013
+
+color.summary.bar=white on rgb003
+color.summary.background=white on color0
+
+color.history.add=color0 on rgb015
+color.history.done=color0 on rgb025
+color.history.delete=color0 on rgb035
+
+color.burndown.pending=on rgb004
+color.burndown.started=on rgb015
+color.burndown.done=on gray4
+
+color.sync.added=gray4
+color.sync.changed=rgb015
+color.sync.rejected=rgb004
+
+color.undo.before=rgb013
+color.undo.after=rgb035
+
+color.calendar.today=color0 on rgb115
+color.calendar.due=color0 on color249
+color.calendar.due.today=color0 on color252
+color.calendar.overdue=color0 on color255
+color.calendar.weekend=on color235
+color.calendar.holiday=color255 on rgb013
+color.calendar.weeknumber=rgb015
+
+color.recurring=rgb115
+color.overdue=color255
+color.due.today=color252
+color.due=color249
+color.active=rgb045 on rgb015
+color.pri.none=
+color.pri.H=rgb035
+color.pri.M=rgb025
+color.pri.L=rgb015
+color.tagged=color246
+color.blocked=white on rgb001
+color.project.none=
+color.tag.none=
+color.alternate=on color233
+

doc/rc/dark-gray-256.theme

@@ -0,0 +1,75 @@
+###############################################################################
+# Sample taskwarrior 1.9 (or later) dark gray 256-color theme
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2011, Paul Beckingham, Federico Hernandez.
+# 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
+#
+################################################################################
+
+color=on
+color.header=color8
+color.footnote=color8
+color.debug=color8
+
+color.summary.bar=black on gray12
+color.summary.background=white on gray3
+
+color.history.add=color0 on gray6
+color.history.done=color0 on gray15
+color.history.delete=color0 on gray10
+
+color.burndown.pending=on gray6
+color.burndown.started=on gray15
+color.burndown.done=on gray10
+
+color.sync.added=gray10
+color.sync.changed=gray15
+color.sync.rejected=gray6
+
+color.undo.before=gray6
+color.undo.after=gray15
+
+color.calendar.today=color8 on color15
+color.calendar.due=color7 on color8
+color.calendar.due.today=color15 on color8
+color.calendar.overdue=underline color0 on color7
+color.calendar.weekend=on color235
+color.calendar.holiday=color7 on color15
+color.calendar.weeknumber=gray4
+
+color.recurring=gray8
+color.overdue=color0 on color15
+color.due.today=underline color0 on color7
+color.due=color7
+color.active=color7 on color8
+color.pri.none=
+color.pri.H=color15
+color.pri.M=color7
+color.pri.L=color8
+color.tagged=gray12
+color.blocked=color15 on color8
+color.project.none=
+color.tag.none=
+color.alternate=on gray2
+

doc/rc/dark-green-256.theme

@@ -0,0 +1,75 @@
+###############################################################################
+# Sample taskwarrior 1.9 (or later) dark 256-color theme, featuring green.
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2006 - 2011, Paul Beckingham, Federico Hernandez.
+# 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
+#
+################################################################################
+
+color=on
+color.header=rgb031
+color.footnote=rgb031
+color.debug=rgb031
+
+color.summary.bar=white on rgb030
+color.summary.background=white on color0
+
+color.history.add=color0 on rgb010
+color.history.done=color0 on rgb030
+color.history.delete=color0 on rgb050
+
+color.burndown.pending=on rgb010
+color.burndown.started=on rgb030
+color.burndown.done=on gray4
+
+color.sync.added=gray4
+color.sync.changed=rgb030
+color.sync.rejected=rgb010
+
+color.undo.before=rgb031
+color.undo.after=rgb053
+
+color.calendar.today=color0 on rgb151
+color.calendar.due=color0 on color249
+color.calendar.due.today=color0 on color225
+color.calendar.overdue=color0 on color255
+color.calendar.weekend=on color235
+color.calendar.holiday=rgb151 on rgb020
+color.calendar.weeknumber=rgb010
+
+color.recurring=rgb151
+color.overdue=color255
+color.due.today=color252
+color.due=color249
+color.active=rgb050 on rgb010
+color.pri.none=
+color.pri.H=rgb050
+color.pri.M=rgb030
+color.pri.L=rgb010
+color.tagged=color246
+color.blocked=white on rgb010
+color.project.none=
+color.tag.none=
+color.alternate=on color233
+

doc/rc/dark-red-256.theme

@@ -0,0 +1,75 @@
+###############################################################################
+# Sample taskwarrior 1.9 (or later) dark 256-color theme, featuring red.
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2006 - 2011, Paul Beckingham, Federico Hernandez.
+# 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
+#
+################################################################################
+
+color=on
+color.header=rgb100
+color.footnote=rgb100
+color.debug=rgb100
+
+color.summary.bar=white on rgb300
+color.summary.background=white on color0
+
+color.history.add=color0 on rgb100
+color.history.done=color0 on rgb300
+color.history.delete=color0 on rgb500
+
+color.burndown.pending=on rgb200
+color.burndown.started=on rgb411
+color.burndown.done=on gray4
+
+color.sync.added=gray4
+color.sync.changed=rgb411
+color.sync.rejected=rgb200
+
+color.undo.before=rgb301
+color.undo.after=rgb503
+
+color.calendar.today=color0 on rgb511
+color.calendar.due=color0 on color249
+color.calendar.due.today=color0 on color252
+color.calendar.overdue=color0 on color255
+color.calendar.weekend=on color235
+color.calendar.holiday=rgb522 on rgb300
+color.calendar.weeknumber=rgb100
+
+color.recurring=rgb511
+color.overdue=color255
+color.due.today=color252
+color.due=color249
+color.active=rgb500 on rgb100
+color.pri.none=
+color.pri.H=rgb500
+color.pri.M=rgb400
+color.pri.L=rgb300
+color.tagged=color246
+color.blocked=white on rgb100
+color.project.none=
+color.tag.none=
+color.alternate=on color233
+

doc/rc/dark-violets-256.theme

@@ -0,0 +1,75 @@
+################################################################################
+# Sample taskwarrior 1.9 (or later) dark violet 256-color theme
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2010 - 2011, Kathryn Andersen
+# 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
+#
+################################################################################
+
+color=on
+color.header=rgb013
+color.footnote=rgb013
+color.debug=rgb013
+
+color.summary.bar=white on rgb103
+color.summary.background=white on color0
+
+color.history.add=color0 on rgb105
+color.history.done=color0 on rgb205
+color.history.delete=color0 on rgb305
+
+color.burndown.pending=on rgb103
+color.burndown.started=on rgb214
+color.burndown.done=on gray4
+
+color.sync.added=gray4
+color.sync.changed=rgb214
+color.sync.rejected=rgb103
+
+color.undo.before=rgb103
+color.undo.after=rgb305
+
+color.calendar.today=color15 on rgb103
+color.calendar.due=color0 on rgb325
+color.calendar.due.today=color0 on rgb404
+color.calendar.overdue=color0 on color9
+color.calendar.weekend=gray12 on gray3
+color.calendar.holiday=color15 on rgb022
+color.calendar.weeknumber=rgb104
+
+color.recurring=rgb115
+color.overdue=color9
+color.due.today=rgb533
+color.due=rgb055
+color.active=rgb445 on rgb213
+color.pri.none=
+color.pri.H=rgb404
+color.pri.M=rgb304
+color.pri.L=rgb325
+color.tagged=rgb334
+color.blocked=white on rgb101
+color.project.none=
+color.tag.none=
+color.alternate=on gray2
+

doc/rc/dark-yellow-green.theme

@@ -0,0 +1,75 @@
+################################################################################
+# Sample taskwarrior 1.9 (or later) dark-yellow-green 256-color theme
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2010 - 2011, Kathryn Andersen
+# 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
+#
+################################################################################
+
+color=on
+color.header=rgb031
+color.footnote=rgb031
+color.debug=rgb031
+
+color.summary.bar=white on rgb030
+color.summary.background=white on color0
+
+color.history.add=color0 on rgb010
+color.history.done=color0 on rgb030
+color.history.delete=color0 on rgb050
+
+color.burndown.pending=on rgb110
+color.burndown.started=on rgb430
+color.burndown.done=on gray4
+
+color.sync.added=gray4
+color.sync.changed=rgb430
+color.sync.rejected=rgb110
+
+color.undo.before=rgb031
+color.undo.after=rgb053
+
+color.calendar.today=color15 on rgb110
+color.calendar.due=color0 on rgb430
+color.calendar.due.today=color0 on rgb410
+color.calendar.overdue=color0 on rgb400
+color.calendar.weekend=on color235
+color.calendar.holiday=rgb151 on rgb020
+color.calendar.weeknumber=rgb110
+
+color.recurring=rgb343
+color.overdue=rgb400
+color.due.today=rgb410
+color.due=rgb420
+color.active=rgb451 on rgb310
+color.pri.none=
+color.pri.H=rgb450
+color.pri.M=rgb030
+color.pri.L=rgb010
+color.tagged=rgb342
+color.blocked=white on rgb110
+color.project.none=
+color.tag.none=
+color.alternate=on gray0
+

doc/rc/holidays-AT.rc

@@ -0,0 +1,78 @@
+################################################################################
+# Sample calendar for Austria
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2011, Andreas Poisel
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+holiday.neujahr.name=Neujahr
+holiday.neujahr.date=20110101
+holiday.heiligedreikonige.name=Heilige drei Könige
+holiday.heiligedreikonige.date=20110106
+holiday.josef.name=Josef (K, St, T, V)
+holiday.josef.date=20110319
+holiday.karfreitag.name=Karfreitag
+holiday.karfreitag.date=20110422
+holiday.ostersonntag.name=Ostersonntag
+holiday.ostersonntag.date=20110424
+holiday.ostermontag.name=Ostermontag
+holiday.ostermontag.date=20110425
+holiday.staatsfeiertag.name=Staatsfeiertag
+holiday.staatsfeiertag.date=20110501
+holiday.florian.name=Florian (OÖ)
+holiday.florian.date=20110504
+holiday.christihimmelfahrt.name=Christi Himmelfahrt
+holiday.christihimmelfahrt.date=20110602
+holiday.pfingstsonntag.name=Pfingstsonntag
+holiday.pfingstsonntag.date=20110612
+holiday.pfingstmontag.name=Pfingstmontag
+holiday.pfingstmontag.date=20110613
+holiday.fronleichnam.name=Fronleichnam
+holiday.fronleichnam.date=20110623
+holiday.mariahimmelfahrt.name=MariÀ Himmelfahrt
+holiday.mariahimmelfahrt.date=20110815
+holiday.rupert.name=Rupert (S)
+holiday.rupert.date=20110924
+holiday.kvolksabst.name=Tag der Volksabstimmung (K)
+holiday.kvolksabst.date=20111010
+holiday.allerheiligen.name=Allerheiligen
+holiday.allerheiligen.date=20111101
+holiday.martin.name=Martin (B)
+holiday.martin.date=20111111
+holiday.leopold.name=Leopold (W, NÖ)
+holiday.leopold.date=20111115
+holiday.mariaempfaengnis.name=MariÀ EmpfÀngnis
+holiday.mariaempfaengnis.date=20111208
+holiday.heiligerabend.name=Heiliger Abend
+holiday.heiligerabend.date=20111224
+holiday.christtag.name=Christtag
+holiday.christtag.date=20111225
+holiday.stefanitag.name=Stefanitag
+holiday.stefanitag.date=20111226
+holiday.silvester.name=Silvester
+holiday.silvester.date=20111231

doc/rc/holidays-CA.rc

@@ -0,0 +1,59 @@
+################################################################################
+# Sample calendar for Canada
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2010 - 2011, Cory Donnelly.
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+holiday.newyearsday.name=New Year's Day
+holiday.newyearsday.date=20110101
+holiday.familyday.name=Family Day
+holiday.familyday.date=20110117
+holiday.goodfriday.name=Good Friday
+holiday.goodfriday.date=20110422
+holiday.eastermonday.name=Easter Monday
+holiday.eastermonday.date=20110425
+holiday.victoriaday.name=Victoria Day
+holiday.victoriaday.date=20110524
+holiday.canadaday.name=Canada Day
+holiday.canadaday.date=20110701
+holiday.firstmondayofaugust.name=First Monday of August
+holiday.firstmondayofaugust.date=20110801
+holiday.labourday.name=Labour Day
+holiday.labourday.date=20110905
+holiday.thanksgiving.name=Thanksgiving Day
+holiday.thanksgiving.date=20111010
+holiday.remembranceday.name=Remembrance Day
+holiday.remembranceday.date=20111111
+holiday.christmasday.name=Christmas Day
+holiday.christmasday.date=20111225
+holiday.boxingday.name=Boxing Day
+holiday.boxingday.date=20111226
+holiday.newyearseve.name=New Year's Eve
+holiday.newyearseve.date=20111231
+

doc/rc/holidays-DE.rc

@@ -0,0 +1,70 @@
+################################################################################
+# Sample calendar for Germany
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2010 - 2011, Federico Hernandez.
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+holiday.neujahr.name=Neujahr
+holiday.neujahr.date=20110101
+holiday.heiligedreikonige.name=Heilige drei Könige (BW,BY,ST)
+holiday.heiligedreikonige.date=20110106
+holiday.karfreitag.name=Karfreitag
+holiday.karfreitag.date=20110422
+holiday.ostern.name=Ostern
+holiday.ostern.date=20110424
+holiday.ostermontag.name=Ostermontag
+holiday.ostermontag.date=20110425
+holiday.maifeiertag.name=Erster Maifeiertag
+holiday.maifeiertag.date=20110501
+holiday.christihimmelfahrt.name=Christi Himmelfahrt
+holiday.christihimmelfahrt.date=20110602
+holiday.pfingstsonntag.name=Pfingstsonntag
+holiday.pfingstsonntag.date=20110612
+holiday.pfingstmontag.name=Pfingstmontag
+holiday.pfingstmontag.date=20110613
+holiday.fronleichnam.name=Fronleichnam (BW,BY,HE,NRW,RP,SL,(SN,TH))
+holiday.fronleichnam.date=20110623
+holiday.mariahimmelfahrt.name=Mariä Himmelfahrt (SL)
+holiday.mariahimmelfahrt.date=20110815
+holiday.einheit.name=Tag der Deutschen Einheit
+holiday.einheit.date=20111003
+holiday.reformationstag.name=Reformationstag (BB,MV,SN,ST,TH)
+holiday.reformationstag.date=20111031
+holiday.allerheiligen.name=Allerheiligen (BW,BY,NRW,RP,SL)
+holiday.allerheiligen.date=20111101
+holiday.bussundbettag.name=Buss und Bettag (SN)
+holiday.bussundbettag.date=20111116
+holiday.heiligabend.name=Heilig Abend
+holiday.heiligabend.date=20111224
+holiday.weihnachtstag.name=Weihnachtstag
+holiday.weihnachtstag.date=20111225
+holiday.zweiterweihnachtstag.name=Zweiter Weihnachtstag
+holiday.zweiterweihnachtstag.date=20111226
+holiday.sylvester.name=Sylvester
+holiday.sylvester.date=20111231

doc/rc/holidays-DK.rc

@@ -0,0 +1,82 @@
+################################################################################
+# Sample calendar for Denmark
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2010 - 2011, Irfan Siddiqui.
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+holiday.nytårsdag.name=Nytårsdag
+holiday.nytårsdag.date=20110101
+holiday.palmesøndag.name=Palmesøndag
+holiday.palmesøndag.date=20110417
+holiday.skærtorsdag.name=Skærtorsdag
+holiday.skærtorsdag.date=20110421
+holiday.langfredag.name=Langfredag
+holiday.langfredag.date=20110422
+holiday.påskedag.name=Påskedag
+holiday.påskedag.date=20110424
+holiday.andenpåskedag.name=Anden påskedag
+holiday.andenpåskedag.date=20110425
+holiday.storebededag.name=Store bededag
+holiday.storebededag.date=20110520
+holiday.kristihimmelfartsdag.name=Kristi himmelfartsdag
+holiday.kristihimmelfartsdag.date=20110602
+holiday.pinsedag.name=Pinsedag
+holiday.pinsedag.date=20110612
+holiday.andenpinsedag.name=Anden pinsedag
+holiday.andenpinsedag.date=20110613
+holiday.juledag.name=Juledag
+holiday.juledag.date=20111225
+holiday.andenjuledag.name=Anden juledag
+holiday.andenjuledag.date=20111226
+
+# 2012
+#holiday.nytårsdag.name=Nytårsdag
+#holiday.nytårsdag.date=20120101
+#holiday.palmesøndag.name=Palmesøndag
+#holiday.palmesøndag.date=20120401
+#holiday.skærtorsdag.name=Skærtorsdag
+#holiday.skærtorsdag.date=20120405
+#holiday.langfredag.name=Langfredag
+#holiday.langfredag.date=20120406
+#holiday.påskedag.name=Påskedag
+#holiday.påskedag.date=20120408
+#holiday.andenpåskedag.name=Anden påskedag
+#holiday.andenpåskedag.date=20120409
+#holiday.storebededag.name=Store bededag
+#holiday.storebededag.date=20120504
+#holiday.kristihimmelfartsdag.name=Kristi himmelfartsdag
+#holiday.kristihimmelfartsdag.date=20120517
+#holiday.pinsedag.name=Pinsedag
+#holiday.pinsedag.date=20120527
+#holiday.andenpinsedag.name=Anden pinsedag
+#holiday.andenpinsedag.date=20120528
+#holiday.juledag.name=Juledag
+#holiday.juledag.date=20121225
+#holiday.andenjuledag.name=Anden juledag
+#holiday.andenjuledag.date=20121226

doc/rc/holidays-ES.rc

@@ -0,0 +1,56 @@
+################################################################################
+# Sample calendar for Spain
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2010 - 2011, Federico Hernandez.
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+holiday.anonuevo.name=Año Nuevo
+holiday.anonuevo.date=20110101
+holiday.reyes.name=Día de los Reyes
+holiday.reyes.date=20110106
+holiday.viernessanto.name=Viernes Santo
+holiday.viernessanto.date=20110422
+holiday.trabajo.name=Fiesta del Trabajo
+holiday.trabajo.date=20110501
+holiday.virgen.name=Asunción de la Virgen
+holiday.virgen.date=20110815
+holiday.fiestanacional.name=Fiesta Nacional de España
+holiday.fiestanacional.date=20111012
+holiday.santos.name=Dia de todos los Santos
+holiday.santos.date=20111101
+holiday.constitucion.name=Dia de la Constitución
+holiday.constitucion.date=20111206
+holiday.concepcion.name=Inmaculada Concepción
+holiday.concepcion.date=20111208
+holiday.nochebuena.name=Noche Buena
+holiday.nochebuena.date=20111224
+holiday.navidad.name=Navidad
+holiday.navidad.date=20111225
+holiday.nochevieja.name=Noche Vieja
+holiday.nochevieja.date=20111231

doc/rc/holidays-FR.rc

@@ -0,0 +1,53 @@
+################################################################################
+# Sample calendar for France
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2010 - 2011, Paul Beckingham, Federico Hernandez.
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+holiday.jourdelan.name=Jour de l'an
+holiday.jourdelan.date=20110101
+holiday.travail.name=Fête du premier mai
+holiday.travail.date=20110501
+holiday.victoire.name=la Fête de Victoire 45
+holiday.victoire.date=20110508
+holiday.ascencion.name=l'Ascencion
+holiday.ascencion.date=20110602
+holiday.pentecôte.name=la Pentecôte
+holiday.pentecôte.date=20110612
+holiday.bastille.name=Fête nationale
+holiday.bastille.date=20110714
+holiday.assomption.name=Assomption
+holiday.assomption.date=20110815
+holiday.toussaint.name=La Toussaint
+holiday.toussaint.date=20111101
+holiday.armistice.name=Jour d'armistice
+holiday.armistice.date=20111111
+holiday.noël.name=Noël
+holiday.noël.date=20111225
+

doc/rc/holidays-IT.rc

@@ -0,0 +1,68 @@
+################################################################################
+# Sample calendar for the US
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2011, Nicola Busanello
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+
+# fisse (legali)
+holiday.capodanno.name=Capodanno
+holiday.capodanno.date=20110101
+holiday.sanmarco.name=Festa della liberazione
+holiday.sanmarco.date=20110425
+holiday.lavoratori.name=Festa del lavoro
+holiday.lavoratori.date=20110501
+holiday.repubblica.name=Festa della repubblica
+holiday.repubblica.date=20110602
+
+# fisse (cristiane)
+holiday.epifania.name=Epifania
+holiday.epifania.date=20110106
+holiday.ferragosto.name=Assunzione (ferragosto)
+holiday.ferragosto.date=20110815
+holiday.ognissanti.name=Ognissanti
+holiday.ognissanti.date=20111101
+holiday.madonna.name=Immacolata concezione
+holiday.madonna.date=20111208
+holiday.natale.name=Natale
+holiday.natale.date=20111225
+holiday.sstefano.name=S.to Stefano
+holiday.sstefano.date=20111226
+
+# variabili (cristiane)
+holiday.carnevale.name=Carnevale
+holiday.carnevale.date=20110308
+holiday.pasqua.name=Pasqua
+holiday.pasqua.date=20110424
+# nel 2011 coincide con la festa della liberazione
+#holiday.pasqua.name=Pasquetta
+#holiday.pasqua.date=20110425
+
+# 2012
+

doc/rc/holidays-NL.rc

@@ -0,0 +1,91 @@
+################################################################################
+# Sample calendar for the Netherlands
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2010 - 2011, Charles T. Yun
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+holiday.nieuwjaar.name=Nieuwjaar
+holiday.nieuwjaar.date=20110101
+holiday.goedevrijdag.name=Goede Vrijdag
+holiday.goedevrijdag.date=20110422
+holiday.pasen.name=Pasen
+holiday.pasen.date=20110424
+holiday.pasen.name=Tweede Paasdag
+holiday.pasen.date=20100425
+holiday.koninginnedag.name=Koninginnedag
+holiday.koninginnedag.date=20110430
+holiday.dodenherdenking.name=Dodenherdenking
+holiday.dodenherdenking.date=20110504
+holiday.bevrijdingsdag.name=Bevrijdingsdag
+holiday.bevrijdingsdag.date=20110505
+holiday.hemelvaartsdag.name=Hemelvaartsdag
+holiday.hemelvaartsdag.date=20110602
+holiday.pinksteren.name= Pinksteren
+holiday.pinksteren.date=20110612
+holiday.pinksteren.name=Tweede Pinksterdag
+holiday.pinksteren.date=20110613
+holiday.sinterklaas.name=Sinterklaas
+holiday.sinterklaas.date=20111205
+holiday.koninkrijksdag.name=Koninkrijksdag
+holiday.koninkrijksdag.date=20111215
+holiday.kerstmis.name=Kerstmis
+holiday.kerstmis.date=20111225
+holiday.kerstmis.name=Tweede Kerstdag
+holiday.kerstmis.date=20111226
+
+# 2012
+#holiday.nieuwjaar.name=Nieuwjaar
+#holiday.nieuwjaar.date=20120101
+#holiday.goedevrijdag.name=Goede Vrijdag
+#holiday.goedevrijdag.date=20120406
+#holiday.pasen.name=Pasen
+#holiday.pasen.date=20120408
+#holiday.pasen.name=Tweede Pasdag
+#holiday.pasen.date=20120409
+#holiday.koninginnedag.name=Koninginnedag
+#holiday.koninginnedag.date=20120430
+#holiday.dodenherdenking.name=Dodenherdenking
+#holiday.dodenherdenking.date=20120504
+#holiday.bevrijdingsdag.name=Bevrijdingsdag
+#holiday.bevrijdingsdag.date=20120505
+#holiday.hemelvaartsdag.name=Hemelvaartsdag
+#holiday.hemelvaartsdag.date=20120617
+#holiday.pinksteren.name= Pinksteren
+#holiday.pinksteren.date=20120627
+#holiday.pinksteren.name=Tweede Pinksterdag
+#holiday.pinksteren.date=20120628
+#holiday.sinterklaas.name=Sinterklaas
+#holiday.sinterklaas.date=20121205
+#holiday.koninkrijksdag.name=Koninkrijksdag
+#holiday.koninkrijksdag.date=20121215
+#holiday.kerstmis.name=Kerstmis
+#holiday.kerstmis.date=20121225
+#holiday.kerstmis.name=Tweede Kerstdag
+#holiday.kerstmis.date=20121226
+

doc/rc/holidays-NO.rc

@@ -0,0 +1,103 @@
+################################################################################
+# Sample calendar for Norway
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2010 - 2011, Jostein Berntsen
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+holiday.nyttårsdag.name=Nyttårsdag
+holiday.nyttårsdag.date=20110101
+holiday.fastelavn.name=Fastelavn
+holiday.fastelavn.date=20110306
+holiday.palmesøndag.name=Palmesøndag
+holiday.palmesøndag.date=20110417
+holiday.skjærtorsdag.name=Skjærtorsdag
+holiday.skjærtorsdag.date=20110421
+holiday.langfredag.name=Langfredag
+holiday.langfredag.date=20110422
+holiday.påskedag.name=Påskedag
+holiday.påskedag.date=20110424
+holiday.påskedag2.name=Påskedag
+holiday.påskedag2.date=20110425
+holiday.offentlighøytidsdag.name=Offentlig Høytidsdag
+holiday.offentlighøytidsdag.date=20110501
+holiday.frigjøringsdag.name=Frigjøringsdag 1945
+holiday.frigjøringsdag.date=20110508
+holiday.grunnlovsdag.name=Grunnlovsdag
+holiday.grunnlovsdag.date=20110517
+holiday.KristiHimmelfartsdag.name=Kristi Himmelfartsdag
+holiday.KristiHimmelfartsdag.date=20110602
+holiday.pinsedag.name=Pinsedag
+holiday.pinsedag.date=20110612
+holiday.pinsedag2.name=Pinsedag
+holiday.pinsedag2.date=20110613
+holiday.julaften.name=Julaften
+holiday.julaften.date=20111224
+holiday.juledag.name=Juledag
+holiday.juledag.date=20111225
+holiday.juledag2.name=Juledag
+holiday.juledag2.date=20111226
+holiday.nyttårsaften.name=Nyttårsaften
+holiday.nyttårsaften.date=20111231
+
+# 2012
+#holiday.nyttårsdag.name=Nyttårsdag
+#holiday.nyttårsdag.date=20120101
+#holiday.fastelavn.name=Fastelavn
+#holiday.fastelavn.date=20120219
+#holiday.palmesøndag.name=Palmesøndag
+#holiday.palmesøndag.date=20120401
+#holiday.skjærtorsdag.name=Skjærtorsdag
+#holiday.skjærtorsdag.date=20120405
+#holiday.langfredag.name=Langfredag
+#holiday.langfredag.date=20120406
+#holiday.påskedag.name=Påskedag
+#holiday.påskedag.date=20120408
+#holiday.påskedag2.name=Påskedag
+#holiday.påskedag2.date=20120409
+#holiday.offentlighøytidsdag.name=Offentlig Høytidsdag
+#holiday.offentlighøytidsdag.date=20120501
+#holiday.frigjøringsdag.name=Frigjøringsdag 1945
+#holiday.frigjøringsdag.date=20120508
+#holiday.grunnlovsdag.name=Grunnlovsdag
+#holiday.grunnlovsdag.date=20120517
+#holiday.KristiHimmelfartsdag.name=Kristi Himmelfartsdag
+#holiday.KristiHimmelfartsdag.date=20120517
+#holiday.pinsedag.name=Pinsedag
+#holiday.pinsedag.date=20120527
+#holiday.pinsedag2.name=Pinsedag
+#holiday.pinsedag2.date=20120528
+#holiday.julaften.name=Julaften
+#holiday.julaften.date=20121224
+#holiday.juledag.name=Juledag
+#holiday.juledag.date=20121225
+#holiday.juledag2.name=Juledag
+#holiday.juledag2.date=20121226
+#holiday.nyttårsaften.name=Nyttårsaften
+#holiday.nyttårsaften.date=20121231
+

doc/rc/holidays-NZ.rc

@@ -0,0 +1,110 @@
+################################################################################
+# Sample calendar for New Zealand
+#
+# Information sourced from:
+# http://www.ers.dol.govt.nz/holidays_act_2003/dates/2010_13.html
+#
+################################################################################
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2011, Stephen Heywood.
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+holiday.newyear.name=New Year's Day
+holiday.newyear.date=20110101
+holiday.dayafternewyearsday.name=Day after New Years Day
+holiday.dayafternewyearsday.date=20110102
+holiday.waitangiday.name=Waitangi Day
+holiday.waitangiday.date=20110206
+
+holiday.goodfriday.name=Good Friday
+holiday.goodfriday.date=20110422
+holiday.eastermonday.name=Easter Monday
+holiday.eastermonday.date=20110425
+
+holiday.anzacday.name=ANZAC Day
+holiday.anzacday.date=20110425
+holiday.queensbirthday.name=Queen's Birthday
+holiday.queensbirthday.date=20110606
+holiday.labourday.name=Labour Day
+holiday.labourday.date=20111024
+
+holiday.christmas.name=Christmas Day
+holiday.christmas.date=20111225
+holiday.boxingday.name=Boxing Day
+holiday.boxingday.date=20111226
+
+# 2012
+#holiday.newyear.name=New Year's Day
+#holiday.newyear.date=20120101
+#holiday.dayafternewyearsday.name=Day after New Years Day
+#holiday.dayafternewyearsday.date=20120102
+#holiday.waitangiday.name=Waitangi Day
+#holiday.waitangiday.date=20120206
+
+#holiday.goodfriday.name=Good Friday
+#holiday.goodfriday.date=20120406
+#holiday.eastermonday.name=Easter Monday
+#holiday.eastermonday.date=20120409
+
+#holiday.anzacday.name=ANZAC Day
+#holiday.anzacday.date=20120425
+#holiday.queensbirthday.name=Queen's Birthday
+#holiday.queensbirthday.date=20120604
+#holiday.labourday.name=Labour Day
+#holiday.labourday.date=20121022
+
+#holiday.christmas.name=Christmas Day
+#holiday.christmas.date=20121225
+#holiday.boxingday.name=Boxing Day
+#holiday.boxingday.date=20121226
+
+# 2013
+#holiday.newyear.name=New Year's Day
+#holiday.newyear.date=20130101
+#holiday.dayafternewyearsday.name=Day after New Years Day
+#holiday.dayafternewyearsday.date=20130102
+#holiday.waitangiday.name=Waitangi Day
+#holiday.waitangiday.date=20130206
+
+#holiday.goodfriday.name=Good Friday
+#holiday.goodfriday.date=20130329
+#holiday.eastermonday.name=Easter Monday
+#holiday.eastermonday.date=20130401
+
+#holiday.anzacday.name=ANZAC Day
+#holiday.anzacday.date=20130425
+#holiday.queensbirthday.name=Queen's Birthday
+#holiday.queensbirthday.date=20130603
+#holiday.labourday.name=Labour Day
+#holiday.labourday.date=20131028
+
+#holiday.christmas.name=Christmas Day
+#holiday.christmas.date=20131225
+#holiday.boxingday.name=Boxing Day
+#holiday.boxingday.date=20131226

doc/rc/holidays-SE.rc

@@ -0,0 +1,66 @@
+################################################################################
+# Sample calendar for Sweden
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2010 - 2011, Federico Hernandez.
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+holiday.nyårsdagen.name=Nyårsdagen
+holiday.nyårsdagen.date=20110101
+holiday.trettondedagjul.name=Trettondedag jul
+holiday.trettondedagjul.date=20110106
+holiday.långfredagen.name=Långfredagen
+holiday.långfredagen.date=20110422
+holiday.påskdagen.name=Påskdagen
+holiday.påskdagen.date=20110424
+holiday.annandagpåsk.name=Annandag påsk
+holiday.annandagpåsk.date=20110425
+holiday.valborgmässoafton.name=Valborgmässoafton
+holiday.valborgmässoafton.date=20110430
+holiday.förstamaj.name=Första maj
+holiday.förstamaj.date=20110501
+holiday.kristihimmelfärdsdag.name=Kristi Himmelsfärdsdag
+holiday.kristihimmelfärdsdag.date=20110602
+holiday.nationaldagen.name=Nationaldagen
+holiday.nationaldagen.date=20110606
+holiday.pingstdagen.name=Pingstdagen
+holiday.pingstdagen.date=20110612
+holiday.midsommarafton.name=Midsommarafton
+holiday.midsommarafton.date=20110624
+holiday.midsommardagen.name=Midsommardagen
+holiday.midsommardagen.date=20110625
+holiday.allahelgonsdag.name=Alla Helgons Dag
+holiday.allahelgonsdag.date=20111105
+holiday.julafton.name=Julafton
+holiday.julafton.date=20111224
+holiday.juldagen.name=Juldagen
+holiday.juldagen.date=20111225
+holiday.annandagjul.name=Annandag jul
+holiday.annandagjul.date=20111226
+holiday.nyårsafton.name=Nyårsafton
+holiday.nyårsafton.date=20111231

doc/rc/holidays-UK.rc

@@ -0,0 +1,49 @@
+################################################################################
+# Sample calendar for the UK
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2010 - 2011, Federico Hernandez.
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+holiday.newyear.name=New Year's Day
+holiday.newyear.date=20110101
+holiday.goodfriday.name=Good Friday
+holiday.goodfriday.date=20110422
+holiday.eastermonday.name=Easter Monday
+holiday.eastermonday.date=20110425
+holiday.may.name=Early May Bank Holiday
+holiday.may.name=20110502
+holiday.spring.name=Spring Bank Holiday
+holiday.spring.name=20110530
+holiday.august.name=August Bank Holiday
+holiday.august.name=20110829
+holiday.christmas.name=Christmas Day
+holiday.christmas.date=20111225
+holiday.boxingday.name=Boxing Day
+holiday.boxingday.date=20111226
+

doc/rc/holidays-US.rc

@@ -0,0 +1,57 @@
+################################################################################
+# Sample calendar for the US
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2010 - 2011, Federico Hernandez.
+# 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
+#
+################################################################################
+
+calendar.holidays=sparse
+
+# 2011
+holiday.newyearsday.name=New Year's Day
+holiday.newyearsday.date=20110101
+holiday.martinlutherkingday.name=Birthday of Martin Luther King, Jr.
+holiday.martinlutherkingday.date=20110117
+holiday.presidentsday.name=Washington's Birthday
+holiday.presidentsday.date=20110221
+holiday.patriotsday.name=Patriots' Day
+holiday.patriotsday.date=20110419
+holiday.memorialday.name=Memorial Day
+holiday.memorialday.date=20110530
+holiday.independenceday.name=Independence Day
+holiday.independenceday.date=20110704
+holiday.laborday.name=Labor Day
+holiday.laborday.date=20110905
+holiday.columbusday.name=Columbus Day
+holiday.columbusday.date=20111010
+holiday.veteransdays.name=Veterans Day
+holiday.veteransdays.date=20111111
+holiday.thanksgiving.name=Thanksgiving Day
+holiday.thanksgiving.date=20111124
+holiday.christmasday.name=Christmas Day
+holiday.christmasday.date=20111225
+holiday.newyearseve.name=New Year's Eve
+holiday.newyearseve.date=20111231
+

doc/rc/light-16.theme

@@ -0,0 +1,75 @@
+###############################################################################
+# Sample taskwarrior 1.9 (or later) light 16-color theme
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2006 - 2011, Paul Beckingham, Federico Hernandez.
+# 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
+#
+################################################################################
+
+color=on
+color.header=blue
+color.footnote=blue
+color.debug=blue
+
+color.summary.bar=black on green
+color.summary.background=white on black
+
+color.history.add=black on red
+color.history.done=black on green
+color.history.delete=black on yellow
+
+color.burndown.pending=on red
+color.burndown.started=on yellow
+color.burndown.done=on green
+
+color.sync.added=green
+color.sync.changed=yellow
+color.sync.rejected=red
+
+color.undo.before=red
+color.undo.after=green
+
+color.calendar.today=black on bright blue
+color.calendar.due=white on red
+color.calendar.due.today=bold white on red
+color.calendar.overdue=black on bright red
+color.calendar.weekend=white on bright black
+color.calendar.holiday=black on yellow
+color.calendar.weeknumber=bold blue
+
+color.recurring=blue
+color.overdue=bold red
+color.due.today=red
+color.due=red
+color.active=black on green
+color.pri.none=
+color.pri.H=bold black
+color.pri.M=black
+color.pri.L=
+color.tagged=green
+color.blocked=white on black
+color.project.none=
+color.tag.none=
+color.alternate=
+

doc/rc/light-256.theme

@@ -0,0 +1,74 @@
+###############################################################################
+# Sample taskwarrior 1.9 (or later) light 256-color theme
+#
+# taskwarrior - a command line task list manager.
+#
+# Copyright 2006 - 2011, Paul Beckingham, Federico Hernandez.
+# 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
+#
+################################################################################
+color=on
+color.header=color4
+color.footnote=color4
+color.debug=color4
+
+color.summary.bar=black on rgb141
+color.summary.background=white on color0
+
+color.history.add=color0 on rgb500
+color.history.done=color0 on rgb050
+color.history.delete=color0 on rgb550
+
+color.burndown.pending=on rgb200
+color.burndown.started=on rgb520
+color.burndown.done=on rgb011
+
+color.sync.added=rgb011
+color.sync.changed=rgb520
+color.sync.rejected=rgb200
+
+color.undo.before=color1
+color.undo.after=color2
+
+color.calendar.today=color15 on rgb013
+color.calendar.due=color0 on color9
+color.calendar.due.today=color15 on color1
+color.calendar.overdue=color0 on color1
+color.calendar.weekend=on color253
+color.calendar.holiday=color0 on color3
+color.calendar.weeknumber=rgb013
+
+color.recurring=rgb013
+color.overdue=color1
+color.due.today=rgb400
+color.due=color9
+color.active=rgb555 on rgb520
+color.pri.none=
+color.pri.H=color232
+color.pri.M=color237
+color.pri.L=color242
+color.tagged=rgb020
+color.blocked=gray12 on gray4
+color.project.none=
+color.tag.none=
+color.alternate=on color254
+

i18n/CMakeLists.txt

@@ -0,0 +1,4 @@
+install (DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/ DESTINATION ${TASK_DOCDIR}/i18n
+                                                FILES_MATCHING REGEX "strings.*"
+                                                               REGEX "tips.*"
+                                                               PATTERN "CMakeFiles" EXCLUDE)

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,125 @@
+# This is an example strings.en-US file.
+#
+# The taskwarrior 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.
+
+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
+
+212 help
+
+215 import
+216 info
+217 prepend
+218 overdue
+219 projects
+220 start
+221 stats
+222 stop
+223 summary
+224 tags
+225 timesheet
+226 log
+227 undo
+228 version
+229 shell
+230 config
+231 show
+
+235 diagnostics
+
+# 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 taskwarrior 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
+# default.  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,67 @@
+%
+For bash users, try 'alias t=task' to save some keystrokes.
+%
+Have you tried 'task edit 1' to use your text editor to modify all aspects of
+task 1?
+%
+Did you know that 'task 1 wait:eom' will hide task 1 until the end of the
+month?  You can then see all waiting tasks with 'task waiting'.
+%
+Did you know that 'task 1 wait:' will restore a waiting task to pending status?
+%
+If you put 'default.command=list project:home' in your .taskrc file, then just
+running 'task' will automatically run 'task list project:home' for you.  Save
+some keystrokes!
+%
+If you edit your pending.data file, make sure that your text editor doesn't
+strip the trailing \n characters from the end of the file.
+%
+If you must edit your pending.data file, make sure that your text editor doesn't
+convert from a Unix to a DOS file encoding.
+%
+Do you have the latest version of task installed?  Check http://taskwarrior.org
+periodically for news of updates.  That feature you wanted might be ready...
+%
+Don't forget the online docs at http://taskwarrior.org/wiki/taskwarrior, and if
+you find errors, please let us know.  Then again, it is a wiki, so feel free to
+correct them yourself.
+%
+Don't forget the online docs at http://taskwarrior.org/wiki/taskwarrior, but if
+you cannot find documentation on a particular topic, either create a ticket
+requesting it, email support@taskwarrior.org asking for it, or start it
+yourself.
+%
+Did you know there are man pages for task?  Try 'man task', 'man taskrc',
+'man task-tutorial', 'man task-color' and 'man task-faq'.
+%
+Did you know there are several 256-color themes available for task?
+%
+Did you know that running 'task show' will perform various checks on your
+.taskrc file, looking for errors?
+%
+Are you making the most of color?  Try 'task color' to see what colors your
+system supports.
+%
+Are you using projects?  If you do, taskwarrior will keep track of the project
+completion percentage and report it to you whenever it changes.
+%
+Did you know you can list tasks that have priorities like 'task list
+priority.above:L'?
+%
+The http://tasktools.org/latest URL can tell you which is the latest version.
+%
+To make your task list clear and actionable, always describe it starting with a
+verb, like "call" or "clean" or "get".
+%
+Don't like the name of a command?  Create an alias.
+%
+You can choose whether your searches are case sensitive or not, by running
+'task config search.case.sensitive yes'
+%
+Back up your data files by making copies of the ~/.taskrc file and ~/.task
+directory.
+%
+Accidentally changed a task? The undo command makes it a breeze to recover from
+any inadvertent change -- even a deletion!
+%
+

i18n/tips.sv-SE

@@ -0,0 +1,14 @@
+%
+För bash användare, med 'alias t=task' kan du spara på nedslagningar på tangentbordet.
+%
+Har du försökt att använda 'task edit 1' för att ändra alla aspekter av task 1 i din texteditor?
+%
+Med 'task 1 wait:eom' kan du göma task 1 fram till slutet av månaden. För att se
+alla task som väntar kan du använda 'task waiting'.
+%
+Visste du att 'task 1 wait:' återställa en väntande task till "peding" igen?
+%
+Skriv 'default.command=list project:home' i din .taskrc fil. När du sen använder
+'task' körs det en 'task list project:home' istäälet för dig. Spara på nedslagningar
+på tangetbordet.
+%

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,93 @@
+Name:           task
+Version:        1.9.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, multi-user 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 doc/rc
+%{_bindir}/task
+%{_mandir}/man1/task.1.gz
+%{_mandir}/man5/taskrc.5.gz
+%{_mandir}/man5/task-tutorial.5.gz
+%{_mandir}/man5/task-color.5.gz
+%{_mandir}/man5/task-faq.5.gz
+%config(noreplace) %{_sysconfdir}/bash_completion.d
+
+
+%changelog
+* Mon May 22 2010 Federico Hernandez <ultrafredde@gmail.com> - 1.9.1-1
+  Intial RPM for task beta release 1.9.1
+* Mon Feb 22 2010 Federico Hernandez <ultrafredde@gmail.com> - 1.9.0-1
+  Intial RPM for task beta release 1.9.0
+* Mon Feb 15 2010 Federico Hernandez <ultrafredde@gmail.com> - 1.9.0.beta3-1
+  Intial RPM for task beta release 1.9.0.beta3
+* Mon Feb 08 2010 Federico Hernandez <ultrafredde@gmail.com> - 1.9.0.beta2-1
+  Intial RPM for task beta release 1.9.0.beta2
+* Wed Feb 03 2010 Federico Hernandez <ultrafredde@gmail.com> - 1.9.0.beta1-1
+  Intial RPM for task beta release 1.9.0.beta1
+* Sat Dec 05 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.8.5-2
+  Fixed wrong ChangeLog file
+* Sat Dec 05 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.8.5-1
+  Intial RPM for task bugfix release 1.8.5
+* Tue Nov 17 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.8.4-1
+  Intial RPM for task bugfix release 1.8.4
+* Wed Oct 21 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.8.3-1
+  Intial RPM for task bugfix release 1.8.3
+* Mon Sep 07 2009 Federico Hernandez <ultrafredde@gmail.com> - 1.8.2-1
+  Intial RPM for task bugfix release 1.8.2
+* 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/README

@@ -0,0 +1,280 @@
+How to make an OSX package
+--------------------------
+
+Note: This is being written from the OSX 10.6 perspective, and may therefore
+      contain steps that are different for 10.5, although I don't recall any
+      actual differences.
+
+
+0. Philosophy
+
+  Only Fredde tags releases.  We only make builds from tagged commits.  We
+  only release builds that build cleanly without errors or warnings.  We only
+  release builds that pass 100% of the unit tests.
+
+
+1. Prerequisites
+
+  You will need an Intel Mac, running OSX 10.5 or later.
+  You will need to install the Developer Tools, which are found on your OSX DVD.
+  You will need git installed, version 1.5 or later.  See http://git-scm.com
+  You will need autotools installed.  See http://www.gnu.org/software/autoconf
+
+2. Get the code
+
+  2.1 Clone the task git repository.  It is important that this is a throwaway
+    clone of the repository, because we will do (locally) destructive things
+    to it.
+
+    $ git clone git://tasktools.org/task.git ~/task-package.git
+    ...
+    $ cd ~/task-package.git
+
+  2.2 Making sure you have the right version of the code.  This assumes you are
+    building taskwarrior 1.9.2, but any version number is interchangeable.
+    Check out the correct branch, and make sure it is sitting at the correct
+    commit, via a tag.  Note that while 1.9.2 is a branch name, v1.9.2 is a tag
+    name.
+
+    $ git checkout 1.9.2
+    $ git reset --hard v1.9.2
+
+    If there is an error in this step, stop, capture the output, and report the
+    errors.
+
+3. Build taskwarrior
+
+  3.1 First build the task binary.  Note the "-j 2" tells make to use both cores
+    in your dual-core Intel CPU, which means faster compiles.  If you own a quad
+    core Mac, use "-j 4".  If you own a single core Mac, just type "make".
+
+    $ autoreconf -f
+    $ ./configure
+    ...
+
+    If any errors are reported, stop, capture the output, and report the errors.
+    
+    $ make -j 2
+
+    If there are any errors, or there are any warnings generated by the compiler
+    stop, capture the output, and report the problem.  You'll need to watch as
+    it builds.
+
+4. Build the test suite
+
+  4.1 The test suite exists to prove that we do not break taskwarrior features
+    from one release to the next.  While this is not a perfect solution, it has
+    saved us many times from releasing code that is inferior.
+
+    The first step is to modify the test suite Makefile to remove the Lua line.
+    This is because we do not yet have dynamic detection of the Lua library for
+    the unit tests.
+
+    $ cd ~/task-package.git/src/tests
+    $ vi Makefile
+
+    Any text editor will do, but look for this line (line 5):
+
+      LFLAGS  = -L/usr/local/lib -llua
+
+    and change it to:
+
+      LFLAGS  = -L/usr/local/lib
+
+    Now build the unit tests:
+
+    $ make -j 2
+    ...
+
+  4.2 Run all the unit tests.
+
+    $ ./run_all
+    Skipping benchmarks
+                                                                                
+    Pass:     4241
+    Fail:        0
+    Skipped:     0
+    Runtime:    86
+
+    The output should look something like this, with 0 failed, and 0 skipped
+    tests.  If there are any failures or skips, stop and mailed the log file,
+    named 'all.log' to Paul & Fredde.
+
+5. Assemble the parts
+
+  5.1 There is a script that copies all the necessary files (binary, man pages
+    etc) in the right place, ready for packaging.  Run this:
+
+    $ cd ~/task-package.git/package-config/osx
+    $ ./update
+
+6. Adjust the package details
+
+  6.1 Launch the package manager.
+
+    $ open -a /Developer/Applications/Utilities/PackageManager.app   
+
+  6.2 Close the 'Untitled' window that opens - we will be using a different
+    file.  Note that PackageManager is still running - it just has no windows.
+
+  6.3 Using the File -> Open menu, open the file
+
+    ~/task-package.git/package-config/osx/task.pmdoc
+
+    <figure 1>
+
+    This is the file from the last time a package was created.  It needs some
+    adjustments.  Start by clicking on the "Taskwarrior x.x.x Distribution" with
+    a package icon in the top left part of the window.
+
+  6.4 Click on the "Configuration" button/tab.
+
+    - Change the "Title" to "Taskwarrior 1.9.2"
+    - Change the "Description" to "Taskwarrior 1.9.2 install for Snow Leopard"
+
+    <figure 2>
+
+  6.5 Click on "Edit Interface..."
+
+    There are 5 radio buttons on the left hand side - we will visit each and
+    make changes.  Click on "Background", make sure it matches the figure.
+
+    <figure 3>
+
+    Click on "Introduction", make sure it matches the figure.
+
+    <figure 4>
+
+    Click on "Read Me", and on the right hand side, under "Read Me Panel", click
+    on "File" and select the file:
+
+      /Users/<your-account>/task-package.git/package-config/osx/README.txt
+
+    <figure 5>
+
+    Click on "License", and on the right hand side, under "License Panel", click
+    on "File" and select the file:
+
+      /Users/<your-account>/task-package.git/package-config/osx/COPYING.txt
+
+    <figure 6>
+
+    Click on "Finish Up", and make sure it matches the figure.
+
+    <figure 7>
+
+    Close the Interface Editor window (it saves automatically).
+
+  6.6 Back in the "task.pmdoc" window, click on the "Requirements" tab/button,
+    then click on the "+" button, and add a requirement rule as shown in the
+    figure.  The minimum system should be 10.5.0 or 10.6.0, depending on which
+    package is being built.
+
+    <figure 8>
+
+  6.7 Click on the "Actions" tab/button and make sure it matches the figure.
+
+    <figure 9>
+
+  6.8 Click on the triangle next to the "local" item in the "Contents" vertical
+    bar on the left to expand and show a folder called "local", with the path
+    "/usr/local", but click on the "local" next to the blue radio button, not
+    the one next to the folder.  Then click on the "Configuration" tab/button.
+
+    - Change the "Choice Name" to "local"
+    - Leave the "Identifier" alone - it is automatic
+    - Make sure "Selected" and "Enabled" are checked, but "Hidden" is not
+
+    <figure 10>    
+
+  6.9 Click on the "Requirements" tab/button and make sure it is all blank.
+
+    <figure 11>
+
+  6.10 Click on the blue folder on the left, which is labelled "local", and has
+    a path of "/usr/local".  Click on the "Configuration" tab/button.
+
+    - Change the "Install" to /Users/<your-account>/task-package.git/package-config/osx/local
+    - Make sure the "Destination" is "/usr/local"
+    - Make sure "Allow custom location" is checked
+    - Make sure the "Package Identifier is "com.beckingham.task192.local.pkg"
+    - Make sure the "Package Version" is 1.0.  If you needed to make a
+      subsequent OSX package, *for the same version of task*, then this number
+      would be increased to show OSX that this package supersedes the earlier
+      one
+    - Make sure "Restart Action" is "None"
+    - Make sure "Require admin authentication" is checked
+    - Make sure "Package Location" is "Self-Contained"
+
+    <figure 12>
+
+  6.11 Click on the "Contents" tab/button.
+
+    - Click on all the triangles in the "local" folder to expand all directories
+    - Make sure "Include root in package is not checked"
+    - Click on the "Apply Recommendations" button
+
+    Make sure it matches the figure.
+
+    <figure 13>
+
+  6.12 Click on the "Components" tab/button, make sure it is all blank.
+
+  6.13 Click on the "Scripts" tab/button, make sure it is all blank.
+
+7. Building the package
+
+  7.1 Click on the "Build" hammer icon to build the package.
+
+  Provide a filename of "task-1.9.1-sl.pkg" for Snow Leopard (10.6), or
+  "task-1.9.2.pkg" for Leopard (10.5), and save it somewhere, for example the
+  Desktop.
+
+  All should succeed.  You can click on the "Return" button to end the build
+  phase, and you can quit PackageManager, but make sure you save the changes
+  you made, because you may need to go through the whole process again, if there
+  is an emergency change, or the package is somehow corrupt.
+
+  <figure 14>
+
+8. Test the package
+
+  8.1 Double-click on the package you just created, and install taskwarrior.
+    You should see the README file in the UI, and the COPYING file on another
+    page.  It should succeed.
+
+  <figure 14>
+  <figure 15>
+  <figure 16>
+  <figure 17>
+  <figure 18>
+  <figure 19>
+  <figure 20>
+  <figure 21>
+
+  8.2 Run the following commands to test the installation
+
+  $ /usr/local/bin/task version
+
+  task 1.9.4 built for darwin
+  Copyright (C) 2006 - 2011 P. Beckingham, F. Hernandez.
+
+  Taskwarrior may be copied only under the terms of the GNU General Public
+  License, which may be found in the taskwarrior source kit.
+
+  Documentation for taskwarrior can be found using 'man task', 'man taskrc',
+  'man task-tutorial', 'man task-color', 'man task-faq' or at
+  http://taskwarrior.org
+
+  $ man task
+  ...
+  ...
+  task 1.9.4             2011-0l-10                task 1.9.4
+
+  The man page should list 1.9.2 as the version number, but the date will be
+  different.
+
+9. Email the package to Fredde.
+
+---
+

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

@@ -0,0 +1 @@
+<pkg-contents spec="1.12"><f n="local" o="root" g="wheel" p="16877" pt="/Users/paul/task-1.9.1.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"/></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"/><f n="ChangeLog" o="root" g="wheel" p="33188"/><f n="COPYING" o="root" g="wheel" p="33188"/><f n="NEWS" o="root" g="wheel" p="33188"/><f n="README" o="root" g="wheel" p="33188"/><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"/></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"/></f><f n="README" o="root" g="wheel" p="33188"/><f n="syntax" o="root" g="wheel" p="16877"><f n="taskdata.vim" o="root" g="wheel" p="33188"/><f n="taskedit.vim" o="root" g="wheel" p="33188"/><f n="taskrc.vim" o="root" g="wheel" p="33188"/></f></f><f n="zsh" o="root" g="wheel" p="16877"><f n="_task" o="root" g="wheel" p="33188"/></f></f></f></f><f n="man" o="root" g="wheel" p="17917"><f n="man1" o="root" g="wheel" p="17901"><f n="task.1" o="root" g="wheel" p="33188"/><mod>group</mod><mod>owner</mod></f><f n="man5" o="root" g="wheel" p="17901"><f n="task-color.5" o="root" g="wheel" p="33188"/><f n="task-faq.5" o="root" g="wheel" p="33188"/><f n="task-tutorial.5" o="root" g="wheel" p="33188"/><f n="taskrc.5" o="root" g="wheel" p="33188"/><mod>group</mod><mod>owner</mod></f><mod>group</mod><mod>owner</mod></f></f><mod>group</mod><mod>owner</mod></f></pkg-contents>

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

@@ -0,0 +1 @@
+<pkgref spec="1.12" uuid="B93940C5-2C4F-47D6-8038-3D24062FBC85"><config><identifier>com.beckingham.task191.local.pkg</identifier><version>1.0</version><description/><post-install type="none"/><requireAuthorization/><installFrom>/Users/paul/task-1.9.1.git/package-config/osx/local</installFrom><installTo mod="true" relocatable="true">/usr/local</installTo><flags><followSymbolicLinks/></flags><packageStore type="internal"/><mod>installTo.path</mod><mod>identifier</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.1</title><build>/Users/paul/Desktop/task-1.9.1-sl.pkg</build><organization>com.beckingham</organization><userSees ui="both"/><min-target os="3"/><domain anywhere="true" system="true"/></properties><distribution><versions min-spec="1.000000"/><scripts></scripts></distribution><description>Task 1.9.1 install for Snow Leopard.</description><contents><choice title="local" id="choice37" starts_selected="true" starts_enabled="true" starts_hidden="false"><pkgref id="com.beckingham.task191.local.pkg"/></choice></contents><resources bg-scale="proportional" bg-align="center"><locale lang="en"><resource mod="true" type="license">/Users/paul/task-1.9.1.git/package-config/osx/COPYING.txt</resource><resource mod="true" type="readme">/Users/paul/task-1.9.1.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,36 @@
+#!/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/doc/task/scripts/fish
+mkdir -p local/share/doc/task/rc
+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 ../../scripts/fish/*         local/share/doc/task/scripts/fish
+
+cp ../../doc/rc/*.theme         local/share/doc/task/rc
+cp ../../doc/rc/holidays*       local/share/doc/task/rc
+
+cp ../../doc/man/*.1            local/share/man/man1
+cp ../../doc/man/*.5            local/share/man/man5
+

package-config/ubuntu/debian/changelog

@@ -0,0 +1,118 @@
+task (1.9.1-2ubuntu1) lucid; urgency=low
+
+  * Initial deb package for task release 1.9.1 on lucid lynx
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Sun, 23 May 2010 00:24:42 +0200
+
+task (1.9.0-2ubuntu1) lucid; urgency=low
+
+  * Initial deb package for task release 1.9.0 on lucid lynx
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Sat, 15 May 2010 11:02:17 +0200
+
+task (1.9.0-1ubuntu1) karmic; urgency=low
+
+  * Initial deb package for task beta release 1.9.0 on karmic koala
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Mon, 22 Feb 2010 22:08:41 +0100
+
+task (1.9.0-1ubuntu1~beta3) karmic; urgency=low
+
+  * Initial deb package for task beta release 1.9.0.beta3 on karmic koala
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Tue, 16 Feb 2010 00:29:31 +0100
+
+task (1.9.0-1ubuntu1~beta2) karmic; urgency=low
+
+  * Initial deb package for task beta release 1.9.0.beta2 on karmic koala
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Mon, 08 Feb 2010 22:09:41 +0100
+
+task (1.9.0-1ubuntu1~beta1) karmic; urgency=low
+
+  * Initial deb package for task beta release 1.9.0.beta1 on karmic koala
+
+ -- Federico Hernandez <ultrafredde@gmail.com>  Wed, 03 Feb 2010 23:51:08 +0100
+
+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: cdbs, debhelper (>= 7), autotools-dev, libncurses5-dev
+Standards-Version: 3.8.4
+Homepage: http://taskwarrior.org
+
+Package: task
+Architecture: any
+Depends: ${shlibs:Depends}, ${misc: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,65 @@
+This package was debianized by:
+
+    Federico Hernandez <ultrafredde@gmail.com> on  Sun, 23 May 2010 00:24:42 +0200
+
+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
+    Alexander Neumann
+    Emil Sköldberg
+    Johannes Schlatow
+
+Copyright:
+
+    Copyright 2006 - 2011, Paul Beckingham
+    Copyright 2009 - 2011  Federico Hernandez
+    Copyright 2006 - 2011, Paul Beckingham, Federico Hernandez
+    Copyright 2009 - 2011  John Florian
+    Copyright 2009 P.C. Shyamshankar
+    Copyright © 1994–2008 Lua.org, PUC-Rio
+
+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 - 2011, 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/rules

@@ -0,0 +1,45 @@
+#!/usr/bin/make -f
+
+config.status: configure
+	dh_testdir
+	./configure $(CROSS) --prefix=/usr
+
+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
+	install -D -m644 scripts/bash/task_completion.sh $(CURDIR)/debian/task/etc/bash_completion.d/task
+	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/source/format

@@ -0,0 +1 @@
+1.0

package-config/ubuntu/debian/watch

@@ -0,0 +1,5 @@
+# Compulsory line, this is a version 3 file
+version=3
+ 
+# the main taskwarrior download website
+http://taskwarrior.org/wiki/taskwarrior/Download http://www.taskwarrior.org/download/task-(.*)\.tar\.gz

script.txt

@@ -1,105 +0,0 @@
-                                            Hello, and welcome to this quick demo of the task program.
-
-task add do laundry                         Let's add some tasks
-                                            I need to do laundry
-
-task add project:garage order dumpster      Oh yeah, the dumpster
-
-task add +phone tell mom i loveher          Must call Mom  (that "phone" there is a tag - they are
-                                              useful for searching, categorizing)
-task add +phone pro:garage schedule
-  goodwill pickup
-
-task ad +email pro:garage ask Tom if        Notice I can abbreviating commands
-  he wants that old bkie
-
-task ls                                     Let's see what we've got
-                                            I spelled bike wrong
-
-task 5 /bkie/bike/
-task ls                                     That's better
-
-task 1 pro:home                             Let's assign projects
-task 3 pro:home tell mom I love her
-task ls pro:garage
-
-task long pro:garage                        Let's see all the columns
-
-task list pro:garage                        There are different ways to list
-
-task lis +phone                             By tag
-task li pro:garage +phone                   By project and tag
-task l mom                                  By word
-
-task 1 priority:H                           Priorities can be High, Medium or Low
-task pri:H 3
-task 1 pri:M
-task li                                     The list is sorted by priority.
-
-task 2 pri:L
-task li
-
-task done 3                                 Suppose task 3 is done
-task li                                     ...and it's gone
-
-task 2 +phone +mistake                      Lets add tags
-
-# Oops!
-task 2 -mistake                             or remove tags
-
-task tags                                   or look at all the tags
-
-task info 2                                 or all the details
-
-task projects                               or all the projects
-
-task 3 fg:bold                              Let's make it colorful
-task 4 fg:bold_green
-task li
-task 3 fg:bold_underline_white
-task li
-
-task 4 bg:on_bright_red fg:bold_yellow
-task li                                     Oh that's just nasty - let's get rid of that.
-task 4 bg:
-task li
-task 4 fg:
-task 3 fg:
-
-task colors                                 There are many combinations to choose from
-
-(Slashes!!!)
-task 1 due:6/8/2008                         Let's add a due date
-date
-
-task li
-task calendar                               Notice the due task is in yellow, today is marked cyan
-
-task 1 due:5/20/2008                        This is now an overdue task
-task li                                     and it shows up red
-task overdue
-task cal
-
-task export file.csv                        You can export the tasks to a spreadsheet
-cat file.csv
-
-task start 1                                Started tasks can be used as reminders
-                                              of what you are supposed to be doing
-
-task active                                 They show up as active
-task done 1                                 Let's clear out a couple
-task li
-task done 3
-task active
-
-task summary                                Summary shows progress on all projects
-
-task history                                History shows general activity - how many added,
-                                              completed etc, by month
-
-                                            And that's it.  There are more commands than this
-                                            covered in the TUTORIAL file, but this should give
-                                            the basic idea.
-
-                                            Thank you for watching.
-

scripts/CMakeLists.txt

@@ -0,0 +1 @@
+install (DIRECTORY bash fish vim zsh add-ons DESTINATION ${TASK_DOCDIR}/scripts)

scripts/add-ons/export-csv.pl

@@ -0,0 +1,70 @@
+#! /usr/bin/perl
+################################################################################
+## taskwarrior - a command line task list manager.
+##
+## Copyright 2006 - 2011, Paul Beckingham, Federico Hernandez.
+## 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
+##
+################################################################################
+
+use strict;
+use warnings;
+use JSON;
+
+# Use the taskwarrior 1.9.4+ _query command to issue a query and return JSON
+my $command = '/usr/local/bin/task _query ' . join (' ', @ARGV);
+
+# Generate output.
+print "'uuid','status','tags','entry','start','due','recur','end','project',",
+      "'priority','fg','bg','description'\n";
+
+for my $task (split /,$/ms, qx{$command})
+{
+  my $data = from_json ($task);
+
+  print "'$data->{'uuid'}',",
+        "'$data->{'status'}',",
+        "'", (exists $data->{'tags'} ? join (' ', @{$data->{'tags'}}) : ''), "',",
+        "'$data->{'entry'}',",
+        "'", ($data->{'start'}    || ''), "',",
+        "'", ($data->{'due'}      || ''), "',",
+        "'", ($data->{'recur'}    || ''), "',",
+        "'", ($data->{'end'}      || ''), "',",
+        "'", ($data->{'project'}  || ''), "',",
+        "'", ($data->{'priority'} || ''), "',",
+        "'", ($data->{'fg'}       || ''), "',",
+        "'", ($data->{'bg'}       || ''), "',",
+        "'$data->{'description'}'",
+        "\n";
+
+  # Note that this format ignores:
+  #   wait
+  #   until
+  #   annotations
+  #   mask
+  #   imask
+}
+
+exit 0;
+
+################################################################################
+