'\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH gbp-import-srpm 1 "31 May 2023" "" "git-buildpackage Manual"
.SH NAME
gbp-import-srpm \- Import source RPM packages into a Git repository
.SH SYNOPSIS
'nh
.fi
.ad l
\fBgbp\ import-srpm\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fB--version\fR] [\fB--help\fR] [\fB--verbose\fR] [\fB--color=\fR[auto|on|off]] [\fB--color-scheme=\fR \fICOLOR_SCHEME\fR] [\fB--vendor\fR= \fIVENDOR\fR] [\fB--allow-same-versions\fR] [\fB--author-is-committer\fR] [\fB--packaging-branch=\fR \fIBRANCH-NAME\fR] [\fB--packaging-tag=\fR \fITAG-FORMAT\fR] [\fB--skip-packaging-tag\fR] [\fB--packaging-dir=\fR \fIDIRECTORY\fR] [\fB--filter=\fR \fIPATTERN\fR] [\fB--keyid=\fR \fIGPG-KEYID\fR] [\fB--[no-]create-missing-branches\fR] [\fB--[no-]pristine-tar\fR] [\fB--[no-]sign-tags\fR] [\fB--upstream-branch=\fR \fIBRANCH-NAME\fR] [\fB--upstream-tag=\fR \fITAG-FORMAT\fR] [\fB--upstream-vcs-tag=\fR \fITAG-FORMAT\fR] [\fB--native\fR] [\fB--repo-user=\fR \fB[GIT|DEBIAN]\fR] [\fB--repo-email=\fR \fB[GIT|DEBIAN]\fR] \fISRPM\fR | \fIDIRECTORY\fR [\fItarget\fR]
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBgbp\ import-srpm\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fBoptions\fR] \fIURL\fR [\fItarget\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBgbp\ import-srpm\fR imports an RPM source package into a Git repository,
notes the package version in the commit logs, and commits the change. All
information, including package name, version and upstream source is
automatically detected from the source package but you can override the
location of the new repository by optionally specifying the
\fItarget\fR argument. The tool supports importing
both archived (src.rpm files) or unpacked (directory) source RPMs. It also imports
from http(s)-URLs.
.SH OPTIONS
.TP 
\*(T<\fB\-\-version\fR\*(T>
Print version of the program, i.e. version of the git-buildpackage
suite
.TP 
\*(T<\fB\-v\fR\*(T>, \*(T<\fB\-\-verbose\fR\*(T>
Verbose execution
.TP 
\*(T<\fB\-h\fR\*(T>, \*(T<\fB\-\-help\fR\*(T>
Print help and exit
.TP 
\*(T<\fB\-\-color=\fR\*(T>[auto|on|off] 
Whether to use colored output.
.TP 
\*(T<\fB\-\-color\-scheme=\fR\*(T>\fICOLOR_SCHEME\fR 
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,
\*(T<\fB\-\-git\-color\-scheme=\fR\*(T>\*(T<'cyan:34::'\*(T> would
show debug messages in cyan, info messages in blue and other messages
in default (i.e. warning and error messages in red).
.TP 
\*(T<\fB\-\-vendor\fR\*(T>=\fIVENDOR\fR 
Distribution vendor name.
.TP 
\*(T<\fB\-\-upstream\-branch\fR\*(T>=\fIBRANCH-NAME\fR 
The branch in the Git repository the upstream sources are put
onto. Default is \fIupstream\fR.
.TP 
\*(T<\fB\-\-packaging\-branch\fR\*(T>=\fIBRANCH-NAME\fR 
The branch in the Git repository the packaging files are put
onto. Default is \fImaster\fR.
.TP 
\*(T<\fB\-\-[no\-]sign\-tags\fR\*(T> 
GPG sign all created tags.
.TP 
\*(T<\fB\-\-keyid=\fR\*(T>\fIGPG-KEYID\fR 
Use this keyid for gpg signing tags.
.TP 
\*(T<\fB\-\-packaging\-tag=\fR\*(T>\fITAG-FORMAT\fR 
Use this tag format when tagging released versions,
default is \fI%(vendor)s/%(version)s\fR.
.TP 
\*(T<\fB\-\-skip\-packaging\-tag\fR\*(T> 
Do not create packaging tag after importing the packaging files.
.TP 
\*(T<\fB\-\-upstream\-tag=\fR\*(T>\fITAG-FORMAT\fR 
Use this tag format when tagging upstream versions,
default is \fIupstream/%(version)s\fR.
.TP 
\*(T<\fB\-\-upstream\-vcs\-tag\fR\*(T>=\fITAG-NAME\fR 
Add \fITAG-FORMAT\fR as an additional parent of the
commit of the upstream tarball. Useful when upstream uses git and you
want to link to its revision history.
\fITAG-FORMAT\fR can be a pattern similar to
what \*(T<\fB\-\-upstream\-tag\fR\*(T> supports.
.TP 
\*(T<\fB\-\-git\-packaging\-dir=\fR\*(T>\fIDIRECTORY\fR 
Subdirectory where to put the RPM packaging files.
.TP 
\*(T<\fB\-\-filter=\fR\*(T>\fIPATTERN\fR 
Filter out files glob-matching pattern. Can be given multiple times.
.TP 
\*(T<\fB\-\-pristine\-tar\fR\*(T> 
Generate pristine-tar delta file.
.TP 
\*(T<\fB\-\-allow\-same\-version\fR\*(T> 
Allow one to re-import a package with an already existing version.
This will not re-import the upstream sources - only packaging files
will be re-imported.
.TP 
\*(T<\fB\-\-author\-is\-committer\fR\*(T> 
Use the author identity as the committer when importing upstream
sources and packaging files.
.TP 
\*(T<\fB\-\-[no\-]create\-missing\-branches\fR\*(T> 
Create missing upstream and/or packaging branch if missing.
.TP 
\*(T<\fB\-\-orphan\-packaging\fR\*(T> 
Import packaging files into an orphan branch that will not be based
on the upstream branch. Useful if you want to maintain (non-native)
package using the 'orphan-packaging' model. This option have no
effect if \*(T<\fB\-\-native\fR\*(T> is used.
.TP 
\*(T<\fB\-\-native\fR\*(T> 
Treat the package as native package. No separate upstream branch or
upstream tags will be created.
.TP 
\*(T<\fB\-\-repo\-user=\fR\*(T>\*(T<\fB[GIT|DEBIAN]\fR\*(T>
When set to \*(T<\fBDEBIAN\fR\*(T>
use the \fBDEBUSER\fR environment variable to set the
user.name Git configuration otherwise use Git's
defaults. Only affects newly created repos.
.TP 
\*(T<\fB\-\-repo\-email=\fR\*(T>\*(T<\fB[GIT|DEBIAN]\fR\*(T>
When set to \*(T<\fBDEBIAN\fR\*(T>
use the \fBDEBEMAIL\fR environment variable to set the
user.email Git configuration otherwise use Git's
defaults. Only affects newly created repos.
.SH "CONFIGURATION FILES"
Several \*(T<\fIgbp.conf\fR\*(T> files are parsed 
to set defaults for the above command-line arguments. See the
\fBgbp.conf\fR(5) manpage for details.
.SH "SEE ALSO"
\fBgbp-buildpackage-rpm\fR(1),
\fBgbp-pq-rpm\fR(1),
\fBgbp-rpm-ch\fR(1),
\fBgbp.conf\fR(5),
\fBdebuild\fR(1),
\fBgit\fR(1),
\fBpristine-tar\fR(1),
.URL file:///usr/share/doc/git-buildpackage/manual-html/index.html "       The Git-Buildpackage Manual"
.SH AUTHOR
Markus Lehtonen <\*(T<markus.lehtonen@linux.intel.com\*(T>>