1REBASE-HELPER(1)                 rebase-helper                REBASE-HELPER(1)
2
3
4

NAME

6       rebase-helper - helps you rebase your package to the latest version
7

SYNOPSIS

9       rebase-helper [-h] [--version] [-v] [--color {always,never,auto}]
10         [--background {dark,light,auto}] [--results-dir RESULTS_DIR]
11         [--workspace-dir WORKSPACE_DIR]
12         [--buildtool {copr,koji,mock,rpmbuild}]
13         [--srpm-buildtool {mock,rpmbuild}]
14         [--pkgcomparetool
15         [{abipkgdiff,csmock,licensecheck,pkgdiff,rpmdiff,rpminspect-
16         rpm,rpminspect-srpm,sonamecheck}]]
17         [--outputtool {json,text}]
18         [--versioneer {anitya,cpan,hackage,npmjs,pypi,rubygems}]
19         [--versioneer-blacklist [{anitya,cpan,hackage,npmjs,pypi,rubygems}]]
20         [--spec-hook-blacklist [{commit-hash-updater,escape-macros,paths-to-rpm-
21         macros,pypi-url-fix,replace-old-version,ruby-helper,typo-fix}]]
22         [--build-log-hook-blacklist [{files}]] [--bugzilla-id BUG_ID]
23         [--non-interactive] [--favor-on-conflict {downstream,upstream,off}]
24         [--not-download-sources] [-w] [--apply-changes]
25         [--disable-inapplicable-patches] [--keep-comments]
26         [--skip-version-check] [--update-sources] [--skip-upload]
27         [--force-build-log-hooks] [--builds-nowait]
28         [--build-tasks OLD_TASK,NEW_TASK] [--builder-options BUILDER_OPTIONS]
29         [--srpm-builder-options SRPM_BUILDER_OPTIONS]
30         [--lookaside-cache-preset {fedpkg,centpkg,rhpkg,rhpkg-sha512}]
31         [--changelog-entry CHANGELOG_ENTRY] [--no-changelog-entry]
32         [--config-file CONFIG_FILE] [-D 'MACRO EXPR']
33         [--copr-project-permanent] [--copr-project-frontpage]
34         [--copr-chroots COPR_CHROOTS] [--get-old-build-from-koji]
35         [--replace-old-version-with-macro] [SOURCES]
36
37
38
39
40

DESCRIPTION

42       rebase-helper is a tool which helps package maintainers to rebase their
43       packages to latest upstream versions.
44
45       It should be executed from a directory containing  spec  file,  sources
46       and patches (usually cloned dist-git repository).
47
48       The  new  version is specified by SOURCES argument, which can be either
49       version number or filename of the new source  archive.   Starting  with
50       version 0.10.0, this argument can be omitted and the new version deter‐
51       mined automatically using one of available versioneers.
52

OPTIONS

54       SOURCES
55              version number or filename of the new source archive
56
57       -h, --help
58              show help message and exit
59
60       --version
61              show rebase-helper version and exit
62
63       -v, --verbose
64              be more verbose
65
66       --color {always,never,auto}
67              colorize the output, defaults to auto
68
69       --background {dark,light,auto}
70              use color scheme for the given background, defaults to auto
71
72       --results-dir RESULTS_DIR
73              location where the rebase-helper-results directory will be  cre‐
74              ated
75
76       --workspace-dir WORKSPACE_DIR
77              location  where  the  rebase-helper-workspace  directory will be
78              created
79
80       --buildtool {copr,koji,mock,rpmbuild}
81              build tool to use, defaults to mock
82
83       --srpm-buildtool {mock,rpmbuild}
84              SRPM build tool to use, defaults to rpmbuild
85
86       --pkgcomparetool   [{abipkgdiff,csmock,licensecheck,pkgdiff,rpmdiff,rp‐
87       minspect-rpm,rpminspect-srpm,sonamecheck}]
88              set  of  tools  to use for package comparison, defaults to abip‐
89              kgdiff,licensecheck,pkgdiff,rpmdiff,rpminspect-rpm,rpmin‐
90              spect-srpm,sonamecheck if available
91
92       --outputtool {json,text}
93              tool to use for formatting rebase output, defaults to text
94
95       --versioneer {anitya,cpan,hackage,npmjs,pypi,rubygems}
96              tool to use for determining latest upstream version
97
98       --versioneer-blacklist [{anitya,cpan,hackage,npmjs,pypi,rubygems}]
99              prevent specified versioneers from being run
100
101       --spec-hook-blacklist [{commit-hash-updater,escape-macros,paths-to-rpm-
102       macros,pypi-url-fix,replace-old-version,ruby-helper,typo-fix}]
103              prevent specified spec hooks from being run
104
105       --build-log-hook-blacklist [{files}]
106              prevent specified build log hooks from being run
107
108       --bugzilla-id BUG_ID
109              do a rebase based on Upstream Release Monitoring bugzilla
110
111       --non-interactive
112              do not interact with user
113
114       --favor-on-conflict {downstream,upstream,off}
115              favor downstream or upstream changes when conflicts appear
116
117       --not-download-sources
118              do not download sources
119
120       -w, --keep-workspace
121              do not remove workspace directory after finishing
122
123       --apply-changes
124              apply changes.patch after a successful rebase
125
126       --disable-inapplicable-patches
127              disable inapplicable patches in rebased SPEC file
128
129       --keep-comments
130              do not remove associated comments  when  removing  patches  from
131              spec file
132
133       --skip-version-check
134              force  rebase  even  if  current version is newer than requested
135              version
136
137       --update-sources
138              update “sources” file and upload new sources to lookaside cache
139
140       --skip-upload
141              skip uploading new sources to lookaside cache
142
143       --force-build-log-hooks
144              enforce running of build  log  hooks  (even  in  non-interactive
145              mode)
146
147       --builds-nowait
148              do not wait for remote builds to finish
149
150       --build-tasks OLD_TASK,NEW_TASK
151              comma-separated remote build task ids
152
153       --builder-options BUILDER_OPTIONS
154              enable  arbitrary  local  builder option(s), enclose BUILDER_OP‐
155              TIONS in quotes to pass more than one
156
157       --srpm-builder-options SRPM_BUILDER_OPTIONS
158              enable  arbitrary  local   srpm   builder   option(s),   enclose
159              SRPM_BUILDER_OPTIONS in quotes to pass more than one
160
161       --lookaside-cache-preset {fedpkg,centpkg,rhpkg,rhpkg-sha512}
162              use  specified lookaside cache configuration preset, defaults to
163              fedpkg
164
165       --changelog-entry CHANGELOG_ENTRY
166              text to use as changelog entry, can contain  RPM  macros,  which
167              will be expanded
168
169       --no-changelog-entry
170              do not add a changelog entry at all
171
172       --config-file CONFIG_FILE
173              path  to  a configuration file, defaults to $XDG_CONFIG_HOME/re‐
174              base-helper.cfg
175
176       -D 'MACRO EXPR', --define 'MACRO EXPR'
177              define an rpm macro, can be used multiple times
178
179       --copr-project-permanent
180              make the created copr project permanent
181
182       --copr-project-frontpage
183              make the created copr project visible on the frontpage
184
185       --copr-chroots COPR_CHROOTS
186              comma-separated list of chroots to create copr project with
187
188       --get-old-build-from-koji
189              do not build old sources, download latest build  from  Koji  in‐
190              stead
191
192       --replace-old-version-with-macro
193              replace  old  version string with %{version} instead of new ver‐
194              sion string
195
196
197

EXIT STATUS

199       This program returns 0 if successful, or non-zero if there was  an  er‐
200       ror.
201

SEE ALSO

203       rpmbuild(8), mock(1), rpmdiff(1), pkgdiff(1), abipkgdiff(1), csmock(1)
204

AUTHOR

206       Petr  Hráček  <phracek@redhat.com>,  Tomáš  Hozza  <thozza@redhat.com>,
207       Nikola Forró <nforro@redhat.com>, František Nečas <fifinecas@seznam.cz>
208
210       2014-2022, Red Hat
211
212
213
214
2150.27                             Jun 24, 2022                 REBASE-HELPER(1)
Impressum