108 lines
2.4 KiB
Groff
108 lines
2.4 KiB
Groff
.TH taskrc 5 2009-05-14 "Task 1.7.0" "User Manuals"
|
|
|
|
.SH NAME
|
|
taskrc \- Configuration file for the task(1) command
|
|
|
|
.SH SYNOPSIS
|
|
.B $HOME/.taskrc
|
|
.B task rc:<directory-path>/.taskrc
|
|
|
|
.SH DESCRIPTION
|
|
.B task
|
|
obtains its configuration data from a file called
|
|
.I .taskrc
|
|
\&. This file is normally located in the user's home directory:
|
|
|
|
.RS
|
|
$HOME/.taskrc
|
|
.RE
|
|
|
|
The default location can be overriden using the
|
|
.I rc:
|
|
attribute when running task:
|
|
|
|
.RS
|
|
$ task rc:<directory-path>/.taskrc
|
|
.RE
|
|
|
|
If
|
|
.B task
|
|
is run without an existing configuration file it will ask if it should create a default, sample
|
|
.I .taskrc
|
|
file in the user's home directory.
|
|
|
|
The task configuration file consists of a series of "assignments" in each line. The "assignments" have the syntax:
|
|
|
|
.RS
|
|
<name-of-configuration-variable>=<value-to-be-set>
|
|
.RE
|
|
|
|
where:
|
|
.RS
|
|
.TP
|
|
<name-of-configuration-variable>
|
|
is one of the variables described below
|
|
|
|
.TP
|
|
<value-to-be-set>
|
|
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.
|
|
|
|
The hash mark, or pounf sign ("#") is used as a "comment" character. It can be used to annotte 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.
|
|
|
|
.SH CONFIGURATION VARIABLES
|
|
Valid variable names and their default values are:
|
|
|
|
|
|
.TP
|
|
.B add [tags] [attrs] description
|
|
|
|
.TP
|
|
.B append [tags] [attrs] description
|
|
|
|
.SH "CREDITS & COPYRIGHTS"
|
|
task was written by P. Beckingham <task@beckingham.net>.
|
|
.br
|
|
Copyright (C) 2006 \- 2009 P. Beckingham
|
|
|
|
This manpage was originally written by Federico Hernandez. It is based on the task man page, which
|
|
was originally written by P.C. Shyamshankar.
|
|
|
|
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)
|
|
|
|
For more information regarding task, the following may be referenced:
|
|
|
|
.TP
|
|
<http://www.beckingham.net/task.html>
|
|
The official site.
|
|
|
|
.TP
|
|
<http://groups.google.com/group/taskprogram>
|
|
The official mailing list.
|
|
|
|
.TP
|
|
<http://github.com/pbeckingham/task/>
|
|
The official code repository.
|
|
|
|
.SH REPORTING BUGS
|
|
Bugs in task may be reported to the issue-tracker at
|
|
|
|
.RS
|
|
<http://github.com/pbeckingham/task/issues>
|
|
.RE
|
|
|
|
or to the mailing list at
|
|
|
|
.RS
|
|
<http://groups.google.com/group/taskprogram>
|
|
.RE
|