-
Notifications
You must be signed in to change notification settings - Fork 0
/
gear.1.inc
151 lines (144 loc) · 4.68 KB
/
gear.1.inc
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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
.\" Copyright (C) 2006-2017 Dmitry V. Levin <[email protected]>
.\" Copyright (C) 2006-2007 Sergey Vlasov <[email protected]>
.\" Copyright (C) 2009 Alexey I. Froloff <[email protected]>
.\"
.\" Additional documentation for the gear command.
.\"
.\" This file is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
[NAME]
gear \- Get Every Archive from git package Repository
[USAGE]
\fBgear\fR can perform several different operations, one of
which is selected by command line options.
.SS "Create a tar archive with source files"
When no options which specify another operation are
specified, \fBgear\fR requires a single non-option argument
\fIoutput-tarball-name\fR. In this mode \fBgear\fR extracts
source files from the repository and packs them into a tar
archive with the specified name. By default the archive is
compressed with \fBzstd\fR; this may be changed using
the following compression options:
.BR \-\-bzip2 ,
.BR \-\-gzip ,
.BR \-\-lz4 ,
.BR \-\-lzop ,
.BR \-\-xz ,
.BR \-\-zstd ,
and
.BR \-\-no\-compress .
.SS "Extract source files to a directory"
When the \fB\-\-export\-dir\fR=\fIdirname\fR option is
specified, \fBgear\fR does not accept any non-option
arguments. In this mode \fBgear\fR extracts source files
from the repository and puts them into the specified
directory.
.SS "Execute hsh-like command"
When the \fB\-\-hasher\fR option is specified, \fBgear\fR
requires one or more non-option arguments
\fIhsh-command\fR..., which specify the command to execute
and parameters for it. In this mode \fBgear\fR extracts
source files from the repository, creates a temporary tar
archive with these files and invokes \fIhsh-command\fR,
appending the archive file name to its parameters. When
\fIhsh-command\fR completes, \fBgear\fR removes the
temporary tar archive.
.SS "Execute rpmbuild-like command"
When the \fB\-\-rpmbuild\fR option is specified, \fBgear\fR
requires one or more non-option arguments
\fIrpmbuild-command\fR..., which specify the command to
execute and parameters for it. In this mode \fBgear\fR
extracts source files from the repository to a temporary
directory and invokes \fIrpmbuild-command\fR, appending the
following parameters to it:
.RS 4
.PP
\-\-define "_specdir \fI$dir\fR"
\-\-define "_sourcedir \fI$dir\fR"
"\fI$spec\fR"
.RE
.PP
where \fI$dir\fR is the name of the temporary directory, and
\fI$spec\fR is the full name of the extracted spec file.
When \fIrpmbuild-command\fR completes, \fBgear\fR optionally
copies the spec file from the temporary directory to the
working copy of the repository (if requested by the
\fB\-\-update\-spec\fR option), and then removes the
temporary source directory.
.SS "Describe the package"
When the \fB\-\-describe\fR options is specified, \fBgear\fR
does not accept any non-option arguments. In this mode
\fBgear\fR just prints the package name, version and release
strings found in the spec file, and does not proceed to
extract source files from the repository.
[TEMPORARY COMMITS AND TAGS]
In
.B \-\-commit
mode,
.B gear
creates a temporary commit object with staged and unstaged changes.
If
.BR specsubst :
directive is in use,
.B gear
also creates a temporary tag object for just created temporary commit object.
[CONFIGURATION]
.B gear
reads following configuration options from
.BR git\-config (1):
.PP
.B gear.compress
.RS 4
compression method, defaults to \-\-zstd.
.RE
.PP
.B gear.rules
.RS 4
rules file name.
.RE
.PP
In
.B \-\-commit
mode, when
.BR specsubst :
directive is in use,
.B gear
also reads
.BR gear.specsubst. *
configuration options from
.BR git\-config (1)
for each variable listed in the
.BR specsubst :
directive.
[ENVIRONMENT]
.TP
.B GIT_DIR
If the
.B GIT_DIR
environment variable is set then it specifies a path to use instead of
the default for the base of the repository.
[BUGS]
\fBgear\fR does not get correct package name, version and
release from spec files which use RPM macros to define these
fields.
[SEE ALSO]
.BR gear\-rules (5),
.BR gear\-commit (1),
.BR gear\-srpmimport (1),
.BR gear\-store\-tags (1),
.BR gear\-update (1),
.BR hsh (1),
.BR git (7),
.BR git\-config (1),
.BR rpmbuild (8).