diff --git a/doc/misc/run.193 b/doc/misc/run.193 index 10a550a09..9b4fd8b78 100755 --- a/doc/misc/run.193 +++ b/doc/misc/run.193 @@ -168,6 +168,11 @@ task rc:x list # Shell echo Shell +#task rc:x shell +#> projects +#> tags +#> list +#> quit # Special tags echo Special tags @@ -226,6 +231,17 @@ task rc:x rc.color.summary.background:"on gray3" summary # Advanced filters echo Advanced filters +task rc:x list +task rc:x list invit +task rc:x list description.contains:invit +task rc:x list pro:party +task rc:x list pro.is:party +task rc:x list pro.not:party +task rc:x list pro:party priority.over:L +task rc:x list pro:party limit:2 +task rc:x list limit:page +task rc:x all status:pending +task rc:x all status:waiting # Import/export echo Import/export diff --git a/doc/misc/script-193.txt b/doc/misc/script-193.txt index 301fa8496..56459d039 100644 --- a/doc/misc/script-193.txt +++ b/doc/misc/script-193.txt @@ -307,7 +307,11 @@ task list the recurrences of a task. ---------------------------------------- Shell ----------------------------------------------------- - shell +task rc:x shell You can use the shell command to create a more immersive +task> projects environment. Any task command you run outside the shell +task> tags can also be run inside the shell, without the need to prefix +task> list every command with "task". +task> quit ---------------------------------------- Special Tags ---------------------------------------------- @@ -389,9 +393,36 @@ task summary There is a project summary report that ---------------------------------------- Advanced Filters ------------------------------------------ - filters - limit:3 - attribute modifiers +task list Filters are a very powerful tool. First here is an +task list invit unfiltered list, which shows all tasks. Now again, but with + the text 'invit', which acts as a filter on the description + field. + +task list description.contains:invit This is the equivalent form using attribute modifiers. In + this example we are filtering on descriptions that contain + the work fragment. Here we are using the 'contains' + modifier, but there are many others. + +task list pro:party Here list all tasks in the 'party' project. +task list pro.is:party And the full equivalent. +task list pro.not:party Here list tasks that are not in the 'party' project. I + could have also used 'isnt' here - there are several + synonyms for modifiers, so that the filter can be written + so that it reads naturally. + +task list pro:party pri.over:L Here the 'over' modifier is filtering on priorities that + sort higher than 'Low', and also filtering on the 'party' + project. There are two terms in this filter. + +task list pro:party limit:2 Same again, but only show me the first two tasks. +task list limit:page Now all tasks, but just show the first page of tasks. I + don't have a page full of tasks here, but you get the idea. + +task all status:pending Now you can see how some of the built-in reports work. The + 'list' report is just all tasks, filtered so that only the + pending tasks are shown. + +task all status:waiting The 'waiting' report is similarly defined. ---------------------------------------- Import/Export ---------------------------------------------