gergely/taskwarrior-2.x
1
0
Fork 0
Code Issues Actions Packages Projects Releases 1 Wiki Activity

Merge branch '1.9.3' of tasktools.org:task into 1.9.3

Browse Source
This commit is contained in:
Paul Beckingham
2010-10-13 21:06:06 -04:00
parent 2708b37ce5 98861d87d6
commit 0159cfde2f
1 changed files with 110 additions and 71 deletions
Download Patch File Download Diff File Expand all files Collapse all files

175
doc/man/task-tutorial.5
View File

@@ -347,102 +347,141 @@ active task as inactive, by stopping it.
$ task active $ task active
$ task 2 stop $ task 2 stop
---------------------------------------- Due dates ------------------------------------------------- .SH DUE DATES
Due dates can be specified as dates, durations into the future or past, by
mnemonic, ordinal of day of week.
task 1 due:7/31/2010 Due dates can be specified as dates...
task 1 due:2wks as some distance into the future...
task 1 due:-2wks or past...
task 1 due:eom or by mnemonic (end of month)...
task 2 due:8th or by ordinal...
task 2 due:sunday or by day...
task 5 due:eow
task list Some of these dates are in the past, so now you see there
task overdue are overdue tasks. Due dates have different colors for
due, imminent, today and overdue values.
task rc.dateformat.report:Y-M-DTH:N:SZ list Some of these dates are in the past, so now you see there are overdue tasks.
Due dates have different colors for due, imminent, today and overdue values.
$ task 1 due:7/31/2010
$ task 1 due:2wks
$ task 1 due:-2wks
$ task 1 due:eom
$ task 2 due:8th
$ task 2 due:sunday
$ task 5 due:eow
You can also choose the format - for input and output. You can also choose the format - for input and output.
---------------------------------------- Calendar -------------------------------------------------- $ task rc.dateformat.report:Y-M-DTH:N:SZ list
task calendar When tasks have due dates, you can see them on the calendar. .SH CALENDAR
When tasks have due dates, you can see them on the calendar.
vi ~/.taskrc $ task calendar
# include /usr/local/share/doc/task/rc/holidays-US.rc
task calendar
Taskwarrior provides sample holiday files. You can create
your own, or use one of the samples to show holidays on the
calendar.
task cal 2010 You can see the whole year. Taskwarrior provides sample holiday files. You can create your own, or use one
task rc.calendar.details:full cal You can see the tasks with due dates also. of the samples to show holidays on the calendar.
task rc.calendar.holidays:full cal And you can see the holidays.
---------------------------------------- Recurrence ------------------------------------------------ Try adding this line to your ~/.taskrc file:
task 7 info Remember the task we added to pay the rent? We're going to include /usr/local/share/doc/task/rc/holidays-US.rc
task 7 due:eom recur:monthly need to do that every month. Recurring tasks allow us to
task 7 set up a single task that keeps coming back, just as you'd
expect.
task 7 until:eoy You can also limit the extent of the recurrence. Let's make Then:
sure the task doesn't recur after the lease ends.
task recurring And there is a recurring report that shows you only the $ task calendar
recurring tasks.
To illustrate a point, let's set up a recurring annual task You can see the whole year, see due tasks as well, and see the holidays:
as a reminder to pay taxes, and put the due date in the past.
This will cause task to fill in the gaps, and create a series
of severely overdue tasks.
task add Pay taxes due:4/15/2007 recur:yearly $ task cal 2010
task long $ task rc.calendar.details:full cal
$ task rc.calendar.holidays:full cal
task 11 delete # y y Deletions to recurring tasks can be escalated to include all .SH RECURRENCE
task list the recurrences of a task. Remember the task we added to pay the rent? We're going to need to do that
every month. Recurring tasks allow us to set up a single task that keeps coming
back, just as you'd expect.
---------------------------------------- Shell ----------------------------------------------------- $ task 7 info
$ task 7 due:eom recur:monthly
$ task 7
task shell You can use the shell command to create a more immersive
task> projects environment. Any task command you run outside the shell You can also limit the extent of the recurrence. Let's make sure the task
task> tags can also be run inside the shell, without the need to prefix doesn't recur after the lease ends.
task> list every command with "task".
$ task 7 until:eoy
And there is a recurring report that shows you only the recurring tasks.
$ task recurring
To illustrate a point, let's set up a recurring annual task as a reminder to pay
taxes, and put the due date in the past. This will cause task to fill in the
gaps, and create a series of severely overdue tasks.
$ task add Pay taxes due:4/15/2007 recur:yearly
$ task long
Deletions to recurring tasks can be escalated to include all the recurrences of
a task.
$ task 11 delete # y y
$ task list
.SH SHELL
You can use the shell command to create a more immersive environment. Any task
command you run outside the shell can also be run inside the shell, without the
need to prefix every command with "task".
$ task shell
task> projects
task> tags
task> list
task> quit task> quit
---------------------------------------- Special Tags ---------------------------------------------- .SH SPECIAL TAGS
You've seen tags, but there are also 'special tags' that have effects on
individual tasks. The 'nocolor' special tag causes the color rules to be
bypassed.
task 6 +nocolor You've seen tags, but there are also 'special tags' that $ task 6 +nocolor
task list have effects on individual tasks. The 'nocolor' special $ task list
tag causes the color rules to be bypassed.
task tags Special tags are highlighted by the 'tags' command. Special tags are highlighted by the 'tags' command.
task 6 -nocolor There are others - the 'nonag' special tag prevents the $ task tags
generation of nag messages when you work on low priority
tasks when there are more important ones.
The 'nocal' special tag will prevent a task from appearing There are others - the 'nonag' special tag prevents the generation of nag
on the calendar. messages when you work on low priority tasks when there are more important ones.
---------------------------------------- Waiting --------------------------------------------------- $ task 6 -nocolor
task add Look for new apartment due:eoy When you have a task with a due date that is far out into The 'nocal' special tag will prevent a task from appearing on the calendar.
task list the future, you may want to hide that task for a while.
task 10 wait:12/1/2010 You can provide a wait date for a task, and it will remain .SH WAITING
task list hidden until that date. It will no longer be cluttering When you have a task with a due date that is far out into
task waiting your task list, but it is still there, and visible using the future, you may want to hide that task for a while.
the 'waiting' report. When the wait date comes, the task
$ task add Look for new apartment due:eoy
$ task list
You can provide a wait date for a task, and it will remain hidden until that
date. It will no longer be cluttering your task list, but it is still there,
and visible using the 'waiting' report. When the wait date comes, the task
will just pop back into the list. will just pop back into the list.
task add Do something in a few seconds To illustrate this, let's set up a task with a very short $ task 10 wait:12/1/2010
task 11 wait:5s wait time of five seconds. $ task list
$ task waiting
task list It's gone. To illustrate this, let's set up a task with a very short wait time of five
(sleep 5) We wait for 5 seconds... seconds.
task list And it's back.
task 11 rc.confirmation:no delete And now it's deleted. $ task add Do something in a few seconds
$ task 11 wait:5s
$ task list
It's gone.
(wait 5 seconds)
$ task list
And it's back. Now we delete it.
$ task 11 rc.confirmation:no delete
---------------------------------------- Dependencies ---------------------------------------------- ---------------------------------------- Dependencies ----------------------------------------------