aboutsummaryrefslogtreecommitdiff
blob: b1e473dd04c31760c6f9a5975e81e759fe9c1f29 (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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
.TH "ebump" "1" "0.1.1" "Gentoolkit" "Gentoo Administration"
.SH "NAME"
.LP 
ebump \- Gentoo: Ebuild revision bumper
.SH "SYNTAX"
.LP 
ebump [\fIoption\fP] <\fIpackage-name[-version]\fP>

.SH "DESCRIPTION" 

.LP
\fIebump\fR bumps the revision of a particular ebuild, and all auxiliary
files in the files/ directory that have a matching version suffix.

.LP
By default, the all new revision files will be added to the VCS.

.LP 
You must stand in the directory of the ebuild to be bumped.

.SH "OPTIONS"
.LP 
\fB\-C\fR
.br
\fB--no-vcs\fB
.IP 
Do not add new files to VCS.

.LP 
\fB\-V\fR
.br
\fB--version\fB
.IP 
Display version information and exit.

.LP 
\fB\-v\fR
.br
\fB--verbose\fB
.IP 
Increase verbosity level. May be used more than once.

.LP 
\fB\-q\fR
.br
\fB--quiet\fB
.IP 
Do not output any non-essential information.

.LP
\fB\-a\fR
.br
\fB--no-auxfiles\fB
.IP
don't bump auxfiles (files/*)

.LP
\fB\-c\fR
.br
\fB--no-changelog\fB
.IP
do not update ChangeLog (via echangelog)

.LP 
\fB\-m\fR <\fIChangeLog text\fR>
.br 
\fB\--message\fR <\fIChangeLog text\fR>
.IP 
Specifies the message to add to the ChangeLog, instead of the standard
placeholder.

.LP 
\fB\-d\fR
.br
\fB\--delete-old\fR
.IP 
Delete old revision and old auxiliary files from VCS. This is
\fIdangerous\fR and should only be used if you know exactly what you are
doing, because
.br
1) the old revision may be stable on a different architecture than the one you
are working on.
.br
2) the auxiliary files may be required by other versions of the ebuild.
.br
3) the new revision should usually undergo a period of testing before being marked stable.

.SH "CONFIGURATION"

.LP
\fB/etc/gentoolkit/ebump.conf\fR
.br
\fB~/.gentoo/ebump.conf\fR
.IP
From these files, \fIebump\fR will load the settings
.br
\fBopt_verbosity\fR (default \fI1\fR) - verbosity level 0-10
.br
\fBopt_add_changelog\fR (default \fIy\fR) - add entry in ChangeLog
.br
\fBopt_add_vcs\fR (default \fIy\fR) - add new files to VCS
.br
\fBopt_bump_auxfiles\fR (default \fIy\fR) - bump auxiliary files in files/
.br
\fBopt_delete_old\fR (default \fIn\fR) - delete old revision (DANGEROUS!)
.br
\fBopt_commitmessage\fR (default \fI""\fR) - default ChangeLog message

.LP
\fB(DEPRECATED)\fR
.br
\fB~/.gentoo/gentool-env\fR
.IR
From this file, \fIebump\fR will load the env vars \fBAUTHORNAME\fR and 
\fBAUTHOREMAIL\fR, which are used to generate proper ChangeLog entries.

.SH "SEE ALSO"
.LP 
The rest of the utilities in \fIapp-portage/gentoolkit-dev\fR, such as
\fIechangelog(1)\fR and \fIekeyword(1)\fR.

.SH "AUTHORS"
.LP 
Karl Trygve Kalleberg <karltk@gentoo.org>
.br
Christian Ruppert <idl0r@gentoo.org>