aboutsummaryrefslogtreecommitdiff
path: root/tatt.1
blob: 191119ee877494a0df6b186547ac2fb59f57b07a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
.TH TATT 1
.SH NAME
tatt (is an) arch testing tool.
.SH SYNOPSIS
.B tatt
\fI<options> [suboptions]\fB

.SH DESCRIPTION
Tatt is an arch-testing tool written for automation of frequently repeated tasks.

.SH OPTIONS
.TP 
\fB-h, --help\fI
Show this help message and exit.
.TP
\fB-d, --depend\fI
Determine stable rdeps.
.TP
\fB-u, --use, --usecombis\fI
Determine use flag combinations.
.TP
\fB-f INFILE, --file=INFILE\fI
Input File containing packages.
.TP
\fB-j JOBNAME, --jobname=JOBNAME\fI
Name for the job, prefix of output files.
.TP
\fB-b BUGNUM, --bug=BUGNUM\fI
Do the full program for a given stable request bug
.TP
\fB-s SUCCBUGNUM, --success=SUCCBUGNUM\fI
Comment that the program was successfully tested
.TP
\fB-r RESOLVENUM, --resolve=RESOLVENUM\fI
Resolve the given bugnumber, needs a message
.TP
\fB-c, --close\fI
Resolve the given bugnumber with closing it, needs to be combined with -r
.TP
\fB-m RESOLVEMESSAGE, --message=RESOLVEMESSAGE\fI
Message for bug resolution.
.TP
\fB-k, --keywording\fI
Search for keywording packages, needs to be combined with -f
.TP
\fB-v, --verbose\fI
Print informative output.

.SH USAGE
.TP
tatt -b300000 -j myjob
Work on a stable bug no 300000. This will unmask the package and
create five shell scripts.  One is for automated testing of USE-flag
combinations, one is for testing of reverse dependencies, one is for
committing the new keywords to CVS, one is for leaving a message on
the bug, and finally one is for cleaning up.

-j specifies a jobname which will be a prefix for the scripts that
tatt produces, if it is left empty the bugnumber will be used

.TP
tatt -f myPackageFile -b bugnumber
This will open the file myPackageFile, look for all atoms in it, and
write scripts that test/commit all packages.  If -j is omitted the
filename is used.  The bugnumber is necessary for the commit script.

.TP
tatt -r bugnum -m "x86 stable, Thanks xyz" 
Removes your arch from the CC field of the bug and adds the message (assuming everything was committed and we want to resolve the bug).
.br
-c switch additionally closes the bug.
.SH FILES
~/.tatt
.br
/usr/share/tatt/templates/

.SH SEE ALSO
gatt(8)
.br
https://github.com/gentoo/tatt

.SH COPYRIGHT 
This software is licensed under the GNU General Public License, version 2 (GPLv2). A copy of this license is available at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.

.SH BUGS 
Forks and pull requests are welcome on GitHub. https://github.com/gentoo/tatt

.SH AUTHOR
tatt is written and maintained by Thomas Kahle <tomka@gentoo.org>