gbp-export-orig(1)

NAME
gbp-export-orig - Export upstream tarballs from a Git repository

SYNOPSIS
gbp export-orig
[--verbose] [--color=[auto|on|off]] [--color-scheme= COLOR_SCHEME] [--upstream-branch= BRANCH_NAME] [--[no-]submodules] [--upstream-tag= tag-format] [--upstream-tree= [TAG|BRANCH|TREEISH]] [--tarball-dir= DIRECTORY] [--force-create] [--compression= TYPE] [--compression-level= LEVEL] [--component= component]... [--[no-]pristine-tar] [--upstream-signatures=[auto|on|off]]

DESCRIPTION
gbp export-orig is used to export upstream tarballs from a Git repository. Usually upstream tarballs are created by gbp buildpackage when needed but if you don't want to perform a build you can use this command.

OPTIONS

\FC--verbose\F[]
    verbose execution

\FC--color=\F[][auto|on|off]
    Whether to use colored output.

\FC--color-scheme\F[]=COLOR_SCHEME
    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).

\FC--upstream-branch\F[]=BRANCH_NAME
    Branch to build the orig tarball from if \FC--upstream-tree\F[] is set to BRANCH. Default is upstream.

\FC--[no-]submodules\F[]
    Include git submodules in the orig tarball.

\FC--upstream-tag=\F[]TAG-FORMAT
    Use this tag format when looking for tags of upstream versions, default is upstream/%(version)s.

\FC--force-create\F[]
    Force creation of an orig tarball (overwriting a pre-existing one if present).

\FC--upstream-tree=\F[][BRANCH|TAG|TREEISH]
    How to find the upstream sources used to generate the tarball. TAG (the default) looks at a tag corresponding to the version in the changelog. BRANCH looks at the upstream branch given via the \FC--upstream-branch\F[] option.

    Other values are interpreted as treeishs.

    This doesn't have any effect if \FC--pristine-tar\F[] is being used.

\FC--tarball-dir=\F[]DIRECTORY
    Search for original tarballs in DIRECTORY instead of generating them. DIRECTORY can contain a version format substitution pattern, eg: foo-%(version)s.

\FC--compression=\F[]TYPE
    Specifies the upstream tarball compression type. This will be used to locate and build the upstream tarball if necessary. The default is auto which derives the compression type from the pristine-tar branch if available and falls back to gzip otherwise. Other options are gzip, bzip2, lzma and xz.

\FC--compression-level=\F[]LEVEL
    Specifies the upstream tarball compression level if an upstream tarball needs to be built.

\FC--component=\F[]COMPONENT
    When generating tarballs create an additional original tarball of directory COMPONENT in the source tree. Using additional original tarballs is a feature of the 3.0 (quilt) source format. See the dpkg-source manpage for details. Note that the --pristine-tar-commit option is currently incompatible with this option.

    This is considered an experimental feature and might change incompatibly.

\FC--pristine-tar\F[]
    Use pristine-tar when generating the upstream tarball if it doesn't exist.

\FC--upstream-signatures=\F[][auto|on|off]
    Whether to export with upstream signatures.

EXAMPLES
Generate an upstream tarball of the version currently referenced in the changelog using pristine-tar:

\FC
      gbp export-orig --pristine-tar
    \F[]

Same as above but generate and additional tarball for directory \FCfoo\F[].

\FC
      gbp export-orig --pristine-tar --component=foo
    \F[]

CONFIGURATION FILES
Several \FCgbp.conf\F[] files are parsed to set defaults for the above command-line arguments. See the gbp.conf(5) manpage for details.

SEE ALSO
gbp-buildpackage(1), gbp-import-orig(1), gbp-pristine-tar(1), gbp.conf(5), debuild(1), git(1), pristine-tar(1),

AUTHOR
Guido Günther <\FCagx@sigxcpu.org\F[]>