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

src/command.cpp

@@ -845,6 +845,14 @@ std::string handleAppend (TDB& tdb, T& task, Config& conf)
       {
         original.setId (task.getId ());
         tdb.modifyT (original);
+
+        if (conf.get ("echo.command", true))
+          out << "Appended '"
+              << task.getDescription ()
+              << "' to task "
+              << task.getId ()
+              << std::endl;
+
       }
 
       return out.str ();
@@ -944,3 +952,34 @@ std::string handleColor (Config& conf)
 }
 
 ////////////////////////////////////////////////////////////////////////////////
+std::string handleAnnotate (TDB& tdb, T& task, Config& conf)
+{
+  std::stringstream out;
+  std::vector <T> all;
+  tdb.pendingT (all);
+
+  std::vector <T>::iterator it;
+  for (it = all.begin (); it != all.end (); ++it)
+  {
+    if (it->getId () == task.getId ())
+    {
+      it->addAnnotation (task.getDescription ());
+      tdb.modifyT (*it);
+
+      if (conf.get ("echo.command", true))
+        out << "Annotated "
+            << task.getId ()
+            << " with '"
+            << task.getDescription ()
+            << "'"
+            << std::endl;
+
+      return out.str ();
+    }
+  }
+
+  throw std::string ("Task not found.");
+  return out.str ();
+}
+
+////////////////////////////////////////////////////////////////////////////////