Updated man pages for new release

This commit is contained in:
Federico Hernandez 2009-07-07 00:46:45 +02:00
parent e8716e68ae
commit 3e5355bc39
2 changed files with 147 additions and 113 deletions

View file

@ -133,8 +133,8 @@ Shows the long usage text.
.SH REPORT SUBCOMMANDS .SH REPORT SUBCOMMANDS
A report is a listing of information from the task database. There are several A report is a listing of information from the task database. There are several
built-in reports currently in task. The output and sort behaviour of these reports currently predefined in task. The output and sort behaviour of these
subcommands can be configured in the configuration file. reports can be configured in the configuration file. See also the man page taskrc(5).
.TP .TP
.B active [tags] [attrs] [description] .B active [tags] [attrs] [description]
@ -183,6 +183,10 @@ Shows all recurring tasks matching the specified criteria.
.B waiting [tags] [attrs] [description] .B waiting [tags] [attrs] [description]
Shows all waiting tasks matching the specified criteria. Shows all waiting tasks matching the specified criteria.
.TP
.B next [tags] [attrs] [description]
Shows all tasks with upcoming due dates matching the specified criteria.
.SH ATTRIBUTES AND METADATA .SH ATTRIBUTES AND METADATA
.TP .TP

View file

@ -66,10 +66,39 @@ configuration file. All text after the character to the end of the line is ignor
.SH CONFIGURATION VARIABLES .SH CONFIGURATION VARIABLES
Valid variable names and their default values are: Valid variable names and their default values are:
.SS FILES
.TP .TP
.B data.location=$HOME/.task .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, 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: /home/paul/.task
.TP
.B locking=on
Determines whether task uses file locking when accessing the pending.data and completed.data files.
Default to "on". Solaris users who store the task data files on an NFS mount may need to set locking
to "off". Note that setting this value to "off" is dangerous. It means that another program may write
to the task.pending file when task is attempting to do the same.
.SS TERMINAL
.TP
.B curses=on
Determines whether task uses ncurses to establish the size of the window you are
using, for text wrapping.
.TP
.B defaultwidth=80
The width of tables used when ncurses support is not available. Defaults to 80.
.TP
.B editor=vi
Specifies which text editor you wish to use for when the
.B task edit <ID>
command is used. Task will first look for this configuration variable. If found, it is used.
Otherwise task will look for the $VISUAL or $EDITOR environment variables, before it defaults
to using "vi".
.SS MISCELLANEOUS
.TP .TP
.B locale=en-US .B locale=en-US
@ -80,7 +109,7 @@ locale for which there is no strings file.
.TP .TP
.B confirmation=yes .B confirmation=yes
May be "yes" or "no", and determines whether task will ask for confirmation before deleting a task. May be "yes" or "no", and determines whether task will ask for confirmation before deleting a task or doing bulk changes.
.TP .TP
.B echo.command=yes .B echo.command=yes
@ -98,6 +127,15 @@ Is a number, defaulting to 2. When more than this number of tasks are modified
.B confirmation .B confirmation
variable is "no". variable is "no".
.TP
.B nag=You have higher priority tasks.
This may be a string of text, or blank. It is used as a prompt when a task is completed
that is not considered high priority. The "task next" command lists important tasks, and
completing one of those does not generate this nagging. Default value is: You have higher
priority tasks.
.SS DATES
.TP .TP
.B dateformat=m/d/Y .B dateformat=m/d/Y
This is a string of characters that define how task formats dates. The default value is: m/d/Y. This is a string of characters that define how task formats dates. The default value is: m/d/Y.
@ -130,24 +168,13 @@ m-d-y would output 07-24-09
.RE .RE
.TP .TP
.B monthsperline=99 .B weekstart=Sunday
Determines how many months the "task calendar" command renders across the screen. Determines the day a week starts. Valid values are Sunday or Monday only.
Defaults to however many will fit. If more months that will fit are specified,
task will only show as many that will fit.
.TP .TP
.B defaultwidth=80 .B displayweeknumber=yes
The width of tables used when ncurses support is not available. Defaults to 80. Determines if week numbers are displayed when using the "task calendar" command.
The week number is dependent on the day a week starts.
.TP
.B curses=on
Determines whether task uses ncurses to establish the size of the window you are
using, for text wrapping.
.TP
.B fontunderline=on
Determines if font underlines or ascii dashes should be used to underline
headers.
.TP .TP
.B due=7 .B due=7
@ -155,32 +182,23 @@ This is the number of days into the future that define when a task is considered
and is colored accordingly. Defaults to 7. and is colored accordingly. Defaults to 7.
.TP .TP
.B nag=You have higher priority tasks. .B monthsperline=2
This may be a string of text, or blank. It is used as a prompt when a task is completed Determines how many months the "task calendar" command renders across the screen.
that is not considered high priority. The "task next" command lists important tasks, and Defaults to however many will fit. If more months that will fit are specified,
completing one of those does not generate this nagging. Default value is: You have higher task will only show as many that will fit.
priority tasks.
.TP .SS COLOR CONTROLS
.B locking=on
Determines whether task uses file locking when accessing the pending.data and completed.data files.
Default to "on". Solaris users who store the task data files on an NFS mount may need to set locking
to "off". Note that setting this value to "off" is dangerous. It means that another program may write
to the task.pending file when task is attempting to do the same.
.TP
.B editor=vi
Specifies which text editor you wish to use for when the
.B task edit <ID>
command is used. Task will first look for this configuration variable. If found, it is used.
Otherwise task will look for the $VISUAL or $EDITOR environment variables, before it defaults
to using "vi".
.TP .TP
.B color=on .B color=on
May be "on" or "off". Determines whether task uses color. When "off", task will 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.
.TP
.B fontunderline=on
Determines if font underlines or ascii dashes should be used to underline
headers.
Task has a number of coloration rules. They correspond to a particular attribute 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 of a task, such as it being due, or being active, and specifies the automatic
coloring of that task. A list of valid color, depending on your terminal, can be coloring of that task. A list of valid color, depending on your terminal, can be
@ -197,22 +215,31 @@ The coloration rules and their defaults are:
.RS .RS
.RS .RS
.B color.overdue=bold_red .B color.overdue=bold_red
The color for overdue tasks.
.br .br
.B color.due=bold_yellow .B color.due=bold_yellow
The color of due tasks.
.br .br
.B color.pri.H=bold .B color.pri.H=bold
The color of priority:H tasks.
.br .br
.B color.pri.M=on_yellow .B color.pri.M=on_yellow
The color of priority:M tasks.
.br .br
.B color.pri.L=on_green .B color.pri.L=on_green
The color of priority:L tasks.
.br .br
.B color.pri.none=white on_blue .B color.pri.none=white on_blue
The color of priority: tasks.
.br .br
.B color.active=bold_cyan .B color.active=bold_cyan
The color of active tasks.
.br .br
.B color.tagged=yellow .B color.tagged=yellow
The color of tagged tasks.
.br .br
.B color.recurring=on_red .B color.recurring=on_red
The color for recurring tasks.
.RE .RE
.RE .RE
@ -257,6 +284,8 @@ Colors any of the messages printed after the report output.
Colors any of the messages printed last. Colors any of the messages printed last.
.RE .RE
.SS SHADOW FILE
.TP .TP
.B .B
shadow.file=$HOME/.task/shadow.txt shadow.file=$HOME/.task/shadow.txt
@ -281,6 +310,8 @@ shadow.notify=on
When this value is set to "on", task will display a message whenever the shadow 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.
.SS DEFAULTS
.TP .TP
.B .B
default.project=foo default.project=foo
@ -308,7 +339,7 @@ default.command=list project:foo
.RE .RE
.RS .RS
Then task will run the "list project:foo" command if no command is specified. This means that then task will run the "list project:foo" command if no command is specified. This means that
by merely typing by merely typing
.RE .RE
@ -326,105 +357,104 @@ ID Project Pri Description
.RE .RE
.RE .RE
The built in reports can be customized by using the following configuration variables. .SS REPORTS
The output columns, their labels and the sort order can be set using the corresponding
variables for each report. The reports can be customized by using the following configuration variables.
The output columns, their labels and the sort order can be set using the
corresponding variables for each report. Each report name is used as a
"command" name. For example
.TP .TP
.B .B task overdue
report.long.description
Lists all task, all data, matching the specified criteria
.TP .TP
.B .B report.X.description
report.long.labels=ID,Project,Pri,Added,Started,Due,Recur,Age,Tags,Description The description for report X when running the "task help" command.
.RE
.br
.B
report.long.columns=id,project,priority,entry,start,due,recur,age,tags,description
.br
.B
report.long.sort=due+,priority-,project+
.TP .TP
.B .B report.X.columns
report.list.description The columns that will be used when generating the report X. Valid columns are:
Lists all tasks matching the specified criteria id, uuid, project, priority, entry, start, due, recur, recur_ind, age, age_compact,
active, tags, description, description_only. The IDs are seperated by commas.
.TP .TP
.B .B report.X.labels
report.list.labels=ID,Project,Pri,Due,Active,Age,Description The labels for each column that will be used when generating report X. The labels
.RE are a comma separated list.
.br
.B
report.list.columns=id,project,priority,due,active,age,description
.br
.B
report.list.sort=due+,priority-,project+
.TP .TP
.B .B report.X.sort
report.ls.description The sort order of the tasks in the generated report X. The sort order is specified
Minimal listing of all tasks matching the specified criteria by using the column ids postfixed by a "+" for ascending sort order or a "-" for
descending sort order. The sort IDs are separated by commas
.TP .TP
.B .B report.X.filter
report.ls.labels=ID,Project,Pri,Description This adds a filter to the report X so that only tasks matching the filter criteria
.RE are displayed in the generated report.
.br
.B
report.ls.columns=id,project,priority,description
.br
.B
report.ls.sort=priority-,project+
.TP .TP
.B .B report.X.limit
report.newest.description An optional value to a report limiting the number of displayed tasks in the
Shows the newest tasks generated report.
.TP .TP
.B Task comes with a number of predefined reports in its default configuration file. These reports are:
report.newest.labels=ID,Project,Pri,Due,Active,Age,Description
.RE
.br
.B
report.newest.columns=id,project,priority,due,active,age,description
.br
.B
report.newest.sort=id-
.br
.B
report.newest.limit=10
.TP .TP
.B .B long
report.oldest.description Lists all task, all data, matching the specified criteria.
Shows the oldest tasks
.TP .TP
.B .B list
report.oldest.labels=ID,Project,Pri,Due,Active,Age,Description Lists all tasks matching the specified criteria.
.RE
.br .TP
.B .B ls
report.oldest.columns=id,project,priority,due,active,age,description Minimal listing of all tasks matching the specified criteria.
.br
.B .TP
report.oldest.sort=id+ .B newest
.br Shows the newest tasks.
.B
report.oldest.limit=10 .TP
.B oldest
Shows the oldest tasks.
.TP
.B overdue
Lists overdue tasks matching the specified criteria.
.TP
.B active
Lists active tasks matching the specified criteria.
.TP
.B completed
Lists completed tasks matching the specified criteria.
.TP
.B recurring
Lists recurring tasks matching the specified criteria.
.TP
.B waiting
Lists all waiting tasks matching the specified criteria.
.TP
.B all
Lists all tasks matching the specified criteria.
.TP
.B next
Lists all tasks with upcoming due dates matching the specified criteria.
.SH "CREDITS & COPYRIGHTS" .SH "CREDITS & COPYRIGHTS"
task was written by P. Beckingham <paul@beckingham.net>. task was written by P. Beckingham <paul@beckingham.net>.
.br .br
Copyright (C) 2006 \- 2009 P. Beckingham Copyright (C) 2006 \- 2009 P. Beckingham
This man page was originally written by Federico Hernandez. It is based on the task man page, which This man page was originally written by Federico Hernandez.
was originally written by P.C. Shyamshankar.
task is distributed under the GNU General Public License. See task is distributed under the GNU General Public License. See
http://www.gnu.org/licenses/gpl-2.0.txt for more information. http://www.gnu.org/licenses/gpl-2.0.txt for more information.