From 2897005e25db4d3ab7e03d5ca904399a20961216 Mon Sep 17 00:00:00 2001
From: Paul Beckingham <paul@beckingham.net>
Date: Sat, 17 May 2014 13:52:01 -0400
Subject: [PATCH] Documentation

- Updated developer docs.
---
 DEVELOPER           | 25 +++----------------------
 NEWS                |  1 +
 doc/man/taskrc.5.in |  2 ++
 3 files changed, 6 insertions(+), 22 deletions(-)

diff --git a/DEVELOPER b/DEVELOPER
index 4e4d253d1..8a0f8fff7 100644
--- a/DEVELOPER
+++ b/DEVELOPER
@@ -112,9 +112,6 @@ New Code Needs
     data file, as found by 'task diag'.  This should check to see if there is
     a suitable UUID generator installed.  This should also be careful to
     properly handle recurring tasks.
-  - Need an external implementation equivalent to, or better than the 'shadow
-    file' feature.  Simply because shadow file capability *can* be implemented
-    outside the core code, we want to make it be that way.
   - Take a look at:
 
       https://bug.tasktools.org/browse/EX
@@ -123,21 +120,6 @@ New Code Needs
     lie outside of the core product, and will be implemented as external scripts
     by anyone who wishes to participate.
 
-Documentation Needed
-  Documentation takes many forms, and we are trying to combine all documentation
-  into one repository, to facilitate sharing and centralize review.  This
-  includeѕ:
-
-  - Man pages
-  - Reference PDF
-  - Wiki replacement
-  - Tutorials
-  - Cookbook
-
-  This is all in the new https://git.tasktools.org/projects/ST/repos/tw.org
-  repository, where all the documents are sourced as markdown.  We welcome
-  everyone with writing skills to help us improve this critical resource.
-
 Unit Tests Needed
   There are always more unit tests needed.  More specifically, better unit tests
   are always needed.  The convention is that there are four types of unit test:
@@ -157,8 +139,9 @@ Unit Tests Needed
      these kind of tests be extensive and thorough, because the software depends
      on this code the most.
 
-  The tests are mainly written in Perl, and all use TAP.  Here is how to get the
-  code and run the test suite:
+  The tests are mainly written in Perl, and all use TAP.  We want them all to be
+  eventually replaced by Python. Here is how to get the code and run the test
+  suite:
      git clone https://git.tasktools.org/scm/tm/task.git
      cd task.git
      git checkout 2.4.0
@@ -190,8 +173,6 @@ Unit Tests Needed
     delete, done, and list commands.  We need unit tests that prove that basic
     functionality is working, and the file containing them should be called
     basic.t.
-  - None of the current unit tests remove the 'extensions' directory, and they
-    all should.
   - Test propagation of modifications to recurring tasks.
   - Test regex support.
   - Need unit tests for each bug in the issue list, if suitable.
diff --git a/NEWS b/NEWS
index a12beec6c..c444ad214 100644
--- a/NEWS
+++ b/NEWS
@@ -23,6 +23,7 @@ New configuration options in taskwarrior 2.4.0
 Newly deprecated features in taskwarrior 2.4.0
 
   - The alias '_query' is deprecated.
+  - The 'shadow file' feature is deprecated.
 
 Removed features in 2.4.0
 
diff --git a/doc/man/taskrc.5.in b/doc/man/taskrc.5.in
index 9edf008c9..9b74abfa7 100644
--- a/doc/man/taskrc.5.in
+++ b/doc/man/taskrc.5.in
@@ -1057,6 +1057,8 @@ preferences, but it is important that you carefully consider any modifications.
 
 .SS SHADOW FILE
 
+Note, this feature is deprecated in 2.4.0.
+
 .TP
 .B
 shadow.file=$HOME/.task/shadow.txt