From a40f424dad2936db738bfb1a71b1f4301089877d Mon Sep 17 00:00:00 2001 From: Paul Beckingham Date: Sat, 9 Mar 2013 16:53:43 -0500 Subject: [PATCH] Documentation - Documented virtual tags. --- doc/man/task.1.in | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/doc/man/task.1.in b/doc/man/task.1.in index 215ead384..43df7444d 100644 --- a/doc/man/task.1.in +++ b/doc/man/task.1.in @@ -457,7 +457,9 @@ Shows a report of aggregated task status by project. .TP .B task tags -Show a list of all tags used. Any special tags used are highlighted. +Show a list of all tags used. Any special tags used are highlighted. Note that +virtual tags are not listed - they don't really exist, and are just a convenient +notation for other task metadata. .TP .B task timesheet [weeks] @@ -562,6 +564,21 @@ exempt from all color rules. The supported special tags are: +nocal This task will not appear on the calendar +next Elevates task so it appears on 'next' report +There are also virtual tags, which represent task metadata in tag form. These +tags do not exist, but can be used to filter tasks. The supported virtual tags +are: + + BLOCKED Matches if the task is blocked + UNBLOCKED Matches if the task is not blocked + BLOCKING Matches if the task is blocking + DUE Matches if the task is due + DUETODAY Matches if the task is due today + TODAY Matches if the task is due today + OVERDUE Matches if the task is overdue + +You can use +BLOCKED to filter blocked tasks, or -BLOCKED for unblocked tasks. +Similarly, -BLOCKED is equivalent to +UNBLOCKED. + .TP .B project: Specifies the project to which a task is related to.