gbp-import-origgbp-import-orig — Import an upstream source into a git repository |
gbp import-orig [--version] [--help] [--verbose] [--color=[auto|on|off]] [--color-scheme=COLOR_SCHEME] [--upstream-version=version] [--[no-]merge] [--merge-mode=[auto|merge|replace]] [--upstream-branch=branch_name] [--debian-branch=branch_name] [--upstream-vcs-tag=tag-format] [--[no-]sign-tags] [--keyid=gpg-keyid] [--upstream-tag=tag-format] [--filter=pattern...] [--component=component...] [--[no-]pristine-tar] [--[no-]filter-pristine-tar] [--[no-]symlink-orig] [--postimport=cmd] [--postunpack=cmd] [--[no-]interactive] [--[no-]rollback] [--upstream-signatures=[auto|on|off]] filename | url | [--uscan]
gbp import-orig imports upstream sources into a Git™ repository. It can import from three sources:
filename: A file in the local
file system. Gzip, bzip2, lzma and xz compressed tar
archives, zip archives and already unpacked source trees are
supported.
url: The tarball is downloaded
from a http
or https url.
This needs the python3-request package installed.
--uscan: The latest upstream or specified version is
fetched via uscan relying on debian/watch.
If the tarballs name is already of the form
package-name_version.orig.tar.gz, the
version information is determined from the tarball's filename,
otherwise it can be given on the command line
via --upstream-version. If the source package
name or version can't be determined, gbp import-orig will
prompt for it unless --no-interactive is given.
The sources are placed on the upstream branch (default:
upstream), tagged and merged onto the
debian branch (default: master). This
is either done using plain git merge
or by creating a new tree that consists of the new
upstream version plus the debian/
directory. The later is used for source format 3.0
(quilt) packages since direct modifications of the upstream
sources are not allowed in that format and so a 1:1 replacement
of the upstream sources is almost always desired. It can
be tweaked via the --merge-mode.
In case of an error gbp import-orig will rollback (undo)
all changes it has done to the repository (see
the --rollback option).
|
Print version of the program, i.e. version of the git-buildpackage suite |
||||||||
|
Verbose execution |
||||||||
|
Print help and exit |
||||||||
|
Whether to use colored output. |
||||||||
|
Colors to use in output (when color is enabled). The format for
COLOR_SCHEME is
'<debug>:<info>:<warning>:<error>'.
Numerical values and color names are accepted, empty fields imply
the default color. For example,
|
||||||||
|
The upstream version number. With |
||||||||
|
Merge the upstream branch to the Debian™ branch after import |
||||||||
|
How to fold the newly imported upstream source to the Debian™ packaging branch after import.
The default is |
||||||||
|
The branch in the Git™ repository the upstream sources are put
onto. Default is |
||||||||
|
The branch in the Git™ repository the Debian™ package is being
developed on, default is |
||||||||
|
Add |
||||||||
|
GPG sign all created tags. |
||||||||
|
Use this |
||||||||
|
Use this tag format when tagging upstream versions,
default is |
||||||||
|
Use this format string for the commit message when importing upstream
versions, default is
|
||||||||
|
Filter out files glob-matching
|
||||||||
|
When importing the upstream tarball also look for an additional tarball
with component name Using additional original tarballs is a feature of the 3.0 (quilt) source format. See the dpkg-source manpage for details. This is currently considered an experimental feature and might change incompatibly. |
||||||||
|
Generate pristine-tar delta file. |
||||||||
|
If using a filter, also filter the files out of the tarball passed to pristine-tar. |
||||||||
|
Whether to create and keep a symlink from the upstream tarball
to a Debian™ policy conformant upstream tarball name located in
This is a good idea if not using pristine-tar since it avoids creating a new tarball with a different md5sum. |
||||||||
|
Run
|
||||||||
|
Run
|
||||||||
|
Use uscan to fetch new upstream version. The version can be
specified with |
||||||||
|
Run command interactively, i.e. ask package name and version if needed. |
||||||||
|
Rollback changes in case of an error. |
||||||||
|
Whether upstream signatures should be imported as well (when using pristine-tar). no turns this off completely while yes always tries to import a signature (which can be useful if you want to fail if e.g. uscan did not fetch a signature). The default auto means to import a signature file if present but do nothing otherwise. |
Download and import a new upstream version using the information from debian/watch
gbp import-orig --uscan
Fetch tarball from an URL
gbp import-orig https://debian.example.com/sid/upstream-tarball-0.1.tar.gz
Import a local tarball
gbp import-orig ../upstream-tarball-0.1.tar.gz
Several gbp.conf files are parsed
to set defaults for the above command-line arguments. See the
gbp.conf(5) manpage for details.
gbp-buildpackage(1), gbp-import-dsc(1), gbp-import-dscs(1), gbp-dch(1), gbp.conf(5), uscan(1), debuild(1), git(1), pristine-tar(1), The Git-Buildpackage Manual