From 18a8ea7b07c85f399801d9c52835c58e133ed0eb Mon Sep 17 00:00:00 2001
From: Paul Beckingham <paul@beckingham.net>
Date: Sun, 12 Jul 2015 22:27:20 -0400
Subject: [PATCH] Documentation: Updated docs to include the new '_unique'
 command

---
 ChangeLog         |  3 +++
 NEWS              |  6 ++++++
 doc/man/task.1.in | 11 +++++++++++
 3 files changed, 20 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index aa5402d4d..13b383f7f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -27,6 +27,9 @@
 - An attempt to add or remove a virtual tag is now an error (thanks to Scott M).
 - json.array now defaults to "on", making "export" output a JSON array that
   can be parsed by most JSON libraries without changes.
+- The '_ids', '_projects', '_tags', '_uuids' helper commands are deprecated,
+  and replaced by the new '_unique' helper command, which generates lists of
+  unique values for the specified attribute.
 
 ------ current release ---------------------------
 
diff --git a/NEWS b/NEWS
index b4ecd6851..9ff5d7ad6 100644
--- a/NEWS
+++ b/NEWS
@@ -6,10 +6,16 @@ New Features in Taskwarrior 2.4.5
 
 New commands in Taskwarrior 2.4.5
 
+  - The '_unique' command shows a set of unique values for the specified
+    attribute
+
 New configuration options in Taskwarrior 2.4.5
 
 Newly deprecated features in Taskwarrior 2.4.5
 
+  - The '_ids', '_projects', '_tags', '_uuids' helper commands are deprecated,
+    and replaced by the new '_unique' helper command.
+
 Removed features in 2.4.5
 
   - The script 'context' was removed, now that context is a core feature.
diff --git a/doc/man/task.1.in b/doc/man/task.1.in
index 325bc4d39..d351f861a 100644
--- a/doc/man/task.1.in
+++ b/doc/man/task.1.in
@@ -546,16 +546,25 @@ Lists all available context variables, for completion purposes.
 .TP
 .B task <filter> _ids
 Shows only the IDs of matching tasks, in the form of a list.
+Deprecated in favor of _unique.
 
 .TP
 .B task _show
 Shows the combined defaults and overrides of the configuration settings, for use
 by third-party applications.
 
+.TP
+.B task <filter> _unique <attribute>
+Reports a unique set of attribute values. For example, to see all the active
+projects:
+
+  task +PENDING _unique projects
+
 .TP
 .B task <filter> _uuids
 Shows only the UUIDs of matching tasks among all tasks (even deleted and
 completed tasks), in the form of a list.
+Deprecated in favor of _unique.
 
 .TP
 .B task _udas
@@ -564,10 +573,12 @@ Shows only defined UDA names, in the form of a list.
 .TP
 .B task <filter> _projects
 Shows only a list of all project names used.
+Deprecated in favor of _unique.
 
 .TP
 .B task <filter> _tags
 Shows only a list of all tags used, for autocompletion purposes.
+Deprecated in favor of _unique.
 
 .TP
 .B task <filter> _urgency