Enhancement - annotations

- Added support for "annotate" command to annotate existing tasks.
- Bumped file format to version 3, due to the annotations.
- Added unit tests to verify that annotations work.
- Changed 'description' column everywhere to include annotations.
- Added 'description_only' column to exclude the annotations.
- Fixed bug in Table.cpp that calculated the width of multi-line
  columns by using the cell length, instead of the length of the
  longest individual line.
- Updated documentation with new feature.
- Updated documentation with new column.
- Enhanced t.t unit tests to cover format 43

html/advanced.html

@@ -102,6 +102,25 @@ Car              2   2 wks      25% XXXXXXXXX</code></pre>
                   Appends the additional description to an existing task.
                 </p>
 
+                <strong>% task annotate &lt;id&gt; additional note...</strong>
+                <p>
+                  Allows an annotation to be attached to an existing task.  Each
+                  annotation has a time stamp, and when displayed, the annotations
+                  are shown under the task description.  For example:
+                </p>
+
+                <pre><code>% task add Go to the supermarket
+% task annotate 1 need milk
+% task ls
+
+ID Project Pri Due Active Age     Description
+ 1                                Go to the supermarket
+                                  3/23/2009 need milk</code></pre>
+                <p>
+                  The date of the annotation uses the "dateformat" configuration
+                  variable.
+                </p>
+
                 <strong>% task delete &lt;id&gt;</strong>
                 <p>
                   There are two ways of getting rid of tasks - mark them as done, or

html/custom.html

@@ -100,6 +100,7 @@ report.mine.sort=priority-,project+</pre></code>
                   <li>active
                   <li>tags
                   <li>recur
+                  <li>description_only
                   <li>description
                 </ul>
 

html/task.html

@@ -108,6 +108,10 @@
                   <li>Added support for the "echo.command" configuration variable that displays
                       the task affected by the start, stop, do, undo, delete and undelete
                       commands (thanks to Bruce Dillahunty).
+                  <li>Added support for task annotations, with each annotation comprising a
+                      timestamp and a description.
+                  <li>Added support for a 'description_only' column that can be used in custom
+                      reports which excludes annotations.
                 </ul>
 
                 <p>

html/usage.html

@@ -37,6 +37,7 @@
                 <pre><code>Usage: task
        task add [tags] [attrs] desc...
        task append [tags] [attrs] desc...
+       task annotate ID desc...
        task completed [tags] [attrs] desc...
        task ID [tags] [attrs] [desc...]
        task ID /from/to/