.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\"
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng .
.TH "GBP-IMPORT-ORIG" "1" "29 October 2014" "" "git-buildpackage Manual"
.SH NAME
git-import-orig, gbp-import-orig \- Import an upstream source into a git repository
.SH SYNOPSIS
\fBgbp import-orig\fR [ \fB--version\fR ] [ \fB--help\fR ] [ \fB--verbose\fR ] [ \fB--color=\fI[auto|on|off]\fB\fR ] [ \fB--color-scheme=\fICOLOR_SCHEME\fB\fR ] [ \fB--upstream-version=\fIversion\fB\fR ] [ \fB--[no-]merge\fR ] [ \fB--upstream-branch=\fIbranch_name\fB\fR ] [ \fB--debian-branch=\fIbranch_name\fB\fR ] [ \fB--upstream-vcs-tag=\fItag_name\fB\fR ] [ \fB--[no-]sign-tags\fR ] [ \fB--keyid=\fIgpg-keyid\fB\fR ] [ \fB--upstream-tag=\fItag-format\fB\fR ] [ \fB--filter=\fIpattern\fB\fR ] [ \fB--[no-]pristine-tar\fR ] [ \fB--[no-]filter-pristine-tar\fR ] [ \fB--[no-]symlink-orig\fR ] [ \fB--postimport=cmd\fR ] [ \fB--[no-]interactive\fR ] \fB\fIupstream-source\fB\fR | \fB--uscan\fR
.SH "DESCRIPTION"
.PP
\fBgbp import-orig\fR imports \fIupstream-source\fR into
the Git repository. \fIupstream-source\fR can either
be a gzip, bzip2, lzma or xz compressed tar archive, a zip archive or an
already unpacked source tree. If it is already of the form
\fIpackage-name_version.orig.tar.gz\fR, the version
information is read from the tarball's filename otherwise it can be given
on the command line via \fB--upstream-version\fR\&. If the source
package name or version can't be determined \fBgbp import-orig\fR will prompt
for it unless \fB--no-interactive\fR is given.
.PP
The sources are placed on the upstream branch (default:
\fIupstream\fR), tagged and merged onto the debian
branch (default: \fImaster\fR).
.SH "OPTIONS"
.TP
\fB--version\fR
Print version of the program, i.e. version of the git-buildpackage
suite
.TP
\fB-v\fR
.TP
\fB--verbose\fR
Verbose execution
.TP
\fB-h\fR
.TP
\fB--help\fR
Print help and exit
.TP
\fB--color=\fI[auto|on|off]\fB \fR
Whether to use colored output.
.TP
\fB--color-scheme=\fICOLOR_SCHEME\fB \fR
Colors to use in output (when color is enabled). The format for
COLOR_SCHEME is
\&':::\&'.
Numerical values and color names are accepted, empty fields imply
the default color. For example --git-color-scheme='cyan:34::' would
show debug messages in cyan, info messages in blue and other messages
in default (i.e. warning and error messages in red).
.TP
\fB--upstream-version=\fIversion\fB\fR
.TP
\fB-u\fIversion\fB\fR
The upstream version number
.TP
\fB--[no-]merge\fR
Merge the upstream branch to the debian branch after import
.TP
\fB--upstream-branch=\fIbranch_name\fB \fR
The branch in the Git repository the upstream sources are put
onto. Default is \fIupstream\fR\&.
.TP
\fB--debian-branch=\fIbranch_name\fB \fR
The branch in the Git repository the Debian package is being
developed on, default is \fImaster\fR\&. After
importing the new sources on the upstream branch, \fBgbp import-orig\fR
will try to merge the new version onto this branch.
.TP
\fB--upstream-vcs-tag=\fItag_name\fB \fR
Add \fItag_name\fR as additional parent to the
commit of the upstream tarball. Useful when upstream uses git and you
want to link to it's revision history.
.TP
\fB--[no-]sign-tags \fR
GPG sign all created tags
.TP
\fB--keyid=\fIgpg-keyid\fB \fR
use this keyid for gpg signing tags
.TP
\fB--upstream-tag=\fItag-format\fB \fR
use this tag format when tagging upstream versions,
default is \fIupstream/%(version)s\fR
.TP
\fB--import-msg=\fImsg-format\fB \fR
use this format string for the commit message when importing upstream
versions, default is
\fIImported Upstream version %(version)s\fR
.TP
\fB--filter=\fIpattern\fB \fR
filter out files glob-matching pattern. Can be given multiple times.
.TP
\fB--[no-]pristine-tar \fR
generate \fBpristine-tar\fR delta file
.TP
\fB--[no-]filter-pristine-tar \fR
if using a filter also filter the files out of the tarball
passed to \fBpristine-tar\fR
.TP
\fB--[no-]symlink-orig\fR
Whether to create and keep a symlink from the upstream tarball
to a Debian policy conformant upstream tarball name located in
\fI\&../\fR\&.
This is a good idea if not using \fBpristine-tar\fR
since it avoids creating a new tarball with a different md5sum.
.TP
\fB--postimport=\fIcmd\fB\fR
run \fIcmd\fR after the import.
.TP
\fB--uscan\fR
Use uscan to fetch new upstream version.
.TP
\fB--[no-]interactive\fR
Run command interactively, i.e. ask package name and version if
needed.
.SH "EXAMPLES"
.PP
Download and import a new upstream version using the informantion from \fIdebian/watch\fR
.nf
\fBgbp import-orig\fR --uscan
.fi
.PP
After downloading an upstream tarball by hand import it
.nf
\fBgbp import-orig\fR \&../upstream-tarball-0.1.tar.gz
.fi
.SH "CONFIGURATION FILES"
.PP
Several \fIgbp.conf\fR files are parsed
to set defaults for the above commandline arguments. See the
\fBgbp.conf\fR(5) manpage for details.
.SH "SEE ALSO"
.PP
\fBgbp-buildpackage\fR(1),
\fBgbp-import-dsc\fR(1),
\fBgbp-import-dscs\fR(1),
\fBgbp-dch\fR(1),
\fBgbp.conf\fR(5),
\fBdebuild\fR(1),
\fBgit\fR(1),
\fBpristine-tar\fR(1),
\fIThe Git-Buildpackage Manual\fR
.SH "AUTHOR"
.PP
Guido Guenther