1REBASE-HELPER(1) rebase-helper REBASE-HELPER(1)
2
3
4
6 rebase-helper - helps you rebase your package to the latest version
7
9 rebase-helper [-h] [--version] [-v] [--color {always,never,auto}]
10 [--background {dark,light,auto}] [--results-dir RESULTS_DIR]
11 [-p | -b | --comparepkgs-only COMPAREPKGS_DIR] [-c]
12 [--buildtool {copr,koji,mock,rpmbuild}] [--srpm-buildtool {mock,rpmbuild}]
13 [--pkgcomparetool {abipkgdiff,csmock,licensecheck,pkgdiff,rpmdiff}]
14 [--outputtool {json,text}]
15 [--versioneer {anitya,cpan,hackage,npmjs,pypi,rubygems}]
16 [--versioneer-blacklist {anitya,cpan,hackage,npmjs,pypi,rubygems}]
17 [--spec-hook-blacklist {commit-hash-updater,escape-macros,paths-to-rpm-macros,pypi-url-fix,replace-old-version,ruby-helper,typo-fix}]
18 [--build-log-hook-blacklist {files}] [--non-interactive]
19 [--favor-on-conflict {downstream,upstream,off}] [--not-download-sources] [-w]
20 [--apply-changes] [--disable-inapplicable-patches] [--get-old-build-from-koji]
21 [--skip-version-check] [--update-sources] [--skip-upload]
22 [--force-build-log-hooks] [--builds-nowait] [--build-tasks OLD_TASK,NEW_TASK]
23 [--builder-options BUILDER_OPTIONS]
24 [--srpm-builder-options SRPM_BUILDER_OPTIONS]
25 [--changelog-entry CHANGELOG_ENTRY] [--config-file CONFIG_FILE] [SOURCES]
26
27
28
29
30
32 rebase-helper is a tool which helps package maintainers to rebase their
33 packages to latest upstream versions.
34
35 It should be executed from a directory containing spec file, sources
36 and patches (usually cloned dist-git repository).
37
38 The new version is specified by SOURCES argument, which can be either
39 version number or filename of the new source archive. Starting with
40 version 0.10.0, this argument can be omitted and the new version deter‐
41 mined automatically using one of available versioneers.
42
44 SOURCES
45 version number or filename of the new source archive
46
47 -h, --help
48 show help message and exit
49
50 --version
51 show rebase-helper version and exit
52
53 -v, --verbose
54 be more verbose
55
56 --color {always,never,auto}
57 colorize the output, defaults to auto
58
59 --background {dark,light,auto}
60 use color scheme for the given background, defaults to auto
61
62 --results-dir RESULTS_DIR
63 directory where rebase-helper output will be stored
64
65 -p, --patch-only
66 only apply patches
67
68 -b, --build-only
69 only build SRPMs and RPMs
70
71 --comparepkgs-only COMPAREPKGS_DIR
72 compare already built packages, COMPAREPKGS_DIR must be a direc‐
73 tory with the following structure: <dir_name>/{old,new}/RPM
74
75 -c, --continue
76 continue previously interrupted rebase
77
78 --buildtool {copr,koji,mock,rpmbuild}
79 build tool to use, defaults to mock
80
81 --srpm-buildtool {mock,rpmbuild}
82 SRPM build tool to use, defaults to rpmbuild
83
84 --pkgcomparetool {abipkgdiff,csmock,licensecheck,pkgdiff,rpmdiff}
85 set of tools to use for package comparison, defaults to abip‐
86 kgdiff,licensecheck,pkgdiff,rpmdiff if available
87
88 --outputtool {json,text}
89 tool to use for formatting rebase output, defaults to text
90
91 --versioneer {anitya,cpan,hackage,npmjs,pypi,rubygems}
92 tool to use for determining latest upstream version
93
94 --versioneer-blacklist {anitya,cpan,hackage,npmjs,pypi,rubygems}
95 prevent specified versioneers from being run
96
97 --spec-hook-blacklist {commit-hash-updater,escape-macros,paths-to-rpm-
98 macros,pypi-url-fix,replace-old-version,ruby-helper,typo-fix}
99 prevent specified spec hooks from being run
100
101 --build-log-hook-blacklist {files}
102 prevent specified build log hooks from being run
103
104 --non-interactive
105 do not interact with user
106
107 --favor-on-conflict {downstream,upstream,off}
108 favor downstream or upstream changes when conflicts appear
109
110 --not-download-sources
111 do not download sources
112
113 -w, --keep-workspace
114 do not remove workspace directory after finishing
115
116 --apply-changes
117 apply changes.patch after a successful rebase
118
119 --disable-inapplicable-patches
120 disable inapplicable patches in rebased SPEC file
121
122 --get-old-build-from-koji
123 do not build old sources, download latest build from Koji
124 instead
125
126 --skip-version-check
127 force rebase even if current version is newer than requested
128 version
129
130 --update-sources
131 update “sources” file and upload new sources to lookaside cache
132
133 --skip-upload
134 skip uploading new sources to lookaside cache
135
136 --force-build-log-hooks
137 enforce running of build log hooks (even in non-interactive
138 mode)
139
140 --builds-nowait
141 do not wait for remote builds to finish
142
143 --build-tasks OLD_TASK,NEW_TASK
144 comma-separated remote build task ids
145
146 --builder-options BUILDER_OPTIONS
147 enable arbitrary local builder option(s), enclose
148 BUILDER_OPTIONS in quotes to pass more than one
149
150 --srpm-builder-options SRPM_BUILDER_OPTIONS
151 enable arbitrary local srpm builder option(s), enclose
152 SRPM_BUILDER_OPTIONS in quotes to pass more than one
153
154 --changelog-entry CHANGELOG_ENTRY
155 text to use as changelog entry, can contain RPM macros, which
156 will be expanded
157
158 --config-file CONFIG_FILE
159 path to a configuration file, defaults to $XDG_CON‐
160 FIG_HOME/rebase-helper.cfg
161
162
163
165 This program returns 0 if successful, or non-zero if there was an
166 error.
167
169 rpmbuild(8), mock(1), rpmdiff(1), pkgdiff(1), abipkgdiff(1), csmock(1)
170
172 Petr Hráček <phracek@redhat.com>, Tomáš Hozza <thozza@redhat.com>,
173 Nikola Forró <nforro@redhat.com>, František Nečas <fifinecas@seznam.cz>
174
176 2014-2019, Red Hat
177
178
179
180
1810.16 May 16, 2019 REBASE-HELPER(1)