- Completed 0.9.9

- Documentation snapshot, version bump.
- Updated status in ChangeLog.
2008-05-27 20:47:56 -04:00 · 2008-05-27 16:05:54 -04:00 · 2008-05-26 21:40:56 -04:00 · 2008-05-26 21:39:10 -04:00 · 2008-05-26 21:14:34 -04:00 · 2008-05-26 20:58:41 -04:00
26 changed files with 958 additions and 362 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -1,7 +1,6 @@
 Makefile.in
 aclocal.m4
 autom4te.cache
-conf.defs
 auto.h*
 config.h.in
 config.status
--- a/7
+++ b/7
@@ -0,0 +1,7 @@
+Principal Author
+  Paul Beckingham, paul@beckingham.net
+
+Contributing Authors
+
+Testers
+
--- a/164
+++ b/164
@@ -1,125 +1,149 @@
+1.1.0 (?)
+  - Command line specification of .taskrc file

-1.0.0 - First official release ()
-  - Bug: assertion fails for task info n, where n is out of range
+1.0.0 (?)
+  - New movie made, uploaded
  - Bug: assertion fails on mobile for t v
-
-0.10.0 - Productization ()
-  ~ Documentation complete
-  ~ Test suite
-  ~ All known bugs fixed
+  - Bug: configure.ac does not properly determine ncurses availability
+  - Bug: when run without arguments, task dumps core on Solaris 10
+  - Bug: Cannot seem to use the percent character in a task description
+  - Bug: New installation "task stats" reports newest task 12/31/1969
+  - Bug: New installation task projects displays header but no data - should short-circuit
+  + Bug: incorrect color specification in sample .taskrc file

 ------ reality -----------------------------------

-0.9.7
-  5/17/2008
-    + Task offers to create a sample ~/.taskrc file if one is not found.
-    + Task offers to create a ~/.task directory if one is not found.
+0.9.9 (5/27/2008)
+  + Autoconf/autmake behaving properly.
+  + Clean build on OS X 10.5.
+  + Clean build on Ubuntu 8.0.
+  + Clean build on Fedora Core 8.
+  + Clean build on Fedora Core 9.

-0.9.6
-  5/13/208
-    + Replaced color management code.
-    + Improved color rules code.
+0.9.8 (5/25/2008)
+  + Added "task color" command.
+  + Removed unnecessary files.
+  + Completed documentation.

-0.9.5
-  5/12/2008
-    +  Replaced Table storage with Grid.
-  5/10/2008
-    + Added Grid.cpp to configure.ac
-    + Added Makefile to src/.gitignore
-    + Makefile should not be part of the repository.
-    + Added Grid.cpp
-    + Added Grid::Cell::operator==
-  4/27/2008
-    + ChangeLog file begun.
-    + Bumped version to 0.9.5 for next release.
+0.9.7 (5/24/2008)
+  + Migrated old compiler flags into Makefile.am
+  + Added ncurses endwin function check to configure.ac
+  + Set up structure for AUTHORS file.
+  + Set up NEWS file, with pleas for feedback.
+  + Added welcome message to README.
+  + Completed a chunk of the TUTORIAL.
+  + Added error handling for "task export" when a file name is not specified.
+  + Task offers to create a sample ~/.taskrc file if one is not found.
+  + Task offers to create a ~/.task directory if one is not found.
+  + Removed unnecessary SAMPLE_taskrc, and assorted references.
+  + Cleaned up ChangeLog.
+  + Minor mods to standard docs.
+  + Bumped version to 0.9.7
+  + Changed some autoconf details
+  + Corrected comment in T.cpp
+  + Made unit tests compile and run again.
+  + Removed tests from distibution.

-0.9.4
-  4/26/2008
-    + Integrated new Grid object into build - not yet integrated into Table.
-  4/19/2008
-    + More .gitignore tweaks.
-    + Added .gitignore
-    + Added more missing files.
-    + Added all source code.
-    + Generic OSS files added.
-    + Initial commit.
+0.9.6 (5/13/208)
+  + Corrected wrong include file in Table.cpp
+  + Replaced color management code.
+  + Improved color rules code.

-0.9.3
-  4/6/2008
+0.9.5 (5/12/2008)
+  + Replaced Table storage with Grid.
+  + Added Grid.cpp to configure.ac
+  + Added Makefile to src/.gitignore
+  + Makefile should not be part of the repository.
+  + Added Grid.cpp
+  + Added Grid::Cell::operator==
+  + ChangeLog file begun.
+  + Bumped version to 0.9.5 for next release.

-0.9.2
-  4/3/2008
+0.9.4 (4/26/2008)
+  + Integrated new Grid object into build - not yet integrated into Table.
+  + More .gitignore tweaks.
+  + Added .gitignore
+  + Added more missing files.
+  + Added all source code.
+  + Generic OSS files added.
+  + Initial commit.

-0.9.1
-  4/1/2008
+0.9.3 (4/6/2008)
+  + Added "task completed" command.
+  + Properly recognizes ncurses.

-0.9.0
-  3/23/2008
-    + flat source directory
-    + autoconf complete
-    + "task next"
-    + "task stats"
-    + "task export"
-    + Rule₋based colorization
+0.9.2 (4/3/2008)
+  + Recognizes whether ncurses, flock is available.
+  + "task" duplicated to "task_rel" for preparation of a fork.

-0.8.16
-  3/13/208
+0.9.1 (4/1/2008)
+  + Blank attributes read are longer be written out.
+  + Completed "task export" command.
+  + Added configuration values to "task version" command.
+  + Consolidated header files, removed unnecessary ones.

-0.8.14
-  2/20/2008
+0.9.0 (3/23/2008)
+  + flat source directory
+  + autoconf complete
+  + "task next"
+  + "task stats"
+  + "task export"
+  + Rules-based colorization

-0.8.13
-  2/2/2008
+0.8.1 (1/28/2008) - 0.8.16 (3/13/2008)
+  + autoconf conversion (many builds)

-0.8.1
-  1/28/2008
-
-0.8.0 - Polish (1/25/2008)
+0.8.0 Polish (1/25/2008)
  + Code cleanup, reorganization
  + "task overdue"
  + Add "age" column to list and long
  + Use 'conf' for build, version tracking
  + Add "/from/to/" description editing

-0.7.0 - Multi-user, File handling, atomicity (1/8/2008)
+0.7.0 Multi-user, File handling, atomicity (1/8/2008)
  + Clean, publishable API reimplementation
  + File locking
  + retain deleted tasks
  + "task info ID" report showing all metadata

-0.6.0 - Reports (12/27/2006)
+[Development hiatus while planning for T, TDB API, new features and the future
+of the project.  Seeded to two testers for feedback, suggestions.]
+
+0.6.0 Reports (12/27/2006)
  + "task history"
  + "task summary"
  + "task calendar"
-  + due: support
+  + due support
  + Table sorting

-0.5.0 - Multi-user support (12/10/2006)
+0.5.0 Multi-user support (12/10/2006)
  + Command logging
  + "task usage" report

-0.4.0 - Destructive / modification commands (12/3/2006)
+0.4.0 Destructive / modification commands (12/3/2006)
  + "task delete" complete
  + "task id ..." complete
  + "task list ..." synonym for "task find ..."

-0.3.0 - Work in progress support (12/3/2006)
+0.3.0 Work in progress support (12/3/2006)
  + "task start" complete
  + "task done" complete
  + completed.data support

-0.2.0 - Neutral commands (12/2/2006)
+0.2.0 Neutral commands (12/2/2006)
  + "task find" complete
  + "task projects" complete
  + "task tags" complete

-0.1.0 - Constructive commands (12/1/2006)
+0.1.0 Constructive commands (12/1/2006)
  + "task add" complete
  + completed.data support
  + ~/.taskrc support

-0.0.1 - Basic infrastructure (11/29/2006)
+0.0.1 Basic infrastructure (11/29/2006)
  + Command line parsing
  + API layer
  + Usage

+------ start -----------------------------------
+
--- a/20
+++ b/20
@@ -0,0 +1,20 @@
+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 patches to task@beckingham.net
+
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,3 +1,3 @@
 SUBDIRS = src
-EXTRA_DIST = TUTORIAL SAMPLE_taskrc
+EXTRA_DIST = TUTORIAL DEVELOPERS

--- a/30
+++ b/30
@@ -1,4 +1,32 @@
+Welcome to Task 1.0.0.

-Task 1.0 is released.
+Task has been built and tested on the following configurations:

+  - OS X 10.5 Leopard
+  - Fedora Core 8
+  - Fedora Core 9
+  - Ubuntu 8
+
+Known Issues:
+
+  - problems running on Solaris 10
+
+While Task has undergone testing, bugs are sure to remain.  If you encounter a
+bug, please contact me at bugs@beckingham.net.  Here is what you could do, in
+order of increasing effort (to you) and usefulness (to me):
+
+  - Do nothing.  Bug probably won't get fixed.
+
+  - Send an email to bugs@beckingham.net, explaining what you saw.  The bug
+    will be addressed, and a new release will be made.  You will be a hero.
+
+  - 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.
+
+  - 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.
+
+Thank you.

--- a/65
+++ b/65
@@ -1,47 +1,44 @@
-
-Thank you
-GTD
-Based on ideas in todo.sh
-Movie at www.b.n/task.mov
-Feedback, suggestions to task@beckingham.net
-
-
-
-
-Task - a GTD utility featuring:
+Thank you for taking a look at task.  Task is a GTD utility featuring:

  - Robust C++ implementation
  - Tags
  - Colorful, tabular output
  - Reports
  - Low-level API
-  - Auto-completion on all commands, options
+  - Abbreviations for all commands, options
  - Multi-user file locking
  - Clean architecture allowing quick addition of new features
-  - UUID for all tasks
-
-Task is an implementation of GTD ideas, similar to todo.sh, but without many of
-the limitations in todo.sh, namely:
-
-  - Bugs are not being fixed
-  - No response or web update from ________ on code submission
-  - todo.py is the todo.sh replacement, but requires a python installation - a
-    significant barrier to many users, and is currently merely a
-    reimplementation of todo.sh
-  - project.sh is the natural progression for todo.sh, but is intended to be a
-    project management solution, but is so far todo.sh with a "done" and
-    "overview" command
-  - There is no output formatting
-  - There is no way to enumerate projects, categories
-  - There is no file locking for multi-user access
-  - With no API, a graphical front end must reimplement the primitives
-
-With a robust infrastructure in place for parsing commands, file I/O and
-structured output, the development threshold for adding new features is kept
-low.

 It is intended that features, mainly in the form of reports will be added
-frequently, with best practices and useful reports evolving.
+frequently, with best practices and useful reports evolving from usage patterns.

 Task is scope-limited to GTD functionality only.

+You may want to jump straight to the TUTORIAL file, or perhaps watch the old
+task movie on YouTube:
+
+  http://www.youtube.com/watch?v=l68LCl6BYvs
+
+or the new improved one:
+
+  http:/www.youtube.com/watch?v=????????????
+
+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!
+
--- a/15
+++ b/15
@@ -1,15 +0,0 @@
-data.location=/home/bob/.task
-#command.logging=on
-confirmation=yes
-nag=Note: try to stick to high priority tasks.  See "task next".
-next=2
-
-#color.overdue=red
-#color.due=on yellow
-#color.pri.H=red
-#color.pri.M=yellow
-#color.pri.L=green
-#color.pri.none=white on yellow
-#color.active=blue
-#color.tagged=yellow
-
--- a/554
+++ b/554
@@ -1,9 +1,18 @@
-Task program tutorial, for version 0.9.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
 -----------
@@ -12,10 +21,10 @@ Build the task program according to the directions in the INSTALL file.  This
 transcript illustrates a typical installation:

  % ls
-  task-0.9.0.tar.gz
-  % gunzip task-0.9.0.tar.gz
-  % tar xf task-0.9.0.tar
-  % cd task-0.9.0
+  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
@@ -23,21 +32,24 @@ transcript illustrates a typical installation:
  % make install

 You need to make sure that the installed task program is in your PATH
-environment variable.  The next step is to create a configuration file for the
-task program.  This file resides in your home directory, is called .taskrc, and
-contains various configuration settings.  Use the provided SAMPLE_taskrc file
-as a starting point for your own:
+environment variable.

-  % cp SAMPLE_taskrc ~/.taskrc
-  % mkdir ~/.task
+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.

-Your .taskrc files contains an entry that points to the .task directory
-belonging to user bob.  Change this entry to point to your own home directory,
-and the .task directory you just created.  Your task program is now ready to
-use.  Verify that task is properly installed with:
+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
-  [show sample output]
+
+  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
@@ -70,14 +82,15 @@ task 2:
  Permanently delete task? (y/n) y

 Task wants you to confirm deletions.  To remove the confirmation, edit your
-.taskrc file and remove the line:
+.taskrc file and change the line:

  confirmation=yes

-or change the yes to no.  
+to have a value of "no".

-While projects and priorities are not necessary, they can be very useful when
-the list of tasks grows large.  Let's assign a project to these tasks:
+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
@@ -92,9 +105,10 @@ the list of tasks grows large.  Let's assign a project to these tasks:
 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.
-
-Now that projects are assigned, we can look at just the Wedding project tasks:
+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

@@ -136,37 +150,44 @@ 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               
+  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 task can have a due date, and can be active.  The task lists are
+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:3/25/2008
-  % task 1 due:5/31/2008
+  % task 3 due:6/25/2008
+  % task 1 due:7/31/2008
  % task list

  ID Project Pri Due       Active Age    Description               
-   3 Family  H   3/25/2008        6 mins Send John a birthday card
-   1 Wedding H   5/31/2008        7 mins Book plane ticket
+   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 3/23/2008, then task 3 is due in 2 days.  It will be colored
+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=<foreground color> on <background color>
-  color.due=<foreground color>
-  color.due=on <background color>
+  color.due=red
+  color.due=on_blue
+  color.due=red on_blue
+  color.due=bold_red on_blue

-Where color is one of:
+Where color is one of the following:

  black
  blue
@@ -178,38 +199,451 @@ Where color is one of:
  white

 All colors are specified in this way.  Take a look in .taskrc for all the other
-colors you control.
+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
 ------------

-Commands:
-  - task add
-  - task list
-  - task long
-  - task ls
-  - task done
-  - task completed
-  - task delete
-  - task start
-  - task summary
-  - task history
-  - task next
-  - task <modify>
-  - task /from/to/
-  - task projects
-  - task tags
-  - task info
-  - task active
-  - task overdue
-  - task calendar
-  - task stats
-  - task usage
-  - task export
-  - task version
+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
 --------------------------
-  - Escaping shell metacharacters
+
+  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
+
+
+
+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

--- a/configure.ac
+++ b/configure.ac
@@ -2,11 +2,10 @@
 # Process this file with autoconf to produce a configure script.

 AC_PREREQ(2.61)
-AC_INIT(task, 0.9.7, bugs@beckingham.net)
+AC_INIT(task, 0.9.9, bugs@beckingham.net)
 AM_INIT_AUTOMAKE
 AC_CONFIG_SRCDIR([src/task.cpp])
 AC_CONFIG_HEADER([auto.h])
-#AC_CONFIG_SUBDIRS([src])

 # Checks for programs.
 AC_PROG_CXX
@@ -14,8 +13,8 @@ AC_PROG_CC
 AC_LANG(C++)

 # Checks for libraries.
-#AC_CHECK_LIB(ncurses, initscr, [LIBS="$LIBS -lncurses" AC_DEFINE([HAVE_NCURSES], [1], [Found ncurses])])
 AC_CHECK_LIB(ncurses,initscr)
+AC_CHECK_LIB(ncurses,endwin)

 # Checks for header files.
 AC_HEADER_STDC
--- a/script.txt
+++ b/script.txt
@@ -0,0 +1,68 @@
+task add do laundry
+task add project:garage order dumpster
+task add +phone tell mom i loveher
+task add +phone pro:garage schedule goodwill pickup
+task add +email pro:garage ask Tom if he wants that old bike
+task ls
+
+task 1 pro:home
+task 3 pro:home tell mom I love her
+task ls pro:garage
+task long pro:garage
+task list pro:garage
+task lis +phone
+task li pro:garage +phone
+task l mom
+
+task 1 priority:H
+task pri:H 3
+task 1 pri:M
+task li
+task 2 pri:L
+task li
+task do 3
+task li
+
+# There may be an arbitrary number of tags.
+task 2 +phone +mistake
+# Oops!
+task 2 -mistake
+task tags
+task info 2
+
+task projects
+
+task 3 fg:bold
+task li
+task 3 fg:white
+task li
+task 3 fg:bold_underline_white
+task li
+task 4 bg:on_bright_red fg:bold_yellow
+task li
+task 4 bg:
+task li
+task 4 fg:
+task colors
+
+task 1 due:6/8/2008
+task li
+task calendar
+task 1 due:6/1/2008
+task li
+task overdue
+task cal
+
+task export file.csv
+cat file.csv
+
+task start 1
+task active
+task do 1
+task li
+task do 3
+task do 1
+task active
+task summary
+task history
+
--- a/src/Config.cpp
+++ b/src/Config.cpp
@@ -7,6 +7,7 @@
 #include <fstream>
 #include <sstream>
 #include <sys/stat.h>
+#include <stdlib.h>
 #include "task.h"
 #include "Config.h"

@@ -35,7 +36,7 @@ bool Config::load (const std::string& file)
    while (getline (in, line))
    {
      // Remove comments.
-      unsigned int pound = line.find ("#");
+      size_type pound = line.find ("#");
      if (pound != std::string::npos)
        line = line.substr (0, pound);

@@ -44,7 +45,7 @@ bool Config::load (const std::string& file)
      // Skip empty lines.
      if (line.length () > 0)
      {
-        unsigned int equal = line.find ("=");
+        size_type equal = line.find ("=");
        if (equal != std::string::npos)
        {
          std::string key   = trim (line.substr (0, equal), " \t");
@@ -86,7 +87,7 @@ void Config::createDefault (const std::string& file)
    if (taskDir != "")
    {
      FILE* out;
-      if (out = fopen (file.c_str (), "w"))
+      if ((out = fopen (file.c_str (), "w")))
      {
        fprintf (out, "data.location=%s\n", taskDir.c_str ());
        fprintf (out, "command.logging=off\n");
@@ -96,12 +97,12 @@ void Config::createDefault (const std::string& file)
        fprintf (out, "curses=on\n");
        fprintf (out, "color=on\n");

-        fprintf (out, "color.overdue=red\n");
-        fprintf (out, "#color.due=on yellow\n");
+        fprintf (out, "color.overdue=bold_red\n");
+        fprintf (out, "#color.due=on_bright_yellow\n");
        fprintf (out, "#color.pri.H=on_red\n");
        fprintf (out, "#color.pri.M=on_yellow\n");
        fprintf (out, "#color.pri.L=on_green\n");
-        fprintf (out, "color.active=cyan\n");
+        fprintf (out, "color.active=bold_cyan\n");
        fprintf (out, "color.tagged=yellow\n");

        fclose (out);
--- a/src/Date.cpp
+++ b/src/Date.cpp
@@ -5,6 +5,8 @@
 ////////////////////////////////////////////////////////////////////////////////
 #include <iostream>
 #include <time.h>
+#include <assert.h>
+#include <stdlib.h>
 #include "task.h"
 #include "Date.h"

@@ -36,8 +38,8 @@ Date::Date (const int m, const int d, const int y)
 ////////////////////////////////////////////////////////////////////////////////
 Date::Date (const std::string& mdy)
 {
-  unsigned int firstSlash  = mdy.find ("/");
-  unsigned int secondSlash = mdy.find ("/", firstSlash + 1);
+  size_t firstSlash  = mdy.find ("/");
+  size_t secondSlash = mdy.find ("/", firstSlash + 1);
  if (firstSlash != std::string::npos &&
      secondSlash != std::string::npos)
  {
@@ -155,7 +157,7 @@ int Date::daysInMonth (int month, int year)
 ////////////////////////////////////////////////////////////////////////////////
 std::string Date::monthName (int month)
 {
-  static char* months[12] =
+  static const char* months[12] =
  {
    "January",
    "February",
@@ -179,7 +181,7 @@ std::string Date::monthName (int month)
 ////////////////////////////////////////////////////////////////////////////////
 void Date::dayName (int dow, std::string& name)
 {
-  static char* days[7] =
+  static const char* days[7] =
  {
    "Sunday",
    "Monday",
@@ -196,7 +198,7 @@ void Date::dayName (int dow, std::string& name)
 ////////////////////////////////////////////////////////////////////////////////
 std::string Date::dayName (int dow)
 {
-  static char* days[7] =
+  static const char* days[7] =
  {
    "Sunday",
    "Monday",
--- a/src/Grid.cpp
+++ b/src/Grid.cpp
@@ -399,6 +399,8 @@ bool Grid::Cell::operator== (const Grid::Cell& rhs) const
  case CELL_STRING: return mString == rhs.mString ? true : false;
  default:          break; // To prevent warnings.
  }
+
+  return false;
 }

 ////////////////////////////////////////////////////////////////////////////////
@@ -414,6 +416,8 @@ bool Grid::Cell::operator!= (const Grid::Cell& rhs) const
  case CELL_STRING: return mString != rhs.mString ? true : false;
  default:          break; // To prevent warnings.
  }
+
+  return false;
 }

 ////////////////////////////////////////////////////////////////////////////////
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -1,2 +1,3 @@
 bin_PROGRAMS = task
 task_SOURCES = Config.cpp Date.cpp T.cpp TDB.cpp Table.cpp Grid.cpp color.cpp parse.cpp task.cpp util.cpp text.cpp rules.cpp Config.h Date.h T.h TDB.h Table.h Grid.h color.h stlmacros.h task.h
+AM_CPPFLAGS = -Wall -pedantic -ggdb3 -fno-rtti
--- a/src/Makefile.in
+++ b/src/Makefile.in
@@ -155,6 +155,7 @@ target_alias = @target_alias@
 top_builddir = @top_builddir@
 top_srcdir = @top_srcdir@
 task_SOURCES = Config.cpp Date.cpp T.cpp TDB.cpp Table.cpp Grid.cpp color.cpp parse.cpp task.cpp util.cpp text.cpp rules.cpp Config.h Date.h T.h TDB.h Table.h Grid.h color.h stlmacros.h task.h
+AM_CPPFLAGS = -Wall -pedantic -ggdb3 -fno-rtti
 all: all-am

 .SUFFIXES:
--- a/src/T.cpp
+++ b/src/T.cpp
@@ -115,7 +115,7 @@ void T::addTag (const std::string& tag)
 ////////////////////////////////////////////////////////////////////////////////
 void T::addTags (const std::vector <std::string>& tags)
 {
-  for (unsigned int i = 0; i < tags.size (); ++i)
+  for (size_t i = 0; i < tags.size (); ++i)
  {
    if (tags[i].find (' ') != std::string::npos)
      throw std::string ("T::addTags - tags may not contain spaces");
@@ -137,7 +137,7 @@ void T::addTags (const std::vector <std::string>& tags)
 void T::removeTag (const std::string& tag)
 {
  std::vector <std::string> copy;
-  for (unsigned int i = 0; i < mTags.size (); ++i)
+  for (size_t i = 0; i < mTags.size (); ++i)
    if (mTags[i] != tag)
      copy.push_back (mTags[i]);

@@ -242,7 +242,7 @@ const std::string T::compose () const
  else if (mStatus == deleted)   line += "X [";

  // Tags
-  for (unsigned int i = 0; i < mTags.size (); ++i)
+  for (size_t i = 0; i < mTags.size (); ++i)
  {
    line += (i > 0 ? " " : "");
    line += mTags[i];
@@ -297,7 +297,7 @@ const std::string T::composeCSV ()

  // Tags
  line += "'";
-  for (unsigned int i = 0; i < mTags.size (); ++i)
+  for (size_t i = 0; i < mTags.size (); ++i)
  {
    line += (i > 0 ? " " : "");
    line += mTags[i];
@@ -364,13 +364,13 @@ void T::parse (const std::string& line)
        if (line[0] == 'X')
          setStatus (deleted);

-        unsigned int openTagBracket  = line.find ("[");
-        unsigned int closeTagBracket = line.find ("]", openTagBracket);
+        size_t openTagBracket  = line.find ("[");
+        size_t closeTagBracket = line.find ("]", openTagBracket);
        if (openTagBracket  != std::string::npos &&
            closeTagBracket != std::string::npos)
        {
-          unsigned int openAttrBracket  = line.find ("[", closeTagBracket);
-          unsigned int closeAttrBracket = line.find ("]", openAttrBracket);
+          size_t openAttrBracket  = line.find ("[", closeTagBracket);
+          size_t closeAttrBracket = line.find ("]", openAttrBracket);
          if (openAttrBracket  != std::string::npos &&
              closeAttrBracket != std::string::npos)
          {
@@ -383,7 +383,7 @@ void T::parse (const std::string& line)
               openAttrBracket + 1, closeAttrBracket - openAttrBracket - 1);
             std::vector <std::string> pairs;
             split (pairs, attributes, ' ');
-             for (unsigned int i = 0; i <  pairs.size (); ++i)
+             for (size_t i = 0; i <  pairs.size (); ++i)
             {
               std::vector <std::string> pair;
               split (pair, pairs[i], ':');
@@ -415,13 +415,13 @@ void T::parse (const std::string& line)
                  : line[37] == 'X' ? deleted
                  :                  pending;

-        unsigned int openTagBracket  = line.find ("[");
-        unsigned int closeTagBracket = line.find ("]", openTagBracket);
+        size_t openTagBracket  = line.find ("[");
+        size_t closeTagBracket = line.find ("]", openTagBracket);
        if (openTagBracket  != std::string::npos &&
            closeTagBracket != std::string::npos)
        {
-          unsigned int openAttrBracket  = line.find ("[", closeTagBracket);
-          unsigned int closeAttrBracket = line.find ("]", openAttrBracket);
+          size_t openAttrBracket  = line.find ("[", closeTagBracket);
+          size_t closeAttrBracket = line.find ("]", openAttrBracket);
          if (openAttrBracket  != std::string::npos &&
              closeAttrBracket != std::string::npos)
          {
@@ -434,7 +434,7 @@ void T::parse (const std::string& line)
               openAttrBracket + 1, closeAttrBracket - openAttrBracket - 1);
             std::vector <std::string> pairs;
             split (pairs, attributes, ' ');
-             for (unsigned int i = 0; i <  pairs.size (); ++i)
+             for (size_t i = 0; i <  pairs.size (); ++i)
             {
               std::vector <std::string> pair;
               split (pair, pairs[i], ':');
--- a/src/TDB.cpp
+++ b/src/TDB.cpp
@@ -7,6 +7,7 @@
 #include <fstream>
 #include <sys/file.h>
 #include <unistd.h>
+#include <string.h>

 #include "task.h"
 #include "TDB.h"
--- a/src/Table.cpp
+++ b/src/Table.cpp
@@ -22,6 +22,8 @@
 //
 ////////////////////////////////////////////////////////////////////////////////
 #include <iostream>
+#include <string.h>
+#include <assert.h>
 #include <Table.h>
 #include <Date.h>
 #include <task.h>
@@ -415,7 +417,7 @@ void Table::calculateColumnWidths ()
  std::vector <int> ideal = mMaxDataWidth;
  int width = 0;
  int countFlexible = 0;
-  for (unsigned int c = 0; c < mColumns.size (); ++c)
+  for (size_t c = 0; c < mColumns.size (); ++c)
  {
    if (mSpecifiedWidth[c] == flexible)
      ++countFlexible;
@@ -440,7 +442,7 @@ void Table::calculateColumnWidths ()
  {
    ideal = mMaxDataWidth;
    width = 0;
-    for (unsigned int c = 0; c < mColumns.size (); ++c)
+    for (size_t c = 0; c < mColumns.size (); ++c)
    {
      if (mSpecifiedWidth[c] > 0)
        ideal[c] = mSpecifiedWidth[c];
@@ -462,7 +464,7 @@ void Table::calculateColumnWidths ()
      int remainder = available % countFlexible;

      int lastFlexible = mColumns.size () - 1;
-      for (unsigned int c = 0; c < mColumns.size (); ++c)
+      for (size_t c = 0; c < mColumns.size (); ++c)
      {
         if (mSpecifiedWidth[c] == flexible)
         {
@@ -476,8 +478,16 @@ void Table::calculateColumnWidths ()
      mCalculatedWidth = ideal;
      return;
    }
-//    else
+    else
+    {
 //      std::cout << "# insufficient room, considering only flexible columns." << std::endl;
+
+      // The fallback position is to assume no width was specificed, and just
+      // calculate widths accordingly.
+      mTableWidth = 0;
+      calculateColumnWidths ();
+      return;
+    }
  }

  // Try again, treating minimum columns as flexible.
@@ -585,7 +595,7 @@ void Table::formatCell (
  std::string postJust;
  std::vector <std::string> chunks;
  wrapText (chunks, data, width);
-  for (unsigned int chunk = 0; chunk < chunks.size (); ++chunk)
+  for (size_t chunk = 0; chunk < chunks.size (); ++chunk)
  {
    // Place the data within the available space - justify.
    int gap = width - chunks[chunk].length ();
@@ -606,7 +616,7 @@ void Table::formatCell (
      for (int i = 0; i < gap / 2; ++i)
        preJust += " ";

-      for (unsigned int i = 0; i < gap - preJust.length (); ++i)
+      for (size_t i = 0; i < gap - preJust.length (); ++i)
        postJust += " ";
    }

@@ -662,7 +672,7 @@ const std::string Table::formatCell (
    for (int i = 0; i < gap / 2; ++i)
      preJust += " ";

-    for (unsigned int i = 0; i < gap - preJust.length (); ++i)
+    for (size_t i = 0; i < gap - preJust.length (); ++i)
      postJust += " ";
  }

@@ -706,7 +716,7 @@ void Table::optimize (std::string& output)
 */

  // \s\n -> \n
-  unsigned int i = 0;
+  size_t i = 0;
  while ((i = output.find (" \n")) != std::string::npos)
  {
    output = output.substr (0, i) +
@@ -749,7 +759,7 @@ void Table::sort (std::vector <int>& order)
    while (r + gap < (int) order.size ())
    {
      bool keepScanning = true;
-      for (unsigned int c = 0; keepScanning && c < mSortColumns.size (); ++c)
+      for (size_t c = 0; keepScanning && c < mSortColumns.size (); ++c)
      {
        keepScanning = false;

@@ -847,8 +857,8 @@ void Table::sort (std::vector <int>& order)
 ////////////////////////////////////////////////////////////////////////////////
 void Table::clean (std::string& value)
 {
-  unsigned int start = 0;
-  unsigned int pos;
+  size_t start = 0;
+  size_t pos;
  while ((pos = value.find ('\t', start)) != std::string::npos)
  {
    value.replace (pos, 1, " ");
@@ -876,7 +886,7 @@ const std::string Table::render ()

  // Print column headers in column order.
  std::string output;
-  for (unsigned int col = 0; col < mColumns.size (); ++col)
+  for (size_t col = 0; col < mColumns.size (); ++col)
    output += formatHeader (
                col,
                mCalculatedWidth[col],
@@ -899,8 +909,8 @@ const std::string Table::render ()
    std::vector <std::vector <std::string> > columns;
    std::vector <std::string> blanks;

-    unsigned int maxHeight = 0;
-    for (unsigned int col = 0; col < mColumns.size (); ++col)
+    size_t maxHeight = 0;
+    for (size_t col = 0; col < mColumns.size (); ++col)
    {
      std::vector <std::string> lines;
      std::string blank;
@@ -920,9 +930,9 @@ const std::string Table::render ()

    if (maxHeight)
    {
-      for (unsigned int lines = 0; lines < maxHeight; ++lines)
+      for (size_t lines = 0; lines < maxHeight; ++lines)
      {
-        for (unsigned int col = 0; col < mColumns.size (); ++col)
+        for (size_t col = 0; col < mColumns.size (); ++col)
          if (lines < columns[col].size ())
            output += columns[col][lines];
          else
--- a/src/library.h
+++ b/src/library.h
@@ -1,49 +0,0 @@
-////////////////////////////////////////////////////////////////////////////////
-// Copyright 2004 - 2008, Paul Beckingham.  All rights reserved.
-//
-//
-////////////////////////////////////////////////////////////////////////////////
-#ifndef INCLUDED_LIBRARY
-#define INCLUDED_LIBRARY
-
-#include <string>
-#include <vector>
-#include <sys/types.h>
-
-#include "stlmacros.h"
-
-#ifndef max
-#define max(a,b) ((a) > (b) ? (a) : (b))
-#endif
-
-// text.cpp
-void wrapText (std::vector <std::string>&, const std::string&, const int);
-std::string trimLeft (const std::string& in, const std::string& t = " ");
-std::string trimRight (const std::string& in, const std::string& t = " ");
-std::string trim (const std::string& in, const std::string& t = " ");
-std::wstring trimLeft (const std::wstring& in, const std::wstring& t = L" ");  // UNICODE safe
-std::wstring trimRight (const std::wstring& in, const std::wstring& t = L" "); // UNICODE safe
-std::wstring trim (const std::wstring& in, const std::wstring& t = L" ");      // UNICODE safe
-void extractParagraphs (const std::string&, std::vector<std::string>&);
-void extractLine (std::string&, std::string&, int);
-void split (std::vector<std::string>&, const std::string&, const char);
-void split (std::vector<std::string>&, const std::string&, const std::string&);
-void join (std::string&, const std::string&, const std::vector<std::string>&);
-std::string commify (const std::string&);
-std::string lowerCase (const std::string&);
-
-// misc.cpp
-void delay (float);
-
-// list.cpp
-int autoComplete (const std::string&, const std::vector<std::string>&, std::vector<std::string>&);
-
-// units.cpp
-void formatTimeDeltaDays (std::string&, time_t);
-std::string formatSeconds (time_t);
-
-// uuid.cpp
-const std::string uuid ();
-
-#endif
-////////////////////////////////////////////////////////////////////////////////
--- a/src/parse.cpp
+++ b/src/parse.cpp
@@ -4,6 +4,7 @@
 //
 ////////////////////////////////////////////////////////////////////////////////
 #include <iostream>
+#include <stdlib.h>
 #include <string>
 #include <vector>
 #include <map>
@@ -13,7 +14,7 @@
 #include "T.h"

 ////////////////////////////////////////////////////////////////////////////////
-static char* colors[] =
+static const char* colors[] =
 {
  "bold",
  "underline",
@@ -75,7 +76,7 @@ static char* colors[] =
  "",
 };

-static char* attributes[] =
+static const char* attributes[] =
 {
  "project",
  "priority",
@@ -88,11 +89,12 @@ static char* attributes[] =
  "",
 };

-static char* commands[] =
+static const char* commands[] =
 {
  "active",
  "add",
  "calendar",
+  "colors",
  "completed",
  "delete",
  "done",
@@ -114,7 +116,7 @@ static char* commands[] =
  "",
 };

-void guess (const std::string& type, char** list, std::string& candidate)
+void guess (const std::string& type, const char** list, std::string& candidate)
 {
  std::vector <std::string> options;
  for (int i = 0; list[i][0]; ++i)
@@ -135,7 +137,7 @@ void guess (const std::string& type, char** list, std::string& candidate)
    error += " '";
    error += candidate;
    error += "' - could be either of ";
-    for (unsigned int i = 0; i < matches.size (); ++i)
+    for (size_t i = 0; i < matches.size (); ++i)
    {
      if (i)
        error += ", ";
@@ -164,8 +166,8 @@ static bool isCommand (const std::string& candidate)
 ////////////////////////////////////////////////////////////////////////////////
 bool validDate (std::string& date)
 {
-  unsigned int firstSlash  = date.find ("/");
-  unsigned int secondSlash = date.find ("/", firstSlash + 1);
+  size_t firstSlash  = date.find ("/");
+  size_t secondSlash = date.find ("/", firstSlash + 1);
  if (firstSlash != std::string::npos &&
      secondSlash != std::string::npos)
  {
@@ -235,7 +237,7 @@ static bool validAttribute (std::string& name, std::string& value)
 ////////////////////////////////////////////////////////////////////////////////
 static bool validId (const std::string& input)
 {
-  for (unsigned int i = 0; i < input.length (); ++i)
+  for (size_t i = 0; i < input.length (); ++i)
    if (!::isdigit (input[i]))
      return false;

@@ -274,13 +276,13 @@ static bool validSubstitution (
  std::string& from,
  std::string& to)
 {
-  unsigned int first = input.find ('/');
+  size_t first = input.find ('/');
  if (first != std::string::npos)
  {
-    unsigned int second = input.find ('/', first + 1);
+    size_t second = input.find ('/', first + 1);
    if (second != std::string::npos)
    {
-      unsigned int third = input.find ('/', second + 1);
+      size_t third = input.find ('/', second + 1);
      if (third != std::string::npos)
      {
        if (first == 0 &&
@@ -317,10 +319,10 @@ void parse (
  command = "";

  std::string descCandidate = "";
-  for (unsigned int i = 0; i < args.size (); ++i)
+  for (size_t i = 0; i < args.size (); ++i)
  {
    std::string arg (args[i]);
-    unsigned int colon;               // Pointer to colon in argument.
+    size_t colon;               // Pointer to colon in argument.
    std::string from;
    std::string to;

--- a/src/rules.cpp
+++ b/src/rules.cpp
@@ -4,6 +4,7 @@
 //
 ////////////////////////////////////////////////////////////////////////////////
 #include <iostream>
+#include <stdlib.h>
 #include "Config.h"
 #include "Table.h"
 #include "Date.h"
@@ -60,8 +61,7 @@ void initializeColorRules (Config& conf)
 ////////////////////////////////////////////////////////////////////////////////
 void autoColorize (T& task, Text::color& fg, Text::color& bg)
 {
-  fg = Text::nocolor;
-  bg = Text::nocolor;
+  // Note: fg, bg already contain colors specifically assigned via command.

  // Colorization of the tagged.
  if (gsFg["color.tagged"] != Text::nocolor ||
--- a/src/task.cpp
+++ b/src/task.cpp
@@ -9,6 +9,7 @@
 #include <fstream>
 #include <sys/types.h>
 #include <unistd.h>
+#include <stdlib.h>
 #include <pwd.h>
 #include <time.h>

@@ -56,32 +57,32 @@ void usage (Config& conf)
  table.addCell (row, 1, "task");

  row = table.addRow ();
-  table.addCell (row, 1, "task add [tags] [attributes] description...");
+  table.addCell (row, 1, "task add [tags] [attrs] desc...");
  table.addCell (row, 2, "Adds a new task");

  row = table.addRow ();
-  table.addCell (row, 1, "task list [tags] [attributes] description...");
+  table.addCell (row, 1, "task list [tags] [attrs] desc...");
  table.addCell (row, 2, "Lists all tasks matching the specified criteria");

  row = table.addRow ();
-  table.addCell (row, 1, "task long [tags] [attributes] description...");
+  table.addCell (row, 1, "task long [tags] [attrs] desc...");
  table.addCell (row, 2, "Lists all task, all data, matching the specified criteria");

  row = table.addRow ();
-  table.addCell (row, 1, "task ls [tags] [attributes] description...");
+  table.addCell (row, 1, "task ls [tags] [attrs] desc...");
  table.addCell (row, 2, "Minimal listing of all tasks matching the specified criteria");

  row = table.addRow ();
-  table.addCell (row, 1, "task completed [tags] [attributes] description...");
+  table.addCell (row, 1, "task completed [tags] [attrs] desc...");
  table.addCell (row, 2, "Chronological listing of all completed tasks matching the specified criteria");

  row = table.addRow ();
-  table.addCell (row, 1, "task ID [tags] [attributes] [description...]");
+  table.addCell (row, 1, "task ID [tags] [attrs] [desc...]");
  table.addCell (row, 2, "Modifies the existing task with provided arguments");

  row = table.addRow ();
  table.addCell (row, 1, "task ID /from/to/");
-  table.addCell (row, 2, "Perform the substitution on the description, for fixing mistakes");
+  table.addCell (row, 2, "Perform the substitution on the desc, for fixing mistakes");

  row = table.addRow ();
  table.addCell (row, 1, "task delete ID");
@@ -143,6 +144,10 @@ void usage (Config& conf)
  table.addCell (row, 1, "task export");
  table.addCell (row, 2, "Exports all tasks as a CSV file");

+  row = table.addRow ();
+  table.addCell (row, 1, "task color");
+  table.addCell (row, 2, "Displays all possible colors");
+
  row = table.addRow ();
  table.addCell (row, 1, "task version");
  table.addCell (row, 2, "Shows the task version number");
@@ -220,6 +225,7 @@ int main (int argc, char** argv)
    else if (command == "info")               handleInfo           (tdb, task, conf);
    else if (command == "long")               handleLongList       (tdb, task, conf);
    else if (command == "ls")                 handleSmallList      (tdb, task, conf);
+    else if (command == "colors")             handleColor          (           conf);
    else if (command == "completed")          handleCompleted      (tdb, task, conf);
    else if (command == "delete")             handleDelete         (tdb, task, conf);
    else if (command == "start")              handleStart          (tdb, task, conf);
@@ -1689,7 +1695,7 @@ void handleReportHistory (const TDB& tdb, T& task, Config& conf)
  table.setColumnJustification (4, Table::right);
  table.setColumnJustification (5, Table::right);

-  char *months[] =
+  const char *months[] =
  {
    "January", "February", "March", "April", "May", "June",
    "July", "August", "September", "October", "November", "December",
@@ -2138,17 +2144,6 @@ void handleReportOverdue (const TDB& tdb, T& task, Config& conf)
 ////////////////////////////////////////////////////////////////////////////////
 void handleReportStats (const TDB& tdb, T& task, Config& conf)
 {
-  // Determine window size, and set table accordingly.
-  int width = 80;
-#ifdef HAVE_LIBNCURSES
-  if (conf.get ("curses", true))
-  {
-    WINDOW* w = initscr ();
-    width = w->_maxx + 1;
-    endwin ();
-  }
-#endif
-
  // Get all the tasks.
  std::vector <T> tasks;
  tdb.allT (tasks);
@@ -2353,34 +2348,38 @@ void handleDone (const TDB& tdb, T& task, Config& conf)
 void handleExport (const TDB& tdb, T& task, Config& conf)
 {
  std::string file = trim (task.getDescription ());
-
-  std::ofstream out (file.c_str ());
-  if (out.good ())
+  if (file.length () > 0)
  {
-    out << "'id',"
-        << "'status',"
-        << "'tags',"
-        << "'entry',"
-        << "'start',"
-        << "'due',"
-        << "'end',"
-        << "'project',"
-        << "'priority',"
-        << "'fg',"
-        << "'bg',"
-        << "'description'"
-        << "\n";
-
-    std::vector <T> all;
-    tdb.allT (all);
-    foreach (t, all)
+    std::ofstream out (file.c_str ());
+    if (out.good ())
    {
-      out << t->composeCSV ().c_str ();
+      out << "'id',"
+          << "'status',"
+          << "'tags',"
+          << "'entry',"
+          << "'start',"
+          << "'due',"
+          << "'end',"
+          << "'project',"
+          << "'priority',"
+          << "'fg',"
+          << "'bg',"
+          << "'description'"
+          << "\n";
+
+      std::vector <T> all;
+      tdb.allT (all);
+      foreach (t, all)
+      {
+        out << t->composeCSV ().c_str ();
+      }
+      out.close ();
    }
-    out.close ();
+    else
+      throw std::string ("Could not write to export file.");
  }
  else
-    throw std::string ("Could not write to export file.");
+    throw std::string ("You must specify a file to write to.");
 }

 ////////////////////////////////////////////////////////////////////////////////
@@ -2449,7 +2448,7 @@ void handleModify (const TDB& tdb, T& task, Config& conf)
      if (from != "")
      {
        std::string description = original.getDescription ();
-        unsigned int pattern = description.find (from);
+        size_t pattern = description.find (from);
        if (pattern != std::string::npos)
        {
          description = description.substr (0, pattern) +
@@ -2473,6 +2472,83 @@ void handleModify (const TDB& tdb, T& task, Config& conf)
  throw std::string ("Task not found.");
 }

+////////////////////////////////////////////////////////////////////////////////
+void handleColor (Config& conf)
+{
+  std::cout << std::endl << "Foreground" << std::endl
+            << "           "
+                    << Text::colorize (Text::bold,                   Text::nocolor, "bold")                   << "          "
+                    << Text::colorize (Text::underline,              Text::nocolor, "underline")              << "          "
+                    << Text::colorize (Text::bold_underline,         Text::nocolor, "bold_underline")         << std::endl
+
+            << "  " << Text::colorize (Text::black,                  Text::nocolor, "black")                  << "    "
+                    << Text::colorize (Text::bold_black,             Text::nocolor, "bold_black")             << "    "
+                    << Text::colorize (Text::underline_black,        Text::nocolor, "underline_black")        << "    "
+                    << Text::colorize (Text::bold_underline_black,   Text::nocolor, "bold_underline_black")   << std::endl
+
+            << "  " << Text::colorize (Text::red,                    Text::nocolor, "red")                    << "      "
+                    << Text::colorize (Text::bold_red,               Text::nocolor, "bold_red")               << "      "
+                    << Text::colorize (Text::underline_red,          Text::nocolor, "underline_red")          << "      "
+                    << Text::colorize (Text::bold_underline_red,     Text::nocolor, "bold_underline_red")     << std::endl
+
+            << "  " << Text::colorize (Text::green,                  Text::nocolor, "green")                  << "    "
+                    << Text::colorize (Text::bold_green,             Text::nocolor, "bold_green")             << "    "
+                    << Text::colorize (Text::underline_green,        Text::nocolor, "underline_green")        << "    "
+                    << Text::colorize (Text::bold_underline_green,   Text::nocolor, "bold_underline_green")   << std::endl
+
+            << "  " << Text::colorize (Text::yellow,                 Text::nocolor, "yellow")                 << "   "
+                    << Text::colorize (Text::bold_yellow,            Text::nocolor, "bold_yellow")            << "   "
+                    << Text::colorize (Text::underline_yellow,       Text::nocolor, "underline_yellow")       << "   "
+                    << Text::colorize (Text::bold_underline_yellow,  Text::nocolor, "bold_underline_yellow")  << std::endl
+
+            << "  " << Text::colorize (Text::blue,                   Text::nocolor, "blue")                   << "     "
+                    << Text::colorize (Text::bold_blue,              Text::nocolor, "bold_blue")              << "     "
+                    << Text::colorize (Text::underline_blue,         Text::nocolor, "underline_blue")         << "     "
+                    << Text::colorize (Text::bold_underline_blue,    Text::nocolor, "bold_underline_blue")    << std::endl
+
+            << "  " << Text::colorize (Text::magenta,                Text::nocolor, "magenta")                << "  "
+                    << Text::colorize (Text::bold_magenta,           Text::nocolor, "bold_magenta")           << "  "
+                    << Text::colorize (Text::underline_magenta,      Text::nocolor, "underline_magenta")      << "  "
+                    << Text::colorize (Text::bold_underline_magenta, Text::nocolor, "bold_underline_magenta") << std::endl
+
+            << "  " << Text::colorize (Text::cyan,                   Text::nocolor, "cyan")                   << "     "
+                    << Text::colorize (Text::bold_cyan,              Text::nocolor, "bold_cyan")              << "     "
+                    << Text::colorize (Text::underline_cyan,         Text::nocolor, "underline_cyan")         << "     "
+                    << Text::colorize (Text::bold_underline_cyan,    Text::nocolor, "bold_underline_cyan")    << std::endl
+
+            << "  " << Text::colorize (Text::white,                  Text::nocolor, "white")                  << "    "
+                    << Text::colorize (Text::bold_white,             Text::nocolor, "bold_white")             << "    "
+                    << Text::colorize (Text::underline_white,        Text::nocolor, "underline_white")        << "    "
+                    << Text::colorize (Text::bold_underline_white,   Text::nocolor, "bold_underline_white")   << std::endl
+
+            << std::endl << "Background" << std::endl
+            << "  " << Text::colorize (Text::nocolor, Text::on_black,          "on_black")               << "    "
+                    << Text::colorize (Text::nocolor, Text::on_bright_black,   "on_bright_black")        << std::endl
+
+            << "  " << Text::colorize (Text::nocolor, Text::on_red,            "on_red")                 << "      "
+                    << Text::colorize (Text::nocolor, Text::on_bright_red,     "on_bright_red")          << std::endl
+
+            << "  " << Text::colorize (Text::nocolor, Text::on_green,          "on_green")               << "    "
+                    << Text::colorize (Text::nocolor, Text::on_bright_green,   "on_bright_green")        << std::endl
+
+            << "  " << Text::colorize (Text::nocolor, Text::on_yellow,         "on_yellow")              << "   "
+                    << Text::colorize (Text::nocolor, Text::on_bright_yellow,  "on_bright_yellow")       << std::endl
+
+            << "  " << Text::colorize (Text::nocolor, Text::on_blue,           "on_blue")                << "     "
+                    << Text::colorize (Text::nocolor, Text::on_bright_blue,    "on_bright_blue")         << std::endl
+
+            << "  " << Text::colorize (Text::nocolor, Text::on_magenta,        "on_magenta")             << "  "
+                    << Text::colorize (Text::nocolor, Text::on_bright_magenta, "on_bright_magenta")      << std::endl
+
+            << "  " << Text::colorize (Text::nocolor, Text::on_cyan,           "on_cyan")                << "     "
+                    << Text::colorize (Text::nocolor, Text::on_bright_cyan,    "on_bright_cyan")         << std::endl
+
+            << "  " << Text::colorize (Text::nocolor, Text::on_white,          "on_white")               << "    "
+                    << Text::colorize (Text::nocolor, Text::on_bright_white,   "on_bright_white")        << std::endl
+
+            <<                 std::endl;
+}
+
 ////////////////////////////////////////////////////////////////////////////////
 void gatherNextTasks (
  const TDB& tdb,
--- a/src/task.h
+++ b/src/task.h
@@ -47,6 +47,7 @@ void handleDelete (const TDB&, T&, Config&);
 void handleStart (const TDB&, T&, Config&);
 void handleDone (const TDB&, T&, Config&);
 void handleModify (const TDB&, T&, Config&);
+void handleColor (Config&);
 void gatherNextTasks (const TDB&, T&, Config&, std::vector <T>&, std::vector <int>&);
 void nag (const TDB&, T&, Config&);

@@ -56,9 +57,6 @@ void wrapText (std::vector <std::string>&, const std::string&, const int);
 std::string trimLeft (const std::string& in, const std::string& t = " ");
 std::string trimRight (const std::string& in, const std::string& t = " ");
 std::string trim (const std::string& in, const std::string& t = " ");
-std::wstring trimLeft (const std::wstring& in, const std::wstring& t = L" ");  // UNICODE safe
-std::wstring trimRight (const std::wstring& in, const std::wstring& t = L" "); // UNICODE safe
-std::wstring trim (const std::wstring& in, const std::wstring& t = L" ");      // UNICODE safe
 void extractParagraphs (const std::string&, std::vector<std::string>&);
 void extractLine (std::string&, std::string&, int);
 void split (std::vector<std::string>&, const std::string&, const char);
--- a/src/text.cpp
+++ b/src/text.cpp
@@ -76,8 +76,8 @@ void extractParagraphs (const std::string& input, std::vector<std::string>& outp
  std::string copy = input;
  while (1)
  {
-    unsigned int so = copy.find ("<p>");
-    unsigned int eo = copy.find ("</p>");
+    size_t so = copy.find ("<p>");
+    size_t eo = copy.find ("</p>");

    if (so == std::string::npos && eo == std::string::npos)
      break;
@@ -99,13 +99,6 @@ std::string trimLeft (const std::string& in, const std::string& t /*= " "*/)
  return out.erase (0, in.find_first_not_of (t));
 }

-// UNICODE safe
-std::wstring trimLeft (const std::wstring& in, const std::wstring& t /*= L" "*/)
-{
-  std::wstring out = in;
-  return out.erase (0, in.find_first_not_of (t));
-}
-
 ////////////////////////////////////////////////////////////////////////////////
 std::string trimRight (const std::string& in, const std::string& t /*= " "*/)
 {
@@ -113,13 +106,6 @@ std::string trimRight (const std::string& in, const std::string& t /*= " "*/)
  return out.erase (out.find_last_not_of (t) + 1);
 }

-// UNICODE safe
-std::wstring trimRight (const std::wstring& in, const std::wstring& t /*= L" "*/)
-{
-  std::wstring out = in;
-  return out.erase (out.find_last_not_of (t) + 1);
-}
-
 ////////////////////////////////////////////////////////////////////////////////
 std::string trim (const std::string& in, const std::string& t /*= " "*/)
 {
@@ -127,13 +113,6 @@ std::string trim (const std::string& in, const std::string& t /*= " "*/)
  return trimLeft (trimRight (out, t), t);
 }

-// UNICODE safe
-std::wstring trim (const std::wstring& in, const std::wstring& t /*= L" "*/)
-{
-  std::wstring out = in;
-  return trimLeft (trimRight (out, t), t);
-}
-
 ////////////////////////////////////////////////////////////////////////////////
 // Remove enclosing balanced quotes.  Assumes trimmed text.
 void unquoteText (std::string& text)
@@ -147,7 +126,7 @@ void unquoteText (std::string& text)
 ////////////////////////////////////////////////////////////////////////////////
 void extractLine (std::string& text, std::string& line, int length)
 {
-  unsigned int eol = text.find ("\n");
+  size_t eol = text.find ("\n");

  // Special case: found \n in first length characters.
  if (eol != std::string::npos && eol < (unsigned) length)
@@ -183,8 +162,16 @@ void extractLine (std::string& text, std::string& line, int length)
  // If no space was found, hyphenate.
  else
  {
-    line = text.substr (0, length - 1) + "-";
-    text = text.substr (length - 1, std::string::npos);
+    if (length > 1)
+    {
+      line = text.substr (0, length - 1) + "-";
+      text = text.substr (length - 1, std::string::npos);
+    }
+    else
+    {
+      line = text.substr (0, 1);
+      text = text.substr (length, std::string::npos);
+    }
  }
 }

--- a/src/util.cpp
+++ b/src/util.cpp
@@ -10,6 +10,7 @@
 #include <sys/time.h>
 #include <unistd.h>
 #include <stdio.h>
+#include <string.h>
 #include "Table.h"
 #include "task.h"
 #include "../auto.h"
Author	SHA1	Message	Date
Paul Beckingham	a42b8a89c3	- Completed 0.9.9	2008-05-27 20:47:56 -04:00
Paul Beckingham	011ad8fafd	- Documentation snapshot, version bump.	2008-05-27 16:05:54 -04:00
Paul Beckingham	586883a98d	- Updated status in ChangeLog.	2008-05-26 21:40:56 -04:00
Paul Beckingham	40dc0490e1	- Removed unused variable only detectable on Ubuntu 8. - Removed misplaced files.	2008-05-26 21:39:10 -04:00
Paul Beckingham	abef040ebc	Merge branch 'fedora9' Conflicts: src/Date.cpp src/Table.cpp	2008-05-26 21:14:34 -04:00
Paul Beckingham	cb4f86e9f1	- Changes necessary for a clean build on Fedora9.	2008-05-26 20:58:41 -04:00
Paul Beckingham	b8fc8a0172	- Changes to enable a clean build on Ubuntu 8.	2008-05-26 14:58:45 -04:00
Paul Beckingham	35dd5df583	Merge branch 'fedora8'	2008-05-26 14:45:59 -04:00
Paul Beckingham	e666772477	- Added bugs to ChangeLog	2008-05-26 14:17:59 -04:00
Paul Beckingham	6b07f04338	Merge branch 'master' into fedora8	2008-05-26 14:17:13 -04:00
Paul Beckingham	334eb45534	- Corrected improperly specified color in sample .taskrc	2008-05-26 14:04:15 -04:00
Paul Beckingham	5e6b256df5	- Changes to enable a clean build under Fedora 8.	2008-05-26 13:34:33 -04:00
Paul Beckingham	e392b8a95e	- Added portability documentation.	2008-05-26 13:31:19 -04:00
Paul Beckingham	18fd59a1ed	- Bumped to 0.9.8	2008-05-25 20:36:13 -04:00
Paul Beckingham	4549af6b84	- Added DEVELOPERS file describing high-level code layout. - Removed unused library.h file. - Removed unused std::wstring Unicode variants.	2008-05-25 20:33:27 -04:00
Paul Beckingham	4825b37df5	- Added color command.	2008-05-25 01:01:24 -04:00
Paul Beckingham	148088c775	- Removed overwriting of colors in autoColorize.	2008-05-24 23:32:29 -04:00
Paul Beckingham	45a25ca47b	- Fixed Table::calculateColumnWidths bug.	2008-05-24 23:08:36 -04:00
Paul Beckingham	ab0a57ec89	- Documentation cleanup	2008-05-20 00:05:18 -04:00
Paul Beckingham	65c2fe438f	- Migrated old compiler flags for better warnings, etc	2008-05-19 23:28:48 -04:00
Paul Beckingham	37bdfe06da	- Added endwin check to configure.ac	2008-05-19 10:48:01 -04:00
Paul Beckingham	b54b07ef77	Merge branch 'master' of git@github.com:pbeckingham/task Conflicts: ChangeLog	2008-05-19 00:25:27 -04:00
Paul Beckingham	e3eb87aa74	- Snapshot	2008-05-18 00:32:27 -04:00
Paul Beckingham	b34cb90709	- Set up structure for AUTHORS file. - Set up NEWS file, with pleas for feedback. - Added welcome message to README. - Completed a chunk of the TUTORIAL. - Added error handling for "task export" when a file name is not specified.	2008-05-18 00:30:12 -04:00
Paul Beckingham	04da56193e	- Removed unnecessary SAMPLE_taskrc, and assorted references. - Cleaned up ChangeLog. - Minor mods to standard docs.	2008-05-17 23:16:08 -04:00
Paul Beckingham	3e1afc5777	- ChangeLog snapshot	2008-05-16 16:55:09 -04:00