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         [-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

DESCRIPTION

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

OPTIONS

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

EXIT STATUS

165       This program returns 0 if successful,  or  non-zero  if  there  was  an
166       error.
167

SEE ALSO

169       rpmbuild(8), mock(1), rpmdiff(1), pkgdiff(1), abipkgdiff(1), csmock(1)
170

AUTHOR

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)
Impressum