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).
- 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 ---------------------------

6
NEWS
View file

@ -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.

View file

@ -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