Documentation: Updated docs to include the new '_unique' command

This commit is contained in:
Paul Beckingham
2015-07-12 22:27:20 -04:00
parent 012affa46a
commit 18a8ea7b07
3 changed files with 20 additions and 0 deletions

View File

@@ -27,6 +27,9 @@
- An attempt to add or remove a virtual tag is now an error (thanks to Scott M). - 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 - json.array now defaults to "on", making "export" output a JSON array that
can be parsed by most JSON libraries without changes. 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 --------------------------- ------ current release ---------------------------

6
NEWS
View File

@@ -6,10 +6,16 @@ New Features in Taskwarrior 2.4.5
New commands 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 New configuration options in Taskwarrior 2.4.5
Newly deprecated features 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 Removed features in 2.4.5
- The script 'context' was removed, now that context is a core feature. - The script 'context' was removed, now that context is a core feature.

View File

@@ -546,16 +546,25 @@ Lists all available context variables, for completion purposes.
.TP .TP
.B task <filter> _ids .B task <filter> _ids
Shows only the IDs of matching tasks, in the form of a list. Shows only the IDs of matching tasks, in the form of a list.
Deprecated in favor of _unique.
.TP .TP
.B task _show .B task _show
Shows the combined defaults and overrides of the configuration settings, for use Shows the combined defaults and overrides of the configuration settings, for use
by third-party applications. 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 .TP
.B task <filter> _uuids .B task <filter> _uuids
Shows only the UUIDs of matching tasks among all tasks (even deleted and Shows only the UUIDs of matching tasks among all tasks (even deleted and
completed tasks), in the form of a list. completed tasks), in the form of a list.
Deprecated in favor of _unique.
.TP .TP
.B task _udas .B task _udas
@@ -564,10 +573,12 @@ Shows only defined UDA names, in the form of a list.
.TP .TP
.B task <filter> _projects .B task <filter> _projects
Shows only a list of all project names used. Shows only a list of all project names used.
Deprecated in favor of _unique.
.TP .TP
.B task <filter> _tags .B task <filter> _tags
Shows only a list of all tags used, for autocompletion purposes. Shows only a list of all tags used, for autocompletion purposes.
Deprecated in favor of _unique.
.TP .TP
.B task <filter> _urgency .B task <filter> _urgency