From 393ebae8aa85d71ef90d3e79b5c7dcb6c430119a Mon Sep 17 00:00:00 2001 From: Paul Beckingham Date: Tue, 21 Jun 2011 18:02:08 -0400 Subject: [PATCH] Cleanup - Removed obsolete grammar.bnf file. - doc/misc scripts relocated to screencast.git. --- doc/misc/grammar.bnf | 241 --------------- doc/misc/run.193 | 533 --------------------------------- doc/misc/run.sample.annotate | 16 - doc/misc/run.sample.attmod | 16 - doc/misc/run.sample.blue | 74 ----- doc/misc/run.sample.cal | 71 ----- doc/misc/run.sample.color | 19 -- doc/misc/run.sample.deps | 38 --- doc/misc/run.sample.format | 50 ---- doc/misc/run.sample.ghistory | 16 - doc/misc/run.sample.holidays | 47 --- doc/misc/run.sample.info | 39 --- doc/misc/run.sample.journal | 42 --- doc/misc/run.sample.recur | 35 --- doc/misc/run.sample.red | 74 ----- doc/misc/run.sample.summary | 16 - doc/misc/run.sample.timesheet | 63 ---- doc/misc/script-193.txt | 534 ---------------------------------- doc/misc/script-color.txt | 34 --- doc/misc/script-hooks-2.txt | 40 --- doc/misc/script-hooks.txt | 33 --- doc/misc/script.txt | 109 ------- 22 files changed, 2140 deletions(-) delete mode 100644 doc/misc/grammar.bnf delete mode 100755 doc/misc/run.193 delete mode 100755 doc/misc/run.sample.annotate delete mode 100755 doc/misc/run.sample.attmod delete mode 100755 doc/misc/run.sample.blue delete mode 100755 doc/misc/run.sample.cal delete mode 100755 doc/misc/run.sample.color delete mode 100755 doc/misc/run.sample.deps delete mode 100755 doc/misc/run.sample.format delete mode 100755 doc/misc/run.sample.ghistory delete mode 100755 doc/misc/run.sample.holidays delete mode 100755 doc/misc/run.sample.info delete mode 100755 doc/misc/run.sample.journal delete mode 100755 doc/misc/run.sample.recur delete mode 100755 doc/misc/run.sample.red delete mode 100755 doc/misc/run.sample.summary delete mode 100755 doc/misc/run.sample.timesheet delete mode 100644 doc/misc/script-193.txt delete mode 100644 doc/misc/script-color.txt delete mode 100644 doc/misc/script-hooks-2.txt delete mode 100644 doc/misc/script-hooks.txt delete mode 100644 doc/misc/script.txt diff --git a/doc/misc/grammar.bnf b/doc/misc/grammar.bnf deleted file mode 100644 index 9a9558db6..000000000 --- a/doc/misc/grammar.bnf +++ /dev/null @@ -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 - diff --git a/doc/misc/run.193 b/doc/misc/run.193 deleted file mode 100755 index 5439eb75b..000000000 --- a/doc/misc/run.193 +++ /dev/null @@ -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 <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 <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 - diff --git a/doc/misc/run.sample.annotate b/doc/misc/run.sample.annotate deleted file mode 100755 index 476c3e168..000000000 --- a/doc/misc/run.sample.annotate +++ /dev/null @@ -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 - diff --git a/doc/misc/run.sample.attmod b/doc/misc/run.sample.attmod deleted file mode 100755 index 476c3e168..000000000 --- a/doc/misc/run.sample.attmod +++ /dev/null @@ -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 - diff --git a/doc/misc/run.sample.blue b/doc/misc/run.sample.blue deleted file mode 100755 index 9fbc455a6..000000000 --- a/doc/misc/run.sample.blue +++ /dev/null @@ -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 <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 - diff --git a/doc/misc/run.sample.cal b/doc/misc/run.sample.cal deleted file mode 100755 index f8bbed8d3..000000000 --- a/doc/misc/run.sample.cal +++ /dev/null @@ -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 <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 - diff --git a/doc/misc/run.sample.color b/doc/misc/run.sample.color deleted file mode 100755 index cc8cc1597..000000000 --- a/doc/misc/run.sample.color +++ /dev/null @@ -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 - diff --git a/doc/misc/run.sample.deps b/doc/misc/run.sample.deps deleted file mode 100755 index f2954baf8..000000000 --- a/doc/misc/run.sample.deps +++ /dev/null @@ -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 - diff --git a/doc/misc/run.sample.format b/doc/misc/run.sample.format deleted file mode 100755 index ac261a76c..000000000 --- a/doc/misc/run.sample.format +++ /dev/null @@ -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 - diff --git a/doc/misc/run.sample.ghistory b/doc/misc/run.sample.ghistory deleted file mode 100755 index 476c3e168..000000000 --- a/doc/misc/run.sample.ghistory +++ /dev/null @@ -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 - diff --git a/doc/misc/run.sample.holidays b/doc/misc/run.sample.holidays deleted file mode 100755 index 58c6eb97c..000000000 --- a/doc/misc/run.sample.holidays +++ /dev/null @@ -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 <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 - diff --git a/doc/misc/run.sample.info b/doc/misc/run.sample.info deleted file mode 100755 index 15001db21..000000000 --- a/doc/misc/run.sample.info +++ /dev/null @@ -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 - diff --git a/doc/misc/run.sample.journal b/doc/misc/run.sample.journal deleted file mode 100755 index 143332ae5..000000000 --- a/doc/misc/run.sample.journal +++ /dev/null @@ -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 - diff --git a/doc/misc/run.sample.recur b/doc/misc/run.sample.recur deleted file mode 100755 index 241cb591a..000000000 --- a/doc/misc/run.sample.recur +++ /dev/null @@ -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 - diff --git a/doc/misc/run.sample.red b/doc/misc/run.sample.red deleted file mode 100755 index 064f65b8d..000000000 --- a/doc/misc/run.sample.red +++ /dev/null @@ -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 <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 - diff --git a/doc/misc/run.sample.summary b/doc/misc/run.sample.summary deleted file mode 100755 index 476c3e168..000000000 --- a/doc/misc/run.sample.summary +++ /dev/null @@ -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 - diff --git a/doc/misc/run.sample.timesheet b/doc/misc/run.sample.timesheet deleted file mode 100755 index 07105138a..000000000 --- a/doc/misc/run.sample.timesheet +++ /dev/null @@ -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 <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 - diff --git a/doc/misc/script-193.txt b/doc/misc/script-193.txt deleted file mode 100644 index a98355cd9..000000000 --- a/doc/misc/script-193.txt +++ /dev/null @@ -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 ------------------------------------------------------- - diff --git a/doc/misc/script-color.txt b/doc/misc/script-color.txt deleted file mode 100644 index 4677cf364..000000000 --- a/doc/misc/script-color.txt +++ /dev/null @@ -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 - - - diff --git a/doc/misc/script-hooks-2.txt b/doc/misc/script-hooks-2.txt deleted file mode 100644 index 8a09e27c9..000000000 --- a/doc/misc/script-hooks-2.txt +++ /dev/null @@ -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 - diff --git a/doc/misc/script-hooks.txt b/doc/misc/script-hooks.txt deleted file mode 100644 index 09e0eb2d9..000000000 --- a/doc/misc/script-hooks.txt +++ /dev/null @@ -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 - diff --git a/doc/misc/script.txt b/doc/misc/script.txt deleted file mode 100644 index 0385acaec..000000000 --- a/doc/misc/script.txt +++ /dev/null @@ -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. -