'\" -*- 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-export-orig 1 "1 February 2021" "" "git-buildpackage Manual"
.SH NAME
gbp-export-orig \- Export upstream tarballs from a Git repository
.SH SYNOPSIS
'nh
.fi
.ad l
\fBgbp\ export-orig\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fB--verbose\fR] [\fB--color=\fR[auto|on|off]] [\fB--color-scheme\fR= \fICOLOR_SCHEME\fR] [\fB--upstream-branch=\fR \fIBRANCH_NAME\fR] [\fB--[no-]submodules\fR] [\fB--upstream-tag=\fR \fItag-format\fR] [\fB--upstream-tree=\fR \fI[TAG|BRANCH|TREEISH]\fR] [\fB--tarball-dir=\fR \fIDIRECTORY\fR] [\fB--force-create\fR] [\fB--compression=\fR \fITYPE\fR] [\fB--compression-level=\fR \fILEVEL\fR] [\fB--component=\fR \fIcomponent\fR]\&... [\fB--[no-]pristine-tar\fR] [\fB--upstream-signatures=\fR[auto|on|off]]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBgbp\ export-orig\fR is used to export upstream tarballs from a
Git repository. Usually upstream tarballs are created by
\fBgbp\ buildpackage\fR when needed but if you don't want to perform
a build you can use this command.
.SH OPTIONS
.TP 
\*(T<\fB\-\-verbose\fR\*(T> 
verbose execution
.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 --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 
\*(T<\fB\-\-upstream\-branch\fR\*(T>=\fIBRANCH_NAME\fR 
Branch to build the orig tarball from if
\*(T<\fB\-\-upstream\-tree\fR\*(T> is set to
\fIBRANCH\fR. Default is
\fIupstream\fR.
.TP 
\*(T<\fB\-\-[no\-]submodules\fR\*(T> 
Include git submodules in the orig tarball.
.TP 
\*(T<\fB\-\-upstream\-tag=\fR\*(T>\fITAG-FORMAT\fR 
Use this tag format when looking for tags of upstream versions,
default is \fIupstream/%(version)s\fR.
.TP 
\*(T<\fB\-\-force\-create\fR\*(T> 
Force creation of an orig tarball (overwriting a pre-existing one if
present).
.TP 
\*(T<\fB\-\-upstream\-tree=\fR\*(T>\fI[BRANCH|TAG|TREEISH]\fR 
How to find the upstream sources used to generate the tarball.
\fITAG\fR (the default) looks at a tag corresponding to the
version in the changelog. \fIBRANCH\fR looks at
the upstream branch given via the
\*(T<\fB\-\-upstream\-branch\fR\*(T> option.

Other values are interpreted as treeishs.

This doesn't have any effect if \*(T<\fB\-\-pristine\-tar\fR\*(T>
is being used.
.TP 
\*(T<\fB\-\-tarball\-dir=\fR\*(T>\fIDIRECTORY\fR 
Search for original tarballs in \fIDIRECTORY\fR
instead of generating them.
\fIDIRECTORY\fR can contain a version format
substitution pattern, eg: \fIfoo-%(version)s\fR.
.TP 
\*(T<\fB\-\-compression=\fR\*(T>\fITYPE\fR 
Specifies the upstream tarball compression type. This will be used to
locate and build the upstream tarball if necessary. The default is
\fIauto\fR which derives the compression type
from the pristine-tar branch if available and falls back to gzip
otherwise. Other options are \fIgzip\fR,
\fIbzip2\fR, \fIlzma\fR and
\fIxz\fR.
.TP 
\*(T<\fB\-\-compression\-level=\fR\*(T>\fILEVEL\fR 
Specifies the upstream tarball compression level if an upstream
tarball needs to be built.
.TP 
\*(T<\fB\-\-component=\fR\*(T>\fICOMPONENT\fR 
When generating tarballs create an additional original
tarball of directory \fICOMPONENT\fR
in the source tree. Using additional original tarballs is
a feature of the 3.0 (quilt) source format. See
the \fBdpkg-source\fR manpage for details. Note that the
\fI--pristine-tar-commit\fR
option is currently incompatible with this option.

This is considered an experimental feature and might
change incompatibly.
.TP 
\*(T<\fB\-\-pristine\-tar\fR\*(T> 
Use pristine-tar when generating the upstream tarball if it doesn't
exist.
.TP 
\*(T<\fB\-\-upstream\-signatures=\fR\*(T>[auto|on|off] 
Whether to export with upstream signatures.
.SH EXAMPLES
Generate an upstream tarball of the version currently referenced
in the changelog using pristine-tar:
.PP
.nf
\*(T<
      \fBgbp\ export\-orig\fR \-\-pristine\-tar
    \*(T>
.fi
.PP
Same as above but generate and additional tarball for
directory \*(T<\fIfoo\fR\*(T>.
.PP
.nf
\*(T<
      \fBgbp\ export\-orig\fR \-\-pristine\-tar \-\-component=foo
    \*(T>
.fi
.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\fR(1),
\fBgbp-import-orig\fR(1),
\fBgbp-pristine-tar\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
Guido G\(:unther <\*(T<agx@sigxcpu.org\*(T>>