diff --git a/doc/man1/task.1 b/doc/man1/task.1 index 5cefc371d..58af5352f 100644 --- a/doc/man1/task.1 +++ b/doc/man1/task.1 @@ -111,7 +111,7 @@ Shows a monthly calendar with due tasks marked. .TP .B active -Shows all tasks that are started but not comleted. +Shows all tasks that are started but not completed. .TP .B overdue @@ -220,7 +220,7 @@ Specify alternate configuration file. .SH SPECIFYING DATES AND FREQUENCIES .SS DATES -Task reads dates from the commandline and displays dates in the +Task reads dates from the command line and displays dates in the reports. The expected and desired date format is determined by the configuration variable .I dateformat @@ -252,7 +252,7 @@ task ... due:eom task ... due:eoy .TP -Next occuring weekday +Next occurring weekday task ... due:fri .RE @@ -272,15 +272,15 @@ Mondays, Tuesdays, Wednesdays, Thursdays, Fridays and skipping weekend days. .TP weekly, 1w, 2w, ... -Eery week or a number of weeks. +Every week or a number of weeks. .TP biweekly, fortnight Every two weeks. .TP -quaterly, 1q, 2q, ... -Every three months, a quarter, or a number of quaters. +quarterly, 1q, 2q, ... +Every three months, a quarter, or a number of quarters. .TP semiannual @@ -319,16 +319,14 @@ could be list, ls or long. .SH EXAMPLES -A small section for examples e.g. some stuff from +For examples please see the online documentation at .br -http://www.beckingham.net/30second.html -.br -http://www.beckingham.net/simple.html + .SH FILES .TP -~/.taskrc User configuration file. +~/.taskrc User configuration file - see also taskrc(5). .TP ~/.task The default directory where task stores its data files. The location @@ -341,7 +339,7 @@ can be configured in the configuration file. ~/.task/completed.data The file that contains the completed "done" tasks. .SH "CREDITS & COPYRIGHTS" -task was written by P. Beckingham . +task was written by P. Beckingham . .br Copyright (C) 2006 \- 2009 P. Beckingham @@ -357,26 +355,18 @@ http://www.gnu.org/licenses/gpl-2.0.txt for more information. For more information regarding task, the following may be referenced: .TP - -The official site. - -.TP - -The official mailing list. +The official site at + .TP +The official code repository at -The official code repository. + +.TP +You can contact the project by writing an email to + .SH REPORTING BUGS +.TP Bugs in task may be reported to the issue-tracker at - -.RS - -.RE - -or to the mailing list at - -.RS - -.RE + diff --git a/doc/man5/taskrc.5 b/doc/man5/taskrc.5 index 0ea1b89e1..76c2f8059 100644 --- a/doc/man5/taskrc.5 +++ b/doc/man5/taskrc.5 @@ -5,6 +5,7 @@ taskrc \- Configuration file for the task(1) command .SH SYNOPSIS .B $HOME/.taskrc +.br .B task rc:/.taskrc .SH DESCRIPTION @@ -17,7 +18,7 @@ obtains its configuration data from a file called $HOME/.taskrc .RE -The default location can be overriden using the +The default location can be overridden using the .I rc: attribute when running task: @@ -49,9 +50,9 @@ is the value the variable is to be set to. .RE and set a configuration variable to a certain value. The equal sign ("=") is used to separate the variable -name from the value to be set. +name from the value to be set. -The hash mark, or pounf sign ("#") is used as a "comment" character. It can be used to annotte the +The hash mark, or pound sign ("#") is used as a "comment" character. It can be used to annotate the configuration file. It is placed at the beginning of a line and all text after the character to the end of the line is ignored. @@ -61,7 +62,7 @@ Valid variable names and their default values are: .TP .B data.location=$HOME/.task This is a path to the directory containing all the task files. By default, it is set up to be ~/.task, -for example: /Users/paul/.task +for example: /Users/paul/.task .TP .B confirmation=yes @@ -75,7 +76,7 @@ May be "yes" or "no", and causes task to display the ID and description of any t .B next=2 Is a number, defaulting to 2, which is the number of tasks for each project that are shown in the .B task next -command. +command. .TP .B dateformat=m/d/Y @@ -112,21 +113,21 @@ m-d-y would output 07-24-09 .B monthsperline=99 Determines how many months the "task calendar" command renders across the screen. Defaults to however many will fit. If more months that will fit are specified, -task will only show as many that will fit. +task will only show as many that will fit. .TP .B defaultwidth=80 -The width of tables used when ncurses support is not available. Defaults to 80. +The width of tables used when ncurses support is not available. Defaults to 80. .TP .B curses=on Determines whether task uses ncurses to establish the size of the window you are -using, for text wrapping. +using, for text wrapping. .TP .B due=7 This is the number of days into the future that define when a task is considered due, -and is colored accordingly. Defaults to 7. +and is colored accordingly. Defaults to 7. .TP .B nag=You have higher priority tasks. @@ -153,7 +154,7 @@ to using "vi". .TP .B color=on May be "on" or "off". Determines whether task uses color. When "off", task will -use dashes (-----) to underline column headings. +use dashes (-----) to underline column headings. Task has a number of coloration rules. They correspond to a particular attribute of a task, such as it being due, or being active, and specifies the automatic @@ -206,7 +207,7 @@ Certain attributes like tags, projects and keywords can also have their own colo .RE .RS -.TP +.TP .B color.tag.X=yellow Colors any task that has the tag X. @@ -216,49 +217,49 @@ Colors any task assigned to project X. .TP .B color.keyword.X=on_blue -Colors any task where the description contains X. +Colors any task where the description contains X. .RE .TP -.B +.B shadow.file=$HOME/.task/shadow.txt -If specified, designates a file path that will be autoamtically written to by task, +If specified, designates a file path that will be automatically written to by task, whenever the task database changes. In other words, it is automatically kept up to date. The shadow.command configuration variable is used to determine which report is written to the shadow file. There is no color used in the shadow file. This feature can be useful in maintaining a current file for use by programs like GeekTool, Conky or Samurize. .TP -.B +.B shadow.command=list -This is the command that is run to maintain the shadow file, determined by the +This is the command that is run to maintain the shadow file, determined by the .I shadow.file configuration variable. The format is identical to that of .I default.command \&. Please see the corresponding documentation for that command. .TP -.B +.B shadow.notify=on When this value is set to "on", task will display a message whenever the shadow -file is updated by some task command. +file is updated by some task command. .TP -.B +.B default.project=foo Provides a default project name for the .I task add -command. +command. .TP -.B +.B default.priority=M Provides a default priority for the .I task add -command. +command. .TP -.B +.B default.command=list Provides a default command that is run every time task is invoked with no arguments. For example, if set to: @@ -293,84 +294,95 @@ The output columns, their labels and the sort order can be set using the corresp variables for each report. .TP -.B +.B report.long.description Lists all task, all data, matching the specified criteria .TP -.B +.B report.long.labels=ID,Project,Pri,Added,Started,Due,Recur,Age,Tags,Description .RE -.B +.br +.B report.long.columns=id,project,priority,entry,start,due,recur,age,tags,description -.B +.br +.B report.long.sort=due+,priority-,project+ .TP -.B +.B report.list.description Lists all tasks matching the specified criteria .TP -.B +.B report.list.labels=ID,Project,Pri,Due,Active,Age,Description .RE -.B +.br +.B report.list.columns=id,project,priority,due,active,age,description -.B +.br +.B report.list.sort=due+,priority-,project+ .TP -.B +.B report.ls.description Minimal listing of all tasks matching the specified criteria .TP -.B +.B report.ls.labels=ID,Project,Pri,Description .RE -.B +.br +.B report.ls.columns=id,project,priority,description -.B +.br +.B report.ls.sort=priority-,project+ .TP -.B +.B report.newest.description Shows the newest tasks .TP -.B +.B report.newest.labels=ID,Project,Pri,Due,Active,Age,Description .RE -.B +.br +.B report.newest.columns=id,project,priority,due,active,age,description -.B +.br +.B report.newest.sort=id- -.B +.br +.B report.newest.limit=10 .TP -.B +.B report.oldest.description Shows the oldest tasks .TP -.B +.B report.oldest.labels=ID,Project,Pri,Due,Active,Age,Description .RE -.B +.br +.B report.oldest.columns=id,project,priority,due,active,age,description -.B +.br +.B report.oldest.sort=id+ -.B +.br +.B report.oldest.limit=10 - .SH "CREDITS & COPYRIGHTS" -task was written by P. Beckingham . +task was written by P. Beckingham . .br Copyright (C) 2006 \- 2009 P. Beckingham @@ -381,31 +393,23 @@ task is distributed under the GNU General Public License. See http://www.gnu.org/licenses/gpl-2.0.txt for more information. .SH SEE ALSO -.BR task (1) +.BR task(1) For more information regarding task, the following may be referenced: .TP - -The official site. - -.TP - -The official mailing list. +The official site at + .TP +The official code repository at -The official code repository. + +.TP +You can contact the project by writing an email to + .SH REPORTING BUGS +.TP Bugs in task may be reported to the issue-tracker at - -.RS - -.RE - -or to the mailing list at - -.RS - -.RE +