GothenburgBitFactory/taskwarrior
1
0
Fork 0
mirror of https://github.com/GothenburgBitFactory/taskwarrior.git synced 2025-06-26 10:54:26 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

Documentation

Browse source 
- Added sections on the task shell and advanced filters.
This commit is contained in:
Paul Beckingham 2010-08-03 13:39:57 -04:00
parent d85579d69f
commit e26f29537a
2 changed files with 51 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

16
doc/misc/run.193
View file

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

39
doc/misc/script-193.txt
View file

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