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

Cleanup

Browse source 
- Removed obsolete grammar.bnf file.
- doc/misc scripts relocated to screencast.git.
This commit is contained in:
Paul Beckingham 2011-06-21 18:02:08 -04:00
parent 5808e2073f
commit 393ebae8aa
22 changed files with 0 additions and 2140 deletions
Download patch file Download diff file Expand all files Collapse all files

241
doc/misc/grammar.bnf
View file

@ -1,241 +0,0 @@
# This document defines the BNF grammar that will be supported in Taskwarrior
# 2.1.
# Commands (alphabetically)
command_add ::= "add" ws+ task-elements ;
command_annotate ::= "annotate" ws+ range ws+ words ;
command_append ::= "append" ws+ range ws+ words ;
command_burndown ::= "burndown.monthly" ws+ filter
| "burndown.weekly" ws+ filter
| "burndown.daily" ws+ filter
| "burndown.monthly"
| "burndown.weekly"
| "burndown.daily"
;
command_calendar ::= "calendar" ws+ "due" ws+ filter
| "calendar" ws+ "due"
| "calendar" ws+ "y" ws+ filter
| "calendar" ws+ "y"
| "calendar" ws+ year ws+ filter
| "calendar" ws+ year
| "calendar" ws+ year ws+ month ws+ filter
| "calendar" ws+ year ws+ month
| "calendar" ws+ month-name ws+ filter
| "calendar" ws+ month-name
| "calendar" ws+ filter
| "calendar"
;
command_colors ::= "colors" ws+ "legend"
| "colors" ws+ "sample"
| "colors"
;
command_config ::= "config" ws+ word ws+ words
| "config" ws+ word
;
command_count ::= "count" ws+ filter
| "count"
;
# TODO en-passant
command_delete ::= "delete" ws+ range ;
command_denotate ::= "denotate" ws+ range ws+ pattern ;
command_diagnostics ::= "diagnostics" ;
# TODO en-passant
command_done ::= "done" ws+ range ;
# TODO en-passant
command_duplicate ::= "duplicate" ws+ range ;
command_edit ::= "edit" ws+ range ;
command_ghistory ::= "ghistory.annual" ws+ filter
| "ghistory.monthly" ws+ filter
| "ghistory.weekly" ws+ filter
| "ghistory.daily" ws+ filter
| "ghistory.annual"
| "ghistory.monthly"
| "ghistory.weekly"
| "ghistory.daily"
;
command_help ::= "help" ;
command_history ::= "history.annual" ws+ filter
| "history.monthly" ws+ filter
| "history.weekly" ws+ filter
| "history.daily" ws+ filter
| "history.annual"
| "history.monthly"
| "history.weekly"
| "history.daily"
;
command_import ::= "import" ws+ file
| "import" ws+ "-"
;
command_info ::= "info" ws+ range
;
command_log ::= "log" ws+ task-elements ;
command_merge ::= "merge" ws+ url ;
command_prepend ::= "prepend" ws+ range ws+ words ;
command_projects ::= "projects" ws+ filter
| "projects"
;
command_pull ::= "pull" ws+ url ;
command_push ::= "push" ws+ url ;
command_shell ::= "shell" ;
command_show ::= "show" ws+ pattern
| "show"
;
command_start ::= "start" ws+ range
| "start"
;
command_stats ::= "statistics" ws+ filter
| "statistics"
;
command_stop ::= "stop" ws+ range
| "stop"
;
command_summary ::= "summary" ws+ filter
| "summary"
;
command_tags ::= "tags" ;
command_timesheet ::= "timesheet" ws+ digit
| "timesheet"
;
command_undo ::= "undo" ;
command_version ::= "version" ;
# command_report ::= report ws+ filter ;
# Helper Commands (alphabetically)
helper_query ::= "query" ws+ filter
| "query"
;
# Primitives
range ::= ;
id-equivalent ::= uuid | id ;
id ::= digit+ ;
uuid ::= ;
attribute ::= ;
modifier ::= ;
task-elements ::= task-element+ ;
task-element ::= attribute ws+
| tag ws+
| word ws+
;
filter ::= filter-elements+ ;
filter-elements ::= range
| pattern
| filter-attribute ;
filter-attribute ::= field modifier? ":" value? ;
modifier ::= ".above"
| ".after"
| ".any"
| ".before"
| ".below"
| ".contains"
| ".endswith"
| ".equals"
| ".has"
| ".hasnt"
| ".is"
| ".isnt"
| ".left"
| ".none"
| ".not"
| ".noword"
| ".over"
| ".right"
| ".startswith"
| ".under"
| ".word"
;
value ::= ;
year ::= digit digit digit digit ;
month ::= "1" | "2" | "3" | "4" | "5" | "6"
| "7" | "8" | "9" | "10" | "11" | "12"
;
# TODO Case-insensitive
month-name ::= "january"
| "february"
| "march"
| "april"
| "may"
| "june"
| "july"
| "august"
| "september"
| "october"
| "november"
| "december"
;
filter-attribute ::= field "." modifier ":" value
| field "." modifier ":"
| field ":" value
| field ":"
;
tag ::= "+" word
| "-" word ;
substitution ::= "/" pattern "/" words "/" "g"? ;
pattern ::= ;
url ::= ;
file ::= ;
words ::= ;
word ::= ;
# Fundamentals
digit ::= "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" ;
ws ::= " " | "\t" ;
# End

533
doc/misc/run.193
View file

@ -1,533 +0,0 @@
#! /bin/bash
rm -f /Users/paul/.task/pending.data /Users/paul/.task/completed.data /Users/paul/.task/undo.data
echo 'data.location=~/.task' > /Users/paul/.taskrc
echo 'color=off' >> /Users/paul/.taskrc
echo 'color.summary.background=on gray3' >> /Users/paul/.taskrc
echo '#include /usr/local/share/doc/task/rc/dark-blue-256.theme' >> /Users/paul/.taskrc
echo '#include /usr/local/share/doc/task/rc/dark-red-256.theme' >> /Users/paul/.taskrc
echo '#include /usr/local/share/doc/task/rc/dark-256.theme' >> /Users/paul/.taskrc
# 1 Intro
# 2 Basic usage
echo Basic usage --------------------------------------------------------------
echo $ task add Select a free weekend in November
task add Select a free weekend in November
echo $ task add Select and book a venue
task add Select and book a venue
echo $ task add Come up with a guest list
task add Come up with a guest list
echo $ task add Mail invitations
task add Mail invitations
echo $ task add Select a caterer
task add Select a caterer
echo $ task list
task list
echo $ task log Order a special cake
task log Order a special cake
echo $ task 4 duplicate /Mail/Design/
task 4 duplicate /Mail/Design/
echo $ task 4 duplicate /Mail/Print/
task 4 duplicate /Mail/Print/
echo $ task list
task list
echo $ task 3 done
task 3 done
echo $ task list
task list
# 3 Projects
echo Projects --------------------------------------------------------------
echo $ task add Pay teh rent on teh 31st
task add Pay teh rent on teh 31st
echo $ task 7 /teh/the/g
task 7 /teh/the/g
echo $ task list
task list
echo $ task 7 project:home
task 7 project:home
echo $ task 1-6 project:party
echo 'All' | task 1-6 project:party
echo $ task projects
task projects
echo $ task list project:home
task list project:home
echo $ task li pro:par
task li pro:par
# 4 Priorities
echo Priorities --------------------------------------------------------------
echo $ task 1-3,5 priority:H
echo 'All' | task 1-3,5 priority:H
echo $ task list
task list
echo $ task 3 pri:
task 3 pri:
# 5 Tags
echo Tags --------------------------------------------------------------
echo $ task list
task list
echo $ task 3,5,6 +mall
echo 'All' | task 3,5,6 +mall
echo $ task long
task long
echo $ task list +mall
task list +mall
echo $ task 3 -mall
task 3 -mall
# 6 Modifications
echo Modifications --------------------------------------------------------------
echo $ task 7 Pay rent at the end of the month
echo 'Yes' | task 7 Pay rent at the end of the month
echo $ task add music
task add music
echo $ task 8 prepend Select some
task 8 prepend Select some
echo $ task 8 append for after dinner
task 8 append for after dinner
echo $ task list
task list
echo $ task edit
#task edit
echo $ task add Hire a band?
#task add Hire a band?
echo $ task add Hire a band\?
#task add Hire a band\?
echo $ task add "Hire a band?"
#task add "Hire a band?"
echo $ task add -- Hire a band\? +dj
task add -- Hire a band\? +dj
echo $ task undo
echo 'y' | task undo
echo $ task 1 delete
echo 'y' | task 1 delete
echo $ task undo
echo 'y' | task undo
# 7 Info
echo Info --------------------------------------------------------------
echo $ task 1 info
task 1 info
echo $ task stats
task stats
# 8 Annotations
echo Annotations --------------------------------------------------------------
echo $ task 1 annotate the 13 looks good
task 1 annotate the 13 looks good
sleep 1
echo $ task 1 annotate or the 14th
task 1 annotate or the 14th
echo $ task list
task list
echo $ task list rc.annotations:full
task list rc.annotations:full
echo $ task list rc.annotations:sparse
task list rc.annotations:sparse
echo $ task list rc.annotations:none
task list rc.annotations:none
echo $ task 1 denotate 14th
task 1 denotate 14th
echo $ task list
task list
# 9 Configuration
echo Configuration --------------------------------------------------------------
echo $ task show
task show
echo $ task config answer forty-two
echo 'y' | task config answer forty-two
echo $ task show answer
task show answer
echo $ task config answer
echo 'y' | task config answer
echo $ task rc.report.list.sort=description+ list
task rc.report.list.sort=description+ list
# 10 Defaults
echo Defaults --------------------------------------------------------------
echo $ task config default.command list
echo 'y' | task config default.command list
echo $ task
task
echo $ task config default.priority H
echo 'y' | task config default.priority H
echo $ task config default.project Work
echo 'y' | task config default.project Work
echo $ task add New task
task add New task
echo $ task list
task list
echo $ task undo
echo 'y' | task undo
echo $ task config default.priority
echo 'y' | task config default.priority
echo $ task config default.project
echo 'y' | task config default.project
# 11 Aliases
echo Aliases --------------------------------------------------------------
echo $ task config alias.zzz list
echo 'y' | task config alias.zzz list
echo $ task zzz
task zzz
echo $ task z
task z
# 12 Color
echo Color --------------------------------------------------------------
echo $ task config color on
echo 'y' | task config color on
echo $ task list
task list
echo $ task 1 bg:on_red
task 1 bg:on_red
echo $ task list
task list
echo $ task 1 bg:
task 1 bg:
echo $ task color
task color
echo $ task color white on red
task color white on red
echo $ task color legend
task color legend
echo vi ~/.taskrc # include /usr/local/share/doc/task/rc/dark-blue-256.theme
#vi ~/.taskrc # include /usr/local/share/doc/task/rc/dark-blue-256.theme
echo 'include /usr/local/share/doc/task/rc/dark-blue-256.theme' >> x
echo $ task color legend
task color legend
echo $ task list
task list
echo vi ~/.taskrc # include /usr/local/share/doc/task/rc/dark-red-256.theme
#vi ~/.taskrc # include /usr/local/share/doc/task/rc/dark-red-256.theme
sed 's/blue/red/' x >x2 && mv x2 x
echo $ task color legend
task color legend
echo $ task list
task list
echo vi ~/.taskrc # include /usr/local/share/doc/task/rc/dark-256.theme
#vi ~/.taskrc # include /usr/local/share/doc/task/rc/dark-256.theme
sed 's/red-//' x >x2 && mv x2 x
echo $ task list
task list
echo $ task "rc.color.project.party=on rgb001" rc.color.keyword.invit=bold list
task "rc.color.project.party=on rgb001" rc.color.keyword.invit=bold list
echo $ man task-color
#man task-color
# 13 Active tasks
echo Active tasks --------------------------------------------------------------
echo $ task 2 start
task 2 start
echo $ task list
task list
echo $ task active
task active
echo $ task 2 stop
task 2 stop
echo $ task config journal.time on
task config journal.time on
echo $ task config rc.dateformat.xxx xxx
task config rc.dateformat.xxx xxx
echo $ task config dateformat.annotation 'Y/m/d H:N'
task config dateformat.annotation 'Y/m/d H:N'
echo $ task 2 start
task 2 start
echo $ task list venue
task list venue
echo $ task 2 stop
task 2 stop
echo $ task list venue
task list venue
# 14 Due dates
echo Due dates --------------------------------------------------------------
echo $ task 1 due:7/31/2010
task 1 due:7/31/2010
echo $ task 1 due:2wks
task 1 due:2wks
echo $ task 1 due:-2wks
task 1 due:-2wks
echo $ task 1 due:eom
task 1 due:eom
echo $ task 2 due:8th
task 2 due:8th
echo $ task 2 due:sunday
task 2 due:sunday
echo $ task 5 due:eow
task 5 due:eow
echo $ task list
task list
echo $ task overdue
task overdue
echo $ task rc.dateformat.report:Y-M-DTH:N:SZ list
task rc.dateformat.report:Y-M-DTH:N:SZ list
# 15 Calendar
echo Calendar --------------------------------------------------------------
echo $ task calendar
task calendar
echo $ vi ~/.taskrc # include /usr/local/share/doc/task/rc/holidays-US.rc
#vi ~/.taskrc # include /usr/local/share/doc/task/rc/holidays-US.rc
echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
echo $ task calendar
task calendar
echo $ task cal 2010
task cal 2010
echo $ task rc.calendar.details:full cal
task rc.calendar.details:full cal
echo $ task rc.calendar.holidays:full cal
task rc.calendar.holidays:full cal
# 16 Recurrence
echo Recurrence --------------------------------------------------------------
echo $ task 7 info
task 7 info
echo $ task 7 due:eom recur:monthly
task 7 due:eom recur:monthly
echo $ task 7
task 7
echo $ task 7 until:eoy
task 7 until:eoy
echo $ task recurring
task recurring
echo $ task add Pay taxes due:4/15/2007 recur:yearly
task add Pay taxes due:4/15/2007 recur:yearly
echo $ task long
task long
echo $ task 11 delete
printf "y\ny\n" | task 11 delete # y, y
echo $ task list
task list
# 17 Shell
echo Shell --------------------------------------------------------------
echo $ task shell
#task shell
echo '> projects'
#> projects
echo '> tags'
#> tags
echo '> list'
#> list
echo '> quit'
#> quit
# 18 Special tags
echo Special tags --------------------------------------------------------------
echo $ task 6 +nocolor
task 6 +nocolor
echo $ task list
task list
echo $ task tags
task tags
echo $ task 6 -nocolor
task 6 -nocolor
# 19 Waiting
echo Waiting --------------------------------------------------------------
echo $ task add Look for new apartment due:eoy
task add Look for new apartment due:eoy
echo $ task list
task list
echo $ task 10 wait:12/1/2010
task 10 wait:12/1/2010
echo $ task list
task list
echo $ task waiting
task waiting
echo $ task add Do something in a few seconds
task add Do something in a few seconds
echo $ task 11 wait:5s
task 11 wait:5s
echo $ task list
task list
sleep 5
echo $ task list
task list
echo $ task 11 rc.confirmation:no delete
task 11 rc.confirmation:no delete
# 20 Dependencies
echo Dependencies --------------------------------------------------------------
echo $ task list pro:party
task list pro:party
echo $ task 3 depends:6
task 3 depends:6
echo $ task 6 dep:5
task 6 dep:5
echo $ task 2 dep:1
task 2 dep:1
echo $ task 5 dep:1,2
task 5 dep:1,2
echo $ task 4 dep:1
task 4 dep:1
echo $ task long pro:party
task long pro:party
echo $ task 5 dep:-1
task 5 dep:-1
echo $ task blocked
task blocked
echo $ task unblocked
task unblocked
echo $ task 1 info
task 1 info
echo $ task 2 info
task 2 info
echo $ task 2 done
echo 'y' | task 2 done
echo $ task 1 info
task 1 info
# 21 Reports
echo Reports --------------------------------------------------------------
echo $ task minimal
task minimal
echo $ task ls
task ls
echo $ task list
task list
echo $ task long
task long
echo $ task all
task all
echo $ task completed
task completed
echo $ task recurring
task recurring
echo $ task waiting
task waiting
echo $ task blocked
task blocked
echo $ task oldest
task oldest
echo $ task newest
task newest
echo $ task timesheet
task timesheet
echo $ task next
task next
# 22 Custom report
echo Custom report --------------------------------------------------------------
echo 'report.foo.description=My own report' >> x
echo 'report.foo.columns=id,entry,description' >> x
echo 'report.foo.labels=ID,Entered,Description' >> x
echo 'report.foo.sort=entry+,description+' >> x
echo 'report.foo.filter=status:pending' >> x
echo 'task help | grep foo'
task help | grep foo
echo $ task show report.foo
task show report.foo
echo $ task foo
task foo
# 23 Charts
echo Charts --------------------------------------------------------------
echo $ task history
task history
echo $ task history.annual
task history.annual
echo $ task ghistory
task ghistory
echo $ task ghistory.annual
task ghistory.annual
echo $ task summary
task summary
# 24 Advanced filters
echo Advanced filters --------------------------------------------------------------
echo $ task list
task list
echo $ task list invit
task list invit
echo $ task list description.contains:invit
task list description.contains:invit
echo $ task list desc.word:the
task list desc.word:the
echo $ task list desc.noword:invitations
task list desc.noword:invitations
echo $ task list pro:party
task list pro:party
echo $ task list pro.is:party
task list pro.is:party
echo $ task list pro.not:party
task list pro.not:party
echo $ task list pro:party priority.over:L
task list pro:party priority.over:L
echo $ task list pro:party limit:2
task list pro:party limit:2
echo $ task list limit:page
task list limit:page
echo $ task all status:pending
task all status:pending
echo $ task all status:waiting
task all status:waiting
# 25 Import/export
echo Import/export --------------------------------------------------------------
echo $ task export.csv
task export.csv
echo $ task export.csv venue
task export.csv venue
echo $ task export.vcalendar venue
task export.vcalendar venue
echo $ task export.yaml venue
task export.yaml venue
cat <<EOF >file.text
Remember to read the task man page
EOF
cat file.text
echo $ task import file.text
printf "y\n" | task import file.text
cat <<EOF >file.yaml
%YAML 1.1
---
task:
description: Visit http://taskwarrior.org
due: 1281844800
entry: 1281289630
priority: H
project: work
status: pending
uuid: 23afada0-a446-8d5a-c213-30d99d52c4b0
...
EOF
cat file.yaml
echo $ task import file.yaml
printf "y\n" | task import file.yaml
echo $ task new limit:2
task new limit:2
# 26 Help
echo Help --------------------------------------------------------------
echo $ task help
task help
echo $ man task
#man task
echo $ man taskrc
#man taskrc
echo $ man task-color
#man task-color
echo $ man task-tutorial
#man task-tutorial
echo $ man task-faq
#man task-faq
echo $ man task-sync
#man task-sync
# 27 Wrap up
echo Wrap up --------------------------------------------------------------
echo $ task version
task version
exit

16
doc/misc/run.sample.annotate
View file

@ -1,16 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=120' >> x
echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
echo 'color.alternate=' >> x
exit

16
doc/misc/run.sample.attmod
View file

@ -1,16 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=120' >> x
echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
echo 'color.alternate=' >> x
exit

74
doc/misc/run.sample.blue
View file

@ -1,74 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=120' >> x
echo 'include /usr/local/share/doc/task/rc/dark-blue-256.theme' >> x
echo 'color.alternate=' >> x
echo 'report.list.columns=id,project,priority_long,start,due,recur,age_compact,tags,description' >> x
echo 'report.list.labels=ID,Project,Pri,Started,Due,Recur,Age,Tags,Description' >> x
echo 'report.list.sort=due+,priority_long-,project+' >> x
# Import tasks with old timestamps
cat <<EOF >file.yaml
%YAML 1.1
---
task:
description: Try out the color themes
entry: 1281914800
start: 1282044800
project: software
status: pending
uuid: 13afada0-a446-8d5a-c213-30d99d52c4b0
task:
description: Visit http://taskwarrior.org
entry: 1281089630
tags: www
priority: H
project: software
status: pending
uuid: 23afada0-a446-8d5a-c213-30d99d52c4b0
task:
description: Review task list
entry: 1281289630
due: 1282844800
recur: weekly
project: gtd
status: pending
uuid: 33afada0-a446-8d5a-c213-30d99d52c4b0
task:
description: Try out latest FireFox beta
entry: 1281289630
project: software
status: pending
uuid: 43afada0-a446-8d5a-c213-30d99d52c4b0
...
EOF
printf "y\n" | task rc:x import file.yaml
# Now the visible part.
echo
echo '$ task 1 annotate Try the blue one first'
task rc:x 1 annotate Try the blue one first
echo
echo '$ task list'
task rc:x list
echo
echo '$ task list due.before:eow'
task rc:x list due.before:eow
echo
echo '$ task 2 done'
task rc:x 2 done
exit

71
doc/misc/run.sample.cal
View file

@ -1,71 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=120' >> x
echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
echo 'color.alternate=' >> x
echo 'report.list.columns=id,project,priority_long,start,due,recur,age_compact,tags,description' >> x
echo 'report.list.labels=ID,Project,Pri,Started,Due,Recur,Age,Tags,Description' >> x
echo 'report.list.sort=due+,priority_long-,project+' >> x
# Import tasks with old timestamps
cat <<EOF >file.yaml
%YAML 1.1
---
task:
description: Try out the color themes
entry: 1281914800
start: 1282044800
project: software
status: pending
uuid: 13afada0-a446-8d5a-c213-30d99d52c4b0
task:
description: Visit http://taskwarrior.org
entry: 1281089630
tags: www
priority: H
project: software
status: pending
uuid: 23afada0-a446-8d5a-c213-30d99d52c4b0
task:
description: Review task list
entry: 1281289630
due: 1282844800
recur: weekly
project: gtd
status: pending
uuid: 33afada0-a446-8d5a-c213-30d99d52c4b0
task:
description: Try out latest FireFox beta
entry: 1281289630
project: software
status: pending
uuid: 43afada0-a446-8d5a-c213-30d99d52c4b0
...
EOF
printf "y\n" | task rc:x import file.yaml
# Now the visible part.
echo
echo '$ task calendar sep 2010'
task rc:x calendar sep 2010
echo
echo '$ task calendar'
task rc:x calendar
echo
echo '$ task overdue'
task rc:x 2 done
exit

19
doc/misc/run.sample.color
View file

@ -1,19 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'include /usr/local/share/doc/task/rc/dark-green-256.theme' >> x
# Now the visible part.
echo
echo '$ task color'
task rc:x color
exit

38
doc/misc/run.sample.deps
View file

@ -1,38 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=120' >> x
echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
echo 'color.alternate=' >> x
echo 'report.list.columns=id,project,priority_long,start,due,recur,age_compact,tags,description' >> x
echo 'report.list.labels=ID,Project,Pri,Started,Due,Recur,Age,Tags,Description' >> x
echo 'report.list.sort=due+,priority_long-,project+' >> x
# Now the visible part.
echo
echo $ task add project:Cake Mix the ingredients
task rc:x add project:Cake Mix the ingredients
echo
echo $ task add project:Cake Bake the cake depends:1
task rc:x add project:Cake Bake the cake depends:1
echo
echo $ task add project:Cake Eat the cake depends:2
task rc:x add project:Cake Eat the cake depends:2
echo
echo $ task 2 info
task rc:x 2 info
exit

50
doc/misc/run.sample.format
View file

@ -1,50 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=95' >> x
echo 'include /usr/local/share/doc/task/rc/dark-256.theme' >> x
echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
echo 'color.alternate=' >> x
echo 'due=6' >> x
echo 'dateformat=YMD-H:N' >> x
echo 'dateformat.report=YMD-H:N' >> x
echo 'color.due=rgb530' >> x
echo 'report.list.columns=id,project,priority_long,due,recur,description' >> x
echo 'report.list.labels=ID,Pro,Pri,Due,Recur,Description' >> x
echo 'report.list.sort=due+,priority_long-,project+' >> x
# Now the visible part.
echo
echo '$ task config rc.dateformat YMD-H:N'
echo "Are you sure you want to add 'dateformat' with a value of 'YMD-H:N'? (y/n) y"
echo 'Config file .taskrc modified.'
echo
echo '$ task add Spa appointment due:20100917-11:30'
task rc:x add Lunch with Sue due:20100917-11:30
echo
echo '$ task list'
task rc:x list
echo
echo '$ task list rc.dateformat.report=m-d-Y'
task rc:x list rc.dateformat.report=m-d-Y
echo
echo '$ task list rc.dateformat.report=YMDHNS'
task rc:x list rc.dateformat.report=YMDHNS
echo
echo '$ task list rc.dateformat.report="A, B D, Y (wkV)"'
task rc:x list rc.dateformat.report="A, B D, Y (wkV)"
exit

16
doc/misc/run.sample.ghistory
View file

@ -1,16 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=120' >> x
echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
echo 'color.alternate=' >> x
exit

47
doc/misc/run.sample.holidays
View file

@ -1,47 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=95' >> x
echo 'monthsperline=3' >> x
echo 'calendar.details.report=list' >> x
echo 'calendar.details=full' >> x
echo 'calendar.holidays=full' >> x
echo 'calendar.legend=yes' >> x
echo 'include /usr/local/share/doc/task/rc/dark-green-256.theme' >> x
echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
# Import tasks with old timestamps
cat <<EOF >file.yaml
%YAML 1.1
---
task:
description: Put some more sample screenshots on taskwarrior.org
entry: 1283593511
project: 1.9.3
status: pending
due: 1284647841
uuid: 89295b14-9e15-4771-9dd9-7e82cf8b67b5
annotation:
entry: 1283593519
description: Show the calendar with holidays
annotation:
entry: 1283693560
description: Show a task that is due
...
EOF
printf "y\n" | task rc:x import file.yaml
# Now the visible part.
echo
echo '$ task calendar'
task rc:x calendar
exit

39
doc/misc/run.sample.info
View file

@ -1,39 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=95' >> x
echo 'include /usr/local/share/doc/task/rc/light-256.theme' >> x
echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
echo 'color.alternate=on rgb253' >> x
echo 'due=6' >> x
echo 'color.due=color0' >> x
echo 'color.tagged=color0' >> x
echo 'report.list.columns=id,project,priority_long,due,recur,description' >> x
echo 'report.list.labels=ID,Pro,Pri,Due,Recur,Description' >> x
echo 'report.list.sort=due+,priority_long-,project+' >> x
# Now the visible part.
echo
echo '$ task add Get stationery supplies proj:office pri:H due:sat +@mall +@weekend'
task rc:x add Get stationery supplies proj:office pri:H due:sat +@mall +@weekend
echo
echo '$ task annotate 1 Remember to get batteries'
task rc:x annotate 1 Remember to get batteries
sleep 2
echo
echo '$ task annotate 1 I wonder if they have that antique fanfold computer paper'
task rc:x annotate 1 I wonder if they have that antique fanfold computer paper
echo
echo '$ task 1 info'
task rc:x 1 info

42
doc/misc/run.sample.journal
View file

@ -1,42 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=90' >> x
echo 'journal.time=yes' >> x
echo 'dateformat.annotation=Y/m/d H:N' >> x
#echo 'include /usr/local/share/doc/task/rc/dark-256.theme' >> x
#echo 'include /usr/local/share/doc/task/rc/dark-green-256.theme' >> x
echo 'include /usr/local/share/doc/task/rc/dark-yellow-green.theme' >> x
# Now the visible part.
echo
echo '$ task add Complete the client report due:friday +@work'
task rc:x add Complete the client report due:friday +@work
echo
echo '$ task config journal.time on'
echo "Are you sure you want to add 'journal.time' with a value of 'on'? (y/n) y"
echo 'Config file .taskrc modified.'
echo
echo '$ task start 1'
task rc:x start 1
echo
echo '(some work happens)'
sleep 2
echo
echo '$ task list'
task rc:x list
echo
echo '$ task stop 1'
task rc:x stop 1
echo
echo '$ task list'
task rc:x list
exit

35
doc/misc/run.sample.recur
View file

@ -1,35 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=95' >> x
echo 'monthsperline=3' >> x
echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
echo 'color.alternate=' >> x
echo 'due=3' >> x
echo 'report.list.columns=id,project,priority_long,start,due,recur,age_compact,description' >> x
echo 'report.list.labels=ID,Project,Pri,Started,Due,Recur,Age,Description' >> x
echo 'report.list.sort=due+,priority_long-,project+' >> x
# Now the visible part.
echo
echo '$ task add Deposit paycheck due:friday recur:14days +@bank'
task rc:x add Deposit paycheck due:friday recur:14days
echo
echo '$ task calendar rc.recurrence.limit=6'
task rc:x calendar rc.recurrence.limit=6
echo
echo '$ task list'
task rc:x list
exit

74
doc/misc/run.sample.red
View file

@ -1,74 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=120' >> x
echo 'include /usr/local/share/doc/task/rc/dark-red-256.theme' >> x
echo 'color.alternate=' >> x
echo 'report.list.columns=id,project,priority_long,start,due,recur,age_compact,tags,description' >> x
echo 'report.list.labels=ID,Project,Pri,Started,Due,Recur,Age,Tags,Description' >> x
echo 'report.list.sort=due+,priority_long-,project+' >> x
# Import tasks with old timestamps
cat <<EOF >file.yaml
%YAML 1.1
---
task:
description: Try out the color themes
entry: 1281914800
start: 1282044800
project: software
status: pending
uuid: 13afada0-a446-8d5a-c213-30d99d52c4b0
task:
description: Visit http://taskwarrior.org
entry: 1281089630
tags: www
priority: H
project: software
status: pending
uuid: 23afada0-a446-8d5a-c213-30d99d52c4b0
task:
description: Review task list
entry: 1281289630
due: 1282844800
recur: weekly
project: gtd
status: pending
uuid: 33afada0-a446-8d5a-c213-30d99d52c4b0
task:
description: Try out latest FireFox beta
entry: 1281289630
project: software
status: pending
uuid: 43afada0-a446-8d5a-c213-30d99d52c4b0
...
EOF
printf "y\n" | task rc:x import file.yaml
# Now the visible part.
echo
echo '$ task 1 annotate Try the red one next'
task rc:x 1 annotate Try the red one next
echo
echo '$ task list'
task rc:x list
echo
echo '$ task 2 done'
task rc:x 2 done
echo
echo '$ task summary'
task rc:x summary
exit

16
doc/misc/run.sample.summary
View file

@ -1,16 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=120' >> x
echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
echo 'color.alternate=' >> x
exit

63
doc/misc/run.sample.timesheet
View file

@ -1,63 +0,0 @@
#! /bin/bash
# Small script to create a fragment of output for display on the front page
# of taskwarrior.org, as a teaser.
rm pending.data completed.data undo.data
echo 'data.location=.' > x
echo '_forcecolor=on' >> x
echo 'defaultwidth=120' >> x
echo 'include /usr/local/share/doc/task/rc/dark-violets-256.theme' >> x
echo 'include /usr/local/share/doc/task/rc/holidays-US.rc' >> x
echo 'color.alternate=' >> x
echo 'report.list.columns=id,project,priority_long,start,due,recur,age_compact,tags,description' >> x
echo 'report.list.labels=ID,Project,Pri,Started,Due,Recur,Age,Tags,Description' >> x
echo 'report.list.sort=due+,priority_long-,project+' >> x
# Import tasks with old timestamps
cat <<EOF >file.yaml
%YAML 1.1
---
task:
description: Try out the color themes
entry: 1281914800
start: 1282044800
project: software
status: pending
uuid: 13afada0-a446-8d5a-c213-30d99d52c4b0
task:
description: Visit http://taskwarrior.org
entry: 1281089630
tags: www
priority: H
project: software
status: pending
uuid: 23afada0-a446-8d5a-c213-30d99d52c4b0
task:
description: Review task list
entry: 1281289630
due: 1282844800
recur: weekly
project: gtd
status: pending
uuid: 33afada0-a446-8d5a-c213-30d99d52c4b0
task:
description: Try out latest FireFox beta
entry: 1281289630
project: software
status: pending
uuid: 43afada0-a446-8d5a-c213-30d99d52c4b0
...
EOF
printf "y\n" | task rc:x import file.yaml
# Now the visible part.
echo
echo '$ task timesheet 2'
task rc:x timesheet 2
exit

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

@ -1,534 +0,0 @@
[Make window 116x32 for movie recording, light text, dark background]
This is the script from which a 1.9.3-specific movie will be made. On the left
are the typed commands, and on the right is the voice track.
It is intended that the left and right be combined and the result will be a new
task-tutorial.5 man page.
---------------------------------------- Intro -----------------------------------------------------
http://taskwarrior.org Hello, and welcome to this taskwarrior version 1.9.3 demo.
I'm going to show you over 100 features, so don't blink, or
you'll miss some. Even experienced users are going to learn
*something*.
I will start off with basic usage, and proceed to more
sophisticated commands as we go along.
---------------------------------------- Basic Usage -----------------------------------------------
Let's get started. We're planning a party, and there is a
lot of work to do, so let's capture these tasks.
task add Select a free weekend in August First decide 'when'.
task add Select and book a venue Then decide 'where'.
task add Come up with a guest list Then decide 'who'.
task add Mail invitations Let's send out nice invitations.
task add Select a caterer And a caterer.
task list Let's take a look. Good.
task log Order a special cake Now I've already ordered a cake, so rather than 'add' this,
I'm going to 'log' it. This just means that I want to keep
track of the task, but I've already done it. It saves me a
step.
task 4 duplicate /Mail/Design/ As for those invitations, I'm going to need to design them
task 4 dup /Mail/Print/ first. And I'm also going to need print them. Here we are
task list duplicating a task and making a substitution. Notice how
the commands can be abbreviated, provided they are still
unique.
task 3 done That looks good - but now I think of it, I already have my
task list guest list, so I can mark that one as done.
And that's basic usage, and you already know enough to be
productive using taskwarrior. If you stopped here, you
would be perfectly able to manage your task list.
But if you want to see what it can really do, keep watching...
---------------------------------------- Projects --------------------------------------------------
task add Pay teh rent on teh 31st Remember to pay the rent at the end of the month. Oh,
task 7 /teh/teh/g that was sloppy, but it can be fixed with a global
task list substitution.
task 7 project:home We can now use projects to separate home chores from the
party preparation. Let's assign that last task to the
'home' project. Note that a task may only belong to one
project.
task 1-6 project:party And we will put those first six tasks in the 'party'
project. See how we specify a range of tasks? Taskwarrior
will want to confirm bulk changes like this, but we'll
accept all changes here.
task projects Now that we have multiple projects, as shown here, we can
task list project:home use project as a filter for the list report. You can see
task li pro:par again that we can abbreviate 'list' and 'project', but when
we abbreviate 'party', we are filtering all the projects
that begin with 'par'.
---------------------------------------- Priorities ------------------------------------------------
task 1-3,5 priority:H Priorities are another way to organize tasks. You can use
task list priority values of high, medium and low, and taskwarrior
knows these as H, M or L.
task 3 pri: You can remove priorities by specifying a blank value.
---------------------------------------- Tags ------------------------------------------------------
task list A task may only have one project, but it may have any number
of tags, which are just single words associated with the task.
task 3,5,6 +mall I can go to the print shop at the mall, and do all the
invitation tasks, so let's tag them all.
task long The long report shows tags, too,
task list +mall and I can use tags as a filter to any report too.
task 3 -mall I made a mistake - I can't mail out the invitations at the
mall, so let's remove that tag.
---------------------------------------- Modifications ---------------------------------------------
task 7 Pay rent at the end of the month Task 7 is not worded correctly, so I can modify that by
specifying a task ID and a new description. This is also
considered a bulk change, and so requires confirmation.
task add music We'll need music.
task 8 prepend Select some I can prepend to that.
task 8 append for after dinner I can append to that.
task list
task edit I can also go straight into an editor and modify anything.
task add Hire a band? <--- Sometimes the command will confuse the shell. In this case,
what would happen if there was a file named 'bands' in the
current directory? The shell would expand that wildcard,
so to avoid that, you can...
task add Hire a band\? <--- escape the wildcard...
task add "Hire a band?" <--- or quote the whole description...
task add -- Hire a band\? +dj You can also use the minus minus operator which tells
taskwarrior to stop being clever and interpret the rest
of the arguments as a task description. Otherwise, that
+dj would be interpreted as a tag.
task undo We don't need a band, so the easiest way to get rid of that
task is to undo the last change. Taskwarrior has a
complete undo stack, so you can undo all the way back to
the beginning.
task 1 delete The undo operation gets rid of the task completely, but I
task undo could also have just deleted the task, then the deletion
itself would be tracked, and also undoable.
---------------------------------------- Info ------------------------------------------------------
task 1 info During that undo operation, taskwarrior displayed metadata
task 1 that is associated with the task. You can display this
with the info command, and its shortcut.
task stats There are also statistics that taskwarrior gathers, which
I can display.
---------------------------------------- Annotations -----------------------------------------------
task 1 annotate the 12th looks good Annotations are little notes that can be added to a task.
task 1 annotate or the 13th There can be any number, and each has a time stamp.
task list
task list rc.annotations:full You can choose to display annotations in different ways.
task list rc.annotations:sparse
task list rc.annotations:none
task 1 denotate 13th Annotations can be removed by providing a matching pattern.
task list
---------------------------------------- Configuration ---------------------------------------------
task show There is a 'show' command, that is used to display the
active configuration. There are hundreds of settings that
can be changed, and every one has a sensible default.
man taskrc If you want a complete list of all the settings and their
meanings, read the man page.
task config answer 42 The 'config' command is used to modify the settings, and in
this case the configuration variable 'answer' is given the
value of 42.
task show answer The 'show' command indicates that the value was changed,
task config answer and also that the variable is unrecognized. The show
command performs a detailed check on your configuration, and
alerts you to several kinds of problem. The config command
can also remove a value.
task rc.report.list.sort=description+ list
A very powerful feature is the ability to override the
configuration variables temporarily. Here I am requesting
an ascending sort on the description field only.
---------------------------------------- Defaults --------------------------------------------------
task config default.command list There is a default command, which can be set to anything,
task in this case it is set to the 'list' report. Then running
taskwarrior with no command name runs the default command.
task config default.priority H I can also specify a default priority and project, which
task config default.project Work means that any tasks added will use them, unless an
task add New task alternative is provided.
task list
task undo Let's just revert those changes, to clean up.
task config default.priority
task config default.project
---------------------------------------- Aliases ---------------------------------------------------
task config alias.zzz list You can create aliases to effectively rename commands.
task zzz
task z You can abbreviate those, too.
---------------------------------------- Color -----------------------------------------------------
task config color on All the examples so far have been shown with color turned
task list off. How about some color?
What you see is the result of a set of color rules being
applied to the tasks. There is a hierarchy of color rules
that colorize a task based on the metadata
task 1 "bg:on red" Here is an example of an explicit override to the color
task list rules where a specific task is given a red background.
task 1 bg: Note that the quotes are necessary, otherwise the shell
will consider "bg:on" and "red" to be separate arugments.
task color Taskwarrior supports 256 colors on certain terminal
emulators, and this shows the range of colors available.
task color white on red This is how to show a color sample.
task color legend Or samples of all the active color settings.
Themes are a simple way to use coordinated color schemes
so by including a color theme into the configuration file,
you can see some striking effects.
A blue theme.
# include /usr/local/share/doc/task/rc/dark-blue-256.theme
vi ~/.taskrc
task color legend
task list
A red theme.
# include /usr/local/share/doc/task/rc/dark-red-256.theme
vi ~/.taskrc
task color legend
task list
A general dark theme.
# include /usr/local/share/doc/task/rc/dark-256.theme
vi ~/.taskrc
task list
Here is are two color rules that specify a dark blue
background for all tasks that are part of the 'party'
project, and uses bold to identify any tasks with the
keyword 'invitations' in the description.
task "rc.color.project.party=on rgb001" rc.color.keyword.invit=bold list
man task-color There is a man page with a writeup of all the color
capabilities.
---------------------------------------- Active tasks ----------------------------------------------
task 2 start I'm selecting a venue, so let's indicate that task 2 is
task list active by starting it. See how active tasks are affected
by the color rules.
task active There is an active report that shows only active tasks, and
task 2 stop you can mark any active task as inactive, by stopping it.
task config journal.time on (y) There is a journalling feature that records the start and
task config dateformat.annotation 'Y/m/d H:N' (y)
task 2 start stop times as annotations. We'll turn that on, and add
task list venue the time to the annotation date format.
task 2 stop
task list venue
---------------------------------------- Due dates -------------------------------------------------
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 of week...
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
You can also choose the format - for input and output.
---------------------------------------- Calendar --------------------------------------------------
task calendar When tasks have due dates, you can see them on the calendar.
vi ~/.taskrc
# 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.
task rc.calendar.details:full cal You can see the tasks with due dates also.
task rc.calendar.holidays:full cal And you can see the holidays.
---------------------------------------- Recurrence ------------------------------------------------
task 7 info Remember the task we added to pay the rent? We're going to
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
sure the task doesn't recur after the lease ends.
task recurring And there is a recurring report that shows you only the
recurring tasks.
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
task 11 delete # y y Deletions to recurring tasks can be escalated to include all
task list the recurrences of a task.
---------------------------------------- Shell -----------------------------------------------------
task 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 ----------------------------------------------
task 6 +nocolor You've seen tags, but there are also 'special tags' that
task list have effects on individual tasks. The 'nocolor' special
tag causes the color rules to be bypassed.
task tags Special tags are highlighted by the 'tags' command.
task 6 -nocolor There are others - the 'nonag' special tag prevents the
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
on the calendar.
---------------------------------------- Waiting ---------------------------------------------------
task add Look for new apartment due:eoy When you have a task with a due date that is far out into
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
task list hidden until that date. It will no longer be cluttering
task waiting 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.
task add Do something in a few seconds To illustrate this, let's set up a task with a very short
task 11 wait:5s wait time of five seconds.
task list It's gone.
(sleep 5) We wait for 5 seconds...
task list And it's back.
task 11 rc.confirmation:no delete And now it's deleted.
---------------------------------------- Dependencies ----------------------------------------------
task list pro:party Taskwarrior supports dependencies. Let's take a look at the
party planning tasks, and assign dependencies.
task 3 depends:6 Let's see. I can't mail invitations until they are printed.
task 6 dep:5 I can't print them until I design them.
task 2 dep:1 I need to select a weekend before a location.
task 5 dep:1,2 Design depends on location and weekend.
task 4 dep:1 And the caterer needs to know where.
task long pro:party All my tasks are blocked except task 1. That makes sense.
task 5 dep:-1 Hmm, that double dependency isn't right.
task blocked Here are the blocked tasks.
task unblocked and the opposite, the unblocked tasks.
task 1 info If we look at task 1 closely, we can see that it is blocking
task 2 info 2 and 4. And if we look at task 2, we see that it is
blocked by 1, and blocking 5.
This is called a dependency chain, which is a string of tasks
that are all connected not only by their project, but by
dependencies.
Now we understand that task 1 should be done first, but you
may still violate the laws of physics if you wish. Let's
complete task 2 and see what happens.
task 2 done (y) Taskwarrior realizes what you are doing, and offers to fix
task 1 info the dependency chain to reflect what you have done.
---------------------------------------- Reports ---------------------------------------------------
task minimal Taskwarrior has a good many reports. There is the bare minimum.
task ls The simple.
task list The standard.
task long The kitchen sink.
task all The packrat.
task completed Nostalgia.
task recurring Groundhog day.
task waiting Surprises.
task blocked Wedged.
task unblocked Unencumbered.
task oldest Ancient history.
task newest Contemporary.
task timesheet Corporate.
task next And "what should I work on next?" This one can be useful
because it pulls a few of the highest priority tasks from
all the projects. It's the report we should all be using.
---------------------------------------- Custom Report ---------------------------------------------
You can even define your own custom report. Let's quickly
create a custom report - we'll call it foo - and I can
choose from a long list of fields to include in the report,
but I want to see the ID, the date when I entered the task,
and the description. I can specify the labels for those
columns, the sort order of the report, and I can filter.
cat >> ~/.taskrc
report.foo.description=My own report
report.foo.columns=id,entry,description
report.foo.labels=ID,Entered,Description
report.foo.sort=entry+,description+
report.foo.filter=status:pending
task help | grep foo Custom reports also show up on the help output.
task show report.foo I can inspect the configuration.
task foo And they can be run just like the other reports.
---------------------------------------- Charts ----------------------------------------------------
task history The history report gives monthly totals of tasks added,
task history.annual completed and deleted. There is also an annual version.
task ghistory There is a graphical monthly...
task ghistory.annual and annual version.
task summary There is a project summary report that shows progress in
all the projects.
---------------------------------------- Advanced Filters ------------------------------------------
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 word fragment. Here we are using the 'contains'
modifier, but there are many others.
task list desc.word:the All tasks containing the whole word 'the'. See how
annotations are also searched?
task list desc.noword:invitations Here is a list of all tasks that do not contain the whole
word 'invitations'.
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 ---------------------------------------------
task export.csv You can export your tasks. Here you see all tasks being
exported in CSV format.
task export.csv venue Let's just export one task in CSV format...
task export.vcalendar venue Or in VCalendar format...
task export.yaml venue Or YAML.
cat file.text I can also import. Here I am importing simple lines of
task import file.text text. Taskwarrior recognizes the format and confirms.
cat file.yaml Here is a YAML example. Taskwarrior can read several
task import file.yaml formats, including old versions of its data files. Using
YAML, you can round-trip the data without loss.
task new limit:2 Here are the imported tasks.
---------------------------------------- Help ------------------------------------------------------
task help You'll find a quick reference page built in, with the 'help'
man task command, or perhaps you'll want to take a look at the several
man taskrc man pages installed. This demo has superficially shown
man task-color many features which have more capability and depth which you
can find in the man pages, and online.
man task-tutorial This screencast is actually just a recording of me going
through the tutorial.
man task-faq Some frequently asked questions are answered here.
man task-sync You've patiently watched this whole movie, so here's your
reward - taskwarrior 1.9.3 has network synchronization
features, for sharing tasks across computers. But this is
just a teaser - synch will be shown in the next movie.
---------------------------------------- Wrap up ---------------------------------------------------
task version And that's it. Don't forget to take a look at
taskwarrior.org.
Thank you for watching.
---------------------------------------- End -------------------------------------------------------

34
doc/misc/script-color.txt
View file

@ -1,34 +0,0 @@
Hello. This is a demonstration of the
taskwarrior color capabilities coming
in version 1.9.
task color The color command shows the various
supported colors. For this you will
need an xterm with 256-color support,
or an equivalent.
This demo uses iTerm running on Snow
Leopard.
task add Prepare 1.9 for release Let's create a few tasks, to illustrate
task add Update the various docs the features. Five should be enough.
task add Run the regression tests
task add Make the packages
task add Upload to distributions
--- NOTES
16-color mode
upgrade
blending
alternate lines
--- NOTES
task ls Okay, let's color any tasks that
mention tests a nice medium blue.
echo 'color.keyword.test=color23' >> ~/.taskrc

40
doc/misc/script-hooks-2.txt
View file

@ -1,40 +0,0 @@
$ # Q: What is a formatting hook?
$ # A: Lua code that modifies taskwarrior output at run time.
$
$ cat > hooks.lua
-- Make ID not show up
function id (name, value)
return "(shhh - it's a secret)", 0, nil
end
-- Decorate the UUID
function uuid (name, value)
return '<<<' .. value .. '>>>', 0, nil
end
^D
$ # Q: What is a command hook?
$ # A: Lua code that changes the way commands work.
$
$ cat >> hooks.lua
-- Disable tags
function notags ()
return 1, 'Tags have been disabled'
end
^D
$
$ task config -- hook.format-id ~/demo/hooks.lua:id
$ task config -- hook.format-uuid ~/demo/hooks.lua:uuid
$ task config -- hook.pre-tag ~/demo/hooks.lua:notags
$ task list
$ task add Demonstrate formatting hooks
$ task 1 info
$ task config hooks on
$ task 1 info
$ task 1 +try_to_tag

33
doc/misc/script-hooks.txt
View file

@ -1,33 +0,0 @@
$
$ # Taskwarrior now has Lua 5.1.4 built in.
$
$ task version
$ cat > hooks.lua
function foo ()
print ("Hello from Lua")
return 0, nil
end
^D
$
$ # Taskwarrior can call into Lua at many points during execution.
$ # This one is called immediately before taskwarrior quits.
$
$ task rc.hook.pre-exit=~/hooks.lua:foo version
$
$ # While taskwarrior is calling Lua code, the Lua can also call
$ # back into a taskwarrior API, for information.
$
$ cat > hooks.lua
function foo ()
print "Lua version is " .. task_lua_version ())
print "Taskwarrior version is " .. task_version ())
return 0, nil
end
^D
$
$ cat >> .taskrc
hook.pre-exit=~/hooks.lua:foo
^D
$
$ task version

109
doc/misc/script.txt
View file

@ -1,109 +0,0 @@
Hello, and welcome to this quick demo of the
taskwarrior program.
task add do laundry Let's add some tasks
I need to do laundry
task add project:garage order dumpster Oh yeah, I need to order the dumpster
task add +phone tell mom i loveher Must call Mom (that "phone" there is a tag - they can
be useful for searching and categorizing)
task add +phone pro:garage schedule
goodwill pickup
task ad +email pro:garage ask Tom if Notice I can abbreviate commands
he wants that old bkie
task ls Let's see what we've got
Oh, I spelled bike wrong
task 5 /bkie/bike/
task ls That's better
task 1 pro:home Let's assign projects
task 3 pro:home tell mom I love her
task ls pro:garage
task long pro:garage Let's see all the columns
task list pro:garage There are different ways to list
task lis +phone By tag
task li pro:garage +phone By project and tag
task l mom By word
task 1 priority:H Priorities can be High, Medium or Low
task pri:H 3
task 1 pri:M
task li The list is sorted by priority.
task 2 pri:L
task li
task done 3 Suppose task 3 is done
task li ...and it's gone
task 2 +phone +mistake Lets add tags
# Oops!
task 2 -mistake or remove tags
task tags or look at all the tags
task info 2 or all the details
task projects or all the projects
task 3 fg:bold Let's make it colorful
task 4 fg:bold_green
task li
task 3 fg:bold_underline_white
task li
task 4 bg:on_bright_red fg:bold_yellow
task li Oh that's just nasty - let's get rid of that.
task 4 bg:
task li
task 4 fg:
task 3 fg:
task colors There are many combinations to choose from
task 1 due:6/8/2008 Let's add a due date
date
task li
task calendar Notice the due task is in yellow, today is marked cyan
task 1 due:5/20/2008 This is now an overdue task
task li and it shows up red
task overdue
task cal
task export file.csv You can export the tasks to a spreadsheet
cat file.csv
task start 1 Started tasks can be used as reminders
of what you are supposed to be doing
task active They show up as active
task done 1 Let's clear out a couple
task li
task done 3
task active
task summary Summary shows progress on all projects
task history History shows general activity - how many added,
completed etc, by month
task ghistory This report shows a histogram of tasks that were
added (in red), completed (in green) and deleted
(in yellow), all by month.
And that's it. There are more commands than this
covered in the online documentation, but this should give
the basic idea.
Thank you for watching.